Extension pour Safari

Installez et configurez l’extension UiPath pour Safari afin d’activer UI Automation dans Safari sur macOS avec Studio Web et le Robot macOS local.

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.

To create and run such automations, you must install the UiPath Browser Automation extension for 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

Installing the Safari extension also installs the Native Host component. This means that you can run automations from UiPath Assistant without the need for additional installation.

Installer depuis l’App Store

Étapes d'installation

1. Access the UiPath extension for Safari directly in the App Store

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

   

3. Une fois que vous avez sélectionné Ouvrir, une fenêtre de configuration apparaît.

   

4. 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 Autoriser la navigation privée .

Résultat : un message vous informe que l'extension est désormais disponible.

Installer depuis UiPath Studio Web

Étapes d'installation

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. L’App Store s’ouvre avec l’extension Automatisation du navigateur UiPath.

5. Continue the installation process from step 2 of the Install from App Store section.

Résultat : un message vous informe que l'extension est désormais disponible.

Installer à partir de l'Assistant UiPath

Installation using UiPath Assistant requires 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.

Étapes d'installation

1. Accédez à l'Assistant UiPath.

2. Sélectionnez l’icône du compte.

3. Sélectionnez Préférences.

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

5. Select Install for Safari.

   

Remarque :

Alternatively, select View on App Store to get the extension from the App Store, and then continue from step 2 of the Install from App Store section.

Résultat : l'extension est installée et activée dans Safari.

Installer à partir du terminal

L'installation à partir du Terminal est effectuée 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 latest extension application packaged as an archive.

Cette méthode met à jour la configuration de Safari afin que l'extension soit reconnue comme installée. L'extension est installée pour l'utilisateur actuel uniquement.

Avertissement :

Cette méthode n'est pas destinée aux environnements de production, car elle s'appuie sur un mécanisme qu'Apple pourrait modifier dans les futures mises à jour. Utilisez-la uniquement si aucune autre alternative n'est disponible.

Prérequis

• Toutes les instances de Safari sont fermées.

Étapes d'installation

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

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

2. Lancez Safari pour concevoir et exécuter des automatisations.

Résultat : l'extension est installée et activée dans Safari.

Installer à l'aide d'un MDM

Pour installer via une application MDM (gestion des appareils mobiles), la machine doit être inscrite pour être gérée. Vous trouverez plus de détails sur le fonctionnement de la gestion des appareils sur les machines Apple sur cette page : Gestion des appareils | Documentation pour les développeurs Apple.

Des exemples de MDM incluent :

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

Cette méthode s'appuie sur le nouveau modèle de gestion déclarative pour appliquer les modifications de configuration sur la ou les machines gérées. La configuration des extensions Safari est détaillée ici : ParamètresExtensionSafari | Documentation pour les développeurs Apple.

Désinstaller

Désinstaller depuis l'Assistant UiPath

Uninstall Steps

1. Accédez à l'Assistant UiPath.

2. Sélectionnez l’icône du compte.

3. Sélectionnez Préférences.

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

5. Select Uninstall for Safari.

   

Result: The extension is uninstalled and removed from the Applications folder.

Désinstaller du terminal

The uninstallation 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.

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

Avertissement :

Cette méthode n'est pas destinée aux environnements de production, car elle s'appuie sur un mécanisme qu'Apple pourrait modifier dans les futures mises à jour. Utilisez-la uniquement si aucune autre alternative n'est disponible.

Prérequis

• Toutes les instances de Safari sont fermées.

Uninstall Steps

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

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

Result: The extension is uninstalled and removed from the Applications folder.

Désinstaller des paramètres de Safari

Uninstall Steps

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. Ouvrez le menu contextuel de l'application UiPath pour Safari et sélectionnez Déplacer vers la corbeille.

   

   Si un message contextuel indique que l'application ne peut pas être supprimée car elle est utilisée :

   

   1. Ouvrez le Moniteur d'activité et recherchez Hôte natif UiPath pour Safari.

      

   2. Sélectionnez l'application, choisissez Arrêt, puis sélectionnez Quitter.

   3. Revenez au Finder et sélectionnez à nouveau Déplacer vers la corbeille.

      

6. Entrez vos identifiants Mac, puis sélectionnez OK pour autoriser cette suppression.

   

Résultat : l'extension est désinstallée. Elle est supprimée de la barre d'extension Safari et de l'onglet Extensions des paramètres Safari.

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. Activez UiPath Assistant dans la liste. Si vous ne voyez pas l’application, sélectionnez + en bas de la liste, recherchez UiPath Assistant, sélectionnez l’application et choisissez Ouvrir. Les informations d'identification Mac sont demandées pour cette modification.

   

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

Full Disk Access configuration

To install the Safari extension using UiPath Assistant, you must specifically grant UiPath Assistant access to your Mac files using the Privacy & Security settings.

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. Go to Full Disk Access by selecting the arrow on the right-hand side.
5. Enable Full Disk Access from the list:
   • If UiPath Assistant is listed, enable it.
   • If UiPath Assistant is not listed, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open.

Remarque :

Les informations d’identification Mac sont demandées pour effectuer cette modification.

Result: UiPath Assistant is now authorized to edit the files on your Mac.

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.