Robot - 配置步骤

先决条件

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

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

允许访问

运行 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.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>
    <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 机器人。这些同意在此设置中提到的上述天数内有效。

配置步骤