Blue Prism Browser Automation Agent para extensiones de Manifest V3

Blue Prism Browser Automation Agent es una aplicación complementaria a Blue Prism Enterprise que se ejecuta mediante una extensión de navegador compatible con Blue Prism Manifest V3 (MV3). Esta aplicación se proporciona como un instalador independiente que:

• Detecta la versión instalada de Blue Prism.
• Elimina las extensiones de Manifest V2 (MV2) seleccionadas instaladas en la máquina.
• Instala la extensión de navegador MV3 adecuada.

La aplicación proporciona la capacidad de insertar e invocar JavaScript en páginas web utilizando una extensión de navegador MV3 de Chrome o Edge; además permite a los clientes que utilizan versiones anteriores de Blue Prism implementar extensiones de navegador MV3 sin necesidad de actualizar su instalación de Blue Prism Enterprise. No se requiere una licencia adicional para implementar Browser Automation Agent.

Blue Prism Browser Automation Agent no es válido para usar con la extensión del navegador Firefox de Blue Prism, ya que utiliza MV2.

Requisitos previos

• Antes de instalar Browser Automation Agent, debe instalar una versión compatible de Blue Prism de 6.4.2 a 7.1.2.

  Si utiliza la versión 2.0 de BAA, la extensión del navegador Edge solo puede instalarse para su uso con las versiones 6.8 y posteriores de Blue Prism mediante el instalador. La extensión del navegador Edge no es compatible con las versiones de Blue Prism anteriores a 6.8.

  Si utiliza la versión 1.0 de BAA, la extensión del navegador Edge solo puede instalarse para su uso con las versiones 6.9 y posteriores de Blue Prism mediante el instalador. Para las versiones 6.8.x de Blue Prism, la extensión de Chrome de Blue Prism debe instalarse manualmente desde la tienda web de Chrome para su uso con versiones de Microsoft Edge basadas en Chromium. Para obtener más información, consulte Avisos de actualización para la versión 6.8 de Blue Prism.

• La instalación de Browser Automation Agent debe eliminar las extensiones instaladas actualmente si se instalaron con el instalador de Blue Prism. Si descargó las extensiones en la tienda web o mediante sideloading, debe eliminarlas manualmente antes de la instalación.

• Las funciones Insertar e Invocar JavaScript requieren que se instale la versión adecuada del controlador web de Chrome o Edge en la máquina donde está instalado Blue Prism. Para obtener más información, consulte Instalar los controladores web.

• Browser Automation Agent y las extensiones de navegador MV3 asociadas requieren la versión 104 o posterior de los navegadores Chrome y Edge. Para obtener más información, consulte la Compatibilidad de extensiones de navegadores.

Instalar Browser Automation Agent con el instalador

Puede instalar Browser Automation Agent con todas las extensiones de navegador MV3 asociadas o con las seleccionadas desde la pantalla Instalación avanzada.

Siga los pasos a continuación para instalar Browser Automation Agent y todas las extensiones de navegador MV3 asociadas:

1. Haga doble clic en el MSI proporcionado y abra el asistente de instalación.

2. Haga clic en Comenzar.

   

   Aparece la pantalla Acuerdo de licencia.

3. Lea el EULA y, si acepta los términos, seleccione la casilla de verificación y haga clic en Siguiente.

   

   Aparece la pantalla Ubicación de instalación.

4. Haga clic en Instalar.

   

5. Haga clic en Sí en la pantalla de aviso de Control de cuentas de usuario (UAC).

   La instalación finalizó y las extensiones del navegador Chrome y Edge están instaladas de forma predeterminada.

6. Haga clic en Aceptar para cerrar el asistente de instalación.

Instalación avanzada

1. Si desea instalar solo una de las extensiones del navegador, en la pantalla Ubicación de instalación, seleccione la opción Instalación avanzada y haga clic en Siguiente.

   

   Aparece la pantalla Instalación avanzada.

2. Borre la selección para la extensión del navegador que no desea instalar y haga clic en Instalar.

   

3. Haga clic en Sí en la pantalla de aviso de Control de cuentas de usuario (UAC).

   Finalizó la instalación.

4. Haga clic en Aceptar para cerrar el asistente de instalación.

Instale Browser Automation Agent desde la línea de comandos

Las siguientes opciones de la línea de comandos se pueden utilizar para instalar Browser Automation Agent y establecer la clave de registro para las extensiones Manifest V3 de Chrome y Edge. El siguiente ejemplo supone que el nombre de MSI es BluePrism.BrowserAutomationAgent.

Comando	Descripción
msiexec /i BluePrism.BrowserAutomationAgent_x64 /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 /qn	Instala Browser Automation Agent y establece la clave de registro de la extensión MV3.
msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=BrowserAutomationAgent /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=BrowserAutomationAgent /qn	Instala Browser Automation Agent sin establecer la clave de registro de la extensión 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	Agrega la clave de registro de extensión MV3 a una instalación existente de Browser Automation Agent.

La propiedad ADDLOCAL también se puede usar para instalar múltiples componentes de Blue Prism al separarlos con una coma. El siguiente comando instala versiones de 64 bits de Blue Prism Automation Agent y las extensiones de Chrome y Edge:

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

Instalar los controladores web

Las funciones Insertar e Invocar JavaScript dependen de que se instale la versión adecuada del controlador web de Chrome o Edge en la máquina donde está instalado Blue Prism. Los controladores web son específicos del navegador y de la versión.

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

Descargue los controladores requeridos como archivos ZIP. Extraiga los ejecutables del controlador web y guárdelos en la carpeta de instalación de Blue Prism Browser Automation Agent (la ubicación predeterminada es C:\Archivos de programa\Blue Prism Limited\Blue Prism Browser Automation Agent) o en una carpeta bajo la variable de entorno PATH.

Iniciar un navegador desde Blue Prism

Requisitos previos

Siga estos pasos antes de iniciar cualquier automatización del navegador:

• En un navegador Edge, vaya a Configuración > Sistema y rendimiento; a continuación, asegúrese de que las siguientes configuraciones estén desactivadas:

  • Refuerzo de arranque
  • Continúe ejecutando extensiones y aplicaciones en segundo plano cuando Microsoft Edge está cerrado

• Después de instalar los controladores web como se describió anteriormente, abra Administrador de tareas y verifique que no se estén ejecutando instancias de navegadores. Si se está ejecutando alguna instancia del navegador, cierre las tareas del navegador antes de intentar cualquier automatización. Esto garantizará un lanzamiento desde cero para la automatización del navegador con la configuración más reciente.

Esto debe llevarse a cabo en todas las máquinas en las que Blue Prism iniciará un navegador.

Habilitar funcionalidad JavaScript

Para habilitar la funcionalidad JavaScript, el navegador debe iniciarse con la depuración remota habilitada. Esto se puede hacer en la página principal de Application Modeller (no en el asistente) agregando el siguiente parámetro al campo URL:

--remote-debugging-port

Un puerto de uso común es 9222, por ejemplo:

--remote-debugging-port=9222

Sin embargo, se puede utilizar cualquier puerto válido que no esté en uso. Browser Automation Agent detecta que el puerto está disponible e iniciará BluePrism.JavaScriptInvoker cuando se inicie el navegador.

Esto debe llevarse a cabo cada vez que inicie un navegador desde Blue Prism.

La funcionalidad para usar las funciones Insertar e Invocar JavaScript no cambió y debe funcionar sin cambios adicionales en la mayoría de los casos. Si utiliza Blue Prism Browser Automation Agent versión 1.0, es posible que algunos procesos deban actualizarse para invocar funciones JavaScript después de una inserción; consulte este aviso de actualización para obtener más detalles.

Para verificar que todo funciona según lo esperado, abra el Administrador de tareas y asegúrese de ver lo siguiente:

• Si inicia el navegador sin un puerto de depuración, debe ver BluePrism.BrowserAutomationAgent.exe.
• Si inicia el navegador con un puerto de depuración habilitado y el controlador web adecuado está instalado correctamente, debe ver BluePrism.BrowserAutomationAgent.exe y BluePrism.JavaScriptInvoker.exe.

Todos los errores se mostrarán en: C:\ProgramData\Blue Prism Limited\Blue Prism\Logs\BluePrism.BrowserAgent.txt. Los errores se pueden ver en NLog si están configurados; de lo contrario, se muestran en el Registro de eventos de Windows.

Desinstalar Browser Automation Agent

Siga los pasos a continuación para desinstalar Browser Automation Agent y todas las extensiones de navegador MV3 asociadas:

1. Cierre todas las ventanas del navegador.
2. Abra Panel de control > Programas y características.
3. Haga clic con el botón derecho en Blue Prism Browser Automation Agent y seleccione Desinstalar en el menú de accesos directos.
4. Haga clic en Sí en el mensaje de confirmación y siga las instrucciones en pantalla.

Si ha instalado manualmente cualquier extensión del navegador desde la tienda web o mediante sideloading, debe eliminarlas manualmente después de desinstalar Browser Automation Agent. Para obtener información sobre cómo eliminar una extensión de forma manual, consulte la guía adecuada para su versión de Blue Prism:

• Blue Prism 7
• Blue Prism 6