ジョブについて

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

ジョブとは、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 を設定する」ページを参照してください。

レコーディング

Unattended で失敗したジョブにおいて、プロセスの [記録機能を有効化] オプションがオンになっている場合、対応する実行メディアをダウンロードして、失敗する前の実行の最後の瞬間を確認できます。

実行メディアに関する [表示] 権限を持っている場合は、[ジョブ] ウィンドウに [記録をダウンロード] オプションが表示されます。