Extension for Edge

Attention: UiPath Inc. et ses sociétés affiliées ne traitent, n'utilisent, n'accèdent ou ne stockent aucune donnée client lors de l'utilisation de ce produit.

Important :

L'obsolescence des extensions Manifest V2 devrait commencer en juin 2024.

Les entreprises utilisant la politique ExtensionManifestV2Availability pour assurer la continuité du fonctionnement des extensions Manifest V2 dans leur organisation disposeront d'une année supplémentaire (jusqu'en juin 2025) pour migrer les extensions Manifest V2 dans leur organisation. Les navigateurs pour lesquels cette politique a été activée ne seront pas impactés par le déploiement de l'obsolescence avant cette date.

L'extension UiPath pour Edge MV2 installée par d'anciennes versions de UiPathStudio.msi cessera de fonctionner dans Edge. Nous vous recommandons vivement de mettre à niveau vos installations UiPath Studio et Robot avant cette échéance.

Consultez ici la chronologie complète de la migration d'Edge vers les extensions MV3.

L'extension UiPath pour Edge MV3 est disponible dans les versions de UiPathStudio.msi suivantes :

• 2022.10
• 2022.4.4+
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

Ceux-ci peuvent être téléchargés à partir du centre de ressources de UiPath Automation Cloud.

Cette extension vous aide à créer des automatisations de navigation dans Microsoft Edge. Vous pouvez installer cette extension de plusieurs façons, comme indiqué ci-dessous :

Installer depuis UiPath Studio

1. Ouvrez Studio.
2. Accédez à Accueil (Home) > Outils (Tools) > Extensions UiPath (UiPath Extensions).
3. Sélectionnez Edge > Installer (Install). Choisissez l'une des méthodes disponibles dans la liste déroulante :
   • Stratégie de groupe hors ligne
   • Stratégie de groupe en ligne
   • Tous les utilisateurs (All Users)
   • Utilisateur actuel
   • Hôte natif uniquement
4. Ouvrez Edge et accédez à edge://extensions.
5. Activez l'extension Automatisation Web UiPath (UiPath Web Automation) si nécessaire.

Installer à partir du programme d'installation de Studio

1. Exécutez le programme d'installation UiPathStudio.msi.
2. Sélectionnez un mode d'installation, puis sélectionnez Paramètres avancés (Advanced Settings) > Extensions > Extension UiPath pour Edge Chromium (UiPath extension for Edge Chromium). Si Edge est installé sur votre machine, l'option est sélectionnée par défaut.
3. Cliquez sur Installer. Le programme d'installation de Studio continue tout en installant l'extension pour Edge.

L'extension UiPath pour Edge peut également être installée à partir de la ligne de commande de UiPathStudio.msi.

Installer à partir de la stratégie de groupe

Vous pouvez également installer l’extension UiPath pour Edge en utilisant les stratégies de groupe. Cette méthode installe l’extension en mode silencieux et l'active sans que l’utilisateur ait besoin de confirmer.

Pour les deux méthodes d'installation de la stratégie de groupe, le navigateur n'affiche pas la bannière lorsque l'extension utilise l'API de débogage.

Nous vous recommandons d'utiliser l'installation de la stratégie de groupe hors ligne car l'ID d'extension ne change pas lors de la mise à niveau vers des versions plus récentes. Cette méthode utilise une extension signée par UiPath au lieu du Web Store Edge. Cela signifie qu'après la mise à jour de la version, il n'est pas nécessaire de mettre à jour les stratégies de groupe internes (c'est-à-dire la stratégie ListeInstallationsForcéesExtension ( ExtensionInstallForcelist )) avec un nouvel ID d'extension.

Un autre avantage de réutiliser le même ID d'extension est que les paramètres configurés pour l'extension (tels que Autoriser en mode navigation privée ( Allow InPrivate ) ou Autoriser l'accès aux URL de fichier ( Allow access to file URLs)) ne sont pas réinitialisés après une mise à jour de version.

Hors ligne

Cette méthode d'installation requiert que la machine cible soit jointe à un domaine Microsoft Active Directory ou Azure Active Directory.

Elle ne nécessite pas d’accès à Edge Web Store et peut donc être utilisée dans les environnements contrôlés pour les machines dotées d’un accès Internet restreint.

UiPathStudio.msi utilise cette méthode d'installation par défaut si ses conditions sont remplies.

Vous pouvez également utiliser cette méthode d'installation en l'exécutant à partir d'une invite de commandes élevée :

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-policy-offline /silent

Si votre organisation utilise des stratégies de groupe pour gérer les extensions de navigateur, les modifications suivantes devront également être apportées à la définition de la stratégie de groupe de votre organisation :

1. Dans la stratégie ListeInstallationsForcéesExtension (ExtensionInstallForcelist), ajoutez la valeur suivante :

   ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/EdgeExtension_SelfHosted/extension_manifest_edge.xml

2. Dans la stratégie ListeAutorisationsMessagerieNative (NativeMessagingAllowList), ajoutez la valeur suivante : com.uipath.chromenativemsg_v2.

Si vous devez héberger l'extension UiPath dans votre Web Store interne, vous trouverez le fichier .crx à cet emplacement :

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_edge_self_hosted_mv3.crx

En ligne

Cette méthode d’installation requiert que la machine cible ait accès au Edge Web Store (https://edge.microsoft.com/extensionwebstorebase/v1/crx et https://msedgeextensions.sf.tlu.dl.delivery.mp.microsoft.com).

UiPathStudio.msi utilise cette méthode d'installation si ses conditions sont remplies et que la machine n'est pas jointe à Microsoft Active Directory.

Vous pouvez également utiliser cette méthode d'installation en l'exécutant à partir d'une invite de commandes élevée :

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-policyglobal /silent

Si votre organisation utilise des stratégies de groupe pour gérer les extensions de navigateur, les modifications suivantes devront également être apportées à la définition de la stratégie de groupe de votre organisation :

1. Dans la stratégie ListeInstallationsForcéesExtension (ExtensionInstallForcelist), ajoutez la valeur suivante :

   cdfjcmjmgdnojgaojdnefhjjpaijapci;https://edge.microsoft.com/extensionwebstorebase/v1/crx

2. Dans la stratégie ListeAutorisationsMessagerieNative (NativeMessagingAllowList), ajoutez la valeur suivante : com.uipath.chromenativemsg_v2.

Désinstallation

L’extension UiPath pour Edge peut être désinstallée en exécutant une invite de commandes élevée :

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-cleanup /silent

Vous pouvez également désinstaller en ouvrant Studio, en accédant à Outils (Tools) > Extensions UiPath (UiPath Extensions) et en sélectionnant Edge > Désinstaller (Uninstall). L'extension sera désinstallée avec la même méthode que celle utilisée pour l'installation. Cette méthode est affichée dans la liste déroulante Désactivé (Disabled) à côté du bouton Désinstaller (Uninstall).

Configuration requise pour la version Edge

L'extension UiPath pour Edge MV2 fonctionne avec toutes les versions Edge existantes.

L'extension UiPath pour Edge MV3 nécessite la version 98 ou une version supérieure d'Edge.

Lorsque vous utilisez l'une des méthodes d'installation décrites ci-dessus, la version du navigateur sera vérifiée et l'extension avec le format approprié (MV2 ou MV3) sera automatiquement installée.

Nouvelles fonctionnalités de l'extension

Prise en charge du mode IE

À partir de UiPathStudio.msi 2020.10, l'extension UiPath pour Edge peut être utilisée pour automatiser les pages Web s'exécutant en mode Internet Explorer.

Les pages Web contenant les contrôles Java Applets Silverlight et ActiveX peuvent être automatisées en mode Internet Explorer.

Automatisation des applications Edge

À partir de UiPathStudio.msi 2022.4, l'extension UiPath pour Edge peut être utilisée pour automatiser les applications Edge.

Instances Edge multiples avec plusieurs profils d’utilisateurs

À partir de la version 2023.10 d'UiPath, l'extension UiPath pour Edge prend en charge l'automatisation de plusieurs instances de navigateur s'exécutant avec plusieurs profils d'utilisateur en même temps.

Pour les versions inférieures à 2023.10, l’extension UiPath pour Edge ne prenait pas en charge l’automatisation de plusieurs instances de navigateur s’exécutant avec plusieurs profils d’utilisateurs en même temps. L’automatisation du navigateur vous obligeait donc à fermer toutes les instances actives de Edge et à redémarrer le navigateur à l’aide d’un profil d’utilisateur unique. À partir de la version 2023.10, nous pouvons gérer des scénarios de plusieurs processus de navigateur s’exécutant sous différents profils de navigateur, par exemple lorsqu’une application spécifique doit s’exécuter sur un profil dédié pour isoler les données sensibles des autres applications.

Remarque : l’automatisation de plusieurs profils de navigateur nécessite UiPath.UIAutomation.Activities v23.10 ou une version plus récente, ainsi qu’une extension de navigateur installée avec UiPathStudio.msi v2023.10 ou une version plus récente.

L'ouverture du navigateur avec un profil spécifique est désormais possible lors de l'utilisation de l'activité Utiliser l'application/le navigateur (Use Application/Browser). Pour spécifier un profil au démarrage du navigateur, vous devez ajouter un argument à la ligne de commande du navigateur. Pour ce faire, utilisez la propriété Arguments dans la section d'entrée Cible d'application unifiée (Unified Application Target).

Pour Edge, l'argument requis est : --profile-directory="profile_path".

Le profile_path est le chemin relatif par rapport au chemin du dossier de données utilisateur spécifié pour cette activité Utiliser l'application/le navigateur (Use Application/Browser). Si le chemin du dossier de données utilisateur n'est pas spécifié, le chemin du profil est relatif au répertoire de données utilisateur par défaut %LOCALAPPDATA%\Microsoft\Edge\User Data%. Pour trouver le chemin du profil, accédez à edge://profile-internals/ et récupérez-le à partir de l'entrée Chemin du profil (Profile path).

Résolution des problèmes

Votre administrateur système peut avoir configuré des stratégies de groupe qui empêchent l’extension pour Edge de fonctionner. Pour l’activer, veuillez suivre les instructions de la page Stratégies de groupe.

Pour tout autre problème concernant l'extension UiPath pour Edge, veuillez consulter la page de résolution des problèmes détaillée.