orchestrator

2024.10

true

Orchestrator ユーザーガイド

デリバリー:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

最終更新日時 2024年11月22日

ジョブを管理する

ジョブを開始する

以下の手順を実行する前に、プロセスを作成する必要があります。

プロセスが存在するフォルダーから [オートメーション] > [ジョブ] に移動します。
[開始] をクリックします。[ジョブを開始] ウィンドウが表示されます。
[プロセス名] ドロップダウンで、現在のフォルダーにあらかじめデプロイしておいたプロセスを選択します。
必要に応じて、以下のセクションで概説しているようにフィールドを設定します。
[開始] をクリックします。[ジョブを開始] ウィンドウが閉じ、現在アクティブなフォルダーに利用可能なランタイムがある場合は、設定に従ってロボットでジョブが開始されます。ジョブの [ステート] は、リアルタイムで [ジョブ] ページに表示されます。

ジョブの優先度を設定する

実行されるジョブの優先度を、プロセスレベルで設定された優先度とは異なる値にする必要がある場合は、[ジョブの優先度] ドロップダウンから優先度を選択します。このフィールドには、パッケージから継承された優先度が自動的に入力されます。

実行ランタイムを選択する

[ランタイムの種類] ドロップダウンから、ジョブの実行に使用するランタイムの種類を選択します。

ドロップダウンの下には、利用可能なランタイムと接続済みのランタイムの数が表示されます。

_ 利用可能 - 利用可能なランタイムの数。ランタイムの総数から実行中のジョブの数を引いた値です。

_ 接続済み - ランタイムの総数。アクティブフォルダーに関連付けられた 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 つ減ります。

注:

パブリッシュ時には、ジョブを実行するために利用可能なランタイムが個人用ワークスペースから選択されます。ランタイムの優先順位は次のとおりです。

Serverless
Production (Unattended)
NonProduction

たとえば、Production ランタイムが存在しない場合、Orchestrator では利用可能な NonProduction ランタイムが使用されます。どのランタイムも存在しない場合、ジョブは失敗します。

選択したランタイムがジョブの実行の合間に利用できなくなった場合、Orchestrator では次に利用可能なランタイムが検索されないため、後続のジョブの実行は失敗します。

実行ターゲットを設定する

[実行ターゲット] タブで、必要に応じて以下のオプションを設定して、実行ターゲットを設定します。

動的に割り当て

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

このオプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。

アカウント

以下の方法のいずれかを選択できます。

アカウントを指定すると、プロセスはその特定のユーザーアカウントまたはロボットアカウントの下で実行されます。
アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。有効なアカウントとマシンのペアのみ選択できます。
アカウントを指定しない場合、Orchestrator はアカウントを動的に割り当てます。

マシン

以下の方法のいずれかを選択できます。

マシンオブジェクトを指定すると、プロセスは、選択したマシンテンプレートに接続されたいずれかのホストマシンで実行されます。[接続済みのマシン] フィールドで、接続済みのホストマシンのプールから特定のホストマシンを選択します。
アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。有効なアカウントとマシンのペアのみ選択できます。
マシンを指定しない場合、Orchestrator はホストマシンを動的に割り当てます。

ジョブの種類に一致したランタイムが、関連するマシンテンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホストマシンだけが表示されます。

有効なアカウントとマシンのマッピングを選択

ジョブを実行する特定のアカウントとマシンのペアを選択します。

ジョブを複数のペアで実行する場合は、[アカウントとマシンのマッピングを追加] をクリックできます。その場合、アカウントとマシンのペアごとに保留中のジョブが作成されます。

注: これは、テナント設定の [全般] タブで [ユーザーとマシンのマッピングを有効化] オプションが選択されている場合にのみ機能します。

ジョブの再開時にアカウントとマシンの割り当てを維持する

このフィールドでは、長期実行ジョブの異なるフラグメントを同じアカウントとマシンのペアで実行するかどうかを設定できます。

既定では、中断されているジョブはその時点で利用可能な任意のロボットとマシンで再開されます。

ライセンスまたはリソースの要件に基づいて、ジョブを開始したマシンおよびアカウントコンテキストでジョブを再開できます。

ジョブを実行するのに、SAP ライセンスが必要だとします。その場合、利用可能なマシンごとに SAP ライセンスをインストールするのではなく (コストが増加)、ライセンスを 1 つのマシンにインストールし、そのマシンを使用してジョブを開始および再開することができます。同じ方法を、ユーザーライセンスでも使用できます。つまり、1 つのユーザーライセンスのみを割り当て、そのライセンスを使用してジョブを実行することができます。

ジョブの実行を終了するスケジュールを設定

プロセスの実行時に障害が発生し、ジョブが保留ステートのままになってしまうことがあります。このトグルをオンにすると、以下を実行できます (クリックして展開)。

ドロップダウンメニューから [停止] を選択 - ジョブが「保留中」ステートになってから指定した期間が経過した後に、実行の正常終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
ドロップダウンメニューから [強制終了] を選択 - ジョブが「保留中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
ドロップダウンメニューから [停止] を選択して [ジョブが停止しない場合に自動的に強制終了するスケジュールを設定] オプションをオン - ジョブが「保留中」ステートになってから指定した期間が経過した後に、実行の正常終了を試行します。その後、ジョブが「停止中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。

ジョブが保留中または再開ステータスのままになっている場合にアラートを生成

このトグルをオンにすると、指定した期間より長く保留中または再開ステータスに留まっているジョブに関するアラートがアクティブ化されます。

設定可能な期間は、最小で 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 では、無効な設定でジョブを開始することはできません。無効な設定でジョブを開始しようとすると、設定の修正方法を詳しく示したエラーメッセージが表示されます。

動的な割り当てを使用してジョブを開始すると、つまりマシンまたはアカウントが指定されておらず、フォルダーの設定がジョブの実行に対応していない状態でジョブを開始すると、エラーが発生します。その場合は、設定を修正してください。そうしないと、ジョブは保留中のままになります。たとえば、フォルダーにクロスプラットフォームテンプレートしかない場合に .NET Framework 4.6.1 のバックグラウンドジョブを実行しようとしても、うまくいきません。設定が修正されるまで、ジョブは保留中になるためです。

引数を追加する

[引数] タブに、選択したプロセスの入力引数を入力します。このタブには、選択したプロセスで受け付けられるすべての入力引数が自動的に入力され、対応する値がパッケージから継承されます。

ジョブを停止する

該当する [その他のアクション] ボタンをクリックし、次に [停止] をクリックします。オートメーションプロジェクトは、[停止すべきか確認] アクティビティを検出するまで実行されます。この間、ジョブは [停止中] ステートになります。このアクティビティが検出されると、実行は停止され、ジョブの最終的なステートは [成功] になります。[停止すべきか確認] アクティビティが検出されなかった場合、ジョブの実行はプロジェクトの最後まで停止されません。この場合も、最終的なステートは [成功] になります。

注:

Orchestrator から開始したジョブは、Orchestrator からのみ停止できます。
Assistant から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath® Assistant を使用して停止できます。
ジョブが停止すると、ジョブの終了スケジュールは失われます。そのため、ジョブの再実行時に [ジョブの実行を終了するスケジュールを設定] オプションを再設定する必要があります。

ジョブを再開する

該当する [その他のアクション] ボタンをクリックし、次に [再開] をクリックします。

ジョブを強制終了する

該当する [その他のアクション] ボタンをクリックし、次に [強制終了] をクリックします。オートメーションプロジェクトが強制終了され、[停止] とマークされ、[ジョブの詳細] ウィンドウに「ジョブはキャンセルされました」と表示されます。

注:

Orchestrator から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath Assistant を使用して強制終了できます。
Assistant から開始したジョブは、Orchestrator の [ジョブ] ページから、および UiPath Assistant を使用して強制終了できます。
ジョブが強制終了すると、ジョブの終了スケジュールは失われます。そのため、ジョブの再実行時に [ジョブの実行を終了するスケジュールを設定] オプションを再設定する必要があります。

ジョブを再実行する

この機能を使用すると、ジョブフローの構成を経る必要なく、ジョブのリストからすぐにジョブを実行できます。[停止]、[エラー]、または [成功] のどの最終ステートにあるジョブでも再実行できます。

注:

Assistant などのエージェントまたは Studio のリモートデバッグセッションによってトリガーされたジョブは再実行できません。
[ジョブの実行を終了するスケジュールを設定] オプションがアクティブになっているジョブを再実行する場合、これらのオプションを再設定する必要があります。

この手順を開始するには、以前に何らかのジョブを開始して、そのジョブが最終状態に達している必要があります。

該当の [その他のアクション] ボタンをクリックして、[再実行] をクリックします。[ジョブを開始] ウィンドウが開き、ジョブの初期設定が表示されます。
必要な変更を行います。
[開始] をクリックします。[ジョブを開始] ウィンドウが閉じて、実行が開始されます。各ジョブのステータスは、[ジョブ] ページにリアルタイムで表示されます。

ジョブの詳細を表示する

注:

サイドパネルが開いている間に、リスト内の任意のジョブをクリックして、パネルに含まれる全てのタブについて、その特定の詳細を表示できます。ジョブリストのグリッドは、必要に応じて特定の画面サイズや解像度に合わせて [プロセス] 列を固定したまま横方向にスクロールできます。一部の列のサイズを大きくすると、アクセスしやすいようにスクロールバーが表示されます。
タブの右上隅にある展開アイコンをクリックすると、タブをフルサイズのウィンドウとして開き、階層リンク内に基になるプロセスの名前が表示されます。同じ隅にある [折りたたみ] ボタンをクリックすると、ウィンドウがサイドパネルの状態に戻ります。
ジョブの詳細には、失敗したジョブのライセンスに関する考慮事項は含まれません。ライセンスについて詳しくは、監視機能を使用してください。

特定のジョブの詳細を表示するには、対応する [詳細] ボタンをクリックします。[ジョブの詳細] セクションを含むサイドパネルが表示され、以下のような各種情報を確認できます。