Résolution des problèmes

Remarque : vous devez utiliser au minimum Firefox version 52.0 pour effectuer les automatisations du navigateur.

Cette rubrique présente les dysfonctionnements les plus courants de l’extension pour Firefox et les solutions possibles.

Extension sur d'anciennes versions de Firefox

Description

Mozilla a introduit un algorithme de vérification de signature d'extension dans Firefox, qui désactive les modules complémentaires pour Firefox version 65.0 et inférieure. Par conséquent, si vous installez l'Extension UiPath pour Firefox sur la version 65.0 ou inférieure du navigateur, le message d'erreur suivant s'affiche :

This add-on could not be installed because it appears to be corrupt.

Solution 1

Mettez à jour Firefox vers la version v66.0.4 ou ultérieures.

Solution 2

À partir de Studio 2020.8, l'extension Firefox est nouvellement signée et doit être correctement installée sur les anciennes versions du navigateur Firefox.

Vérification de l'extension

Vérifiez que l'extension UiPath pour Firefox est bien installée et activée :

1. Dans Mozilla Firefox, rendez-vous dans Modules complémentaires > Extensions.
2. Si l'extension ne s'y trouve pas, procédez à son installation selon les instructions qui se trouvent ici.
3. Vérifiez que la version de l'extension UiPath est à jour.

Quelques précautions à suivre :

1. Dans Mozilla Firefox, rendez-vous dans Modules complémentaires > Extensions.
2. Ouvrez le Gestionnaire des tâches ou l'Explorateur de processus.
3. Vérifiez que le processus ChromeNativeMessaging.exe n'est pas en cours d'exécution.
   Remarque : un autre processus de type ChromeNativeMessaging est exécuté dans le cadre de l'extension Chrome : il faut donc fermer Google Chrome au moment de cette vérification.

Si (If) ChromeNativeMessaging n'est pas en cours d'exécution :

1. Dans Mozilla Firefox, rendez-vous dans Modules complémentaires > Extensions.
2. Supprimez manuellement l'extension UiPath en cliquant sur le bouton Remove (Supprimer).
3. Effectuez sa réinstallation, comme expliqué ici.

Si le problème n'est toujours pas résolu après ces manipulations, utilisez le journal de traçage de l'extension UiPath pour essayer d'obtenir plus d'informations sur les erreurs enregistrées. Vous trouverez ci-dessous des exemple de types de traces qui peuvent être recueillies et analysées.

Pour les traces d'extension générales dans Mozilla Firefox:

Allez à Ouvrez le menu > Développeur Web > Console du navigateur (Ctrl + Shift + J). La console navigateur s'affiche. Toutes les erreurs générées par l'extension sont affichées ici.

Pour obtenir les informations de traçage de la page Web que vous souhaitez automatiser :

Allez à Ouvrir le menu > Développeur Web > Console Web (Ctrl + Shift + K). Le Web Console est affiché. Toutes les erreurs de la page Web actuelle sont affichées ici.

Pour obtenir toutes les informations de traçage (et pas seulement les erreurs), suivez les instructions suivantes :

1. Ouvrez l'Éditeur du Registre.
2. Recherchez la clé suivante : HKEY_CURRENT_USER\SOFTWARE\UiPath.
3. Double-cliquez sur la valeur WebExtensionTrace DWORD. La fenêtre Modifier la valeur DWORD (Edit DWORD Value) s'affiche.
4. Dans le champ Données de la valeur (Value Data) , indiquez une valeur de 1 et cliquez sur OK (OK) pour enregistrer les modifications.
   Remarque : si la valeur WebExtensionTrace REG_DWORD n'existe pas, vous devrez alors la créer : cliquez sur le module de droite avec un clic-droit avec la souris, puis sélectionnez Nouveau > Valeur DWORD (32 bits) (New > DWORD (32-bit) Value) et indiquez les valeurs mentionnées ci-dessus.

Vérifiez si des données manquent dans l'Éditeur du Registre :

1. Ouvrez l'Éditeur du Registre.
2. Recherchez la clé suivante : HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg.
3. Ouvrez la valeur REG_SZ (Default). la fenêtre Modifier la chaîne (Edit String) s'affiche et doit contenir un chemin sur ce modèle : C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json.
4. Ouvrez le fichier .json à partir du répertoire indiqué ci-dessus avec un éditeur de texte de type Notepad++.
5. Vérifiez que la propriété du chemin (path) mène bien au fichier ChromeNativeMessaging.exe et qu'elle ressemble à : C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe

Profils de navigateur multiples

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

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 v23.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 Firefox, l'argument requis est : -profile "full_profile_path". Pour récupérer le chemin d'accès complet au profil, accédez à about:profiles et récupérez le répertoire racine de ce profil.