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.

Check if ChromeNativeMessaging.exe is running

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, check the installation methods described in the Extension for Chrome page.
• Check if there are Group Policies affecting ChromeNativeMessaging.exe. See Group Policies for more information.
• Check if ComSpec variable is defined correctly.

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.

Group Policy conflict

Descripción

Cuando se instala la extensión de UiPath para Chrome con la política de grupo, ExtensionInstallForcelist se actualiza en el nivel de máquina.

Esto puede causar un conflicto si ExtensionInstallForcelist también se define en el nivel de usuario o utilizando políticas cloud de Chrome.

Debido a que el nivel de máquina tiene prioridad, las extensiones establecidas a nivel de usuario/nube se desinstalan.

Para confirmar esto, comprueba en chrome://policy si esta advertencia se muestra bajo ExtensionInstallForcelist:

This policy is working as intended but a conflicting value is set elsewhere and is overridden by this policy.

Solución

Para resolver este conflicto sigue estos pasos:

1. Instala la extensión de UiPath para Chrome utilizando el método de instalación NativeHostOnly.

   Este método de instalación permite la comunicación entre la extensión y Studio/Robot.

   No realiza cambios a las Políticas de Grupo.

   To use this installation method add CHROME_INSTALL_TYPE=NativeHostOnly to the installation command for UiPathStudio.msi. Example: UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=NativeHostOnly.

2. En la política ExtensionInstallForcelist, añade el valor:

   1. Para el método de instalación en línea de la política de grupo (que instala la extensión de Chrome Web Store):

      kmejkhcmhgilmppjodlgaklnmdmmhhcl;https://clients2.google.com/service/update2/crx

   2. For the Group Policy Offlineinstallation method (that installs the self-hosted extension):

      ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml

3. In the NativeMessagingAllowList policy, add the value: com.uipath.chromenativemsg_v2.

Known issues specific to MV3 extensions

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

The Click activity with the Simulate input method no longer works on HTML elements that have a click handler with javascript: URI.

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

Esto se notificó como un error de Chromium. Este problema es bastante extraño, ya que muy pocos elementos HTML tienen controladores de clic en este formulario.

Soluciones

Existen dos soluciones para este problema:

1. Identify the failing Click activity in your workflow and change the input method from Simulate to any other input method (Chromium API, Hardware Events, Window Messages).
2. Actualiza el paquete UiPath.UIAutomation.Activities a la versión 22.12 o más reciente y utiliza Habilitar solución para simular clic con la extensión MV3 en Configuración del proyecto.

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 ChromeNativeMessaging.exe no se ha podido 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 Insertar Script Js ya no se puede usar para acceder a variables de página y código

Por defecto, la actividad Insertar Script JS ya no se puede usar para acceder a variables de página, como jQuery $, o para interactuar con el código de página (p. ej., window.alert). La actividad Insertar Script Js no informará de ningún error, pero el script no se ejecutará y se informará del siguiente error en DevTools del explorador (F12): Refused to execute inline script because it violates the following Content Security Policy directive.

Se trata de una limitación introducida por la plataforma MV3.

Para solucionar este problema, selecciona la opción Ejecutar mundo - página de la actividad Inyectar Script Js.

Esta propiedad está disponible a partir de UiPath.UIAutomation.Activities v22.12.0-preview

Your existing JavaScript code doesn't require any changes, and by using the Execution world - Page option it will work for both MV2 and MV3 extensions.

La actividad Abrir navegador tiene tiempo de espera insuficiente

En el caso de las extensiones de 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 desde UiPath.UiAutomation.Activities versión 22.10 o anterior puede alcanzar el tiempo de espera interno de 20 segundos antes de que se haya iniciado la extensión.

A partir de la versión 22.12.0-preview, el tiempo de espera interno de la actividad Abrir navegador ha aumentado de 20 segundos a 60 segundos.

Como es posible que necesites establecer un tiempo de espera más largo para el inicio del navegador, ahora se puede configurar desde las actividades Usar aplicación/navegador y Abrir navegador. Se han añadido los siguientes ajustes al proyecto:

• UI Automation clásico → Navegador → Tiempo de espera (segundos) de apertura del navegador
• UI Automation Modern→ Application/Browser → Open browser timeout (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.