SDK

配置步骤

先决条件

为使自动化项目受益于 Robot JavaScript SDK，需要满足以下先决条件：

安装 2019.10 或更高版本的 Studio 和机器人
在机器人计算机上安装 UiPath JavaScript 插件
Robot JavaScript SDK

重要提示：
对于 Studio v2020.4 及更高版本，Robot JavaScript SDK 是开箱即用的。对于 Studio v2019.10 LTS，还可以使用独立的加载项安装程序。

如果从 v2019.10 升级到 v2020.2 及更高版本，则需要在运行 Studio 和机器人安装程序之前手动卸载 UiPath 机器人 JS 插件。

允许访问

运行 UiPath 机器人 JavaScript 加载项时，您需要提供对自定义应用程序或网页的访问权限，以连接到机器人。

访问由两步对话框处理。必须确认这两个步骤才能运行 RobotJS。它们可以自动化，如下所述。

浏览器访问对话框

此步骤是指浏览器请求打开 UiPath Assistant 的权限。

自动接受“浏览器访问权限”对话框

通过在浏览器的设置中添加uipath-web://*值作为受信任（允许）的 URL，可以自动执行此操作。 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> 标签之前将 SDK 包含在其中。

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

直接下载

您还可通过直接下载获取 Robot JavaScript SDK。

插件设定

要更改加载项设置，您需要在安装文件夹的uipath.config文件中添加ListenerPort和TokenExpiryInDays参数。默认情况下，该部分不包含任何键。

配置文件需要包含以下内容：

<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` 在已配置的端口上启动 Http 侦听器，其中包含该系统上活动用户会话中其他本地侦听器的相关信息。请注意，此处的端口值必须与“SDK 设置”中配置的端口值相符。
`TokenExpiryInDays`	来自新域的任何请求都需要获得用户的同意，以允许从网页应用程序访问 UiPath 机器人。这些同意在此设置中提到的上述天数内有效。