- Robot JavaScript SDK
- Acerca del SDK JavaScript de Robot
- Pasos de configuración
Requisitos previos y configuración para el SDK de JavaScript del robot, incluida la instalación del complemento de JavaScript de UiPath y la concesión de acceso de origen.
Esta página cubre los requisitos previos y la configuración para utilizar el SDK de JavaScript del robot en aplicaciones web personalizadas, incluida la configuración del navegador y el acceso de consentimiento del robot, la instalación del SDK y la configuración del complemento de JavaScript.
Requisitos previos
Se deben cumplir los siguientes requisitos previos para que los proyectos de automatización utilicen el SDK de JavaScript de UiPath Robot:
- 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, se debe conceder acceso a tu aplicación personalizada o página web para conectarse al robot. El acceso se gestiona mediante un cuadro de diálogo de dos pasos: ambos pasos deben confirmarse para ejecutar RobotJS. Ambos cuadros de diálogo admiten la automatización como se describe en las siguientes secciones.
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
El valor uipath-web://*, añadido como URL de confianza en la configuración del navegador, automatiza este cuadro de diálogo. El uipath-web://* se refiere al controlador de protocolo web de UiPath Robot.
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
La variable de entorno del sistema UIPATH_ROBOTJS_ALLOWLIST acepta automáticamente el cuadro de diálogo de consentimiento del robot.
El valor de la variable debe contener las URL de tu aplicación o página web personalizada, separadas por punto y coma. La URL debe contener el número de puerto solo si no se utiliza un puerto estándar (80 o 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:
-
Ejecuta el siguiente comando en la raíz de tu directorio de proyecto:
npm install --save @uipath/robotnpm install --save @uipath/robot
CDN
Para CDN:
-
Añade la siguiente etiqueta de script antes de la etiqueta de cierre
</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
Descarga el SDK de JavaScript de UiPath Robot a través de descarga directa.
Ajustes del complemento
Para configurar los ajustes del complemento:
- Abre el archivo
uipath.configen la carpeta de instalación. - Añade los parámetros
ListenerPortyTokenExpiryInDaysa la sección<robotJsSettings>. De forma predeterminada, la sección no contiene ninguna clave:
<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 oyentes locales de la sesión de usuario activa en ese sistema. El valor del puerto debe coincidir con el configurado en la Configuración 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. |
- Requisitos previos
- Permitiendo acceso
- Explorador de acceso del cuadro de diálogo
- Aceptación automática del cuadro de diálogo de acceso al explorador
- Cuadro de diálogo de consentimiento de UiPath Robot
- Aceptación automática del cuadro de diálogo de permiso de UiPath robot
- El SDK JavaScript de Robot
- NPM
- CDN
- Descarga directa
- Ajustes del complemento