通知を受け取る

UiPath Orchestrator

UiPath Orchestrator ガイド

トリガーを管理する

タイム トリガーを作成する

  1. フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。
  2. トリガーの種類として [時間] を選択します。
  3. 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。
  4. [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。
  5. [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。
  6. [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。
  7. [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。
Desciption
Dynamic allocationAllocate Dynamically

Dynamic allocation with no explicit account and machine selection allows you to execute a foreground process multiple times under the user and machine that become available first. Background processes get executed on any account, regardless if it's busy or not, as long as you have sufficient runtimes.

Using the Allocate Dynamically option you can execute a process up to 10000 times in one job.
*Account

The process is executed under a specific account. Only specifying the account results in Orchestrator allocating the machine dynamically. Specifying both the account and the machine means the job launches on that very account-machine pair.
Machine

The process is executed on one of the host machines attached to the selected machine template. Only specifying the machine results in Orchestrator allocating the account dynamically. Specifying both the account and the machine means the job launches on that very account-machine pair.

Make sure that runtimes matching the job type are allocated to the associated machine template. Only connected host machines associated with the active folder are displayed.
Select valid account-machine mappingsThe process can be executed on specific account-machine pairs. Learn more about account-machine mappings.

Note: Accounts part of mappings that are employed in triggers cannot be deleted or unassigned from the folder the trigger resides in. Make sure the account is not set as an execution target in a trigger so you can delete them.
  1. プロセスに入力引数がある場合、[引数] タブで、その引数の値を設定します。入力および出力引数の詳細については、こちらをご覧ください。
  2. [タイムゾーン] ドロップダウンから、トリガーをオフにするタイムゾーンを選択します。

📘

注

  • トリガーのタイムゾーンはテナントのタイムゾーンには依存しません。タイム トリガーの実行に別のタイム ゾーンを設定できます。

  • 夏時間 (DST) を使用する地域は、協定世界時 (UTC) との時差に基づいてリストに表示されます。DST の期間中でも UTC 時差の値は増加しません。たとえば、DST の期間でもロンドンのタイムゾーンは UTC+00:00 と表示されます。

  • DST を考慮するためにタイムゾーンを調整する必要はありません。Orchestrator のスケジュール メカニズムがジョブの起動時に自動的に DST を考慮するからです。12:00 に実行がスケジュールされているジョブは、冬時間、夏時間のいずれでも 12:00 に実行されます。

  1. トリガーの実行頻度を選択します (分、時間、日、週、月、カスタム)。このセクションの右側で、選択したオプション (頻度、正確な時間、または cron 式) に応じて詳細を設定します。Orchestrator はオープンソース ライブラリを使用して cron の記述を解析・表示します。詳細についてはこちらをご覧ください。

  2. 特定の非稼働日にトリガーの起動を停止する場合は、[非稼働日制限] ドロップダウンから非稼働日カレンダーを選択します。非稼働日について詳しくは、こちらをご覧ください。

  3. [ジョブの実行を終了] オプションを有効化して、ジョブの終了方法を選択します。

📘

注

ジョブがキューに入っている時間も、ここで設定された経過時間に含まれることになります。たとえば、ジョブを午後 1 時に実行されるようにスケジュールし、20 分後に停止するように設定した場合、そのジョブは、たとえ午後 1 時 15 分までキューにあり、その後開始されたとしても、午後 1 時 20 分には停止されます。

  • ドロップダウンから [停止] を選択 - ジョブが「保留中」ステートになってから指定した期間が経過した後に、実行の終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
    例: 10 分以上「保留中」ステートが続いているジョブに対して停止が試行されます。
1331
  • ドロップダウンから [強制終了] を選択 - ジョブが「保留中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
    例: 10 分以上「保留中」ステートが続いているジョブに対して強制終了が試行されます。
1310
  • ドロップダウンから [停止] を選択し、[ジョブが停止しない場合に強制終了] オプションを有効化 - ジョブが「保留中」ステートになってから、指定した期間が経過した後、実行の終了を試行します。その後、ジョブが「停止中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
    例: 10 分以上「保留」ステートが続いているジョブに対して停止が試行されます。それでもジョブが終了しない場合、20 分以上「停止中」ステートが続いているジョブに対して強制終了が試行されます。
1327
  1. [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。タイム トリガーは、手順 9 で選択したタイム ゾーンでの、指定された日時に無効化されます。
  2. ジョブの開始用に設定されたアカウントとマシンのコンテキスト (手順 7) を維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] ボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。このオプションについて詳しくは、こちら (手順 6 の表) をご覧ください。

キュー トリガーを作成する

注: キュー トリガーと SLA 予測値は、キューとプロセスの関連付けに関して互いに依存しています。したがって、一方を構成すると、設定が一致するように、もう一方は自動入力されます。たとえば、キュー Y に対するキュー トリガーを、プロセス X を使用するように 定義します。キュー Y の SLA 予測値はプロセス X のみを使用して決まるので、Y のキュー SLA を有効化すると、X には値が事前入力され、読み取り専用になります。

  1. フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。
  2. トリガーの種類として [キュー] を選択します。
  3. 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。
  4. [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。
  5. [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。
  6. [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。
  7. [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。
Desciption
AccountThe process is executed under a specific account. Only specifying the account results in Orchestrator allocating the machine dynamically. Specifying both the account and the machine means the job launches on that very account-machine pair.
MachineThe process is executed on one of the host machines attached to the selected machine template. Only specifying the machine results in Orchestrator allocating the account dynamically. Specifying both the account and the machine means the job launches on that very account-machine pair.

Make sure that runtimes matching the job type are allocated to the associated machine template. Only connected host machines associated with the active folder are displayed.
  1. プロセスに入力引数がある場合、[引数] タブで、その引数の値を設定します。入力および出力引数の詳細については、こちらをご覧ください。
  2. [最初のジョブをトリガーする、アイテムの最小数です。]、[同時に許可されている保留中および実行中のジョブの最大数です。]、[指定した数のアイテムが追加されるたびにジョブをトリガー] の各フィールドに値を入力します。
Description
Minimum number of items that trigger the first jobThe item-processing job is only started after the targeted queue has at least this number of new items. Deferred queue items are not counted.
Maximum number of pending and running jobs allowed simultaneouslyThe maximum number of allowed pending and running jobs, counted together. For 2 or more jobs allowed simultaneously, the third option needs to be defined as described below.
Another job is triggered for each __ new item(s)The number of new queue items (on top of the number configured for the Minimum number of items that trigger the first job option) to trigger a new job.
  1. [タイムゾーン] ドロップダウン メニューから、キュー トリガーを無効化する基準となるタイムゾーンを選択します (手順 12 をご覧ください)。トリガーのタイムゾーンはテナントのタイムゾーンには依存しません。
  2. 特定の非稼働日にトリガーの起動を停止する場合は、[非稼働日制限] ドロップダウンから非稼働日カレンダーを選択します。非稼働日に関する詳細は、こちらをご覧ください。
  3. [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。キュー トリガーは、手順 10 で選択したタイム ゾーンでの、指定された日時に無効化されます。
  4. ジョブの開始用に設定されたアカウントとマシンのコンテキスト (手順 7) を維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] ボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。このオプションについて詳しくは、こちら (手順 6 の表) をご覧ください。

トリガーを編集する

該当する [編集] ボタンをクリックして、必要に応じて変更を行い、[トリガーを編集] ウィンドウで [更新] をクリックします。

トリガーを無効化する

トリガーを無効化するには、対応する [その他のアクション] ボタンをクリックしてから、[無効化] をクリックします。無効化されたタイム トリガーの前には disabled_time_trigger アイコンが表示されます。無効化されたキュー トリガーの前には disabled_queue_trigger アイコンが表示されます。

または、それを選択して [無効化] をクリックします。

将来の特定の日時に、トリガーを自動的に無効化することもできます。これを行うには、次の手順に従います。

  1. 該当する [編集] ボタンをクリックします。
  2. [指定日時でトリガーを無効化] オプションを有効化します。
  3. 希望の日付と時刻を入力します。トリガーのタイム ゾーンは、トリガーが無効化されるときに影響します。
  4. [更新] をクリックすると、変更が反映されます。

🚧

重要

既定では、過去 1 日間正常に起動できていないトリガーが起動に 10 回失敗すると、そのトリガーは自動的に無効化されます。この値は Triggers.DisableWhenFailedCount パラメーターを使用してカスタマイズできます。

トリガーを有効化する

トリガーを有効化するには、対応する [その他のアクション] ボタンをクリックしてから、[有効化] をクリックします。有効化されたタイム トリガーは、その前に enabled_time_trigger アイコンでマークされます。有効化されたキュートリガーは、その前に enabled_queue_trigger でマークされます。

または、該当するスケジュールを選択して [有効化] をクリックします。

トリガーを削除する

トリガーを削除するには、該当する [その他のアクション] ボタンをクリックし、次に [削除] をクリックします。

または、該当するスケジュールを選択して [削除] をクリックします。

トリガーにより開始されたジョブを表示する

指定のスケジュールにより開始したジョブを表示するには、[その他のアクション] ボタンをクリック後、[ジョブを表示] をクリックします。[ジョブ] ウィンドウが表示され、選択されたトリガーにより過去に実行されたすべてのジョブ (該当する場合) が表示されます。

非稼働日を管理する

新しいカレンダーを作成する

  1. [設定] ページで [非稼働日] タブを開きます。以前に定義されたすべてのカレンダーのリストがアルファベット順に表示されます。
    BankHoliday カレンダーが存在する場合、ここに表示されます。非稼働日を定義した Orchestrator を 19.10 にアップグレードすると、このカレンダーが作成されます。
  2. [追加] をクリックして新しいカレンダーを作成し、強調表示されている空白のフィールドに、そのカレンダーの名前を入力します。名前は一意とする必要があり、最大 150 文字の英数字を入力できます。名前のないカレンダーや空白文字のみの名前のカレンダーは作成できません。
  3. [保存] をクリックするか、キーボードの Enter キーを押して、新しいカレンダーを保存します。カレンダーが保存されて、カレンダー リストに表示されます。
  4. 選択したカレンダーに、手動入力、.csv ファイルのアップロード、またはこれらの組み合わせで非稼働日を定義します。
  5. [トリガー] ページで、新しいトリガーの作成時または既存のトリガーの編集時に、[非稼働日の制限] ドロップダウンから希望のカレンダーを選択します。

📘

注

非稼働日を使用する場合、トリガーのタイム ゾーンはテナントのタイム ゾーン ([テナント] > [設定] > [全般]) と同じである必要があります。カレンダーの制限は別々のタイムゾーンで適用できないためです。タイム ゾーンが明示的に定義されていないテナントは、ホストからタイム ゾーンを継承します。

  1. [更新] をクリックすると、変更が反映されます。カレンダーに行う変更はすべて、その後そのカレンダーに関連するすべてのトリガーに入力されます。

手動で非稼働日を選択する

  1. カレンダーをクリックして選択します。ウィンドウの右側のカレンダーは、それに応じて更新されます。
  2. 表示されたカレンダーで、トリガーの起動を停止する日付をクリックします。選択した日付を再度クリックすると、選択解除します。
  3. 非稼働日として選択された日付を保存するには、[保存] をクリックします。
1409

.csv ファイルをアップロードする

.csv ファイルから、選択したカレンダーに一連の日付を直接アップロードできます。正常にアップロードされるように、事前定義した形式でデータをファイルに入力しておく必要があります。アップロードしたファイルの新しい日付によって、カレンダーに既に保存されている日付が上書きされます。

📘

重要

.csv ファイルには、列ヘッダーとして ExcludedDate が必要です。その列には、すべての非稼働日を、YYYY-MM-DD、YYYY/MM/DD、または YYYY MM DD の形式で入力する必要があります。
詳細については、下記の「例」セクションを展開してください。

  1. 選択したカレンダーで、[CSV をアップロード] をクリックします。
  2. 希望の .csv ファイルに移動し、選択して、[開く] をクリックします。 Orchestrator はファイルを解析して、フォーマット ルールを満たしていることを確認します (以下の例のセクションをご覧ください)。
  3. 確認ダイアログで [はい] をクリックして、カレンダーに既に含まれている日付をアップロードされたファイルの新しい日付で上書きします。
  4. 変更されたカレンダーを保存するには、[保存] をクリックします。

または、

  1. . ファイルをドラッグして、選択したカレンダーの上部にドロップします。Orchestrator によってファイルが解析され、フォーマット ルールを満たしていることが確認されます (以下の「例」セクションをご覧ください)。
  2. 確認ダイアログで [はい] をクリックして、カレンダーに既に含まれている日付をアップロードされたファイルの新しい日付で上書きします。
  3. 変更されたカレンダーを保存するには、[保存] をクリックします。

例

次に示す .csv ファイルの内容をカレンダーにアップロードするとします。このようなファイルを容易に作成するには、データを Excel ファイルに入力して .csv ファイルとして保存します。

SaveAsCSV

または、すべての列ヘッダーを入力済みの .csv ファイルをダウンロードして、ニーズに合わせてカスタマイズすることもできます。

ファイルをダウンロード

このファイルには、列ヘッダー ExcludedDate が事前定義されています。すべての非稼働日を、YYYY-MM-DD、YYYY/MM/DD、または YYYY MM DD のいずれかの形式でこの列に入力します。

 NWDCSVFile

カレンダーの名前を変更する

  1. 設定ページの [非稼働日] タブでカレンダーを選択します。
  2. カレンダーの名前を変更します。
  3. 変更された名前を保存するには、[保存] をクリックします。

カレンダーを削除する

  1. 設定ページの [非稼働日] タブでカレンダーを選択します。
  2. [削除] をクリックします。
  3. ポップアップ ウィンドウで [はい] をクリックして、意図しているとおりか確認します。カレンダーが削除されます。

📘

注:

トリガーに割り当てられていないカレンダーのみを削除できます。

カレンダーから非稼働日を削除することもできます。非稼働日をクリックすると、その日はマークされなくなります。変更は必ず保存してください。

約 1 か月前に更新

トリガーを管理する

改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。