通知を受け取る

UiPath Orchestrator

UiPath Orchestrator ガイド

トリガーを管理する

トリガーの作成


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

Desciption

Dynamic Allocation

Allocate Dynamically
Only available for time triggers.

Dynamic allocation with no explicit user 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 user, 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.

User

The process is executed under a specific user. Only specifying the user results in Orchestrator allocating the machine dynamically. Specifying both the user and the machine means the job launches on that very user-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 user dynamically. Specifying both the user and the machine means the job launches on that very user-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.

User-Machine Mappings

Only available for time triggers.

The process can be executed on multiple specific user-machine pairs. Learn more about user-machine mappings.

Note: Users part of mappings that are employed in triggers cannot be deleted or unassigned from the folder the trigger resides in. Make sure the user is not set as an execution target in a trigger so you can delete them.

  1. プロセスに入力引数がある場合、[引数] タブで、その引数の値を設定します。入力および出力引数の詳細については、こちらをご覧ください。
  2. [タイムゾーン] ドロップダウンから、トリガーをオフにするタイムゾーンを選択します。トリガーのタイムゾーンはテナントのタイムゾーンには依存しないことに注意してください。
  3. 特定の非稼働日にトリガーの起動を停止する場合は、[非稼働日] ドロップダウンから非稼働日カレンダーを選択します。非稼働日に関する詳細は、こちらをご覧ください。
  4. [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。

タイム トリガー

  1. トリガーの実行頻度を選択します (時間カスタム)。このセクションの右側で、選択したオプション (頻度、正確な時間、または cron 式) に応じて詳細を設定します。Orchestrator はオープンソース ライブラリを使用して cron の記述を解析・表示します。詳細についてはこちらをご覧ください。
  2. [指定時間が経過した後にジョブを停止] トグルを有効化して、ジョブが停止または強制終了されるまでの経過時間を入力します。停止時間が経過した後にジョブを停止または強制終了する場合に選択します。
    : ここで指定した時間は、ジョブがキューに置かれた場合でも設定に従って経過します。たとえば、午後 1 時にジョブを実行するスケジュールを設定し 20 分後に停止するよう設定した場合、午後 1 時 15 分までジョブがキュー内に残り、その後開始されたとしてもこのジョブは午後 1 時 20 分に停止します。

キュー トリガー

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

  1. [最初のジョブをトリガーする、アイテムの最小数です。][同時に許可されている保留中および実行中のジョブの最大数です。][指定した数のアイテムが追加されるたびにジョブをトリガー] の各フィールドに値を入力します。

Description

Minimum number of items that trigger the first job

The 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 simultaneously

The 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.

トリガーの編集


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

トリガーを無効化


既定では、起動に 10 回失敗し、最終日に 1 回も実行に成功しないと、トリガーは自動的に無効化されます。

📘

注:

特定の日数内に起動に一度も成功しなかった場合にトリガーを無効化する、実行の失敗回数の既定値を変更するには、UiPath.Orchestrator.dll.config 内の Triggers.DisableWhenFailedCount パラメーターを設定します。日数を更新するには、Triggers.DisableWhenFailingSinceDays を使用します。

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

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

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

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

トリガーを有効化


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

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

トリガーの削除


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

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

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


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

非稼働日の管理


カレンダーの新規作成

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

📘

カレンダーの制限は異なるタイムゾーンに適用できないため、テナント レベル ([設定] ページ > [全般] タブ) で設定されたタイムゾーンとは異なるタイムゾーンではトリガーを保存できません。タイムゾーンが明示的に定義されていないテナントは、ホストからタイムゾーンを継承します。

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

非稼働日の手動での選択

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

.csv ファイルのアップロード

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

📘

重要

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

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

または、

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

 

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

SaveAsCSV

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

ファイルをダウンロード

 

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

 

 NWDCSVFile

カレンダーの名前変更

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

カレンダーの削除

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

📘

注:

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

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

12 か月前に更新


トリガーを管理する


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

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