Acerca del tiempo de ejecución remoto de UiPath

UiPath Remote Runtime es un componente que facilita la comunicación entre una aplicación o escritorio remoto, como Citrix Virtual Apps, y la extensión de UiPath dedicada: la Extensión de UiPath para Citrix, la Extensión de UiPath para Windows Remote Desktop o la Extensión de UiPath para VMware Horizon. Recopila información sobre los elementos de la IU específicos de aplicaciones remotas y la envía a la extensión correspondiente para que los selectores se generen de forma nativa en UIExplorer.

Nota:

A partir de Citrix Virtual Apps and Desktops 7 2109 todos los canales virtuales personalizados están bloqueados por defecto. Esto impide que UiPath Remote Runtime funcione correctamente.

Para solucionar este problema, el canal virtual UiPath debe añadirse a la política de la lista de permitidos:

UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

El componente Remote Runtime obtuvo una certificación Citrix Ready, lo que lo convierte en una solución eficaz y de confianza para trabajar con tecnologías Citrix.

En función del tipo de entorno en el que desees crear tus proyectos de automatización, el componente UiPath Remote Runtime se puede instalar del siguiente modo:

• En servidores Citrix Application: se comunica con la Extensión de UiPath para Citrix.
• En máquinas virtuales de VMware Horizon: se comunica con la extensión de UiPath para VMware Horizon.
• En máquinas Windows Remote Desktop: se comunica con la Extensión de UiPath para Remote Desktop.

Ten en cuenta que las extensiones de UiPath correspondientes deben estar instaladas en la máquina cliente.

El instalador UiPathRemoteRuntime.msi se incluye en UiPathPlatformInstaller.exe, o puedes obtenerlo contactando con nuestro Equipo de soporte. Ten en cuenta que UiPathPlatformInstaller.exe no admite argumentos de línea de comandos.

Una vez instalado el componente UiPath Remote Runtime, este registra una tarea en el Programador de tareas para que el proceso UiPathRemoteRuntime.exe comience cada vez que el usuario inicie sesión.

El componente UiPath Remote Runtime debe establecer la conexión entre una aplicación o servidor de sobremesa y una extensión de UiPath correspondiente instalada en una máquina cliente. De esta forma, los selectores se generan de forma nativa en la máquina cliente en la que está instalado Studio, sin necesidad de realizar actividades de reconocimiento de imágenes u OCR.

Programador de tareas

De forma predeterminada, el componente UiPath Remote Runtime crea una entrada en el Programador de tareas de Windows para iniciarse automáticamente cada vez que el usuario correspondiente inicia sesión. Esta función está representada por la opción Crear iniciar tarea UiPathRemoteRuntime en el instalador UiPathRemoteRuntime.msi que puedes deshabilitar si es necesario.

La entrada del Programador de tareas de UiPath Remote Runtime se puede añadir o eliminar a través del instalador o del Símbolo del sistema como puedes ver en las siguientes secciones.

Instalación del tiempo de ejecución a distancia de UiPath

Desde el instalador

1. Ejecuta el archivo UiPathRemoteRuntime.msi para instalar el componente UiPath Remote Runtime. Debes instalarlo en todos los servidores Citrix Application o máquinas Windows Remote Desktop en los que quieras crear tus proyectos de automatización.
2. Cierra sesión en la ventana de Citrix o sesión RDP actual en la máquina cliente y vuelve a iniciar sesión. Esto es necesario para que los cambios se apliquen.
3. Instala la Extensión de UiPath para Citrix o la Extensión de UiPath para Windows Remote Desktop en la máquina cliente, en función de la tecnología en la que desees crear tus proyectos de automatización.

También puedes instalar la extensión para Java, Chrome y Citrix desde el instalador y la entrada del Programador de tareas seleccionando las opciones correspondientes tal y como se indica a continuación:

La entrada del Programador de tareas para Remote Runtime se puede añadir o eliminar en cualquier momento. Solo tienes que ejecutar el instalador UiPathRemoteRuntime.msi y elegir la opción correspondiente.

Desde el símbolo del sistema

Nota: la instalación de UiPathRemoteRuntime.msi requiere derechos de administrador.

1. Haz clic en el botón de Inicio de Windows y escribe cmd en el campo de búsqueda.
2. Haz clic con el botón derecho en Símbolo del Sistema y ejecútalo como administrador.
3. Cambia el directorio a la carpeta UiPathRemoteRuntime.msi (por ejemplo: cd C:\Tools\Studio).
4. Utiliza el comando UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask para instalar el componente UiPath Remote Runtime.
5. Cierra sesión en la ventana de Citrix o sesión RDP actual en la máquina cliente y vuelve a iniciar sesión. Esto es necesario para que los cambios se apliquen.
6. Instala la Extensión de UiPath para Citrix o la Extensión de UiPath para Windows Remote Desktop en la máquina cliente, en función de la tecnología en la que desees crear tus proyectos de automatización.

Además, puedes usar los argumentos RemoteRuntimeTask; JavaBridge; ChromeExtension; EdgeChromium; CitrixClient; para instalar la extensión para la entrada de Programador de tareas, extensiones de Java, Chrome, Microsoft Edge o Citrix como los siguientes ejemplos:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient: instala el componente Remote Runtime, la entrada Task Scheduler, la extensión para Java, la extensión para Chrome, la extensión para Microsoft Edge, y la extensión para Citrix.

También puedes realizar una instalación silenciosa utilizando el parámetro /quiet:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet: instala silenciosamente el compoennte Remote Runtime y la entrada Task Scheduler.

Ahora puedes crear procesos para automatizar en Citrix Virtual Apps y Desktops, así como a través de conexiones RDP, tal y como harías en una máquina estándar. Gracias a las extensiones correspondientes, las actividades OCR y Reconocimiento de imágenes ya no son necesarias para identificar correctamente los elementos de la IU. En su lugar, los elementos se reconocen de forma nativa y se pueden usar con cualquier actividad.

Arquitectura de Remote Runtime

Cuando inicias un proceso, el Robot envía los comandos necesarios a la extensión para Citrix o Windows Remote Desktop a través de un canal RPC. Este paquete de información también contiene detalles sobre la versión del paquete UIAutomation utilizado para crear el proceso.

Seguidamente, la extensión correspondiente reenvía el paquete de información a través de un canal virtual ICA al componente UiPath Remote Runtime, que está en los servidores Citrix Application o en la máquina Remote Desktop.

En función de la versión del paquete UIAutomation con el que se creara el proceso, el componente UiPath Remote Runtime indica al ejecutor del Robot qué controlador debe usar.

Múltiples canales ICA

La comunicación entre el componente UiPath Remote y la extensión correspondiente se realiza a través de un canal ICA de desarrollo interno. Se pueden usar muchos canales ICA, pero el Citrix Receiver, por ejemplo, ya utiliza diversos canales para el portapapeles, el sonido, etc.

Consideraciones sobre la transferencia de datos y el ancho de banda

Una vez instalado el componente Remote Runtime, puedes crear tus proyectos de automatización sin necesidades de crear reglas de firewall.

La transferencia de datos entre el componente Remote Runtime y la extensión requiere poco uso de ancho de banda. Por ejemplo, cada acción realizada por el Robot (como una actividad Hacer clic) transfiere alrededor de 3 KB de datos.

Dependencias del controlador

El componente Tiempo de ejecución remoto de UiPath y la dependencia del controlador UiPath para el paquete UiPath.UIAutomation.Activities deben tener la misma versión. No obstante, cuando el Tiempo de ejecución remoto de UiPath se actualiza para que coincida con una nueva dependencia del controlador UiPath para el paquete UiPath.UIAutomation.Activities, el Tiempo de ejecución remoto de UiPath conserva la retrocompatibilidad con todas las versiones instaladas anteriormente.

La versión de Remote Runtime se indica en el campo Comentarios, ubicado en la pestaña Detalles de las propiedades UiPathRemoteRuntime.msi.

La versión de la dependencia del controlador de UiPath se muestra en el Administrador de paquetes, en la sección de información del paquete UiPathUIAutomationActivities.

Puedes ver las dependencias incluidas con cada versión del paquete UiPath.UIAutomation.Activities en esta página.

Soporte compatible

El componente UiPath Remote Runtime se introdujo por primera vez en la v2018.4. Para garantizar la compatibilidad con versiones anteriores, las versiones más nuevas del Robot (como v2019.10.1) pueden ejecutar procesos creados con la versión 18.4.5 y posteriores del paquete UIAutomation sin ningún problema.

Está instalado en el servidor Citrix Application o la máquina Remote Desktome en la carpeta %ProgramFiles(x86)%\UiPath. Todas las versiones instaladas son visibles en la carpeta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.

Cuando creas o ejecutas un proceso, debes usar un paquete UiPath.UIAutomation.Activities que sea compatible con la versión del controlador del componente UiPath Remote Runtime. El controlador está representado por la dependencia de UiPath del paquete UiPath.UIAutomation.Activities.

En esta página se muestra qué paquete UiPath.UIAutomation.Activities contiene versiones de controlador compatibles para el componente UiPath Remote Runtime.

Cada instalador UiPathRemoteRuntime.msi contiene la última dependencia de UiPath y la última dependencia de UiPath compatible con apoyo a largo plazo.

Ten en cuenta que si usas una versión del paquete UiPath.UIAutomation.Activities que no contiene una de las dependencias de UiPath citadas anteriormente, los selectores no se generan y se lanza una excepción, según se muestra a continuación.

Añadir dependencias de Remote Runtime

La selección interactiva en la aplicación de destino no crea selectores correctos, salvo que UiPath.UIAutomation.Activities coincida con la dependencia de UiPath Remote Runtime en el servidor Citrix Applicacion o la máquina Remote Desktop.

Por ejemplo, si quieres crear un proyecto de automatización usando la versión 19.6.0 del paquete UiPath.UIAutomation.Activities, también debes copiar la dependencia de UiPath correspondiente de la máquina cliente (donde está instalado Studio) en el servidor Citrix Application o la máquina Remote Desktop. Esto se realiza de la forma siguiente:

1. En la máquina cliente (donde está instalado Studio), vete a la carpeta %UserProfile%\.nuget\packages\uipath. Todas las dependencias de UiPath instaladas se encuentran aquí.
2. Copia la versión que se corresponda con el paquete UiPath.UIAutomation.Activities que deseas utilizar. Puedes consultar la lista de dependencias incluidas en el paquete UiPath.UIAutomation.Activities en esta página..
3. En el servidor Citrix Application o la máquina Remote Desktop, vete a la carpeta %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath y pega aquí la versión de la dependencia de UiPath copiada previamente.

Los selectores se generan correctamente con tu versión actual del paquete UiPath.UIAutomation.Activities. Los cambios se aplican en cuanto se copia la dependencia.

Requisitos de hardware y software

El componente UiPath Remote Runtime tiene los mismos requisitos que el UiPath Robot. Consulta la lista completa de requisitos aquí.