- 基本情報
- ベスト プラクティス
- テナント
- レジストリ
- Cloud ロボット
- Automation Suite ロボット
- フォルダー コンテキスト
- プロセス
- ジョブ
- Apps (アプリ)
- トリガー
- ログ
- 監視
- インデックス
- キュー
- アセット
- コネクション
- ビジネス ルール
- ストレージ バケット
- MCP サーバー
- Orchestrator のテスト
- リソース カタログ サービス
- Integrations
- トラブルシューティング
Orchestrator ユーザー ガイド
利用可能な機能は、使用するクラウド製品によって異なります。詳しくは、「 機能の提供状況」をご覧ください。
ジョブとは、UiPath Robot でプロセスを実行することです。ジョブの実行は Attended または Unattended のいずれかのモードで開始できます。デバッグまたは開発を目的とした場合を除き、Attended ロボットでのジョブは Orchestrator から開始できません。
Attended ジョブは、UiPath Assistant またはロボットのコマンド ライン インターフェイスからトリガーできます。Unattended ジョブは Orchestrator から開始されます。[ジョブ] ページまたは [プロセス] ページからその場で直接開始されるか、[トリガー] ページのトリガーを使用してあらかじめ設定された方法で開始されます。
[ジョブ] ページはジョブのコントロール センターです。このページでは、開始されたジョブの監視、それらの詳細情報とログの表示、ジョブの停止/強制終了/再開/再実行が可能です。
次の表に、[ジョブ] ページのフィールドの説明を示します。
一部のフィールドは、すべてのジョブの種類には関係しません。[ ジョブ ] ページに、特定のジョブの種類に適用されないフィールドがある場合、その値は、該当する種類のジョブに対して 「該当なし 」と表示されます。
| フィールド | 説明 |
|---|---|
| プロセス | プロセスの名前です。 [Remote debugging job] は、リモート デバッグ セッションを通じて Studio から開始されたジョブに対して表示されます。 |
| 実行の種類 | 実行の種類は、実行が行われる場所と、ロボットがユーザーを偽装するかどうかで異なります。
|
| ステート | ジョブのステートです。詳細は、ジョブのステートの説明をご覧ください。 |
| Healing Agent | ジョブの実行中に Healing Agent によって問題が検出されたかどうかを以下のいずれかで示します。
|
| 開始 | ジョブの実行が開始されてからの相対的な経過時間です。このフィールドにカーソルを置くと、正確な開始日時が表示されます。 |
| 終了 | ジョブの実行が完了してからの相対的な経過時間です。このフィールドにカーソルを置くと、正確な完了日時が表示されます。 |
| 開始時刻 (絶対時間) (*) | ジョブの実行が開始されてからの絶対的な経過時間です。絶対時間のタイムスタンプはテナントのタイム ゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイム ゾーンで表示さるため、テナントのタイム ゾーンと異なる場合があります。 |
| 終了時刻 (絶対時間) (*) | ジョブの実行が完了してからの絶対的な経過時間です。絶対時間のタイムスタンプはテナントのタイム ゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイム ゾーンで表示さるため、テナントのタイム ゾーンと異なる場合があります。 |
| Duration | ジョブの実行時間です。ジョブの開始時刻から、ジョブが最終ステートに達した時刻までの間隔として計算されます。 |
| ソース | 実行のエージェントです。
|
| 作成時刻 (*) | ジョブ作成の相対的な時間です。 |
| 作成時刻 (絶対時間) (*) | ジョブ作成の絶対的な時間です。 |
| 優先度 | ジョブの優先度です。詳細は、「ジョブの優先度の説明をご覧ください。 |
| ユーザーの操作 | 基になるプロセスがユーザーの操作を必要とするかどうかを指定します。
|
| マシン (*) | 実行インフラストラクチャを Orchestrator に接続するために使用されたマシン オブジェクトです。 |
| ホスト名 (*) | 実行に使用されたワークステーションの名前です。 |
| ホスト ID (*) | 実行に使用される ID です。以下の値が表示されます。
domain\username を変更すると、ホスト ID も変更されます。
|
| ランタイムの種類 | 実行に使用されるランタイムの種類です。 |
(*) 既定ではジョブ グリッドに表示されない列です。これらの列は [列] ドロップダウンから選択します。
アカウントとマシンのマッピング
ジョブを開始またはトリガーを定義するときに、実行の対象となる特定のアカウントとマシンのペアを定義できます。アカウントとマシンのマッピングでは、特定のアカウントによるプロセスの無人実行を特定のマシン テンプレートに関連付けることができます。これにより、オートメーションの実行ターゲットをきめ細かく制御できます。アカウントとマシンのマッピングは、テナントベース (特定のフォルダーに関連付けられていない) またはフォルダーベース (特定のフォルダーに関連付けられている) で実行されます。
アカウントとマシンのマッピングの設定方法について詳しくは、こちらをご覧ください。
実行ターゲット
Orchestrator でジョブを開始するメカニズムに従って、ジョブの割り当て方法と実行ターゲットを暗黙的に選択して設定できます。ここでは、[ジョブ] ページからジョブを開始する際に使用できる割り当て方法と実行ターゲットについて説明します。
トリガーの実行ターゲットについては、こちらをご覧ください。
When an execution target is configured through bindings (for example, when a parent automation invokes another process), select Inherit parent job identity (previously Run as Myself) to run the invoked job under the identity of the parent job. This option is available for both background and Windows (foreground) automations. For Windows automations, the parent job identity must have an unattended robot with credentials configured, otherwise the invoked job fails to start.
ジョブの実行が特定のリソースに依存しており、そのリソースがまだ利用できない場合、ジョブの実行条件が満たされるまでの間、そのジョブは [保留中] ステートに留まります。 たとえば、ユーザー U1 は資格情報 C1 を使用してホスト名 H1 に接続します。しかし、ホスト名に接続するための資格情報として、誤って C2 が入力されているとします。その場合、ジョブは保留ステートに入ります。その後資格情報を正しいもの (C1) に更新すると、ジョブの実行は再開されます。
ジョブの実行中にロボットが応答しなくなった場合 (ロボットのマシンがダウンした場合や、Robot サービスがクラッシュした場合)、再接続した後、クラッシュ時に実行中だったジョブを再実行します。
図 1. ジョブを開始する
1. 動的に割り当て
アカウントとマシンが明示的に選択されていない動的割り当てでは、最初に利用可能になったアカウントとマシンで、フォアグラウンド プロセスを複数回実行できます。バックグラウンド プロセスは、ビジーであるかどうかにかかわらず、任意のアカウントによって実行されます (十分な数のランタイムがある場合)。
[動的に割り当て] オプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。
2. 有効なアカウントとマシンのマッピングを選択
選択したジョブを実行する特定のアカウントとマシンのペアを指定できます。
図 2. [実行ターゲット] タブ
複数のジョブを一度に実行するには、ペアごとに 1 回ずつ [アカウントとマシンのマッピングを追加] をクリックして、表示されるドロップダウン リストから目的の項目を選択します。
完了すると、アカウントとマシンのペアごとに保留中のジョブが作成されます。
これは、テナント設定の [全般] タブで [ユーザーとマシンのマッピングを有効化] オプションが選択されている場合にのみ機能します。
3. アカウント
プロセスは、特定のユーザーまたはロボットのアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
4. マシン
プロセスは、選択したマシン テンプレートに接続されたホスト マシンのいずれかで実行されます。テンプレートを指定すると、[ホスト名] オプションが追加で表示され、接続済みのホスト マシンのプールから特定のホスト マシンを選択できます。マシンのみを指定すると、Orchestrator によりアカウントが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。
5. ジョブの実行の終了に関するスケジュールを設定する
プロセスの実行時に障害が発生し、ジョブが保留ステートのままになってしまうことがあります。このトグルを使用すると、ジョブが停止または強制終了されるまでの経過時間を指定して、ジョブの停止方法を自動化できます。ジョブを停止できない場合のために、ジョブの強制終了のオプションが用意されています。
6. ジョブの再開時にアカウントとマシンの割り当てを維持する
プロセスの実行を再開する場合、既定では利用可能な任意のマシン上の、利用可能な任意のロボットが使用されます。同じアカウントとマシンの組み合わせを維持することで、最適なリソース使用とライセンス要件が保証されます。
対応するマシン テンプレートが割り当てられたフォルダーに属する、ホスト マシン上の各アカウントに対して、Windows のユーザーをプロビジョニングする必要があります。 たとえば、マシン テンプレート FinanceT によって生成されたキーを使用して、サーバーを Orchestrator に接続したとします。このマシン テンプレートは、FinanceExecution フォルダーと FinanceHR フォルダーに割り当てられ、これらのフォルダーには 6 つのアカウントも割り当てられます。これら 6 つのアカウントは、サーバー上の Windows ユーザーとしてプロビジョニングされている必要があります。
同じプロセスを複数回実行するようにジョブを設定した場合、各実行に対してジョブ エントリが作成されます。ジョブの順序はジョブの優先度と作成時刻によって決まり、より高い優先度のより古いジョブが待ち行列の先頭に配置されます。ロボットが使用可能になり次第、待ち行列内の次のジョブが実行されます。それまでの間、ジョブは保留ステートのままです。
例
セットアップ
- 1 フォルダー
- 2 ランタイムが設定された 1 つのマシン テンプレート
- アカウント 2 つ: john.smith と petri.ota
- ユーザーによる操作が必要なプロセス 2 つ: P1 - キューにキュー アイテムを追加します。P2 - キュー内のアイテムを処理します。マシン テンプレートとアカウントを、プロセスが含まれるフォルダーに関連付ける必要があります。
望ましい結果
- P1 は任意のユーザーにより高優先度で実行される。
- P2 は petri.ota により低優先度で実行される。
必要なジョブ設定
- P1 を使用してジョブを開始します。P1 は特定のアカウントには割り当てません。また、優先度は [高] に設定します。
- P2 のジョブを開始します。P2 は petri.ota に割り当てます。また、優先度は [低] に設定します。
実行優先度
競合するジョブのうちどれを優先させるかは、プロセスのデプロイ時またはそのプロセスのジョブ/トリガーの設定時に、[ジョブの優先度] フィールドで指定できます。ジョブには、次の 10 個の優先度を設定できます。
図 3. 実行優先度
Orchestrator では、次の一連のステップに従ってジョブが割り当てられます。
- ロボットが新しいジョブを実行できるようになります。
- Orchestrator は、そのロボットに割り当てられたマシン テンプレートと、テンプレートに関連付けられたすべてのフォルダーを識別します。
- Orchestrator は、フォルダー内のすべての保留中のジョブを評価します。
- Orchestrator は、優先度が最も高いジョブをロボットに割り当てます。優先度が同じジョブが複数ある場合は、古いものから新しい順にロボットに送信します。
ただし、マシン テンプレートと高密度マシンでは、複数のフォルダーのジョブを同時に実行できます。
ジョブを手動で開始する
[ジョブの優先度] フィールドの既定値は [継承] です。つまり、優先度は、最初の設定が継承されます。その設定をそのまま使用することも、変更することもできます。
- 場所: [オートメーション] ページ > [ジョブ]
ジョブはプロセス レベルで設定された優先度を継承します。
- 場所: [オートメーション] ページ > [トリガー]
トリガーの優先度が [継承] の場合、ジョブはプロセス レベルで設定された優先度を継承します。
トリガーの優先度が [継承] と異なる場合、ジョブはトリガー レベルで設定された優先度を継承します。[継承] に変更すると、プロセス レベルで設定された優先度が使用されます。
- 場所: [オートメーション] ページ > [プロセス]
ジョブはそのプロセスに設定された優先度を継承します。
同じプロセスを複数回実行するようにジョブを設定した場合、各実行に対してジョブ エントリが作成されます。ジョブの順序はジョブの優先度と作成時刻によって決まり、より高い優先度のより古いジョブが待ち行列の先頭に配置されます。ロボットが使用可能になり次第、待ち行列内の次のジョブが実行されます。それまでの間、ジョブは保留ステートのままです。
トリガーによるジョブの開始
優先度は既定で [継承] に設定されます。つまり、プロセス レベルで設定された値を継承します。プロセスを選択すると、矢印のアイコンが、プロセス レベルで設定された値を示すよう自動的に更新されます。トリガーによって起動されたジョブの優先度は、すべてトリガー レベルで設定されます。ただし、既定の [継承] をそのまま使用した場合、それらのジョブはプロセス レベルで設定された優先度で起動されます。
以後にプロセス レベルで加えられた変更は、トリガーと、そのプロセスで作成されたジョブに、暗黙的に伝播されます。
API を使用してジョブの優先度を設定する
インターフェイスで利用可能な 10 個の優先度レベルは、API の 100 個のレベルに対応しています。つまり、API では優先度をさらにきめ細かく設定できます。これらのレベルは、次のようにマッピングされます。
| 最小 | 最大値 | 既定 (Default) | |
|---|---|---|---|
| 最低 | 1 | 10 | 5 |
| 非常に低い | 11 | 20 | 15 |
| 低 (Low) | 21 | 30 | 25 |
| やや低い | 31 | 40 | 35 |
| 中 | 41 | 50 | 45 |
| やや高い | 51 | 60 | 55 |
| 高 (High) | 61 | 70 | 65 |
| 非常に高い | 71 | 80 | 75 |
| 最高 | 81 | 90 | 85 |
| Critical | 91 | 100 | 95 |
ジョブの優先度を設定または変更するには、SpecificPriorityValue パラメーターを使用します。このパラメーターは、以下のエンドポイントで使用できます。
POST/odata/Jobs/UiPath.Server.Configuration.OData.StartJobsPOST/odata/ProcessSchedulesPUT/odata/ProcessSchedules({key})
たとえば、ジョブが 2 つあり、それぞれに優先度 92 と 94 を設定するとします。どちらのジョブも [緊急] の範囲内に収まりますが、優先度 94 のジョブが優先度 92 のジョブより先に実行されます。
Windows Server 上で実行されていない同じマシンで、複数のロボットでユーザーの介入が必要なジョブを 1 つ開始した場合は、選択したプロセスが 1 つ目のロボットでのみ実行され、残りは失敗します。これらの各実行のインスタンスは [ジョブ] ページで作成され、表示されます。
高密度ロボットによるジョブ
同じ Windows Server 端末において、複数の高密度ロボットでジョブを開始した場合、選択したプロセスが指定したそれぞれのロボットによって同時に実行されることになります。これらの各実行のインスタンスは [ジョブ] ページで作成および表示します。
高密度ロボットを使用し、そのマシン上で RDP を有効化しない場合は、ジョブを開始するたびに、次のエラーが表示されます: 「A specified logon session does not exist.すでに終了している可能性があります。」高密度ロボットの設定方法については、「 高密度ロボット用の Windows Server を設定する」 をご覧ください。
レコーディング
Unattended で失敗したジョブにおいて、プロセスの [記録機能を有効化] オプションがオンになっている場合、対応する実行メディアをダウンロードして、失敗する前の実行の最後の瞬間を確認できます。
実行メディアに関する [表示] 権限を持っている場合は、[ジョブ] ウィンドウに [記録をダウンロード] オプションが表示されます。