Robot Executor

UiPath Executor を構成および管理します。Robot コンポーネントは、独立したセッションでオートメーション ワークフローを実行するロボット コンポーネントです。

UiPath Executor is a component of the UiPath software structure that is used to run automations or jobs. It is the component that actually executes the automation workflows, and you can identify it in the list of running processes as UiPath.Executor.exe.

動作のしくみ

オートメーションのライフサイクルでは、Executor は実行段階に相当します。

1. 設計段階 — Studio で設計および作成したオートメーション ワークフローが Orchestrator にパブリッシュされます。
2. Orchestrator の段階 — Orchestrator は、ロボットによって実行される操作を管理、制御し、ログに記録するコンポーネントです。ここで、ジョブをスケジュールしたり、オンデマンドで実行したりできます。
3. 実行段階 — タスクがスケジュールまたはトリガーされると、Orchestrator は Robot サービスにコマンドを送信します。続いて、Robot サービスが UiPath Executor のインスタンスを起動して、オートメーション タスクを実行します。各インスタンスは独立したセッションで動作するため、あるタスクが失敗しても他のタスクは影響を受けません。
4. 実行後段階 — タスクが完了すると、Executor インスタンスは終了され、結果が Orchestrator に返されます。実行時間、ステータス (成功または失敗)、例外などの詳細がログに記録されます。この詳細を分析して、トラブルシューティングやプロセスの改善を行うことができます。

機能

Executor には次のような機能があります。

• ローカルまたはリモートのタスクを実行する — UiPath Executor は、Robot サービスがインストールされているローカル デバイス内でタスクを実行することも、他のデバイスにリモートで接続してそこでタスクを実行することもできます。
• 複数のジョブを同時に実行する — Executor は複数のオートメーションを同時に実行できます。各オートメーションは独立したセッションとして動作します。
• 負荷分散とタスクの優先順位付け — Executor は、UiPath Orchestrator と連携してオートメーションの負荷を複数のロボット間で分散したり、あらかじめ定義されたルールに基づいてタスクに優先順位を付けたりできます。
• ワークフローの分離を維持する — Executor での各実行は分離されています。つまり、あるジョブでエラーや失敗が発生しても他のジョブのパフォーマンスには影響しません。
  注:

  Executor はさまざまな DPI 設定に適合するので、どのような解像度でもワークフローを実行できます。一部のアプリケーションで DPI を処理できない場合は、この特定の機能を無効化できます。

オートメーション プロジェクトに基づく Executor の種類

Robot サービスは、オートメーション プロジェクトの種類に基づいて、オートメーションを実行する、関連する Executor の種類を起動します。次の表は、使用されるターゲット フレームワークに基づいて、Executor が実行できるプロジェクトの種類をまとめたものです。

プロジェクト/Executor の種類	アーキテクチャ	サポートされる OS	使用されるフレームワーク
Windows - レガシ	32 ビット	Windows (x64 および x86)	.NET Framework 4.7.2
Windows	64 ビット	Windows x64	.NET 10 with Windows support (.NET Core - Windows)
クロスプラットフォーム	64 ビット	Windows, Linux (64-bit)	.NET 10 with cross-platform support (.NET Core)

表の各行は異なる Executor の種類を表しており、そのそれぞれが、プロジェクトを実行するために特定の要件 (プロジェクトの種類、ターゲット オペレーティング システム、使用される .NET Framework バージョン) に基づいてどのように構成されるかを示しています。この情報によって各プロジェクトにどの Executor が適しているかを理解することで、ターゲット環境との互換性を確保し、関連するフレームワークの機能を活用できます。

The Executor and executor packages

The Executor is the .NET executor of Unified Runtime, and runs RPA processes and test cases. By default, agents, functions, and API workflows don't run in UiPath.Executor.exe. They run in executor packages, in a separate host process that the Robot Service starts. The settings on this page, such as preloaded executors, Medium+ integrity, and UIPATH_HEADLESS_WITH_USER, apply to the Executor only.

Executor のユーザー設定

The Executor has a dedicated system variable UIPATH_HEADLESS_WITH_USER, which you can configure depending on the type of user that runs the automation.

When the user is Local Service, you can run background automations. Here, the setting for UIPATH_HEADLESS_WITH_USER should either be Falseor not set at all.

When the user running the automation has credentials specified in Orchestrator, there are two scenarios you should consider:

• For background automations, the UIPATH_HEADLESS_WITH_USER setting should be True.
• For foreground automations, there should be no UIPATH_HEADLESS_WITH_USER variable set.

次の表は、Executor のユーザーの条件をまとめたものです。

ユーザーの種類	オートメーションの種類	UIPATH_HEADLESS_WITH_USER 設定
Local Service	バックグラウンド	False または null
Orchestrator で構成されたユーザー	バックグラウンド	True
	フォアグラウンド	変数は不要

事前読み込み済みの Executor

Usually, each process requires time to load the required workflow, packages, and libraries into memory before it can start processing. In a preloaded setup, those dependencies are already loaded into memory, in dedicated execution slots. A preloaded executor is enabled by default in User Mode. Preloaded executors exist only in User Mode: in Service Mode, the Robot doesn't start them, and the variables below have no effect.

以下に、事前読み込み済みの Executor に関する重要な詳細を示します。

• 高速な実行: プロセスを事前に読み込むことで、ロボットはより迅速にタスクでの作業を開始できます。
• リソース使用率: 事前読み込み済みの Executor では、必要なワークフローがメモリに読み込み済みであるため、ロボットが消費するリソースが減ります。
• 利用可能な用途: 事前読み込み済みの Executor は、主に Assistant、RobotJS、Studio、またはコマンド ライン インターフェイスから開始される有人オートメーション用に設計されています。Orchestrator の無人ジョブの場合は、事前読み込み済みではない Executor が 1 つ開始されます。

事前読み込み済みの設定用のシステム変数

You can manage the behavior of preloaded executors by setting specific environment variables on the robot machine, as follows. They apply to User Mode robots only:

Environment Variable (環境変数)	値 (Value)	説明
UIPATH_PRE_LOADED_EXECUTOR	なし	既定の動作を上書きし、最初のジョブの開始時にのみ、事前読み込み済みの Executor を起動します。
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	True	事前読み込み済みの Executor を無効化します。

動作のしくみ

システムに UIPATH_PRE_LOADED_EXECUTOR 変数を追加すると、事前読み込み済みの設定が構成されます。これにより 2 つの Executor が開始されます。1 つはジョブの開始時に開始され、もう 1 つは今後のジョブを待機します。これが事前読み込み済みの Executor です。別のジョブが開始されると、この事前読み込み済みの Executor が使用され、次のジョブを待機するために別の事前読み込み済みの Executor が生成されます。つまり、事前読み込み済みの設定では、ジョブを待機している利用可能な Executor が常に 1 つ存在します。

事前読み込み済みの Executor とオペレーティング システム

For Windows devices, when UiPath.Service.UserHost.exe starts in User Mode, it launches two preloaded executors: one for Windows projects, and another for Windows-Legacy projects.

中+ の整合性への昇格

一部の Windows アプリケーションは、標準のユーザー セッションよりも高い整合性レベルで実行されます。一般的な例の 1 つは Windows CredentialBroker ダイアログです。これは、リモート デスクトップ (RDP) セッションに接続するためにユーザー名とパスワードを入力する際に表示されます。CredentialBroker は中+ の整合性で実行されるため、Executor は既定では CredentialBroker と対話できず、オートメーションはダイアログへの資格情報の入力に失敗します。

Executor でこのようなウィンドウを自動化できるようにするには、 UIPATH_MEDIUMPLUS_EXECUTOR マシン (システム) 環境変数を 1に設定します。この変数を設定すると、Robot サービスは Executor を中+ の整合性レベルで起動するので、Executor が他の方法ではアクセスできないウィンドウと対話できるようになります。

また、Executor 全体ではなく特定の呼び出しのみを昇格させるには、 UIPATH_MEDIUMPLUS_INVOKE マシン (システム) 環境変数を 1に設定します。この変数を有効化すると、[ ワークフロー ファイルを呼び出し ] アクティビティと [ プロセスを呼び出し ] アクティビティは、呼び出しごとに中+ の整合性レベルで実行できます。オートメーションの残りの部分は標準の整合性レベルのままにします。

昇格は、昇格を要求した呼び出しにのみ適用されます。また、アクティビティの昇格オプションも有効化する必要があります。変数だけでは何も昇格されません。

昇格オプションには UiPath.System.Activities 26.6.0 以降が必要です。[ ワークフロー ファイルを呼び出し ] では、ワークフローが分離して呼び出されている場合にのみ適用されます。UIPATH_MEDIUMPLUS_EXECUTORと同様に、この機能は Windows 専用であり、UAC を有効にする必要があります。

要件

• Windows only — this feature is not available on Linux.
• UAC を有効化する必要がある — 昇格が可能かどうかは、マシン上でユーザー アカウント制御がアクティブになっていることに依存します。UAC が無効化されている場合、変数は無視され、Executor は既定の整合性レベルで起動します。
• インストール モード — Robot は、マシン単位のインストール (Program Files にインストール) を使用して、サービス モードまたはユーザー モードでインストールする必要があります。ユーザー単位のインストールでは中+ への昇格はサポートされません。
• マシンレベルの変数 — 有人オートメーションと無人オートメーションの両方で、変数をマシン (システム) 環境変数として設定する必要があります。ユーザー レベルの変数は効果がありません。昇格は、変数がマシン レベルで設定されている場合にのみ有効になります。

有効化する方法

1. ロボット端末で [システムのプロパティ] > [環境変数] を開きます。
2. [ システム変数 ] セクションで、[ 新規] を選択します。変数はマシン (システム) レベルで設定する必要があります。ユーザー レベルの変数は無効です。
3. 変数名を UIPATH_MEDIUMPLUS_EXECUTOR に、値を 1 に設定します。
4. [OK] を選択して変数を保存します。
5. 変更を反映するために、Robot サービスを再起動します。

結果

中+ への昇格を有効化すると、オートメーションは CredentialBroker ダイアログや、中+ の整合性が必要なその他のウィンドウを操作できるようになります。UIPATH_MEDIUMPLUS_EXECUTORを設定すると、Executor はオートメーション全体に対して管理者特権で実行されます。UIPATH_MEDIUMPLUS_INVOKEを設定すると、昇格を要求する呼び出しのみが管理者特権で実行されます。Executor が昇格したレベルで起動できない場合 (たとえば、UAC が無効化されている場合)、Executor は既定の整合性レベルにフォールバックして警告をログに記録します。