Solución de problemas de la extensión de Chrome

En esta página se presentan las razones más frecuentes por las que la Extensión de UiPath para Chrome puede no funcionar correctamente y cómo resolver dichas incidencias.

Ten en cuenta que las automatizaciones del navegador con la extensión para Chrome son posibles en una sola ventana de Chrome.

Nota: Debes usar al menos la versión 64 de Google Chrome para realizar automatizaciones de explorador.

Check if the Extension for Chrome is installed and enabled

1. En Google Chrome, ve a chrome://extensions/.
2. Asegúrate de que la extensión esté instalada y habilitada, como se explica aquí.
3. Si la extensión se ha instalado correctamente, pero no aparece en Chrome, comprueba si hay políticas de grupo que afecten a la extensión, tal y como se explica aquí.
   

   Nota: al seleccionar la casilla de verificación Modo desarrollador en la parte superior de la página chrome://extensions/, aparece el botón Actualizar en la página Detalles de la extensión.

Comprobar si se está ejecutando ChromeNativeMessaging.exe

ChromeNativeMessaging.exe habilita la comunicación entre la extensión UiPath para Chrome y el UiPath Studio/Robot.

1. Abre Chrome.
2. Abre el Administrador de tareas.
3. Comprueba si el proceso ChromeNativeMessaging.exe está en funcionamiento.
   
   

   

   
   

4. Si el proceso no se está ejecutando:

   • Asegúrate de que la extensión esté instalada. Para obtener más información sobre la forma de instalarla, consulta la página de documentación.
   • Comprobar si hay políticas de grupo que afecten a ChromeNativeMessaging.exe. Consulta la página de documentación para obtener más información.
   • Comprueba si la variable de entorno ComSpec está definida correctamente.

Si la información anterior no ha resuelto tu problema, puedes intentar obtener información adicional viendo los informes de seguimiento y analizando los errores descritos por la extensión de UiPath.Los que siguen son tipos de trazas que puedes recopilar y analizar: Habilitar trazas.

Habilitar informes de seguimiento

Extensión de informes generales de seguimiento en Google Chrome

1. En Google Chrome, ve a chrome://extensions/.
2. Selecciona la casilla de verificación del Modo de desarrollador en la parte superior de la página web.
3. Ve a la extensión de UiPath y haz clic en la página en segundo plano. Se mostrará así la página Herramientas de desarrollador.
4. Ve a la ficha Consola. Aquí se muestran todos los informes de seguimiento generados por la extensión.
   Nota: los errores están marcados en rojo.

Informes de seguimiento generados por la página web que quieres automatizar

1. En la página web que quieres automatizar, ve a la barra de navegación lateral > Más herramientas > Herramientas de desarrollador (o pulsa Ctrl+Shift+I). Se mostrarán así los informes de seguimiento generados por la extensión de UiPath para la página actual.
   Nota: los errores están marcados en rojo.

Informes de seguimiento completos

1. Abre el Editor del Registro.
2. Navega a la clave HKEY_CURRENT_USER\SOFTWARE\UiPath.
3. Haz doble clic en el valor DWORD de WebExtensionTrace. Se mostrará la ventana Editar valor de DWORD.
4. En el campo Datos de valor, cambia el valor a 1 y haz clic en Aceptar. El valor se ha guardado.
   Nota: Si el valor DWORD de WebExtensionTrace no existe, deberás crearlo haciendo clic derecho en el panel de la derecha, seleccionando Nuevo > Valor de DWORD (32 bits), y proporcionando los valores mencionados anteriormente.

   Si la extensión para Chrome sigue sin funcionar, elimina la extensión de chrome://extensions/ y vuelve a instalarla.

Check if ComSpec variable is defined correctly

Si no hay variable de entorno ComSpec o tiene un valor no válido, entonces Google Chrome no podrá iniciar la ChromeNativeMessaging.exe.

La solución es añadir manualmente el valor correcto para la variable de entorno ComSpec.

Esta variable se establece durante la instalación de Windows y debería mostrar el valor %SystemRoot%\system32\cmd.exe.

Habilitar el acceso a las URL de archivos y el modo de incógnito

De forma predeterminada, la extensión no goza de acceso a las URL de los archivos ni al modo de incógnito. Para habilitar estas funciones:

1. En Google Chrome, ve a chrome://extensions/. Se mostrará la página Extensiones de Chrome.
2. Ir a la extensión UiPath Web Automation y haz clic en el botón Detalles. Se muestra la página de detalles de UiPath Web Automation.
3. Asegúrate de que se seleccionan las opciones Permitir en incógnito y Permitir acceso a las URL del archivo.
   
   

   

   
   

Multiple browser profiles

Varias instancias de Chrome con varios perfiles de usuario

La Extensión de UiPath para Chrome no es compatible con la automatización de varias instancias del navegador que se ejecutan con varios perfiles de usuario al mismo tiempo. Por tanto, la automatización del navegador requiere que cierres todas las instancias activas de Chrome y reinicies el navegador con un único perfil de usuario.

Detener todas las instancias de Chrome

En algunos casos, los procesos en segundo plano de Chrome evitan que se cierre por completo, lo que interfiere con las automatizaciones incluso si la instancia del navegador no es visible.

Es recomendable que cierres Chrome haciendo clic con el botón derecho en el icono de Chrome de la bandeja del sistema y selecciones Salir. De este modo, se garantiza que no haya otros perfiles de usuarios en segundo plano.

Problemas conocidos específicos de las extensiones MV3

La actividad de clic con Simulate falla en elementos específicos de la página web

La actividad Hacer clic con el método de entrada Simulate ya no funciona en elementos HTML que tienen un controlador de clic con URI javascript:.

En este caso, el clic simulado no tendrá efecto y no se informará de ningún error.

Esto fue reportado como un error de Chromium aquí: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 Este problema es bastante extraño ya que muy pocos elementos HTML tienen controladores de clic en este formulario.

Solución

Cambia el método de entrada para la actividad Hacer clic que falla de Simulate a cualquier otro método de entrada:

• API de Chromium
• Eventos de hardware
• Mensajes de ventana

El valor de la política de grupo DeveloperToolsAvailability debe establecerse en 1

DeveloperToolsAvailability tiene los siguientes valores posibles:

• 0 = No permite el uso de las Herramientas de desarrollador en extensiones instaladas por la política de empresa, permitir el uso de las herramientas de desarrollador en otros contextos
• 1 = Permite el uso de las herramientas de desarrollador
• 2 = Deshabilitar el uso de las herramientas de Desarrollador

Si la extensión UiPath para Chrome ha sido instalada utilizando la Política de grupo, entonces DisponibilidadHerramientasDesarrollador debe establecerse como 1 para habilitar la plena funcionalidad de la extensión.

Este valor se establece correctamente de forma automática cuando se instala la extensión, pero se sobrescribirá si tu administrador de sistema ha establecido un valor diferente para esta política.

Los demás valores de DeveloperToolsAvailability causan los problemas que se indican a continuación.

Si DeveloperToolsAvailability se establece en 0 entonces:

• La extensión UiPath para Chrome v22.4 no funcionará en absoluto con esta restricción. Considera actualizar a la v22.10 de la extensión disponible con UiPathStudio.msi 2022.4.4.
• La extensión UiPath para Chrome v22.10 estará restringida a trabajar con las versiones LTS de UIAutomation (19.10.x,20.10.x, 21.10.x, 22.4.x)
• La actividad InjectJS no funcionará.

Si DeveloperToolsAvailability se establece en 2 entonces:

• Se aplican todas las limitaciones de DeveloperToolsAvailability=0
• El método de entrada ChromiumAPI no funcionará.

La ventana del navegador de UiPath Web Automation muestra una advertencia

La ventana del navegador de UiPath Web Automation muestra la siguiente advertencia si no se ha ChromeNativeMessaging.exepodido iniciar:

Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

Vuelve a instalar la extensión desde UiPath Studio.

Ver Comprueba si ChromeNativeMessaging.exe se está ejecutando.

La actividad Abrir navegador tiene tiempo de espera insuficiente

Para las extensiones MV3, el navegador carga la extensión más tarde, después de que se hayan cargado las páginas web. Esto significa que en máquinas más lentas, la actividad Abrir navegador de la versión 20.10 o anterior de UiPath.UiAutomation.Activities puede alcanzar el tiempo de espera interno de 20 segundos antes de que se inicie la extensión.

A partir de la versión 20.10.13, el tiempo de espera interno de la actividad Abrir explorador ha aumentado de 20 a 60 segundos.

Además, puedes configurar el tiempo de espera a través de la variable de entorno UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS . Por ejemplo, configura UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 para usar 120 segundos para el tiempo de espera de la actividad.