- 基本情報
- ベスト プラクティス
- テナント
- リソース カタログ サービス
- フォルダー コンテキスト
- 自動化
- プロセス
- ジョブ
- トリガー
- ログ
- 監視
- キュー
- アセット
- ストレージ バケット
- Orchestrator のテスト
- その他の構成
- Integrations
- ホストの管理
- 組織管理者
- トラブルシューティング
Orchestrator の [ジョブ] ページでは、オートメーションのジョブを開始、監視、管理できます。
ジョブを開始する
以下の手順を実行する前に、プロセスを作成する必要があります。
- プロセスが存在するフォルダーから [オートメーション] > [ジョブ] に移動します。
- [開始] を選択します。 [ジョブを開始] ウィンドウが表示されます。
- [プロセス名] ドロップダウンで、現在のフォルダーにあらかじめデプロイしておいたプロセスを選択します。
- 必要に応じて、以下のセクションで概説しているようにフィールドを設定します。
- [開始] を選択します。 [ジョブを開始] ウィンドウが閉じ、現在アクティブなフォルダーに利用可能なランタイムがある場合は、設定に従ってロボットでジョブが開始されます。ジョブの [ステート] は、リアルタイムで [ジョブ] ページに表示されます。
ジョブの優先度を設定する
実行されるジョブの優先度を、プロセス レベルで設定された優先度とは異なる値にする必要がある場合は、[ジョブの優先度] ドロップダウンから優先度を選択します。このフィールドには、パッケージから継承された優先度が自動的に入力されます。
実行ランタイムを選択する
[ランタイムの種類] ドロップダウンから、ジョブの実行に使用するランタイムの種類を選択します。
ドロップダウンの下には、利用可能なランタイムと接続済みのランタイムの数が表示されます。
-
_ 利用可能 - 利用可能なランタイムの数。ランタイムの総数から実行中のジョブの数を引いた値です。
-
_ 接続済み - ランタイムの総数。アクティブ フォルダーに関連付けられた Orchestrator に接続されたすべてのマシン上のランタイムの合計です。
ランタイムの種類 説明 Production (Unattended) ジョブは Unattended ランタイムを使用して、無人モードで実行されます。 テスト ジョブは Testing ランタイムを使用して、無人モードで実行されます。 NonProduction ジョブは NonProduction ランタイムを使用して、無人モードで実行されます。 Cloud - VM Testing ジョブは、テスト環境または非運用環境で実行するように構成されたクラウドの仮想マシン上で、無人モードで実行されます。仮想マシンを実行すると、テスト環境用のロボット ユニットが消費されます。 詳しくは、こちらのページの「ロボット ユニット - 消費」セクションをご覧ください。 Cloud - VM ジョブは、運用環境で実行するように構成されたクラウドの仮想マシン上で、無人モードで実行されます。仮想マシンを実行すると、運用環境用のロボット ユニットが消費されます。 詳しくは、こちらのページの「ロボット ユニット - 消費」セクションをご覧ください。
例: マシン テンプレート A に NonProduction のランタイムが 2 つと Unattended のランタイムが 1 つあり、マシン テンプレート B に NonProduction のランタイムが 3 つと Unattended のランタイムが 2 つあるとします。いずれのマシン テンプレートも 1 つのフォルダーに関連付けられています。各テンプレートで、1 つのホスト マシンを接続します。すると、ランタイムのステートは次のようになります。
- Unattended:
3 Available, 3 Connected - NonProduction:
5 Available, 5 Connected
ランタイムを占有するジョブが実行されると、その種類のジョブで利用可能なランタイム数が 1 つ減ります。
パブリッシュ時には、ジョブを実行するために利用可能なランタイムが個人用ワークスペースから選択されます。ランタイムの優先順位は次のとおりです。
- Production (Unattended)
- NonProduction たとえば、Production ランタイムが存在しない場合、Orchestrator では利用可能な NonProduction ランタイムが使用されます。どのランタイムも存在しない場合、ジョブは失敗します。選択したランタイムがジョブの実行と実行の間に利用できなくなると、Orchestrator は次に利用可能なランタイムを検索しないため、次のジョブの実行は失敗します。
実行ターゲットを設定する
[実行ターゲット] タブで、必要に応じて以下のオプションを設定して、実行ターゲットを設定します。
図 1. ジョブを開始する
動的に割り当て
アカウントとマシンが明示的に選択されていない動的割り当てでは、最初に利用可能になったアカウントとマシンで、フォアグラウンド プロセスを複数回実行できます。バックグラウンド プロセスは、ビジーであるかどうかにかかわらず、任意のアカウントによって実行されます (十分な数のランタイムがある場合)。
このオプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。
アカウント
以下の方法のいずれかを選択できます。
- アカウントを指定すると、プロセスはその特定のユーザー アカウントまたはロボット アカウントの下で実行されます。
- アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。有効なアカウントとマシンのペアのみ選択できます。
- アカウントを指定しない場合、Orchestrator はアカウントを動的に割り当てます。
マシン
以下の方法のいずれかを選択できます。
- マシン オブジェクトを指定すると、プロセスは、選択したマシン テンプレートに接続されたいずれかのホスト マシンで実行されます。[接続済みのマシン] フィールドで、接続済みのホスト マシンのプールから特定のホスト マシンを選択します。
- アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。有効なアカウントとマシンのペアのみ選択できます。
- マシンを指定しない場合、Orchestrator はホスト マシンを動的に割り当てます。
ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。
有効なアカウントとマシンのマッピングを選択
ジョブを実行する特定のアカウントとマシンのペアを選択します。
図 2. ジョブを実行する特定のアカウントとマシンのペアの選択
ジョブを複数のペアで実行する場合は、[アカウントとマシンのマッピングを追加] をクリックできます。その場合、アカウントとマシンのペアごとに保留中のジョブが作成されます。
これは、テナント設定の [全般] タブで [ユーザーとマシンのマッピングを有効化] オプションが選択されている場合にのみ機能します。
ジョブの再開時にアカウントとマシンの割り当てを維持する
このフィールドでは、長期実行ジョブの異なるフラグメントを同じアカウントとマシンのペアで実行するかどうかを設定できます。
既定では、中断されているジョブはその時点で利用可能な任意のロボットとマシンで再開されます。
ライセンスまたはリソースの要件に基づいて、ジョブを開始したマシンおよびアカウント コンテキストでジョブを再開できます。
ジョブを実行するのに、SAP ライセンスが必要だとします。その場合、利用可能なマシンごとに SAP ライセンスをインストールするのではなく (コストが増加)、ライセンスを 1 つのマシンにインストールし、そのマシンを使用してジョブを開始および再開することができます。同じ方法を、ユーザー ライセンスでも使用できます。つまり、1 つのユーザー ライセンスのみを割り当て、そのライセンスを使用してジョブを実行することができます。
ジョブの実行を終了するスケジュールを設定
プロセスの実行時に障害が発生し、ジョブが保留中または実行中のステートのままになってしまうことがあります。トグルをオンにすると、次の操作が可能です (クリックして展開します)。
- ドロップダウン メニューから [ 停止 ] を選択 - ジョブが「保留中」または「実行中」ステートになってから指定した期間が経過した後に、実行の終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
図 3. ジョブの実行の停止
- ドロップダウン メニューから [ 強制終了 ] を選択 - ジョブが「保留中」または「実行中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
図 4. ジョブの実行の強制終了
- ドロップダウン メニューから [ 停止 ] を選択し、[ ジョブが停止しない場合に自動的に強制終了するスケジュールを設定 ] オプションをオンにします。- ジョブが保留中または実行中ステートになってから指定した期間が経過した後に、実行の正常終了を試行します。その後、ジョブが停止ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日 23 時間 59 分)。
図 5. ジョブの実行の停止
ジョブが保留中または再開ステータスのままになっている場合にアラートを生成
このトグルをオンにすると、指定した期間より長く保留中または再開ステータスに留まっているジョブに関するアラートがアクティブ化されます。
設定可能な期間は、最小で 1 分、最大で 11 日です。
ジョブが設定された期間を超えた場合、重要度が「Error」のアラートがポップアップで表示され、以下のテキストによって通知されます。
「N jobs for #process {process_number} have been pending or resumed for more than X hours and Y minutes. (#プロセス {process_number} の N 個のジョブが、X 時間 Y 分を超えて保留中または再開ステータスのままです。)」各項目の説明:
- N - アラートをトリガーしたジョブの数です。
- {process_number} - プロセス識別子です。
- X - ジョブが保留中または再開ステータスの間に設定値を超えた時間数です。日は時間に変換されます。
- Y - ジョブが保留中または再開ステータスの間に設定値を超えた分数です。
開始済みのジョブが完了していない場合にアラートを生成
このトグルをオンにすると、指定した期間内に完了しないジョブに関するアラートがアクティブ化されます。
設定可能な期間は、最小で 1 分、最大で 11 日です。
ジョブが設定された期間を超えた場合、重要度が「Error」のアラートがポップアップで表示され、以下のテキストによって通知されます。
「Job for #process {process_number} has been running for more than X hours and Y minutes. (#プロセス {process_number} のジョブが、X 時間 Y 分を超えて実行されています。)」各項目の説明:
- {process_number} - プロセス識別子です。
- X - ジョブが完了試行中に設定値を超えた時間数です。日は時間に変換されます。
- Y - ジョブが完了試行中に設定値を超えた分数です。
Orchestrator では、無効な設定でジョブを開始することはできません。無効な設定でジョブを開始しようとすると、設定の修正方法を詳しく示したエラー メッセージが表示されます。
図 6. 無効な設定での [ジョブを開始] ページ
Starting a job using dynamic allocation, i.e. no machine or account specified, with an incompatible folder setup results in an error. Make sure to correct the setup, otherwise, jobs stay pending indefinitely.
For example, trying to run a.NET Framework 4.6.1 background job when there are only cross-platform templates in the folder does not work, as jobs stay pending until the configuration is fixed.
引数を追加する
[引数] タブに、選択したプロセスの入力引数を入力します。このタブには、選択したプロセスで受け付けられるすべての入力引数が自動的に入力され、対応する値がパッケージから継承されます。
ジョブの引数は 10,000 文字を超えてはなりません。
ジョブを停止する
ジョブの [その他のアクション] メニューから [停止] を選択します。Orchestrator はジョブのステータスを [停止中] とマークしてロボットに通知を送信しますが、オートメーション プロジェクトの実行は続行されます。
[ 停止すべきか 確認] アクティビティが検出されると、結果として true が返されます。この結果は、いつ [ジョブを停止 ] アクティビティを呼び出して正常なシャットダウン プロセスを開始するかを決定するマーカーとして使用できます。
[ ジョブを停止 ] アクティビティが見つからない場合、プロジェクトの終わりに到達するまでジョブの実行は停止しません。ジョブの最終ステータスは [成功] です。
- Orchestrator から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath® Assistant を使用してのみ停止できます。
- Assistant から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath® Assistant を使用して停止できます。
- ジョブが停止すると、ジョブの終了スケジュールは失われます。そのため、ジョブの再実行時に [ジョブの実行を終了するスケジュールを設定] オプションを再設定する必要があります。
ジョブを再開する
該当する [その他のアクション] ボタンをクリックし、次に [再開] をクリックします。
ジョブを強制終了する
該当する [その他のアクション] ボタンをクリックし、次に [強制終了] をクリックします。オートメーション プロジェクトが強制終了され、[停止] とマークされ、[ジョブの詳細] ウィンドウに「ジョブはキャンセルされました」と表示されます。
- Orchestrator から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath Assistant を使用して強制終了できます。
- Assistant から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath Assistant を使用して強制終了できます。
- ジョブが強制終了すると、ジョブの終了スケジュールは失われます。そのため、ジョブの再実行時に [ジョブの実行を終了するスケジュールを設定] オプションを再設定する必要があります。
ジョブを再実行する
この機能を使用すると、ジョブ フローの構成を経る必要なく、ジョブのリストからすぐにジョブを実行できます。[停止]、[エラー]、または [成功] のどの最終ステートにあるジョブでも再実行できます。
- Assistant などのエージェントまたは Studio のリモート デバッグ セッションによってトリガーされたジョブは再実行できません。
- [ジョブの実行を終了するスケジュールを設定] オプションがアクティブになっているジョブを再実行する場合、これらのオプションを再設定する必要があります。
この手順を開始するには、以前に何らかのジョブを開始して、そのジョブが最終状態に達している必要があります。
- Select the corresponding More Actions button, and then Restart. The Start Job window is displayed, with the job's initial settings.
- 必要な変更を行います。
- Select Start. The Start Jobs window closes and the execution starts. The status of each job is displayed, in real-time, on the Jobs page.
ジョブのログを表示する
特定のジョブのログを表示するには、該当する [その他のアクション] ボタンをクリックし、[ログを表示] をクリックします。[ログ] ページが表示されます。ここには、対象のジョブの項目のみが含まれています。
リモート デバッグ セッションから開始したジョブで生成されるログは、[ジョブのログ] ページには表示されません。グローバルな [ログ] ページに表示されます。
ジョブの詳細を表示する
特定のジョブの詳細を表示するには、対応する [詳細を表示] ボタンをクリックします。[ジョブの詳細] ウィンドウが表示され、以下のようなさまざまな情報を確認できます。
- 基になるプロセスの名前
- 実行するロボットとマシン
- ジョブが失敗した理由
- ジョブが開始されない理由
- 問題を修正し、ジョブの開始をトリガーするためのアクション
図 7. ジョブの詳細
図 8. 保留中のジョブの詳細
[情報] フィールドには、失敗したジョブのライセンスに関する考慮事項は表示されません。ライセンスについて詳しくは、監視機能を使用してください。
実行メディアをダウンロードする
失敗したジョブの記録をダウンロードするには、[その他のオプション] > [記録をダウンロード] をクリックします。実行メディアは、設定に従ってダウンロードされます。