Extension pour Safari

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

• de concevoir des automatisations de l’interface utilisateur dans Studio Web dans le navigateur Safari sur macOS ;
• d’exécuter les automatisations du navigateur dans Safari à l’aide d’un robot macOS local, installé et connecté à Orchestrator au préalable ;
• de démarrer les automatisations de navigateur Attended dans Safari via l’Assistant pour macOS.

Pour créer et exécuter de telles automatisations, vous devez installer l’extension Automatisation du navigateur UiPath pour Safari.

Vous pouvez commencer depuis Studio Web en ajoutant n’importe quelle activité UI Automation. Lorsque vous accédez à Studio Web à partir de Safari, vous êtes invité à installer l’extension UiPath pour Safari depuis l’App Store. Suivez le guide d’installation pour configurer l’extension, puis commencez à concevoir vos workflows pour l’automatisation du navigateur dans Safari.

Remarque :

Pour créer des automatisations de navigateur dans Safari sur des machines exécutant macOS, la version minimale prise en charge est macOS 12.

Installer

Installer depuis UiPath Studio Web

1. Dans UiPath Automation Cloud™, accédez à Studio Web.

2. Ajoutez une activité Utiliser un navigateur (Use Browser) de votre projet. Vous êtes invité à installer l’extension UiPath pour Safari.

   

3. Sélectionnez le bouton Installer l’extension (Install extension).

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

5. Sélectionnez Obtenir (Get) pour installer l’extension, puis Ouvrir (Open).

   

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

   

7. Sélectionnez Ouvrir les paramètres Safari (Open Safari settings) pour accéder à la fenêtre Extensions, dans laquelle vous pouvez définir les autorisations appropriées pour l’extension nouvellement installée.

   1. Activez l’extension Automatisation du navigateur UiPath (UiPath Browser Automation) dans le panneau de gauche.

   2. Sélectionnez Toujours autoriser sur chaque site Web et confirmez ce choix.

   3. Si vous avez l'intention d'utiliser la navigation privée, activez le paramètre Activer la navigation privée.

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

Installer depuis l’App Store

Vous pouvez accéder à l’extension UiPath pour Safari directement dans l’ App Store et poursuivre le processus d’installation à partir de l’ étape 4 de la section précédente.

Installer à partir de l'Assistant UiPath

L’installation de l’extension Safari depuis Studio Web ou directement depuis l’App Store installe également le composant Hôte natif (Native Host). Cela signifie que vous pouvez exécuter des automatisations à partir de l’Assistant UiPath sans avoir besoin d’installation supplémentaire.

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. Accédez à l'Assistant UiPath.

2. Select the account icon.

3. Select Preferences.

4. Accédez à Extensions UiPath (UiPath Extensions).

5. Select View on App Store for Safari.

   

6. Sélectionnez Installer (Install).

7. Sélectionnez Ouvrir (Open).

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.

It is not yet clear if this install method can be used to install the extension only for the current user or for all users on the machine.

Avertissement :

The new declarative management model is not yet implemented by the MDM providers.

Installer à partir du 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 included with UiPath Assistant, which also includes the extension application as an archive.

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

This method edits the Safari configuration file in such a way that Safari is tricked into considering the extension installed. This installs the extension only for the current user.

Avertissement :

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.

Install Steps

Prérequis :

• All instances of Safari are closed.

1. Ouvrez un terminal et exécutez la commande suivante :

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

2. Start Safari to design and run automations.

Désinstaller

Désinstaller des paramètres de Safari

1. Accédez aux paramètres de Safari.

2. Accédez à l’onglet Extensions.

3. Sélectionnez le bouton Désinstaller.

   

4. Cliquez sur le bouton Afficher dans la méthode de recherche (Show in Finder). Cela ouvre la méthode de recherche avec l’application sélectionnée.

   

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.

Configuration de l’accessibilité

Pour utiliser le mode de saisie des événements matériels, vous devez spécifiquement accorder à UiPath Assistant l’accès à votre Mac à l’aide des paramètres de Confidentialité et sécurité.

Pour ce faire, suivez les étapes ci-dessous :

1. Sélectionnez le menu Apple.

2. Sélectionnez Paramètres système.

3. Sélectionnez Confidentialité et sécurité dans la barre latérale de gauche.

4. Accédez à Accessibilité en sélectionnant la flèche située à droite.

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.

Limites connues

Tenez compte des limitations suivantes lors de la création d’automatisations de navigateur pour Safari :

• L’extension ne peut pas accéder aux URL de fichiers. Il s’agit d’une limitation de Safari, comme expliqué dans ce fil de discussion du forum des développeurs Apple (Autoriser l’accès aux URL de fichiers pour les extensions Web (Allow access to file URLs for web extensions)).
• L’extension ne prend pas en charge plusieurs profils.