通知を受け取る

UiPath Studio

UiPath Studio ガイド

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

UiPath リモート ランタイムは、Citrix Virtual Apps などのリモート アプリケーションまたはデスクトップと、専用の 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.

UiPath リモート ランタイム コンポーネントをインストールすると、タスク スケジューラにタスクが登録され、ユーザーのログインごとに UiPathRemoteRuntime.exe プロセスが開始されます。

1562

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

タスク スケジューラー

既定では、UiPath リモート ランタイム コンポーネントは、Windows のタスク スケジューラーにエントリを作成し、該当するユーザーがログインするたびに、自動的に起動します。この機能は、UiPathRemoteRuntime.msi インストーラーの [UiPath リモート ランタイムを起動するタスクを作成] オプションによって指定します。この機能は、必要に応じて無効化できます。

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

UiPath リモート ランタイムをインストールする

インストーラーの場合

  1. UiPathRemoteRuntime.msi ファイルを実行して UiPath リモート ランタイムをインストールします。オートメーション プロジェクトを作成するすべての Citrix Application Server、VMware Horizon Server、または Windows リモート デスクトップ マシンにインストールする必要があります。
  2. クライアント マシン上の現在の Citrix ウィンドウ、VMware Horizon ウィンドウ、または RDP セッションからログオフして、ログインし直します。これは、変更を反映させるために必要な操作です。
  3. オートメーション プロジェクトの作成に使用するテクノロジーに合わせて、UiPath Citrix 拡張機能UiPath VMware Horizen 拡張機能、または UiPath Windows リモート デスクトップとアプリ拡張機能をクライアント マシンにインストールします。

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

618

リモート ランタイムのタスク スケジューラーのエントリは、いつでも追加または削除できます。UiPathRemoteRuntime.msi インストーラーを実行し、対応するオプションを選択するだけです。

550

コマンド プロンプトから

📘

注:

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

  1. Windows のスタートボタンをクリックし、検索フィールドに「cmd」と入力します。
  2. [コマンド プロンプト] を右クリックし、管理者として実行します。
  3. ディレクトリを UiPathRemoteRuntime.msi フォルダーに変更します (例: cd C:\Tools\Studio)。
  4. UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask コマンドを使用して、UiPath リモート ランタイムをインストールします。
  5. クライアント マシン上の現在の Citrix ウィンドウ、VMware Horizon ウィンドウ、または RDP セッションからログオフして、ログインし直します。これは、変更を反映させるために必要な操作です。
  6. オートメーション プロジェクトの作成に使用するテクノロジーに合わせて、UiPath Citrix 拡張機能UiPath VMware Horizen 拡張機能、または UiPath Windows リモート デスクトップとアプリ拡張機能をクライアント マシンにインストールします。

さらに、以下の例に示すように、引数 RemoteRuntimeTaskJavaBridgeChromeExtensionEdgeChromium、または CitrixClient を使用してタスク スケジューラのエントリと、Java、Chrome、Microsoft Edge、または Citrix 用の拡張機能をインストールできます。

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

また、/quiet パラメーターを使用してサイレント インストールを実行することもできます。

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

UiPath リモート ランタイムは、APPLICATIONFOLDER オプションを使用して任意の場所にインストールできます。

  • UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – リモート ランタイム コンポーネントを D:\UiPathRemoteRuntime にサイレント モードでインストールし、タスク スケジューラのエントリを追加します。

これで、標準マシンの場合と同様に、Citrix Virtual Apps and Desktops、VMware Apps、および RDP 接続での自動化プロセスを作成できるようになりました。対応する拡張機能があるため、UI 要素を適切に識別するために OCR アクティビティや画像認識アクティビティを使用する必要はありません。要素はネイティブに認識され、すべてのアクティビティで使用できます。

UIAutomation との依存関係

UiPath リモート ランタイムには UiPath.UIAutomation.Activities パッケージのバージョンとの依存関係があり、UiPath Studio/Robot のバージョンには依存していません。

リモート マシンにインストールされているリモート ランタイムは、プロジェクトで使用する UIAutomation アクティビティ パッケージの最新のバージョンを使用している必要があります。これは以前のバージョンにも対応しています (後方互換性があります)。

UiPath.UIAutomation.Activities パッケージと UiPath リモート ランタイムは、同じ UiPath ドライバーに依存しています。UIAutomation パッケージのリリース バージョンごとに、同じバージョン番号の UiPath リモート ランタイム コンポーネントのダウンロード リンクが提供されます。

UiPathRemoteRuntime.msi インストーラーは以下の場所からダウンロードできます。

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

UiPath リモート ランタイム コンポーネントは、Citrix Application Server、VMware Server、またはリモート デスクトップ マシンの %ProgramFiles(x86)\UiPath フォルダーにインストールされます。インストールされたすべてのバージョンが %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath フォルダーに表示されます。

プロセスを構築または実行する際は、UiPath リモート ランタイムのデプロイされたドライバーのバージョンに対応する UiPath.UIAutomation.Activities アクティビティ パッケージを使用する必要があります。

UiPath.UIAutomation.Activities アクティビティ パッケージの UiPath ドライバーの依存関係のバージョンは、Studio の [パッケージを管理] 画面の情報セクションに表示されます。

372

これと同じ UiPath のバージョンが、リモート マシンの %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath フォルダーに存在する必要があります。

752

UiPathRemoteRuntime.msi の各インストーラーには、最新の UiPath 依存関係のほか、サポート対象の最新のロング ターム サポート (LTS) の UiPath 依存関係も含まれています。

下表には、UiPath.UIAutomation.Activities パッケージと UiPath リモート ランタイム間の依存関係が記載されています。

UIAutomation package versionUiPathRemoteRuntime build numberUiPath driver dependencyUIAutomation compatible versions for UiPathRemoteRuntime
22.10.522.10.52.889222.10.52.889222.10.5
22.4.8
21.10.8
20.10.13
19.11.5
18.4.8
22.10.322.10.46.4763522.10.46.4763522.10.3
22.4.7
21.10.7
20.10.12
19.11.5
18.4.8
22.4.822.4.52.1140522.4.52.1140522.4.8
21.10.8
20.10.13
19.11.5
18.4.8
22.4.722.4.42.6195122.4.42.6195122.4.7
21.10.7
20.10.12
19.11.5
18.4.8
21.10.821.10.49.1343621.10.49.1343621.10.8
20.10.13
19.11.5
18.4.8
21.10.721.10.42.6490521.10.42.6490521.10.7
20.10.12
19.11.5
18.4.8
20.10.1320.10.8363.3284920.10.8363.3284920.10.13
19.11.5
18.4.8
20.10.1220.10.8242.2323820.10.8242.2323820.10.12
19.11.5
18.4.8
19.11.519.10.7601.1536919.10.7601.1536919.11.5
18.4.8
18.4.810.0.7772.1918410.0.7772.1918419.11.5
18.4.8

リモート ランタイムのビルド番号は、UiPathRemoteRuntime.msi ファイルの [プロパティ][詳細] タブの [コメント] フィールドで確認できます。

540

インストールされている、リモート マシン上の UiPath 依存関係のセットに含まれない UiPath 依存関係を持つ UiPath.UIAutomation.Activities パッケージのバージョンを使用する場合、セレクターは生成されず、「UiPath.UIAutomation.Activities パッケージは、サーバーで実行されている UiPath リモート ランタイムに対応していません。」という例外がスローされます。

リモート ランタイム依存関係を追加する

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

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

  1. クライアント マシン (Studio がインストールされている場所) で、%UserProfile%\.nuget\packages\uipath フォルダーに移動します。インストール済みの UiPath の依存関係はすべてここにあります。
  2. 使用する UiPath.UIAutomation.Activities パッケージに対応するバージョンをコピーします。UiPath.UIAutomation.Activities パッケージに含まれる依存関係のリストは、「UIAutomation アクティビティについて」か Studio の [パッケージを管理] から確認できます。
  3. Citrix Application サーバー、VMware サーバー、またはリモート デスクトップ マシンで、%ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath フォルダーに移動し、前の手順でコピーした UiPath 依存関係のバージョンを貼り付けます。

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

上記のリモート ランタイムの依存関係は、設計時と実行時の両方で必要です。

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

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

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

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

752

複数の ICA チャネル

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

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

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

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

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

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

4 日前に更新

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


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

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