トラブルシューティング

このページでは、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 App で対話型の選択がフリーズし、何も選択されない

現象

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 App セッションのログインでプロセスが自動的に開始されます。

  

  注:

  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' Value: '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 クライアントがクラッシュしました。

原因

Citrix アプリが読み込まれる前に、GetWindowText 関数を使用するアクティビティ ([要素の存在を確認]など) が実行されました。

解決策

このアクティビティの前に遅延を追加して、Citrix アプリを読み込む時間を確保します。

高 DPI で対話型の選択と要素の識別が機能しない

現象

Windows 向け Citrix Workspace アプリ (CWA) 2206 以降では、高 DPI ポリシー設定が適用されていない場合、ディスプレイの DPI スケールが 100% を超えると、Citrix アプリで対話型の選択や要素識別が機能しないことがあります。

原因

これは、Windows 向け Citrix Workspace アプリ 2206 での DPI サポートの変更が原因で発生します。

解決策

Enable_DPI レジストリ値を Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\ICA Client\DPI から削除します。