Guía para desarrolladores de robots

Última actualización 17 de dic. de 2024

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:

Studio y Robot versión 2021.10 o superior instalada
El complemento JavaScript de UiPath instalado en la máquina de Robot

Permitiendo acceso

Cuando se ejecuta el complemento de JavaScript de UiPath robot, debes proporcionar acceso a tu aplicación o página web personalizada para conectarte 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 explorador que solicita permisos para abrir el UiPath Assistant.

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

Se puede automatizar añadiendo el valor uipath-web://* como una URL de confianza (permitida) en la configuración del navegador. 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.

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.2/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.3.2/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 que provenga de un nuevo dominio debe tener 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.