Résolution des problèmes rencontrés avec l’extension Chrome

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. Assurez-vous que l’extension est installée et activée, comme expliqué ici.
3. Si l’extension a été installée correctement mais n’apparaît pas dans Chrome, vérifiez s’il existe des stratégies de groupe (Group Policies) qui affectent l’extension, comme expliqué ici.
   

   Remarque : la sélection de la case à cocher Mode développeur (Developer mode) en haut de la page chrome://extensions/ affiche le bouton Mettre à jour (Update) sur la page Détails (Details) de l'extension.

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 :

• Assurez-vous que l’extension est installée. Pour plus d’informations, consultez les méthodes d’installation présentées sur la page Extension pour Chrome.
• Vérifiez s’il existe des Stratégies de groupe affectant ChromeNativeMessaging.exe. Consultez la section Stratégies de groupe Chrome pour plus d’informations.
• Vérifier si la variable ComSpec est correctement définie.

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.

À 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).

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.

Group Policy conflict

Description

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

Cela peut entraîner un conflit si ExtensionInstallForcelist est également défini au niveau de l'utilisateur ou à l'aide des Stratégies Chrome Cloud.

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

Pour le confirmer, consultez chrome://policy si cet avertissement est affiché sous ListeInstallationsForcéesExtension (ExtensionInstallForcelist) :

This policy is working as intended but a conflicting value is set elsewhere and is overridden by this policy.

Solution

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

1. Installez l’extension UiPath pour Chrome à l’aide de la méthode d’installation NativeHostOnly.

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

   Il n’apporte aucune modification aux stratégies de groupe.

   Pour utiliser cette méthode d'installation, ajoutez CHROME_INSTALL_TYPE=NativeHostOnly à la commande d'installation de UiPathStudio.msi. Exemple : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=NativeHostOnly.
2. Dans la stratégie ListeInstallationsForcéesExtension (ExtensionInstallForcelist), ajoutez la valeur suivante :

   1. Pour la méthode d'installation Stratégie de groupe en ligne (Group Policy Online) (qui installe l'extension Chrome Web Store) :

      kmejkhcmhgilmppjodlgaklnmdmmhhcl;https://clients2.google.com/service/update2/crx

   2. Pour la méthode d'installation Stratégie de groupe en ligne (Group Policy Online) (qui installe l'extension auto-hébergée) :

      ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml

3. Dans la stratégie ListeAutorisationsMessagerieNative, ajoutez la valeur suivante : com.uipath.chromenativemsg_v2.
4. Définissez la stratégie de groupe DisponibilitéOutilsDéveloppement sur la valeur 1 (Autoriser l’utilisation des outils de développement).

   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 Simuler (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.

Cela a été signalé comme un bogue Chromium. Ce problème est assez rare, car très peu d'éléments HTML ont des gestionnaires de clics sous cette forme.

Solution de contournement

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

1. Identifiez l’activité Cliquer (Click) défaillante dans votre workflow et modifiez la méthode d’entrée de Simuler (Simulate) vers n’importe quelle autre méthode d’entrée (API Chromium, Événements matériels, Messages de la fenêtre).
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

Si l'extension UiPath pour Chrome est installée via une stratégie de groupe, DisponibilitéOutilsDéveloppement ( DeveloperToolsAvailability ) doit être défini sur 1 pour activer toutes les fonctionnalités de l'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 DisponibilitéOutilsDéveloppement (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 DisponibilitéOutilsDéveloppement (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.

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

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

Par défaut, l'activité Injecter le script Js ( Inject Js Script ) ne peut plus être utilisée pour accéder aux variables de page, telles que jQuery $, ou pour interagir avec le code de la page (par exemple, window.alert). L’activité Injecter le script Js ( Inject Js Script ) ne rapportera pas d’erreur, mais l’exécution du script échouera et l’erreur suivante sera signalée dans le navigateur 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).

Cette propriété est disponible à partir de UiPath.UIAutomation.Activities v22.12.0-preview.

Votre code JavaScript existant ne nécessite aucune modification, et en utilisant l'option Monde de l’exécution (Execution world) - Page, il fonctionnera pour les extensions MV2 et MV3.

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

Pour les extensions MV3, le navigateur charge l'extension ultérieurement, après le chargement des pages Web. Cela signifie que sur les machines plus lentes, l'activité Open Browser de UiPath.UiAutomation.Activities version 22.10 ou une version antérieure peut atteindre le délai d'expiration interne de 20 secondes avant le démarrage de l'extension.

À partir de la version v22.12.0-preview, le délai d'attente interne pour l'activité Open Browser est passé de 20 à 60 secondes.

Comme vous pouvez avoir besoin de fixer un délai plus long pour le démarrage du navigateur, il est désormais possible de le configurer à partir des activités Use Application/Browser et Open Browser. Les paramètres de projet suivants ont été ajoutés :

• UI Automation Classic → Navigateur (Browser) → Délai d'attente du navigateur ouvert (secondes) (Open browser timeout (seconds))

• UI Automation Modern → Application/Navigateur (Application/Browser) → Délai d'attente du navigateur ouvert (secondes) (Open browser timeout (seconds))

En outre, vous pouvez configurer le délai d'attente via la variable d'environnement UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS . Par exemple, définissez UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 pour utiliser 120 secondes pour le délai d'attente de l'activité.