- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 录制
- 用户界面元素
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix Technologies Automation
- RDP 自动化
- VMware Horizon 自动化
- Salesforce 自动化
- SAP 自动化
- macOS 用户界面自动化
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 扩展程序
- 测试套件 - Studio
- 故障排除
UiPath 远程运行时
UiPath Remote Runtime 是一个组件,可实现远程桌面或应用程序(例如 Citrix Virtual Apps)与某些 UiPath 扩展程序之间的通信。其中包括 UiPath Citrix、Windows 远程桌面和应用程序、VMware Horizon 和 Amazon WorkSpaces 扩展程序。UiPath Remote Runtime 会收集有关远程应用程序目标用户界面元素的信息,并将此数据传递到相应的扩展程序。这允许在“UI Explorer”中原生生成选取器。
从 Citrix Virtual Apps and Desktops 7 2109 开始,默认情况下会阻止所有自定义虚拟通道。这会导致 UiPath Remote Runtime 无法正常工作。要解决此问题,必须将 UiPath 虚拟通道添加到允许列表策略中:
UIPCTX,C:\Program Files
(x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe
Remote Runtime 组件已获 Citrix Ready 认证,因此可将其视为与 Citrix 技术搭配使用的可靠有效的解决方案。
根据您构建的自动化项目所要基于的环境类型,您可以按照按照如下方式安装 UiPath 远程运行时组件:
- 在 Citrix 应用程序服务器上 – 与 UiPath Citrix 扩展程序通信。
- 在 VMware Horizon 虚拟机上 – 与适用于 VMware Horizon 的 UiPath 扩展程序通信。
- 在 Windows 远程桌面机器上 – 与 UiPath Windows 远程桌面和应用程序扩展程序通信。
- 在 Amazon WorkSpaces 计算机上 – 与 UiPath Amazon WorkSpaces 扩展程序通信。
必须在客户机上安装相应的 UiPath 扩展程序。
UiPathRemoteRuntime.msi
安装程序:
- UiPath Customer Portal 中的产品下载。
- UiPath Automation Cloud 中的“资源中心”。要访问资源中心,您需要登录 Automation Cloud 组织,然后单击左侧导航栏上的“帮助”按钮。
UiPathRemoteRuntime.exe
进程。
需要 UiPath 远程运行时组件,以便在应用程序或桌面服务器和客户端计算机上的 UiPath 扩展程序之间建立连接。这样,选取器会在安装了 Studio 的客户端计算机上原生生成,而不必依赖于 OCR 和图像识别活动。
UiPath Remote Runtime 的要求与 UiPath Robot 相同。请参阅硬件和软件要求中的完整要求列表。
- 运行
UiPathRemoteRuntime.msi
文件以安装 UiPath Remote Runtime。它需要安装在运行自动化目标应用程序的所有 Citrix 应用程序服务器、VMware Horizon 虚拟机、Windows 远程桌面计算机或 Amazon WorkSpaces 虚拟桌面上。 - 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口、RDP 会话或 Amazon WorkSpaces 虚拟桌面注销,再重新登录。需要这一步操作,以便您的更改生效。
- 根据您要基于哪种技术创建自动化项目,在客户端计算机上安装 UiPath Citrix 扩展程序、UiPath VMware Horizon 扩展程序、UiPath Windows 远程桌面和应用程序扩展程序或 UiPath Amazon WorkSpaces 扩展程序。
您还可以通过选择相应的选项,从安装程序中选择部署适用于 Java、Chrome、Microsoft Edge、Firefox、Microsoft 远程桌面和应用程序、VMware、Citrix 和 Amazon WorkSpaces 的扩展程序以及任务调度条目,如下所示:
UiPathRemoteRuntime.msi
安装程序并选择相应的选项即可。
UiPathRemoteRuntime.msi
需要管理员权限。
- 单击 Windows 开始按钮,然后在搜索字段中键入
cmd
。 - 右击命令提示符并以管理员身份运行。
- 将目录更改到
UiPathRemoteRuntime.msi
文件夹(例如:cd C:\Tools\Studio
)。 - 使用
UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask
命令安装UiPath 远程运行时组件。 - 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口、RDP 会话或 Amazon WorkSpaces 虚拟桌面注销,再重新登录。需要这一步操作,以便您的更改生效。
- 根据您要基于哪种技术创建自动化项目,在客户端计算机上安装 UiPath Citrix 扩展程序、UiPath VMware Horizon 扩展程序、UiPath Windows 远程桌面和应用程序扩展程序或 UiPath Amazon WorkSpaces 扩展程序。
此外,您可以使用以下选项来安装扩展程序:
UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient,FirefoxExtension,WindowsRdpExtension,VMwareExtension,AmazonWorkSpacesClient
– 安装 Remote Runtime 组件、任务计划程序条目,以及适用于 Java、Chrome、Microsoft Edge、Citrix、Firefox、Microsoft 远程桌面和 Apps、VMware Horizon 和 Amazon WorkSpaces 的扩展程序。
/quiet
参数执行静默安装。
UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet
- 以静默方式安装 Remote Runtime 组件和任务计划程序条目。
APPLICATIONFOLDER
选项在任何位置安装 UiPath Remote Runtime:
UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet
– 在D:\UiPathRemoteRuntime
中静默安装 Remote Runtime 组件,并添加任务调度程序条目。
现在,您可以如同在标准计算机上一样,创建基于 Citrix Virtual Apps and Desktops、VMware 应用程序、Amazon WorkSpaces 虚拟桌面以及 RDP 连接上进行自动化的流程。由于存在对应的扩展程序,正确识别用户界面元素已不再需要 OCR 和图像识别活动。元素可以原生识别,并可与任何活动搭配使用。
UiPathRemoteRuntime.msi
安装程序中的“创建启动 UiPath 远程运行时任务”选项进行管理。如有必要,可以选择禁用。
UiPathRemoteRuntime.exe
进程。
UiPath Remote Runtime 依赖于 UiPath.UIAutomation.Activities 包的版本,而不依赖于 UiPath Studio/Robot 的版本。
安装在远程计算机上的 Remote Runtime 必须具有您要在项目中使用的最新 UIAutomation 包版本,并且它与以前的 UIAutomation 版本兼容(向后兼容)。
UiPath.UIAutomation.Activities 包和 UiPath Remote Runtime 具有相同的 UiPath 驱动程序依赖项。对于每个发布的用户界面自动化包版本,都提供具有相同版本号的 UiPath Remote Runtime 组件的下载链接。
https://download.uipath.com/versions/23.10.8/UiPathRemoteRuntime.msi
下载所需的 UiPath Remote Runtime 安装程序。
UiPathRemoteRuntime.msi
安装程序:
- UiPath Customer Portal 中的“产品下载”。
- UiPath Automation Cloud 中的“资源中心”。要访问“资源中心”,您需要登录 Automation Cloud 组织,单击工具栏上的“帮助”按钮,然后选择“资源”>“下载”。
- 或者,您可以通过联系技术支持页面提交请求。
%ProgramFiles(x86)\UiPath
文件夹中。所有已安装版本均位于 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath
文件夹中。
构建或执行流程时,您需要使用与已部署的 UiPath Remote Runtime 驱动程序版本兼容的 UiPath.UIAutomation.Activities 包。
%ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath
文件夹中必须存在相同的 UiPath 版本。
UiPathRemoteRuntime.msi
安装程序都包含最新的 UiPath 依赖项以及最新支持的长期支持 (LTS) UiPath 依赖项。
下表列出了 UiPath.UIAutomation.Activities 包和 UiPath Remote Runtime 之间的依赖项:
UIAutomation 包版本 |
UiPath Remote Runtime 内部版本号 |
UiPath 驱动程序依赖项 |
UiPath Remote Runtime 的 UIAutomation 兼容版本 |
---|---|---|---|
24.10.7 | 24.10.108.16096 | 24.10.108.16096 |
24.10.7 23.10.13 23.4.11 22.10.9 22.4.11 21.10.10 20.10.15 |
23.10.13 |
23.10.97.53968 |
23.10.97.53968 |
23.10.13 23.4.11 22.10.10 22.4.12 21.10.10 20.10.15 |
23.4.11 |
23.10.86.3201 |
23.4.81.50665 |
23.10.11 23.4.11 22.10.10 22.4.12 21.10.10 20.10.15 |
22.10.10 | 23.4.67.63183 | 22.10.67.59238 |
23.4.10 22.10.10 22.4.12 21.10.10 20.10.15 |
22.4.12 | 23.4.67.63183 | 22.4.67.58669 |
23.4.10 22.10.10 22.4.12 21.10.10 20.10.15 |
21.10.10 | 23.4.67.63183 | 23.4.67.63183 |
23.4.10 22.10.10 22.4.12 21.10.10 20.10.15 |
20.10.15 | 23.4.67.63183 | 20.10.8676.29744 |
23.4.10 22.10.10 22.4.12 21.10.10 20.10.15 |
19.11.5 |
22.4.43.27553 |
19.10.7601.15369 |
22.4.7 21.10.7 20.10.12 19.11.5 18.4.8 |
18.4.8 |
22.4.43.27553 |
10.0.7772.19184 |
22.4.7 21.10.7 20.10.12 19.11.5 18.4.8 |
UiPathRemoteRuntime.msi
文件的“属性”的“详细信息”选项卡的“注释”字段中验证 Remote Runtime 内部版本号。
The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server
。
目标应用程序的交互式选取无法构建正确的选取器,除非 UiPath.UIAutomation.Activities 与 Citrix 应用程序服务器、VMware 虚拟机、远程桌面计算机或 Amazon WorkSpaces 虚拟桌面上的 UiPath Remote Runtime 依赖项匹配。
例如,如果要使用 UiPath.UIAutomation.Activities 包版本 23.10.8 构建自动化项目,您需要将客户端计算机(其中已安装 Studio/Robot)中的相应 UiPath 依赖项复制到 Citrix 应用程序服务器、VMware 虚拟机、远程桌面计算机或 Amazon WorkSpaces 虚拟桌面上。
操作方法如下:
- 在客户机(安装 Studio 的计算机)上,导航至
%UserProfile%\.nuget\packages\uipath
文件夹。所有已安装的 UiPath 依赖项均位于该文件夹中。 - 复制与您要使用的 UiPath.UIAutomation.Activities 包对应版本的文件夹。您可以在“关于用户界面自动化活动”页面中查看 UiPath.UIAutomation.Activities 包随附的依赖项列表,也可以按照“并行支持”中的说明检查包依赖项。
- 在 Citrix 应用程序服务器、VMware 虚拟机、远程桌面计算机或 Amazon WorkSpaces 虚拟桌面上,导航到
%ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath
文件夹,然后在此粘贴之前复制的 UiPath 依赖项版本。- 例如,对于 UiPath.UIAutomation.Activities 版本 23.10.8,相应的 UiPath 依赖项为 23.10.71.64399。这是您需要从 Studio/Robot 计算机复制到远程计算机的文件夹的名称。
现已使用当前版 UiPath.UIAutomation.Activities 生成恰当的选取器。复制依赖项后,更改即可生效。
设计时和执行时都需要上述 Remote Runtime 依赖项。
在启动流程时,机器人会通过 RPC 通道向 Citrix 扩展程序或 Windows 远程桌面扩展程序发出必要的命令。此信息包还包含用于构建流程的用户界面自动化包的版本详情。
相应的扩展程序随后通过 ICA 虚拟通道将此信息包转发给 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时组件。
UiPath 远程运行时组件会根据构建流程所使用的用户界面自动化包版本,指示机器人执行程序应使用哪种驱动程序。
远程运行时组件与对应扩展程序之间的通信通过内部开发的 ICA 通道完成。您可使用多个 ICA 通道,但 Citrix Receiver 等程序已为剪贴板、音频及其他组件使用多个通道。
安装远程运行时组件后,即可创建自动化项目,且无需创建任何防火墙规则。
在 Remote Runtime 和扩展程序之间数据传输几乎不需要使用带宽。例如,机器人执行的每个操作(例如单击活动)只会传输大约 3 KB 的数据。
如果您跳过多个远程连接(RDP、Citrix 或 VMware)以到达开发自动化的目标远程计算机,则必须在每台中间远程计算机上安装远程运行时,而不仅仅是在目标计算机上。有关更多详细信息,请查看“配置多跃点连接”页面。