Erweiterung für Safari

Starting with UiPath.UIAutomation.Activities version 24.10.0, Safari UI Automation support is available in preview. The extension for Safari lets you:

• Entwerfen Sie UI-Automatisierungen in Studio Web im Safari-Browser unter macOS.
• Führen Sie Browser-Automatisierungen in Safari mit einem lokalen macOS Robot aus, der zuvor installiert und mit dem Orchestrator verbunden wurde.
• Starten Sie Attended-Browserautomatisierungen in Safari über den macOS-Assistant.

Um solche Automatisierungen zu erstellen und auszuführen, müssen Sie die UiPath Browser Automation-Erweiterung für Safari installieren.

Sie können von Studio Web aus beginnen, indem Sie UIAutomation-Aktivitäten hinzufügen. Wenn Sie über Safari auf Studio Web zugreifen, werden Sie aufgefordert, die UiPath-Erweiterung für Safari aus dem App Store zu installieren. Folgen Sie der Konfigurationsanleitung, um die Erweiterung zu konfigurieren, und beginnen Sie dann mit der Gestaltung Ihrer Workflows für die Browser-Automatisierung in Safari.

Hinweis:

Zum Erstellen von Browser-Automatisierungen in Safari auf Maschinen mit macOS ist die mindestens unterstützte Version macOS 12.

Installieren

Über UiPath Studio Web installieren

1. Greifen Sie in der UiPath Automation Cloud™ auf Studio Web zu.

2. Fügen Sie Ihrem Projekt eine Use Browser-Aktivität hinzu. Sie werden aufgefordert, die UiPath-Erweiterung für Safari zu installieren.

   

3. Wählen Sie die Schaltfläche Erweiterung installieren aus.

4. The App Store opens with the UiPath Browser Automation extension.

5. Wählen Sie Abrufen aus, um die Erweiterung zu installieren, und öffnen Sie sie dann.

   

6. After you select Open, a configuration window appears.

   

7. Wählen Sie Safari-Einstellungen öffnen, um auf das Fenster Erweiterungen zuzugreifen, in dem Sie die richtigen Berechtigungen für die neu installierte Erweiterung festlegen können.

   1. Aktivieren Sie die UiPath Browser Automation-Erweiterung im linken Bereich.

   2. Wählen Sie Auf jeder Website immer zulassen aus und bestätigen Sie diese Auswahl.

   3. Wenn Sie privates Browsing verwenden möchten, aktivieren Sie die Einstellung Privates Browsing zulassen.

Result: A message informs you that the extension is now available.

Über den App Store installieren

Sie können direkt im App Store auf die UiPath-Erweiterung für Safari zugreifen und den Installationsvorgang ab Schritt 4 des vorherigen Abschnitts fortsetzen.

Installieren über UiPath Assistant

Bei der Installation der Safari-Erweiterung über Studio Web oder direkt über den App Store wird auch die native Host-Komponente installiert. Das bedeutet, dass Sie Automatisierungen über den UiPath Assistant ohne zusätzliche Installation ausführen können.

Installation using UiPath Assistant requires only a few clicks, with no additional configuration, as long as UiPath Assistant is already installed. This method installs the latest extension version published to the Web Store for the current user only.

Install Steps

1. Greifen Sie auf UiPath Assistant zu.

2. Select the account icon.

3. Select Preferences.

4. Wechseln Sie zu UiPath-Erweiterungen.

5. Select View on App Store for Safari.

   

6. Wählen Sie Installieren aus.

7. Wählen Sie Öffnen aus.

8. Follow the steps required by the extension.

Result: The extension is installed and enabled in Safari.

Install using an MDM

To install via an MDM (mobile device management) application, the machine has to be enrolled to be managed. More details on how device management works on Apple machines can be found on this page: Device Management | Apple Developer Documentation.

Examples of MDMs include:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (open-source)

This method relies on the new declarative management model to push configuration changes to the managed machine(s). The configuration for Safari extensions is detailed here: SafariExtensionSettings | Apple Developer Documentation.

Installieren über das Terminal

The installation from Terminal is performed via UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant, which also includes the extension application packaged as an archive.

This method updates the Safari configuration so that the extension is recognized as installed. The extension is installed for the current user only.

Warnung:

This method is not meant for production environments, as it relies on a mechanism that Apple might change in future updates. Use it only if no other alternative is available.

Voraussetzungen:

• All instances of Safari are closed.

Install Steps

1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari peruser
   

2. Start Safari to design and run automations.

Deinstallieren

Deinstallieren in den Safari-Einstellungen

1. Greifen Sie auf die Safari-Einstellungen zu.

2. Navigieren Sie zur Registerkarte Erweiterungen.

3. Wählen Sie die Schaltfläche Deinstallieren aus.

   

4. Wählen Sie die Schaltfläche Im Finder anzeigen aus. Dadurch wird der Finder mit der ausgewählten Anwendung geöffnet.

   

5. Open the context menu for the UiPath for Safari application and select Move to the Bin.

   

   If a pop-up message states the application cannot be deleted because it is in use:

   

   1. Open Activity Monitor and search for UiPath Native Host for Safari.

      

   2. Select the application, choose Stop, then select Quit.

   3. Return to Finder and select Move to Bin again.

      

6. Enter your Mac credentials and then select OK to authorize this deletion.

   

Result: The extension is uninstalled. It is removed from the Safari extension bar and from the Safari Settings Extensions tab.

Konfiguration der Zugänglichkeit

Um den Eingabemodus Hardware-Ereignisse zu verwenden, müssen Sie UiPath Assistant über die Einstellungen von Datenschutz und Sicherheit ausdrücklich Zugriff auf Ihren Mac gewähren.

Führen Sie dazu die folgenden Schritte aus:

1. Wählen Sie das Apple-Menü aus.

2. Wählen Sie Systemeinstellungen aus.

3. Wählen Sie Datenschutz und Sicherheit in der linken Seitenleiste aus.

4. Wechseln Sie zu Zugänglichkeit, indem Sie den Pfeil auf der rechten Seite auswählen.

5. Enable UiPath Assistant from the list. If you do not see the application, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open. Mac credentials are requested for this change.

   

Result: UiPath Assistant is now authorized to use Hardware Events input mode in Safari automations.

Bekannte Einschränkungen

Berücksichtigen Sie beim Erstellen von Browser-Automatisierungen für Safari die folgenden Einschränkungen:

• Die Erweiterung kann nicht auf Datei-URLs zugreifen. Dies ist eine Einschränkung von Safari, wie in diesem Thread im Apple Developer Forum erklärt wird (Zugriff auf Datei-URLs für Web-Erweiterungen zulassen).
• Die Erweiterung unterstützt nicht mehrere Profile.