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.

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:

• Asegúrate de que la extensión esté instalada. Para obtener más información, consulta los métodos de instalación descritos en la página Extensión para Chrome.
• Comprobar si hay políticas de grupo que afecten a ChromeNativeMessaging.exe. Consulta Políticas de grupo de Chrome para obtener más información.
• Comprueba si la variable ComSpec está definida correctamente.

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 NativeHostsExecutablesLaunchDirectly Group 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. 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.

Group Policy conflict

Descripción

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

Esto puede causar un conflicto si el ExtensionInstallForcelist se definetambién a nivel usuario o utiliza políticas de Chrome Cloud.

Porque el nivel de máquina tiene prioridad, las extensiones establecidas en el nivel de usuario / nube se desinstalarán.

Para confirmar esto, comprueba en chrome://policysi esta advertencia aparece debajo de 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 habilita comunicación entre la extensión y UiPath Studio/Robot.

   No realiza cambios a las Políticas de Grupo.

   Para usar este método de instalación añade CHROME_INSTALL_TYPE=NativeHostOnlyal comando de instalación para UiPathStudio.msi. Ejemplo: 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. Para el método de instalación sin conexión de la política de grupo (que instala la extensión autoalojada):

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

3. En la política NativeMessagingAllowList, añade el valor: com.uipath.chromenativemsg_v2.
4. Establece la política de grupo DeveloperToolsAvailability en el valor 1 (Permitir el uso de las herramientas de desarrollo).

   Se requiere esta configuración para habilitar la funcionalidad de la extensión completa. Para obtener más información sobre esta configuración, consulta la sección de resolución de problemas.

Known issues specific to MV3 extensions

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 Simular ya no funciona en elementos HTML que tengan 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 se informó como un error de ChromiumEste 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. Identifica la actividad de Click que falla en tu flujo de trabajo y cambia el método de entrada desde Simular para cualquier otro método de entrada (API de Chromium, Eventos de Hardware y Mensajes de ventana).
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

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 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.

Ver Comprueba si ChromeNativeMessaging.exe se está ejecutando.

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 el explorador DevTools (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

Tu código JavaScript existente no requiere ningún cambio, y mediante la opción Ejecución del mundo - página, funcionará para las extensiones MV2 y MV3.

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 Classic → Navegador → Tiempo de espera de apertura del navegador (segundos)

• UI Automation Modern → Aplicación/navegador → Tiempo de espera de apertura del navegador (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.