- 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/robot
npm install --save @uipath/robot
CDN
对于 CDN，请在结束 </body> 标签之前添加 SDK：
<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。
插件设定
要更改加载项设置，请将 ListenerPort 和 TokenExpiryInDays 参数添加到安装文件夹中的 uipath.config 文件中。默认情况下，该部分不包含任何键。
配置文件必须包含以下内容：
<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 机器人。这些同意在此设置中提到的上述天数内有效。 |