Extension pour Safari

À partir de UiPath.UIAutomation.Activities version 24.10.0, la prise en charge de Safari UI Automation est disponible en aperçu. L’extension pour Safari vous permet:

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

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

   

6. Une fois que vous avez sélectionné Ouvrir, une fenêtre de configuration s'affiche.

   

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.

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

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.

L'installation à l'aide de l'Assistant UiPath ne nécessite que quelques clics, sans configuration supplémentaire, tant que l'Assistant UiPath 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 Preferences (Préférences).

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

5. Sélectionnez Afficher dans l’App Store pour Safari.

   

6. Sélectionnez Installer (Install).

7. Sélectionnez Ouvrir (Open).

8. Suivez les étapes requises par l’extension.

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

Installer via un gestionnaire d'appareils mobiles

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

Voici quelques exemples de MDM:

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

Cette méthode s'appuie sur le nouveau modèle de gestion déclaratif pour transmettre les modifications de configuration à la ou aux machines gérées. La configuration des extensions Safari est détaillée ici: SafariExtensionSettings | Documentation du développeur Apple.

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 l’application d’extension 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 uniquement pour l’utilisateur actuel.

Avertissement :

Cette méthode n’est pas destinée aux environnements de production, car elle repose sur un mécanisme qu’Apple pourrait modifier dans les futures mises à jour. Utilisez-le 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 peruser
   

2. Démarrez Safari pour concevoir et exécuter des automatisations.

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. 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 du fait qu’elle est en cours d’utilisation:

   

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

      

   2. Sélectionnez l’application, choisissez Arrêter, puis sélectionnez Quitter.

   3. Revenez à la méthode de recherche et sélectionnez à nouveau Déplacer vers la corbeille .

      

6. Saisissez vos informations d’identification 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 dans les 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. Activer UiPath Assistant à partir de la liste. Si l'application n'est pas visible, sélectionnez + en bas de la liste, recherchez UiPath Assistant, sélectionnez l'application, puis sélectionnez Ouvrir. Les informations d’identification Mac sont demandées pour effectuer cette modification.

   

Résultat: UiPath Assistant est désormais autorisé à utiliser le mode de saisie des événements matériels dans les automatisations Safari.

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.