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

L’installation de l’extension Safari installe également le composant Hôte natif. Cela signifie que vous pouvez exécuter des automatisations à partir de l’Assistant UiPath sans avoir besoin d’installation supplémentaire.

Installer depuis l’App Store

Étapes d'installation

1. Accédez à l’extension UiPath pour Safari directement dans l’ 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. Poursuivez le processus d'installation à partir de l'étape 2 de la section Installer depuis l'App Store .

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

Installer à partir de l'Assistant UiPath

L'installation à l'aide d'UiPath Assistant ne nécessite aucune configuration supplémentaire, tant que UiPath Assistant est déjà installé. Cette méthode installe la dernière version de l’extension publiée sur Web Store pour l’ utilisateur actuel uniquement.

É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. Sélectionnez Installer pour Safari.

   

Remarque :

Vous pouvez également sélectionner Afficher dans l’App Store pour obtenir l’extension dans l’App Store, puis passer à l’étape 2 de la section Installer depuis l’App Store .

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 fournit un outil pour gérer l’installation de l’extension: UiPath.ExtensionControl.Portable.dll. Cet outil est distribué avec UiPath Assistant, qui inclut également la dernière version d’application d’extension packagée sous forme d’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

Étapes de désinstallation

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. Sélectionnez Désinstaller pour Safari.

   

Résultat: l'extension est désinstallée et supprimée du dossier Applications .

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.

Cette méthode met à jour la configuration de Safari pour que l’extension soit désinstallée. L’extension est désinstallée uniquement pour l’utilisateur actuel.

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 de désinstallation

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

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

Résultat: l'extension est désinstallée et supprimée du dossier Applications .

Désinstaller des paramètres de Safari

Étapes de désinstallation

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.

Configuration de l’accès complet au disque

Pour installer l’extension Safari à l’aide de UiPath Assistant, vous devez spécifiquement accorder à UiPath Assistant l’accès à vos fichiers Mac à l’aide des paramètres 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 à Accès complet au disque en sélectionnant la flèche située à droite.
5. Activez l'accès complet au disque dans la liste:
   • Si UiPath Assistant est répertorié, activez-le.
   • Si UiPath Assistant n’est pas répertorié, sélectionnez + en bas de la liste, recherchez UiPath Assistant, sélectionnez l’application, puis sélectionnez Ouvrir.

Remarque :

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

Résultat: UiPath Assistant est désormais autorisé à modifier les fichiers sur votre 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.