Robot - 配置步骤

先决条件

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

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

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

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

允许访问

当 UiPath^TM Robot JavaScript 插件运行时，您需要提供对自定义应用程序或网页的访问权限，以连接到机器人。

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

浏览器访问对话框

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

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

可以通过在浏览器设置中添加 uipath-web://* 值作为受信任（允许）的 URL 来自动化此操作。uipath-web://* 是指 UiPath^TM Robot 网页协议处理程序。

注意：根据所使用的浏览器，需要配置不同的设置。例如，如果您使用的是 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.1/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.3.1/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^TM Robot。这些同意在此设置中提及的上述天数内有效。

配置步骤