Solución de problemas

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:

Deberás utilizar al menos la versión 64 de Google Chrome para llevar a cabo automatizaciones del navegador.

Check if the Extension for Chrome is installed and enabled

1. En Google Chrome, ve a chrome://extensions/.

2. Make sure the extension is installed and enabled, as explained here.

3. If the extension was installed correctly but does not appear in Chrome, check if there are Group Policies that affect the extension, as explained here.

   

   Nota:

   Selecting the Developer mode check box at the top of the chrome://extensions/ page displays the Update button on the extension Details page.

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:

   • Make sure the extension is installed. For more information on how to install it, check the docs page.
   • Check if there are Group Policies affecting ChromeNativeMessaging.exe. See the docs page for more information.
   • Check if the ComSpec environment variable is defined correctly.

If the information above did not solve your issue, you can try getting additional information by viewing traces and analyzing the errors thrown by the UiPath extension. The following are types of traces you can collect and analyze: Enabling Traces.

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 se marcan 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 se marcan 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, tendrás que crearlo haciendo clic con el botón derecho en el panel derecho, seleccionando Nuevo > Valor DWORD (32 bits) y proporcionando los valores mencionados anteriormente.

   If the extension for Chrome is still not working, remove the extension from chrome://extensions/ and reinstall it.

Check if ComSpec variable is defined correctly

Descripción

El proceso ChromeNativeMessaging.exe se ejecuta bajo el usuario actual y se utiliza cmd.exepara iniciar el navegador.

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

Además, el administrador puede deshabilitar la solicitud del sistema para algunos usuarios o configurarla para que se ejecute siempre con privilegios elevados.

Solución

Añade manualmente el valor correcto para la variable de entorno ComSpec. Esta variable se establece en la instalación de Windows y debe establecerse en: %SystemRoot%\system32\cmd.exe.

Otras soluciones

Si la variable de entorno ComSpec se establece correctamente pero el problema persiste, el usuario puede no tener permiso para ejecutar la solicitud del sistema. En este caso, el ChromeNativeMessaging.exeproceso no se puede iniciar con la ejecución cmd.exe bajo el usuario actual.

Starting with Chromium 120.0.6090+, a NativeHostsExecutablesLaunchDirectlyGroup Policy allows admins to turn this on for users in restricted environments (Cloud PCs that forbid cmd.exe, for example).

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. Navigate to the UiPath Web Automation extension and click the Details button. The UiPath Web Automation details page is displayed.

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.

This was reported as a Chromium bug here: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 This issue is quite rare as very few HTML elements have click handlers in this form.

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

La 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

If the UiPath Extension for Chrome is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.

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 enumeran a continuación.

Si DeveloperToolsAvailability se establece como 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 como 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.

See Check If ChromeNativeMessaging.exe Is Running.

La actividad Abrir navegador tiene tiempo de espera insuficiente

For MV3 extensions, the browser loads the extension later, after the web pages have loaded. This means that on slower machines, the Open Browser activity from UiPath.UiAutomation.Activities version 20.10 or older can reach the internal timeout of 20 seconds before the extension has started.

Starting with v20.10.13, the internal timeout for the Open Browser activity has been increased from 20 seconds to 60 seconds.

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.