orchestrator

2024.10

true

Orchestrator ユーザーガイド

デリバリー:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 2024年11月13日

ジョブについて

注: ジョブをマスターするには、まずプロセスを使用するためのコツをつかむ必要があります。ランタイム引数、プロセスの種類、プロセスの互換性について学んでください。

ジョブとは、UiPath Robot でプロセスを実行することです。ジョブの実行は Attended または Unattended のいずれかのモードで開始できます。デバッグまたは開発を目的とした場合を除き、Attended ロボットでのジョブは Orchestrator から開始できません。

Attended ジョブは、UiPath Assistant またはロボットのコマンドラインインターフェイスからトリガーできます。Unattended ジョブは Orchestrator から開始されます。[ジョブ] ページまたは [プロセス] ページからその場で直接開始されるか、[トリガー] ページのトリガーを使用してあらかじめ設定された方法で開始されます。

[ジョブ] ページはジョブのコントロールセンターです。このページでは、開始されたジョブの監視、それらの詳細情報とログの表示、ジョブの停止/強制終了/再開/再実行が可能です。

以下の表に、[ジョブ] ページのフィールドの説明を示します。

フィールド	説明
プロセス	プロセスの名前です。リモートデバッグセッションにより Studio から開始されたジョブは `[Remote debugging job]` と表示されます。
マシン (*)	実行インフラストラクチャを Orchestrator に接続するために使用されたマシンオブジェクトです。
ホスト名	実行に使用されたワークステーションの名前です。
ホスト ID	実行に使用される ID です。以下の値が表示されます。 `<Domain\Username>` - その特定のアカウントで実行されたジョブです。次のようなジョブに対して表示されます。フォアグラウンドジョブ (Robot のバージョンは関係なし) 2021.10 より前のロボットで実行された、すべてのジョブマシンキーを使用してユーザーのサインインなしで接続されたロボットで実行された Attended ジョブ 2021.10 より前のロボットの場合、ホスト ID の値は Orchestrator で行ったアカウント設定に従い動的に設定されます。ジョブの実行に使用するアカウントの `domain\username` を変更すると、ホスト ID も変更されます。 `ROOT` - Linux ロボットで実行されたバックグラウンドジョブです。 `NT AUTHORITY\LOCAL SERVICE` - Robot サービス ID で実行されたジョブです。資格情報なしで v2021.10 以降の Robot で実行されたバックグラウンドジョブに対して表示されます。サービスモードの Robot は `NT AUTHORITY\LOCAL SERVICE` で実行されます。ユーザーモードの Robot は、いずれかのユーザー ID で実行されます。 `N/A` - 対話型サインインで接続したユーザーにより Assistant から開始されたジョブです。ユーザーのサインインなしで、マシンキーを使用してて接続されたロボットの場合は <ドメイン\ユーザー名> が表示されます。
ジョブの種類	実行場所およびロボットによるユーザー偽装の有無によって決まる、ジョブの種類です。サービス (無人) - サーバーで実行され、ロボットがユーザーを偽装していないジョブです。ジョブは Orchestrator から起動されます。個人 (リモート) - サーバーで実行され、ロボットが個人用ワークスペースの所有者の ID を使用して実行されているジョブです。ジョブは Orchestrator から起動されます。 Attended - ユーザーの個人用マシンで実行されているジョブです。ジョブは Assistant から起動されています。 Development - サーバーで実行されているジョブです。ジョブはリモートデバッグを使用して Studio から起動されています。
ランタイムの種類	実行に使用されるランタイムの種類です。
ステート	ジョブのステートです。詳細は、ジョブのステートの説明をご覧ください。
優先度	ジョブの優先度です。詳細は、ジョブの優先度の説明をご覧ください。
開始	ジョブの実行が開始されてからの相対的な経過時間です。このフィールドにカーソルを置くと、正確な開始日時が表示されます。
終了	ジョブの実行が完了してからの相対的な経過時間です。このフィールドにカーソルを置くと、正確な完了日時が表示されます。
開始時刻 (絶対時間) (*)	ジョブの実行が開始されてからの絶対的な経過時間です。絶対時間のタイムスタンプはテナントのタイムゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイムゾーンで表示さるため、テナントのタイムゾーンと異なる場合があります。
終了時刻 (絶対時間) (*)	ジョブの実行が完了してからの絶対的な経過時間です。絶対時間のタイムスタンプはテナントのタイムゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイムゾーンで表示さるため、テナントのタイムゾーンと異なる場合があります。
ソース	実行のエージェントです。手動 - ジョブは Orchestrator から開始されました。タイムトリガー - ジョブはタイムトリガーによって開始されました。タイムトリガーの名前が [ソース] 列に表示されます。キュートリガー - ジョブはキュートリガーによって開始されました。キュートリガーの名前が [ソース] 列に表示されます。イベントトリガー - ジョブはイベントトリガーによって開始されました。イベントトリガーの名前が [ソース] 列に表示されます。 API トリガー - ジョブは API トリガーによって開始されました。API トリガーの名前が [ソース] 列に表示されます。 Assistant - ジョブは UiPath Assistant によって開始されました。 Studio - ジョブは Studio からデバッグを目的として開始されました。 Apps - ジョブがアプリを介して開始されました。
作成時刻 (*)	ジョブ作成の相対的な時間です。
作成時刻 (絶対時間) (*)	ジョブ作成の絶対的な時間です。

(*) 既定ではジョブグリッドに表示されない列です。これらの列は [列] ドロップダウンから選択します。

アカウントとマシンのマッピング

ジョブを開始またはトリガーを定義するときに、実行の対象となる特定のアカウントとマシンのペアを定義できます。アカウントとマシンのマッピングでは、特定のアカウントによるプロセスの無人実行を特定のマシンテンプレートに関連付けることができます。これにより、オートメーションの実行ターゲットをきめ細かく制御できます。アカウントとマシンのマッピングは、テナントベース (特定のフォルダーに関連付けられていない) またはフォルダーベース (特定のフォルダーに関連付けられている) で実行されます。

アカウントとマシンのマッピングの設定方法については、こちらをご覧ください。

実行ターゲット

Orchestrator でジョブを開始するメカニズムに従って、ジョブの割り当て方法と実行ターゲットを暗黙的に選択して設定できます。ここでは、[ジョブ] ページからジョブを開始する際に使用できる割り当て方法と実行ターゲットについて説明します。

トリガーの実行ターゲットについては、こちらをご覧ください。

注:

ジョブの実行が特定のリソースに依存しており、そのリソースがまだ利用できない場合、ジョブの実行条件が満たされるまでの間、そのジョブは [保留中] ステートに留まります。

たとえば、ユーザー U1 は資格情報 C1 を使用してホスト名 H1 に接続します。しかし、ホスト名に接続するための資格情報として、誤って C2 が入力されているとします。その場合、ジョブは保留ステートに入ります。その後資格情報を正しいもの (C1) に更新すると、ジョブの実行は再開されます。

注: ジョブの実行中にロボットが応答しなくなった場合 (ロボットのマシンがダウンした場合や、Robot サービスがクラッシュした場合)、再接続した後、クラッシュ時に実行中だったジョブを再実行します。

1. 動的に割り当て

アカウントとマシンが明示的に選択されていない動的割り当てでは、最初に利用可能になったアカウントとマシンで、フォアグラウンドプロセスを複数回実行できます。バックグラウンドプロセスは、ビジーであるかどうかにかかわらず、任意のアカウントによって実行されます (十分な数のランタイムがある場合)。

[動的に割り当て] オプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。

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 個の優先度を設定できます。

ジョブを手動で開始する

[ジョブの優先度] フィールドの既定値は [継承] です。つまり、優先度は、最初の設定が継承されます。その設定をそのまま使用することも、変更することもできます。

場所: [オートメーション] ページ > [ジョブ]

ジョブはプロセスレベルで設定された優先度を継承します。

場所: [オートメーション] ページ > [トリガー]

トリガーの優先度が [継承] の場合、ジョブはプロセスレベルで設定された優先度を継承します。

トリガーの優先度が [継承] と異なる場合、ジョブはトリガーレベルで設定された優先度を継承します。[継承] に変更すると、プロセスレベルで設定された優先度が使用されます。

場所: [オートメーション] ページ > [プロセス]

ジョブはそのプロセスに設定された優先度を継承します。

トリガーによるジョブの開始

優先度は既定で [継承] に設定されます。つまり、プロセスレベルで設定された値を継承します。プロセスを選択すると、矢印のアイコンが、プロセスレベルで設定された値を示すよう自動的に更新されます。トリガーによって起動されたジョブの優先度は、すべてトリガーレベルで設定されます。ただし、既定の [継承] をそのまま使用した場合、それらのジョブはプロセスレベルで設定された優先度で起動されます。

以後にプロセスレベルで加えられた変更は、トリガーと、そのプロセスで作成されたジョブに、暗黙的に伝播されます。

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.StartJobs
POST/odata/ProcessSchedules
PUT/odata/ProcessSchedules({key})

たとえば、ジョブが 2 つあり、それぞれに優先度 92 と 94 を設定するとします。どちらのジョブも [緊急] の範囲内に収まりますが、優先度 94 のジョブが優先度 92 のジョブより先に実行されます。

注: Windows Server 上で実行されていない同じマシンで、複数のロボットでユーザーの介入が必要なジョブを 1 つ開始した場合は、選択したプロセスが 1 つ目のロボットでのみ実行され、残りは失敗します。これらの各実行のインスタンスは [ジョブ] ページで作成および表示します。

高密度ロボットによるジョブ

同じ Windows Server 端末において、複数の高密度ロボットでジョブを開始した場合、選択したプロセスが指定したそれぞれのロボットによって同時に実行されることになります。これらの各実行のインスタンスは [ジョブ] ページで作成および表示します。

高密度ロボットを使用し、そのマシン上で RDP を有効化しない場合は、ジョブを開始するたびに、次のエラーが表示されます: 「A specified logon session does not exist.It may already have been terminated.」(指定したジョブセッションは存在しません。すでに終了した可能性があります)。高密度ロボットの設定方法については、「高密度ロボット用の Windows Server を設定する」ページを参照してください。