Résolution des problèmes

Cette page présente les dysfonctionnements les plus courants de l'extension UiPath pour Chrome et leurs solutions possibles.

Notez que les automatisations de navigateur ayant l'extension pour Chrome sont actuellement possibles dans une fenêtre Chrome unique.

Remarque :

Vous devez utiliser au minimum Google Chrome version 64 pour effectuer les automatisations de navigateur.

Vérification de l'installation et de l'activation de l'extension pour Chrome

1. Dans Google Chrome, rendez-vous sur chrome://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 Chrome, check if there are Group Policies that affect the extension, as explained here.

   

   Remarque :

   Selecting the Developer mode check box at the top of the chrome://extensions/ page displays the Update button on the extension Details page.

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

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

1. Ouvrez Chrome.

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, check the installation methods described in the Extension for Chrome page.
• Check if there are Group Policies affecting ChromeNativeMessaging.exe. See Group Policies for more information.
• Check if ComSpec 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, Google Chrome 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.

Starting with Chromium 120.0.6090+, a NativeHostsExecutablesLaunchDirectlyGroup Policy allows admins to turn this on for users in restricted environments (Cloud PCs that forbid cmd.exe, for example).

Activez 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 activer ceux-ci :

1. Dans Google Chrome, rendez-vous sur chrome://extensions/. La page Extensions Chrome s’affiche.

2. Accédez à l'extension Automatisation Web UiPath (UiPath Web Automation) et cliquez sur le bouton Détails (Details). La page de détails Automatisation Web UiPath (UiPath Web Automation) s'affiche.

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

   

Profils de navigateur multiples

Instances Chrome multiples avec plusieurs profils d’utilisateurs

L'extension UiPath pour Chrome ne prend pas en charge l’automatisation simultanée de plusieurs instances de navigateur en cours d’exécution avec plusieurs profils d’utilisateurs. Ainsi, l’automatisation du navigateur vous oblige à fermer toutes les instances actives de Chrome et à redémarrer le navigateur à l’aide d’un seul profil d’utilisateur.

Arrêt de toutes les instances Chrome

Dans certains cas, les processus en arrière-plan dans Chrome 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 Chrome en faisant un clic droit sur l’icône Chrome dans la barre d'état, et en sélectionnant Quitter (Exit). Cela garantit qu’aucun autre profil d’utilisateur ne continue à être utilisé en arrière-plan.

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

Remplacez la méthode d’entrée de l'activité Clic (Click) Simulate en échec par une autre méthode d'entrée :

• API Chromium
• Événements matériels
• Messages de la fenêtre

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 Chrome 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 Chrome v22.4 ne fonctionnera pas du tout avec cette restriction. Veuillez envisager de mettre à niveau vers la v22.10 de l'extension disponible avec UiPathStudio.msi 2022.4.4.
• L'extension UiPath pour Chrome v22.10 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é 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 from UiPath.UiAutomation.Activities version 20.10 or older can reach the internal timeout of 20 seconds before the extension has started.

Starting with v21.10.8, you can configure the timeout 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, instead of the default value of 60 seconds.