Blue Prism Browser Automation Agent pour les extensions Manifest V3

Blue Prism Browser Automation Agent est une application complémentaire à Blue Prism Enterprise, qui est lancée par une extension de navigateur compatible Blue Prism Manifest V3 (MV3). Cette application est fournie sous la forme d'un assistant d'installation distinct qui :

• détecte la version de Blue Prism qui est installée ;
• supprime les extensions Manifest V2 (MV2) sélectionnées installées sur la machine. ;
• installe l'extension de navigateur MV3 appropriée.

L'application offre des options d'appel et d'insertion JavaScript sur des pages Web à l'aide d'une extension de navigateur Chrome ou Edge MV3. De plus, elle permet aux clients utilisant des anciennes versions de Blue Prism de déployer des extensions de navigateur MV3 sans mettre à niveau leur installation Blue Prism Enterprise. Aucune licence supplémentaire n'est requise pour déployer Browser Automation Agent.

Blue Prism Browser Automation Agent n'est pas compatible avec l'extension de navigateur Firefox Blue Prism, car il utilise MV2.

Prérequis

• Avant d'installer Browser Automation Agent, vous devez installer une version compatible de Blue Prism de 6.4.2 à 7.1.2.

  Si vous utilisez la version 2.0 de BAA, l'extension de navigateur Edge ne peut être installée que pour Blue Prism 6.8 et des versions ultérieures à l'aide de l'assistant d'installation. L'extension de navigateur Edge n'est pas prise en charge dans les versions de Blue Prism antérieures à 6.8.

  Si vous utilisez la version 1.0 de BAA, l'extension de navigateur Edge ne peut être installée que pour Blue Prism 6.9 et des versions ultérieures à l'aide de l'assistant d'installation. Pour les versions 6.8.x de Blue Prism, l'extension Blue Prism Chrome doit être installée manuellement à partir de la boutique en ligne Chrome pour être utilisée avec les versions de Microsoft Edge basées sur Chromium. Voir Avis de mise à niveau pour la version 6.8 de Blue Prism pour en savoir plus.

• L'installation de Browser Automation Agent doit supprimer vos extensions actuelles si elles ont été installées à l'aide de l'assistant d'installation de Blue Prism. Si vous avez téléchargé les extensions depuis la boutique en ligne ou via un chargement latéral, vous devez les supprimer manuellement avant l'installation.

• Les fonctions d'insertion et d'appel JavaScript nécessitent l'installation de la version appropriée du pilote Web Chrome ou Edge sur la machine sur laquelle Blue Prism est installé. Voir Installer les pilotes Web pour en savoir plus.

• Browser Automation Agent et les extensions de navigateur MV3 associées nécessitent la version 104 ou ultérieure des navigateurs Chrome et Edge. Pour en savoir plus, veuillez consulter la compatibilité des extensions de navigateur.

Installer Browser Automation Agent à l'aide de l'assistant d'installation

Vous pouvez installer Browser Automation Agent avec toutes les extensions de navigateur MV3 associées, ou avec celles sélectionnées sur l'écran Installation avancée.

Suivez les étapes ci-dessous pour installer Browser Automation Agent et toutes les extensions de navigateur MV3 associées :

1. Double-cliquez sur le MSI fourni et ouvrez l'assistant d'installation.

2. Cliquez sur Démarrer.

   

   L'écran Contrat de licence s'affiche.

3. Lisez le contrat de licence de l'utilisateur final et, si vous acceptez les conditions, cochez la case et cliquez sur Suivant.

   

   L'écran Emplacement d'installation s'affiche.

4. Cliquez sur Installer.

   

5. Cliquez sur Oui sur l'écran d'invite Contrôle de compte utilisateur (CCU).

   L'installation est terminée et les extensions de navigateur Chrome et Edge sont installées par défaut.

6. Cliquez sur OK pour fermer l'assistant d'installation.

Installation avancée

1. Si vous souhaitez installer l'une des extensions de navigateur, choisissez l'option Installation avancée et cliquez sur Suivant sur l'écran Emplacement d'installation.

   

   L'écran Installation avancée s'affiche.

2. Effacez la sélection de l'extension de navigateur que vous ne souhaitez pas installer, puis cliquez sur Installer.

   

3. Cliquez sur Oui sur l'écran d'invite Contrôle de compte utilisateur (CCU).

   L'installation est terminée.

4. Cliquez sur OK pour fermer l'assistant d'installation.

Installer Browser Automation Agent à partir de la ligne de commande

Les options de ligne de commande suivantes peuvent être utilisées pour installer Browser Automation Agent et définir la clé de registre pour les extensions Chrome et Edge Manifest V3. L'exemple ci-dessous suppose que le nom MSI est BluePrism.BrowserAutomationAgent.

Commande	Description
msiexec /i BluePrism.BrowserAutomationAgent_x64 /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 /qn	Installe Browser Automation Agent et définit la clé de registre de l'extension MV3.
msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=BrowserAutomationAgent /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=BrowserAutomationAgent /qn	Installe Browser Automation Agent sans définir la clé de registre de l'extension MV3.
msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=ChromePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=ChromePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=EdgePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=EdgePlugin /qn	Ajoute la clé de registre de l'extension MV3 à une installation existante de Browser Automation Agent.

La propriété ADDLOCAL peut aussi être utilisée pour installer plusieurs composants Blue Prism en les séparant par une virgule. La commande suivante installe les versions 64 bits de Blue Prism Automation Agent, ainsi que les extensions Chrome et Edge :

msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=BrowserAutomationAgent,ChromePlugin,EdgePlugin /qn

Installer les pilotes Web

Les fonctions d'insertion et d'appel JavaScript nécessitent l'installation de la version appropriée du pilote Web Chrome ou Edge sur la machine sur laquelle Blue Prism est installé. Les pilotes Web sont spécifiques au navigateur et à la version.

• Chrome : https://chromedriver.chromium.org/downloads
• Edge : https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/

Téléchargez les pilotes requis au format ZIP. Extrayez les exécutables du pilote Web et enregistrez-les dans le dossier d'installation de Blue Prism Browser Automation Agent (l'emplacement par défaut étant C:\Program Files\Blue Prism Limited\Blue Prism Browser Automation Agent) ou dans un dossier sous votre variable d'environnement PATH.

Lancer un navigateur à partir de Blue Prism

Prérequis

Effectuez les opérations suivantes avant de démarrer toute automatisation de navigateur :

• Dans un navigateur Edge, allez dans Réglages > Système et performances et assurez-vous que les réglages suivants sont désactivés :

  • Démarrage rapide
  • Continuer à exécuter des extensions et des applications en arrière-plan lorsque Microsoft Edge est fermé

• Après avoir installé les pilotes Web comme décrit ci-dessus, ouvrez le Gestionnaire des tâches et vérifiez qu'aucune instance de navigateur n'est en cours d'exécution. Si une instance de navigateur est en cours d'exécution, terminez les tâches du navigateur avant de tenter une automatisation. Cela garantit un nouveau lancement pour l'automatisation du navigateur, avec les derniers réglages en date.

Cette action doit être effectuée sur toutes les machines sur lesquelles Blue Prism lancera un navigateur.

Activer la fonctionnalité JavaScript

Pour activer la fonctionnalité JavaScript, le navigateur doit être lancé avec le débogage à distance activé. Vous pouvez le faire sur la page principale du modélisateur d'application (et non dans l'assistant) en ajoutant le paramètre suivant au champ URL :

--remote-debugging-port

9222 est un port fréquemment utilisé. Exemple :

--remote-debugging-port=9222

Néanmoins, vous pouvez renseigner n'importe quel port valide et inutilisé. Browser Automation Agent détecte que le port est disponible et lance BluePrism.JavaScriptInvoker au démarrage du navigateur.

Cette opération doit être effectuée à chaque fois que vous lancez un navigateur depuis Blue Prism.

La fonctionnalité d'utilisation des fonctions d'insertion et d'appel JavaScript n'a pas changé et devrait fonctionner sans autre modification dans la majorité des cas. Si vous utilisez Blue Prism Browser Automation Agent 1.0, il peut être nécessaire de mettre à jour certains processus pour appeler les fonctions JavaScript après une insertion. Consultez cet avis de mise à niveau pour en savoir plus.

Pour vérifier que tout fonctionne comme prévu, ouvrez le Gestionnaire des tâches et assurez-vous que vous voyez ce qui suit :

• Si vous lancez le navigateur sans port de débogage, vous devriez voir BluePrism.BrowserAutomationAgent.exe.
• Si vous lancez le navigateur avec un port de débogage activé et que le bon pilote Web est installé, vous devriez voir BluePrism.BrowserAutomationAgent.exe et BluePrism.JavaScriptInvoker.exe.

Toutes les erreurs s'afficheront ici : C:\ProgramData\Blue Prism Limited\Blue Prism\Logs\BluePrism.BrowserAgent.txt. Les erreurs peuvent être visualisées dans NLog s'il est configuré. Sinon, elles s'affichent dans le journal des événements Windows.

Désinstaller Browser Automation Agent

Suivez les étapes ci-dessous pour désinstaller Browser Automation Agent et toutes les extensions de navigateur MV3 associées :

1. Fermez toutes les fenêtres du navigateur.
2. Allez dans Panneau de configuration > Programmes et fonctionnalités.
3. Cliquez avec le bouton droit sur Blue Prism Browser Automation Agent et sélectionnez Désinstaller dans le menu contextuel.
4. Cliquez sur Oui dans le message de confirmation et suivez les instructions à l'écran.

Si vous avez installé manuellement une extension de navigateur depuis la boutique en ligne ou via un chargement latéral, vous devez la supprimer vous-même après avoir désinstallé Browser Automation Agent. Pour plus de détails sur la suppression manuelle d'une extension, consultez le guide approprié pour votre version de Blue Prism :

• Blue Prism 7
• Blue Prism 6