故障排除

本页介绍如何解决在 Citrix 环境中运行自动化时可能遇到的问题。

默认情况下阻止虚拟通道

观察到的行为

After upgrading to a Citrix version higher than Citrix Virtual Apps and Desktops 7 2109, existing Citrix automations that rely on UiPath Remote Runtime fail: selector generation stops working and UI Automation activities can no longer detect Citrix elements.

原因

Starting with Citrix Virtual Apps and Desktops 7 2109, all custom virtual channels are blocked by default, which prevents UiPath Remote Runtime from communicating with the Citrix session.

解决方案

Add the UiPath virtual channel to the Citrix allow list policy:

1. Configure the allow list policy by following the Citrix virtual channel allow-list policy settings documentation.

2. Add the following value to the allow list policy, replacing <UiPathRemoteRuntime-Install_Path> with your install location:

   UIPCTX,<UiPathRemoteRuntime-Install_Path>\UiPathRemoteRuntime.exe

   例如：

   UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Citrix Apps 中交互式选择冻结并且任何对象均未选中

观察到的行为

After you install the UiPath Extension for Citrix and try to select UI elements from a Citrix App, interactive selection freezes for one minute, and then nothing is selected.

原因

This happens if the UiPath Remote Runtime is not running in the Citrix App session.

解决方案

• 在打开 Citrix 应用程序的 Citrix 应用程序服务器上，检查是否安装了 UiPathRemoteRuntime.msi。

• 在 Citrix 应用程序服务器上，检查“UiPathRemoteRuntime.exe”进程是否正在运行。如果“UiPathRemoteRuntime.msi”已经安装，则该进程会在 Citrix 应用程序会话登录时自动启动。

  

  备注：

  If you cannot install UiPathRemoteRuntime.msi on the Citrix application servers, consider uninstalling the UiPath Extension for Citrix from the client machine. For instructions, see Extension for Citrix.

无法复制文件“C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll”。另一个进程正在使用此文件。

观察到的行为

尝试安装 UiPath Citrix 扩展程序时，系统将显示以下错误：

原因

This occurs when the UiPath Extension for Citrix is already installed and an open Citrix App is using it.

解决方案

Close all active Citrix App sessions, as described in Restarting active Citrix sessions, then reinstall the UiPath Extension for Citrix.

无法读取 Citrix 注册表键：“SOFTWARECitrixInstallICA Client”值：“InstallFolder”

观察到的行为

When you try to install the UiPath Extension for Citrix, the following error is displayed:

原因

如果未安装 Citrix Receiver，就会显示此错误消息。如果未安装 Citrix Receiver for Universal Windows Platform，也会显示此消息。

解决方案

下载并安装 Citrix Receiver 或 Citrix Workspace。

wfica32.exe 0xC0000094 中的未处理异常：整数除零

观察到的行为

目标 Citrix 应用程序无法启动，Citrix ICA 客户端崩溃。

原因

使用 GetWindowText 函数的活动（如“存在元素”）在 Citrix 应用程序可以加载之前执行。

解决方案

通过添加活动前的延迟，为 Citrix 应用程序留出加载时间。

交互式选择和元素识别不适用于高 DPI

观察到的行为

从适用于 Windows 2206 的 Citrix Workspace 应用程序 (CWA) 开始，如果未应用高 DPI 策略设置，则当显示 DPI 缩放比例高于 100% 时，交互式选择和元素识别可能不适用于 Citrix Apps。

原因

这是由 Citrix 中的以下更改引起的：适用于 Windows 2206 的 Citrix Workspace 应用程序的 DPI 支持更改。

解决方案

从 Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\ICA Client\DPI 中删除 Enable_DPI 注册表值：