通知を受け取る

UiPath Studio

UiPath Studio ガイド

UiPath リモート ランタイムについて

UiPath リモート ランタイムは、Citrix 仮想アプリなどのリモート アプリケーションまたはデスクトップと、専用の UiPath 拡張機能 (UiPath Citrix 拡張機能UiPath Windows リモート デスクトップとアプリ拡張機能、または UiPath VMware Horizon 拡張機能) 間の通信を行うためのコンポーネントです。リモート アプリケーションのターゲット UI 要素に関する情報を収集し、対応する拡張機能に送信して、セレクターが UI Explorer でネイティブに生成されるようにします。

📘

注:

Citrix Virtual Apps and Desktops 7 2109 以降、カスタム仮想チャネルはすべて既定でブロックされます。
これにより、UiPath リモート ランタイムは正しく動作しなくなります。
この問題を解決するには、UiPath 仮想チャネルを許可リスト ポリシーに追加する必要があります。
UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

リモート ランタイム コンポーネントは、Citrix Ready 認定を付与されており、Citrix の技術と連動する、信頼できる効果的なソリューションになっています。

オートメーション プロジェクトの構築先となる環境の種類によって、UiPath リモート ランタイム コンポーネントを次のようにインストールすることができます。

対応する UiPath 拡張機能をクライアント マシンにインストールする必要があります。

You can obtain the UiPathRemoteRuntime.msi installer by contacting our Support Team.

Once the UiPath Remote Runtime component is installed, it registers a task in the TaskScheduler so that the UiPathRemoteRuntime.exe process is started at every user login.

15621562

アプリケーション サーバーまたはデスクトップ サービスと、クライアント マシンにインストール済みの対応する UiPath 拡張機能の間で接続を確立するには、UiPath リモート ランタイム コンポーネントが必要です。これにより、OCR や画像認識のアクティビティを利用せずに、Studio がインストールされているクライアント マシン上でセレクターがネイティブで作成されます。

タスク スケジューラー

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.

リモート ランタイムのタスク スケジュール エントリは、以下のセクションに示すとおり、インストーラーまたはコマンド プロンプトを使って追加または削除できます。

UiPath リモート ランタイムのインストール

インストーラーの場合

  1. Run the UiPathRemoteRuntime.msi file to install the UiPath Remote Runtime. It needs to be installed on all the Citrix Application servers or the Windows Remote Desktop machines on which you want to create your automation projects.
  2. クライアント マシンで実行中の Citrix ウィンドウまたは RDP セッションからいったんログオフして、再度ログインします。変更を反映させるには、この操作が必要です。
  3. オートメーション プロジェクトの作成に使用するテクノロジーに合わせて、クライアント マシンに、UiPath Citrix 拡張機能または UiPath Windows リモート デスクトップとアプリ拡張機能をインストールします。

タスク スケジュールのエントリに加えて、インストーラーから、対応するオプションを選択して (下図参照) Java、Chrome、Citrix の拡張機能をデプロイすることも選択できます。

618618

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.

550550

コマンド プロンプトから

📘

注:

UiPathRemoteRuntime.msi をインストールするには、管理者権限が必要です。

  1. Click the Windows Start button and type cmd in the search field.
  2. [コマンド プロンプト] を右クリックし、管理者として実行します。
  3. Change the directory to the UiPathRemoteRuntime.msi folder (For example: cd C:\Tools\Studio など)。
  4. Use the UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask command to install the UiPath Remote Runtime component.
  5. クライアント マシンで実行中の Citrix ウィンドウまたは RDP セッションからいったんログオフして、再度ログインします。変更を反映させるには、この操作が必要です。
  6. オートメーション プロジェクトの作成に使用するテクノロジーに合わせて、クライアント マシンに、UiPath Citrix 拡張機能または UiPath Windows リモート デスクトップとアプリ拡張機能をインストールします。

Additionally, you can use the RemoteRuntimeTask JavaBridge ChromeExtension EdgeChromium または CitrixClient arguments to install the extension for Task Scheduler entry, Java, Chrome, Microsoft Edge or Citrix extensions as exemplified below:

  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient - リモート ランタイム コンポーネント、タスク スケジューラーのエントリ、Java 向け拡張機能、Chrome 向け拡張機能、Microsoft Edge 向け拡張機能、および Citrix 向け拡張機能をインストールします。

You can also perform a silent installation by using the /quiet parameter:

  • UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet - リモート ランタイム コンポーネントとタスク スケジューラーのエントリをサイレント モードでインストールします。

You can install the UiPath Remote Runtime at any location using the APPLICATIONFOLDER option:

  • UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet - silently installs the Remote Runtime component in D:\UiPathRemoteRuntime, and adds the Task Scheduler entry.

これで、標準的なマシンと同じように、Citrix Virtual Apps and Desktops および RDP 接続で自動化するためのプロセスを作成できます。専用の拡張機能を使用することにより、OCR および画像認識のアクティビティを必要とせずに、UI 要素を適切に識別できます。その代わりに、要素はネイティブで認識され、どのアクティビティでも使用できます。

ドライバーの依存関係

UiPath リモート ランタイムと UiPath.UIAutomation.Activities パッケージの UiPath ドライバーの依存関係は、同じバージョンである必要があります。ただし、UiPath リモート ランタイムを UiPath.UIAutomation.Activities パッケージの UiPath ドライバーの新しい依存関係に一致するようアップグレードした場合、UiPath リモート ランタイムの、インストール済みのすべてのバージョンとの後方互換性は維持されます。

The Remote Runtime version is dictated by the Comments field, located in the Details tab of the UiPathRemoteRuntime.msi properties.

405405

UiPath ドライバー依存関係のバージョンは UiPathUIAutomation.Activities パッケージ情報セクションのパッケージ マネージャーに表示されます。

343343

こちらのページUiPath.UIAutomation.Activities パッケージの各バージョンに同梱されている依存関係を確認できます。

リモート ランタイム アーキテクチャ

プロセスを開始すると、ロボットは RPC チャネル経由で必要なコマンドを Citrix または Windows リモート デスクトップ拡張機能に送信します。この情報パッケージには、プロセスのビルドに使用される UIAutomation パッケージのバージョンに関する詳細も含まれています。

対応する拡張機能は、情報パッケージを ICA 仮想チャネルを使用して、Citrix Application サーバーまたはリモート デスクトップ マシンにある UiPath リモート ランタイム コンポーネントに転送します。

プロセスのビルドに使用した UIAutomation パッケージのバージョンに応じて、UiPath リモート ランタイム コンポーネントは、使用するドライバーを Robot Executor に指示します。

752752

複数の ICA チャネル

リモート ランタイム コンポーネントと対応する拡張機能間の通信は、内部で開発された ICA チャネルを使用して行われます。複数の ICA チャネルを使用できますが、たとえば、Citrix Receiverでは、クリップボード、オーディオなどにいくつかのチャネルが既に使用されています。

データ転送と帯域幅に関する考慮事項

リモート ランタイム コンポーネントをインストールすると、ファイアウォール ルールを作成しなくてもオートメーション プロジェクトを作成できます。

リモート ランタイムと拡張機能間のデータ転送では、帯域幅をほとんど使用する必要はありません。たとえば、ロボットが実行する各操作 ([クリック] アクティビティなど) は、約 3 KB のデータを転送します。

サイドバイサイドのサポート

UiPath リモート ランタイム コンポーネントは、v2018.4 で初めて導入されました。後方互換性を確保するために、新しいバージョンの Robot (v2019.10.1 の Robot など) では、UIAutomation パッケージのバージョン 18.4.5 以降で作成したプロセスを問題なく実行できます。

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

プロセスを構築するか実行する場合、UiPath リモート ランタイムのデプロイされたドライバーのバージョンに対応する UiPath.UIAutomation.Activities パッケージを使用する必要があります。ドライバーは UiPath.UIAutomation.Activities パッケージの UiPath 依存関係で表されます。
This page displays which UiPath.UIAutomation.Activities package contains compatible driver versions for the UiPath Remote Runtime.

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

上記の UiPath 依存関係の 1 つを含んでいない UiPath.UIAutomation.Activities パッケージのバージョンを使用している場合、以下に示すようにセレクターが生成されず、例外がスローされます。

400400

リモート ランタイム依存関係の追加

UiPath.UIAutomation.Activities が Citrix Application サーバーまたはリモート デスクトップ マシン上の UiPath リモート ランタイムの依存関係と一致しない限り、ターゲット アプリケーションで対話的に選択しても正しいセレクターは構築されません。

たとえば、UiPath.UIAutomation.Activities パッケージのバージョン 19.6.0 を使用してオートメーション プロジェクトを構築する場合、Citrix Application サーバー上の (Studio がインストールされている) クライアント マシンまたはリモート デスクトップ マシンから対応する UiPath 依存関係をコピーする必要があります。これは、次の手順で行います。

  1. On the client machine (where Studio is installed), navigate to the %UserProfile%\.nuget\packages\uipath folder. All installed UiPath dependencies are located there.
  2. 使用する UiPath.UIAutomation.Activities パッケージに対応したバージョンをコピーします。UiPath.UIAutomation.Activities パッケージに同梱される依存関係のリストは、このページで確認できます。
  3. On the Citrix Application server or the Remote Desktop machine, navigate to the %ProgramFiles%\UiPath\RemoteRuntime\packages\uipath folder and paste the previously copied UiPath dependency version here.

現在のバージョンの UiPath.UIAutomation.Activities でセレクターが適切に生成されるようになりました。変更は、依存関係がコピーされるとすぐに有効になります。

ハードウェアおよびソフトウェアの要件

The UiPath Remote Runtime has the same requirements as the UiPath Robot. See the full list of requirements here.

約 1 か月前に更新

UiPath リモート ランタイムについて


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。