Résolution des problèmes

Cette page présente les dysfonctionnements les plus courants de l’extension pour Edge et leurs solutions possibles.

Consultez les pages suivantes :

• Impossible de communiquer avec le navigateur
• L’extension Edge est automatiquement supprimée
• L'extension a peut-être été corrompue
• Vérification si l'extension pour Microsoft Edge est installée et activée
• Vérifiez si ChromeNativeMessaging.exe est en cours d’exécution
• Vérifier si la variable ComSpec est correctement définie
• Activation de l'accès aux URL de fichiers et au mode navigation privée
• Profils de navigateur multiples
• Stratégie de groupe en conflit
• Problèmes connus spécifiques aux extensions MV3

Vérification si l'extension pour Microsoft Edge est installée et activée

1. Dans Microsoft Edge, accédez à edge://extensions/.
2. Make sure the extension is installed and enabled, as explained here.
3. If the extension was installed correctly but does not appear in Microsoft Edge, check if there are Group Policies that affect the extension, as explained here.

Vérifiez si ChromeNativeMessaging.exe est en cours d’exécution

L'élément ChromeNativeMessaging.exe permet la communication entre l'extension UiPath pour Edge et UiPath Studio/Robot.

1. Ouvrez Microsoft Edge.

2. Ouvrir le Gestionnaire des tâches.

3. Vérifiez que le processus ChromeNativeMessaging.exe n'est pas en cours d'exécution.

   

4. Si le processus n’est pas en cours d’exécution :

   • Make sure the extension is installed. For more information on how to install it, check the docs page.
   • Check if there are Group Policies affecting ChromeNativeMessaging.exe. See the docs page for more information.
   • Check if the ComSpec environment variable is defined correctly.

Vérifier si la variable ComSpec est correctement définie

Description

Le processus ChromeNativeMessaging.exe s’exécute sous l’utilisateur actuel et utilise cmd.exe pour démarrer le navigateur.

Si la variable d'environnement ComSpec est manquante ou a une valeur non valide, Microsoft Edge ne peut pas lancer ChromeNativeMessaging.exe.

En outre, l’administrateur peut désactiver l’invite de commande pour certains utilisateurs, ou la configurer de sorte qu’elle doive toujours être exécutée avec des privilèges élevés.

Solution

Ajoutez manuellement la valeur correcte pour la variable d’environnement ComSpec. Cette variable est définie lors de l’installation de Windows et doit être définie sur : %SystemRoot%\system32\cmd.exe.

Autres solutions de contournement

Si la variable d’environnement ComSpec est correctement définie mais que le problème persiste, il se peut que l’utilisateur ne soit pas autorisé à exécuter l’invite de commande. Dans ce cas, le processus ChromeNativeMessaging.exe ne peut pas être démarré lorsque la commande cmd.exe est exécutée sous l’utilisateur actuel.

À partir de Chromium 120.0.6090+, une stratégie de groupe NativeHostsExecutablesLaunchDirectly permet aux administrateurs d’activer cette option pour les utilisateurs dans des environnements restreints (PC Cloud qui interdisent cmd.exe, par exemple).

Activation de l'accès aux URL de fichiers et au mode navigation privée

Par défaut, l'extension n'a pas accès aux URL de fichiers ou au mode navigation privée. Pour les activer :

1. Dans Microsoft Edge, accédez à edge://extensions/. La page Extensions Microsoft Edge (Microsoft Edge Extensions) s'affiche.

2. Accédez à l'extension Automatisation du navigateur UiPath (UiPath Browser Automation) et cliquez sur le bouton Détails (Details).

3. Vérifier que les options Autoriser en mode navigation privée (Allow in InPrivate) et Autoriser l'accès aux URL de fichier (Allow access to file URLs) sont sélectionnées.

   

Profils de navigateur multiples

Instances Microsoft Edge multiples avec plusieurs profils d'utilisateurs

L'extension UiPath pour Microsoft Edge ne prend pas en charge l'automatisation de plusieurs instances de navigateur s'exécutant avec plusieurs profils d'utilisateur en même temps. Par conséquent, l'automatisation du navigateur vous oblige à fermer toutes les instances actives de Microsoft Edge et à redémarrer le navigateur à l'aide d'un seul profil d'utilisateur.

Arrêt de toutes les instances Microsoft Edge

Dans certains cas, les processus en arrière-plan dans Microsoft Edge empêchent celui-ci de se fermer complètement, ce qui interfère avec les automatisations, même si l'instance du navigateur n'est pas visible.

Nous vous recommandons de fermer Microsoft Edge en cliquant avec le bouton droit sur l'icône Microsoft Edge dans la barre d'état système et en sélectionnant Fermer Microsoft Edge (Close Microsoft Edge). Cela garantit qu'aucun autre profil d'utilisateur ne reste utilisé en arrière-plan.

Stratégie de groupe en conflit

Lors de l'installation de l'extension UiPath pour Edge à l'aide de la stratégie de groupe, ExtensionInstallForcelist est mis à jour au niveau de la machine.

Cela peut provoquer un conflit si ExtensionInstallForcelist est également défini au niveau de l'utilisateur.

Le niveau de la machine étant prioritaire, les extensions définies au niveau de l'utilisateur/du cloud seront désinstallées.

Pour confirmer cela, vérifiez au niveau de edge://policy si ce Warning s'affiche sous ExtensionInstallForcelist :

More than one source with conflicting values is present for this policy!

Pour résoudre ce conflit, procédez comme suit :

1. Install the UiPath extension for Edge using theNativeHostOnly installation method.

L'hôte natif permet la communication entre l'extension et UiPath Studio/Robot.

Il n'apportera aucune modification aux stratégies de groupe.

To use this installation method add EDGE_INSTALL_TYPE=NativeHostOnly to the installation command for UiPathStudio.msi.

Exemple :

UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,EdgeExtension EDGE_INSTALL_TYPE=NativeHostOnly

2. In the ExtensionInstallForcelist policy, add the value:

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

3. In the NativeMessagingAllowlist policy, add the value:

com.uipath.chromenativemsg_v2

4. Set DeveloperToolsAvailability Group Policy to the value1 (Allow usage of the Developer Tools).

Ce paramètre est requis pour activer la fonctionnalité d'extension complète.

Problèmes connus spécifiques aux extensions MV3

L’activité Clic (Click) avec Simuler (Simulate) échoue sur des éléments de page Web spécifiques

L'activité Clic (Click) avec la méthode d'entrée Simulate ne fonctionne plus sur les éléments HTML qui ont un gestionnaire de clics avec l'URI javascript:.

Dans ce cas, le clic simulé ne prendra pas effet et aucune erreur ne sera signalée.

This was reported as a Chromium bug here: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 This issue is quite rare as very few HTML elements have click handlers in this form.

Solution de contournement

Deux solutions de contournement sont disponibles pour ce problème :

1. Identify the failing Click activity in your workflow and change the input method from Simulate to any other input method (Chromium API, Hardware Events, Window Messages).
2. Mettez à niveau vers le package UiPath.UIAutomation.Activities v22.12 ou une version plus récente et utilisez l’option Activer la solution de contournement pour simuler un clic avec l’extension MV3 dans Paramètres du projet (Project Settings).

La valeur de la stratégie de groupe DisponibilitéOutilsDéveloppement (DeveloperToolsAvailability) doit être définie sur 1.

DisponibilitéOutilsDéveloppement (DeveloperToolsAvailability) a les valeurs possibles suivantes :

• 0 = utilisation des outils de développement interdite sur les extensions installées par la stratégie d'entreprise, utilisation des outils de développement autorisée dans d'autres contextes
• 1 = utilisation des outils de développement autorisée
• 2 = utilisation des outils de développement interdite

If the UiPath Extension for Edge is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.

Cette valeur est automatiquement définie correctement lorsque l'extension est installée, mais sera écrasée si votre administrateur système a défini une autre valeur pour cette stratégie.

Les autres valeurs de DisponibilitéOutilsDéveloppement (DeveloperToolsAvailability) provoquent les problèmes répertoriés ci-dessous.

Si DeveloperToolsAvailability est défini sur 0, alors :

• L'extension UiPath pour Edge se limitera aux versions LTS d'UiAutomation (19.10.x, 20.10.x, 21.10.x, 22.4.x)
• L'activité InjectJS ne fonctionnera pas.

Si DeveloperToolsAvailability est défini sur 2, alors :

• Toutes les limitations de DeveloperToolsAvailability=0 s'appliquent
• La méthode d'entrée ChromiumAPI ne fonctionnera pas.

La fenêtre du navigateur Automatisation Web UiPath (UiPath Web Automation) affiche un avertissement

La fenêtre du navigateur d'automatisation Web UiPath (UiPath Web Automation) affiche l'avertissement suivant si ChromeNativeMessaging.exe n'a pas pu être démarré :

Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

Réinstallez l'extension à partir d'UiPath Studio.

See Check if ChromeNativeMessaging.exe is running.

L'activité Injecter JavaScript (Inject JS Script) ne peut plus être utilisée pour accéder aux variables de page et au code

By default, the Inject Js Script activity can no longer be used to access page variables, such as jQuery $ , or to interact with page code (e.g., window.alert). The Inject Js Script activity won't report an error, but the script will fail to execute and the following error will be reported in the browser DevTools (F12): Refused to execute inline script because it violates the following Content Security Policy directive.

Il s'agit d'une limitation introduite par la plate-forme MV3.

Pour résoudre ce problème, sélectionnez l'option Monde de l’exécution (Execution world) - Page dans l'activité Injecter JavaScript (Inject JS Script).

Your existing JavaScript code doesn't require any changes, and by using the Execution world - Page option it will work for both MV2 and MV3 extensions.

L'activité Open Browser a un délai d'expiration insuffisant

For MV3 extensions, the browser loads the extension later, after the web pages have loaded. This means that on slower machines, the Open Browser activity can reach the internal timeout of 60 seconds before the extension has started.

Starting with UiPath.UiAutomation.Activities v22.10.6, the internal timeout for the Open Browser activity can be configured through the UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS environment variable. For example, set UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 to use 120 seconds for the activity's timeout.