- Robot JavaScript SDK
Robot JavaScript SDK 的先决条件和配置，包括安装 UiPath JavaScript 插件和授予原始访问权限。
本页介绍在自定义网页应用程序中使用机器人 JavaScript SDK 的先决条件和配置，包括设置浏览器和机器人同意访问权限、安装 SDK 以及配置 JavaScript 插件。
先决条件
自动化项目必须满足以下先决条件才能使用 Robot JavaScript SDK：
- 安装 2021.10 或更高版本的 Studio 和机器人
- 在机器人计算机上安装 UiPath JavaScript 插件
允许访问
运行 UiPath 机器人 JavaScript 插件时，您必须获得对自定义应用程序或网页的访问权限，以连接到机器人。访问权限由两步对话框处理 — 必须确认两个步骤才能运行 RobotJS。这两个对话框都支持自动化，如以下各节所述。
浏览器访问对话框
此步骤是指浏览器请求打开 UiPath Assistant 的权限。
“自动接受浏览器访问”对话框
在浏览器设置中添加为受信任 URL 的 uipath-web://* 值可自动执行此对话框。uipath-web://* 是指 UiPath 机器人网页协议处理程序。
根据使用的浏览器，需要配置不同的设置。 例如，如果您使用的是 Google Chrome，请按照 Google Chrome URL 白名单文档中所述的步骤操作。
机器人同意对话框
机器人同意对话框用于允许机器人 JavaScript SDK 和机器人执行程序之间建立连接。
自动接受机器人同意对话框
UIPATH_ROBOTJS_ALLOWLIST 系统环境变量会自动接受机器人同意对话框。
变量值必须包含自定义应用程序或网页的 URL，并用分号分隔。仅当不使用标准端口（80 或 443）时，URL 才应包含端口号。
Robot JavaScript SDK
该 SDK 提供可以包含在自定义应用程序或网页中的所有必要方法和属性。您可以通过下列方式下载它：
NPM
npm 包可用于 TypeScript 绑定。要将其包含在您的项目中，请执行以下操作：
-
在项目目录的根目录运行以下命令：
npm install --save @uipath/robotnpm install --save @uipath/robot
CDN
对于 CDN：
-
在结束
</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>
直接下载
通过直接下载下载 Robot JavaScript SDK。
插件设定
要配置加载项设置：
- 打开安装文件夹中的
uipath.config文件。 - 将
ListenerPort和TokenExpiryInDays参数添加到<robotJsSettings>部分。默认情况下，该部分不包含任何键：
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
| 属性 | 描述 |
|---|---|
ListenerPort | UiPath.RobotJS.ServiceHost.exe在配置的端口上启动HttpListener ，并包含该系统上活动用户会话中的其他本地侦听器的相关信息。端口值必须与在“SDK 设置”中配置的端口值相符。 |
TokenExpiryInDays | 来自新域的任何请求都需要获得用户的同意，以允许从网页应用程序访问 UiPath 机器人。这些同意在此设置中提到的上述天数内有效。 |