トリガーを管理する

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

1. フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。

2. トリガーの種類として [時間] を選択します。

3. 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。

4. [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。

5. [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。

6. [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。

7. [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。

   説明
   動的に割り当て	動的に割り当て アカウントとマシンが明示的に選択されていない動的割り当てでは、最初に利用可能になったユーザーとマシンで、フォアグラウンド プロセスを複数回実行できます。バックグラウンド プロセスは、ビジーであるかどうかにかかわらず、任意のアカウントによって実行されます (十分な数のランタイムがある場合)。 [動的に割り当て] オプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。
   	アカウント プロセスは、特定のアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
   	マシン プロセスは、選択したマシン テンプレートに接続されたいずれかのホスト マシンで実行されます。マシンのみを指定すると、Orchestrator がアカウントを動的に割り当てます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。 ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。
   有効なアカウントとマシンのマッピングを選択	プロセスは、特定のアカウントとマシンのペアで実行できます。 トリガーに使用されるマッピングの一部であるアカウントを削除したり、トリガーが存在するフォルダーへの割り当てを解除したりすることはできません。アカウントがトリガーで実行ターゲットとして設定されておらず、削除できるようになっていることを確認します。

8. On the Arguments tab, provide values for input arguments if your process has any.

9. [タイムゾーン] ドロップダウンから、トリガーをオフにするタイムゾーンを選択します。

   注:

   • トリガーのタイムゾーンはテナントのタイムゾーンには依存しません。タイム トリガーの実行に別のタイム ゾーンを設定できます。
   • 夏時間 (DST) を使用する地域は、協定世界時 (UTC) との時差に基づいてリストに表示されます。DST の期間中でも UTC 時差の値は増加しません。たとえば、DST の期間でもロンドンのタイムゾーンは UTC+00:00 と表示されます。
   • DST を考慮するためにタイムゾーンを調整する必要はありません。Orchestrator のスケジュール メカニズムがジョブの起動時に自動的に DST を考慮するからです。12:00 に実行がスケジュールされているジョブは、冬時間、夏時間のいずれでも 12:00 に実行されます。

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

    注:

    cron 式は非稼働日と組み合わせて使用できます。つまり、トリガーが cron 式を使用して、除外日に当たる日に実行されるよう設定されている場合、その日はスキップされて、トリガーが次に利用可能な日に再スケジュールされます。

11. From the Non-working days restrictions drop-down, select a non-working days calendar, if you want your trigger to stop firing on certain non-business days.

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

    注:

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

    さらに、保留中または実行中のジョブを 2 時間後に停止するようスケジュールし、さらに 3 時間後に同じジョブを強制終了するよう設定した場合、ジョブは 5 時間後に強制終了されます。これは、最初に、ジョブが実際に 2 時間後に停止されたことを示すシグナルが Orchestrator に送信されるために発生します。シグナルを受信すると、ジョブの強制終了アクションが 3 時間後にトリガーされ、合計で 5 時間かかります。

    • ドロップダウンから [停止] を選択 - ジョブが「保留中」または「実行中」ステートになってから指定した期間が経過した後に、実行の終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。

      例: 10 分以上「保留中」または「実行中」ステートが続いているジョブに対して停止が試行されます。

      

    • ドロップダウンから [強制終了] を選択 - ジョブが「保留中」または「実行中」ステートになってから指定した期間が経過した後に、実行の強制終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。

      例: 10 分以上「保留中」または「実行中」ステートが続いているジョブに対して強制終了が試行されます。

      

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

      例: 10 分以上「保留中」または「実行中」ステートが続いているジョブに対して停止が試行されます。それでもジョブが終了しない場合、20 分以上「停止中」ステートが続いているジョブに対して強制終了が試行されます。

      

13. Enable the Disable Trigger at toggle, and enter the date and time when the trigger is to be disabled. The selected time zone selected when the time trigger gets disabled.

14. ジョブの開始用に設定されたアカウントとマシンのコンテキストを維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] チェックボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。

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

注:

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

1. フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。

2. トリガーの種類として [キュー] を選択します。

3. 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。

4. [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。

5. [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。

6. [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。

7. [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。

   説明
   アカウント	プロセスは、特定のアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
   マシン	プロセスは、選択したマシン テンプレートに接続されたいずれかのホスト マシンで実行されます。マシンのみを指定すると、Orchestrator がアカウントを動的に割り当てます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。 ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。

8. On the Arguments tab, provide values for input arguments if your process has any.

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

   説明
   最初のジョブをトリガーするアイテムの最小数	アイテム処理ジョブは、ターゲット キューに少なくともこの数の新しいアイテムが追加された後にのみ開始されます。 延期済みのキュー アイテムはカウントされません。
   同時に許可される保留中および実行中のジョブの最大数	一緒にカウントされる、許可された保留中および実行中のジョブの最大数。 同時に 2 つ以上のジョブを許容する場合は、次に示す 3 番目のオプションを定義する必要があります。
   指定した数のアイテムが追加されるたびにジョブをトリガー	新しいジョブをトリガーする新しいキュー アイテムの数 ([最初のジョブをトリガーするアイテムの最小数] オプションで設定された数に追加)。

10. From the Timezone drop-down, select the time zone according to which the queue trigger gets disabled. The trigger time zone is not dependent on the tenant time zone.

11. From the Non-working days restrictions drop-down, select a non-working days calendar if you want your trigger to stop firing on certain non-business days.

12. [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。キュー トリガーは、手順 10 で選択したタイム ゾーンでの、指定された日時に無効化されます。

13. ジョブの開始用に設定されたアカウントとマシンのコンテキストを維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] チェックボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。

トリガーを編集する

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

トリガーを無効化する

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

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

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

1. 該当する [編集] ボタンをクリックします。

2. [指定日時でトリガーを無効化] オプションを有効化します。

3. 希望の日付と時刻を入力します。トリガーのタイム ゾーンは、トリガーが無効化されるときに影響します。

4. [更新] をクリックすると、変更が反映されます。

   既定では、過去 1 日間正常に起動できていないトリガーが起動に 10 回失敗すると、そのトリガーは自動的に無効化されます。

   This value can be customized using the Triggers.DisableWhenFailedCount parameter.

トリガーを有効化する

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

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

トリガーを削除する

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

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

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

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

非稼働日を管理する

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

1. [設定] ページで [非稼働日] タブを開きます。以前に定義されたすべてのカレンダーのリストがアルファベット順に表示されます。

   BankHoliday カレンダーが存在する場合、ここに表示されます。非稼働日を定義した Orchestrator を 19.10 にアップグレードすると、このカレンダーが作成されます。

2. [追加] をクリックして新しいカレンダーを作成し、強調表示されている空白のフィールドに、そのカレンダーの名前を入力します。名前は一意とする必要があり、最大 150 文字の英数字を入力できます。名前のないカレンダーや空白文字のみの名前のカレンダーは作成できません。

3. [保存] をクリックするか、キーボードの Enter キーを押して、新しいカレンダーを保存します。カレンダーが保存されて、カレンダー リストに表示されます。

4. 選択したカレンダーに、手動入力、.csv ファイルのアップロード、またはこれらの組み合わせで非稼働日を定義します。

5. [トリガー] ページで、新しいトリガーの作成時または既存のトリガーの編集時に、[非稼働日の制限] ドロップダウンから希望のカレンダーを選択します。

   注:

   When you use non-working days, the trigger time zone must be the same as the tenant time zone (Tenant> Settings> General), because calendar restrictions cannot be applied in different time zones. A tenant without an explicitly defined time zone inherits it from the host.

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

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

1. カレンダーをクリックして選択します。ウィンドウの右側のカレンダーは、それに応じて更新されます。

2. 表示されたカレンダーで、トリガーの起動を停止する日付をクリックします。選択した日付を再度クリックすると、選択解除します。

3. 非稼働日として選択された日付を保存するには、[保存] をクリックします。

   

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

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

注:

.csv ファイルには、列ヘッダーとして ExcludedDate が必要です。その列には、すべての非稼働日を、YYYY-MM-DD、YYYY/MM/DD、または YYYY MM DD の形式で入力する必要があります。

See the Example section below for more information.

オプション 1

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

オプション 2

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

例

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

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

ファイルをダウンロード

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

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

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

カレンダーを削除する

1. 設定ページの [非稼働日] タブでカレンダーを選択します。

2. [削除] をクリックします。

3. ポップアップ ウィンドウで [はい] をクリックして、意図しているとおりか確認します。カレンダーが削除されます。

   注:

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

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