Robot: pasos de configuración

Requisitos previos

Para que tus proyectos de automatización aprovechen el SDK JavaScript de Robot, deben cumplirse los siguientes requisitos previos:

Versión 2019.10 o posterior de Studio y Robot instalada
El complemento de JavaScript de UiPath^® instalado en la máquina del robot
El SDK JavaScript de Robot

Importante:
El SDK JavaScript de UiPath Robot se proporciona listo para usar para Studio v2020.4 y superiores. Para Studio v2019.10 LTS también hay disponible un instalador independiente adicional.

Si actualizas de v2019.10 a v2020.2 y posteriores, debes desinstalar manualmente el complemento JS de UiPath^® Robot antes de ejecutar el instalador de Studio y Robot.

Permitiendo acceso

Cuando se ejecuta el complemento de JavaScript de UiPath^® Robot, debes proporcionar acceso a tu aplicación personalizada o página web para que se conecte al Robot.

El acceso se gestiona mediante un cuadro de diálogo en dos pasos. Ambos pasos deben confirmarse para ejecutar RobotJS. Pueden automatizarse como se describe a continuación.

Explorador de acceso del cuadro de diálogo

Este paso se refiere al navegador que solicita permisos para abrir UiPath^® Assistant.

Aceptación automática del cuadro de diálogo de acceso al explorador

Puede automatizarse añadiendo el uipath-web://*valor como una url de confianza (permitida) en la configuración del navegador. El uipath-web://* se refiere al controlador de protocolo web de UiPath^® Robot.

Nota: según el explorador utilizado, hay que establecer diferentes configuraciones. Por ejemplo, si utilizas Google Chrome, sigue los pasos descritos en la documentación de Google Chrome URLAllowList.

Cuadro de diálogo de consentimiento de UiPath Robot

El cuadro de diálogo de permiso de UiPath Robot se utiliza para permitir la conexión entre Robot JavaScript SDK y Ejecutor de robot.

Aceptación automática del cuadro de diálogo de permiso de UiPath robot

Esto puede permitirse automáticamente añadiendo la variable de entorno del UIPATH_ROBOTJS_ALLOWLISTsistema.

Los valores utilizados en la variable deben ser las URL de tu página web o aplicación personalizada, separados por punto y coma. La URL debe contener solo el número de puerto si no se utiliza un puerto estándar ( 80o 443).

El SDK JavaScript de Robot

Este SDK proporciona todos los métodos y propiedades necesarios que puedes incluir en tu aplicación o página web personalizada. Puedes descargarlo de la siguiente forma:

NPM

El paquete npm está disponible con vinculaciones de TypeScript. Para incluirlo en tu proyecto, deberás ejecutar el siguiente comando en la raíz del directorio de tu proyecto:

npm install --save @uipath/robotnpm install --save @uipath/robot

CDN

Para CDN, deberás incluir el SDK antes de cerrar la etiqueta </body>.

<body>
...
...
<script href="//download.uipath.com/js/1.3.1/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.3.1/UiPathRobot.js"></script>
</body>

Descarga directa

También puedes obtener el SDK JavaScript de Robot mediante descarga directa.

Ajustes del complemento

Para cambiar la configuración del complemeto, debes añadir los TokenExpiryInDaysparámetros ListenerPorty en el uipath.configarchivo desde la carpeta de instalación. De forma predeterminada, la sección no contiene ninguna clave.

El archivo de configuración debe contener lo siguiente:

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings><robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Atributo	Descripción
`ListenerPort`	El `UiPath.RobotJS.ServiceHost.exe` inicia un HttpListener en el puerto configurado y contiene la información sobre otros listeners locales de la sesión del usuario activo en ese sistema. Ten en cuenta que aquí el valor del puerto debe coincidir con el que se configura en los Ajustes del SDK.
`TokenExpiryInDays`	Cualquier solicitud procedente de un nuevo dominio debe tener el consentimiento del usuario para permitir el acceso de UiPath^® Robots desde una aplicación web. Estos consentimientos son válidos para el número de días mencionado en este ajuste.

Pasos de configuración