UiPath Studio

UiPath Studio 指南

关于 UiPath 远程运行时

UiPath Remote Runtime is a component which facilitates the communication between a remote application or desktop, such as Citrix Virtual Apps, and the dedicated UiPath extension - the UiPath Extension for Citrix, the UiPath Extension for Windows Remote Desktop, or the UiPath Extension for VMware Horizon. It gathers info about targeted UI elements of remote applications and sends them to the corresponding extension so that selectors are natively generated in UIExplorer.

The Remote Runtime component was granted a Citrix Ready certification, making it a trusted, effective solution for working with Citrix technologies.

根据您构建的自动化项目所要基于的环境类型,您可以按照按照如下方式安装 UiPath 远程运行时组件:

请注意,客户机上需要安装相应的 UiPath 扩展程序。

The UiPathRemoteRuntime.msi installer is included in UiPathPlatformInstaller.exe, or you can obtain it by contacting our Support Team. Please note that UiPathPlatformInstaller.exe does not support command line arguments.

安装 UiPath 远程运行时组件后,该组件将在“任务计划程序”中注册任务,以便在用户每次登录时启动 UiPathRemoteRuntime.exe 流程。

需要 UiPath 远程运行时组件,以便在应用程序或桌面服务器和客户端计算机上的 UiPath 扩展程序之间建立连接。这样,选取器会在安装了 Studio 的客户端计算机上原生生成,而不必依赖于 OCR 和图像识别活动。

Task Scheduler

By default, the UiPath Remote Runtime component creates an entry in Windows Task Scheduler to automatically start every time the corresponding user logs in. This feature is represented by the Create Launch UiPathRemoteRuntime task option in the UiPathRemoteRuntime.msi installer, which you can choose to disable, if necessary.

The Remote Runtime Task Schedule entry can be added or removed via the installer or the Command Prompt, as you can see in the following sections.

安装 UiPath 远程运行时

从安装程序

  1. 运行 UiPathRemoteRuntime.msi 文件以安装 UiPath 远程运行时。您需要将其安装到您要创建自动化项目的所有 Citrix 应用程序服务器或 Windows 远程桌面机器上。
  2. 从客户端计算机上当前的 Citrix 窗口或 RDP 会话注销,再重新登录。需要这一步操作,以便您的更改生效。
  3. 根据您要基于哪种技术创建自动化项目,在客户端计算机上安装 UiPath Citrix 扩展程序UiPath Windows 远程桌面扩展程序

You can also choose to deploy the extension for Java, Chrome, and Citrix from the installer, as well as the Task Schedule entry, by selecting the corresponding options, as depicted below:

The Task Scheduler entry for the Remote Runtime can be added or removed at any moment. Simply run the UiPathRemoteRuntime.msi installer and choose the corresponding option.

从命令提示符中

  1. 单击“Windows 开始”按钮,然后在搜索字段中键入 cmd
  2. 右键单击“命令提示符”并以管理员身份运行。
  3. 将目录更改到 UiPathRemoteRuntime.msi 文件夹(例如:cd C:\Tools\Studio)。
  4. 使用 UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime 命令安装UiPath 远程运行时组件。
  5. 从客户端计算机上当前的 Citrix 窗口或 RDP 会话注销,再重新登录。需要这一步操作,以便您的更改生效。
  6. 根据您要基于哪种技术创建自动化项目,在客户端计算机上安装 UiPath Citrix 扩展程序UiPath Windows 远程桌面扩展程序

Additionally, you can use the JavaBridge, ChromeExtension, CitrixClient or RemoteRuntimeTask arguments to install the extension for Java, Chrome, Citrix, or the Task Scheduler entry as exemplified below:

  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,JavaBridge - installs the Remote Runtime component and the extension for Java.
  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,ChromeExtension - installs the Remote Runtime component and the extension for Chrome.
  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,JavaBridge,ChromeExtension - installs the Remote Runtime component, the extension for Java, and the extension for Chrome.
  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,JavaBridge,ChromeExtension,CitrixClient - installs the Remote Runtime component, the extension for Java, the extension for Chrome, and the extension for Citrix.
  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,JavaBridge,ChromeExtension,CitrixClient,RemoteRuntimeTask - installs the Remote Runtime component, the extension for Java, the extension for Chrome, the extension for Citrix, and the Task Scheduler entry.

还可以使用 /quiet 参数执行静默安装。

  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,JavaBridge,ChromeExtension,CitrixClient,RemoteRuntimeTask /quiet - silently installs the Remote Runtime component, the extension for Java Bridge, the extension for Chrome, the extension for Citrix, and the Task Scheduler entry.

现在,您可以如同在标准计算机上一样,创建基于 Citrix 虚拟应用程序和桌面以及通过 RDP 连接进行自动化的流程。由于存在对应的扩展程序,正确识别用户界面元素已不再需要 OCR 和图像识别活动。元素可以原生识别,并可与任何活动搭配使用。

驱动程序依赖项

UiPath 远程运行时和 UiPath.UIAutomation.Activities 包的 UiPath 驱动程序依赖项必须使用相同版本。

远程运行时版本由 UiPathRemoteRuntime.msi 属性“详细信息”选项卡的“注释”字段规定。

UiPath 驱动程序依赖项版本则显示在 UiPathUIAutomation.Activities 包信息部分的“包管理器”中。

You can view the dependencies shipped with each version of the UiPath.UIAutomation.Activities package on this page.

远程运行时架构

在启动流程时,机器人会通过 RPC 通道向 Citrix 扩展程序或 Windows 远程桌面扩展程序发出必要的命令。此信息包还包含用于构建流程的用户界面自动化包的版本详情。

相应的扩展程序随后通过 ICA 虚拟通道将此信息包转发给 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时组件。

UiPath 远程运行时组件会根据构建流程所使用的用户界面自动化包版本,指示机器人执行程序应使用哪种驱动程序。

多个 ICA 通道

远程运行时组件与对应扩展程序之间的通信通过内部开发的 ICA 通道完成。您可使用多个 ICA 通道,但 Citrix Receiver 等程序已为剪贴板、音频及其他组件使用多个通道。

数据传输及带宽注意事项

安装远程运行时组件后,即可创建自动化项目,且无需创建任何防火墙规则。

远程运行时与扩展程序之间的数据传输只需使用少量带宽。例如,机器人执行的每个操作(如“单击”活动)约仅传输 3 KB 数据。

并行支持

The UiPath Remote Runtime component was first introduced in v2018.4. To ensure backward compatibility, newer versions of the Robot (such as a v2019.10.1 Robot) are able to execute processes created with the UIAutomation package version 18.4.5 and greater without any issues.

It is installed on the Citrix Application server or Remote Desktop machine in the %ProgramFiles(x86)%\UiPath folder. All installed versions are visible in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.

在构建或执行流程时,您需使用 UiPath.UIAutomation.Activities 包,且此包的版本要与 UiPath 远程运行时中已部署的驱动程序版本兼容。驱动程序由 UiPath.UIAutomation.Activities 包的 UiPath 依赖项表示。下表显示了哪种 UiPath.UIAutomation.Activities 包中包含可与 UiPath 远程运行时兼容的驱动程序版本。

UiPath.UIAutomation.Activities
UiPath/远程运行时

18.4.2

10.0.6913.22031

18.4.3

10.0.6929.25268

18.4.4

10.0.6992.20526

18.4.5

10.0.7020.22745

18.4.6

10.0.7194.26789

19.1.0

10.0.6957.21531

19.2.0

10.0.6957.21531

19.3.0

10.0.7004.31775

19.4.1

19.4.7054.14370

19.4.2

19.4.7068.19937

19.5.0

19.5.7079.28746

19.6.0

19.6.7108.25473

19.7.0

19.7.7128.27029

19.10.1

19.10.7243.31457

19.11.0

19.10.7275.19994

19.11.1

19.10.7312.25504

19.11.2

19.10.7312.25504

Each UiPathRemoteRuntime.msi installer contains the latest UiPath dependency, as well as the latest supported Long Term Support (LTS) UiPath dependency.

请注意,如果您所用 UiPath.UIAutomation.Activities 包的版本不包含上述 UiPath 依赖项之一,则系统不会生成选取器并会抛出异常,如下所示。

添加远程运行时依赖项

目标应用程序的交互式选取无法构建正确的选取器,除非 UiPath.UIAutomation.Activities 与 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时依赖项匹配。

例如,如果要使用 UiPath.UIAutomation.Activities 包版本 19.6.0 构建自动化项目,您还需要将客户端计算机(其中已安装 Studio)中的相应 UiPath 依赖项复制到 Citrix 应用程序服务器或远程桌面机器上。操作方法如下:

  1. 在客户机(安装 Studio 的计算机)上,导航至 %UserProfile%\.nuget\packages\uipath 文件夹。所有已安装的 UiPath 依赖项均位于该文件夹中。
  2. Copy the version which corresponds to the UiPath.UIAutomation.Activities package you want to use. You can view the list of dependencies shipped the UiPath.UIAutomation.Activities package on this page.
  3. 在 Citrix 应用程序服务器或远程桌面机器上,导航到 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹,然后在此粘贴之前复制的 UiPath 依赖项版本。

现已使用当前版 UiPath.UIAutomation.Activities 生成恰当的选取器。复制依赖项后,更改即可生效。

Updated 4 months ago


关于 UiPath 远程运行时


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.