トリガーを管理する

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

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

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

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

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

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

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

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

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

   注:

   アクティブでない (応答なしまたは切断ステータス) ホスト名を選択すると警告が表示されます。非アクティブなセッションによって実行されるようにスケジュールされたジョブは、Orchestrator への接続が確立されるまで、保留中ステートのままになります。

   • 非アクティブなホスト名の選択に同意するには、[確認] をクリックします。
   • 前に戻って別のホスト名を選択するには、[キャンセル] をクリックします。

   同じトリガーを同じアカウントとマシンのマッピングで、ただしホスト名を追加で選択して設定すると、実行するジョブの数が 2 倍になります。

   • たとえば、アカウント A1 をマシン テンプレート MT1 にマッピングしてトリガー T1 を設定したとします。この設定では、10 個のジョブがキューに登録されます。

     その後、同じトリガー T1 を、アカウント A1 をマシン テンプレート MT1 にマッピングして、ただし今回はホスト名 H1 も選択して設定するとします。この場合、同じ 10 個のジョブが再びキューに登録されます。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. トリガーを実行する頻度を分単位で選択します。

    重要:

    The cron standard employed by our cron expressions uses a time system based on 60 minutes to an hour. This means that the only way it can execute a trigger at the exact interval configured in the Repeat every field is if the value of that interval is a divisor of 60. Otherwise, the recurrence will not entirely abide by the number of minutes in that field, thus causing execution discrepancies. To avoid this, we recommend adjusting your trigger settings or using event triggers.

    例: トリガーを 21 分間隔で実行するように設定し、ジョブを 9:00 に開始するとします。この場合、次のような実行スケジュールが作成されます。

    • 最初のジョブは 9:00 に開始されます。
    • 2 番目のジョブは 9:21 に開始されます。
    • 3 番目のジョブは 9:42 に開始されます。
    • 4 番目のジョブは 10:00 に開始されます。

    The reason why the fourth job starts after 18 minutes instead of 21 is that the cron component matches every 21^st item from a set of minutes between 1 and 59. In this example, these items are 00, 21, 42.

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

13. [ジョブの実行を終了するスケジュールを設定] トグルをオンにして、ジョブの終了方法を選択します。

    注:

    • ジョブがキューに入っている時間も、ここで設定された経過時間に含まれることになります。たとえば、ジョブを午後 1 時に実行されるようにスケジュールし、20 分後に停止するように設定した場合、そのジョブは、たとえ午後 1 時 15 分までキューにあり、その後開始されたとしても、午後 1 時 20 分には停止されます。
    • トリガーの [ジョブの実行を終了するスケジュールを設定] オプションは、手動で開始されたジョブのために保持されます。

    たとえば、トリガー T1 を作成し、以下のジョブ終了スケジュールをアクティブ化したとします。

    • ジョブの実行を終了するスケジュールを設定: 10 分後にジョブを停止

    • Schedule automatic "Kill", if the job does not stop:Kill job after 2 mins

      [オートメーション] > [トリガー] ページで、トリガー T1 に対して [ジョブを今すぐ開始] をクリックすると、[ジョブの開始] ページが開き、既に適用されているジョブ終了スケジュールが表示されます (トリガーの作成時に設定したものと同じ)。

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

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

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

      

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

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

      

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

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

      

14. [トリガーを自動的に無効化するスケジュールを設定] トグルをオンにして、トリガーを無効化する日時を入力します。タイム トリガーは、選択したタイム ゾーンで指定された日時に無効化されます。

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

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

注:

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

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

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

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

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

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

6. [ランタイムの種類] ドロップダウン メニューから、ランタイム ライセンスの種類を選択します。

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

   説明
   アカウント	プロセスは、特定のアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシン テンプレートの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
   マシン	プロセスは、選択したマシン テンプレートに接続されたホスト マシンのいずれかで実行されます。マシン テンプレートのみを指定すると、Orchestrator によりアカウントが動的に割り当てられます。アカウントとマシン テンプレートの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。 ジョブの実行に必要なランタイム ライセンスが、関連するマシン テンプレートに割り当てられていることを確認してください。
   ホスト名	マシン テンプレートを選択すると、[ホスト名] オプションが表示され、プロセスを実行する任意のワークステーション/ロボット セッションを選択できます。 アクティブなフォルダーで利用可能なすべてのセッション (未接続、切断、または接続済み) が表示されます。 注: マッピングの設定に使用できるのは Unattended ランタイムのみです。ジョブの実行に必要なランタイム ライセンスが、関連するマシン テンプレートに割り当てられていることを確認してください。

   注:

   アクティブでない (応答なしまたは切断ステータス) ホスト名を選択すると警告が表示されます。非アクティブなセッションによって実行されるようにスケジュールされたジョブは、Orchestrator への接続が確立されるまで、保留中ステートのままになります。

   • 非アクティブなホスト名の選択に同意するには、[確認] をクリックします。
   • 前に戻って別のホスト名を選択するには、[キャンセル] をクリックします。

   同じトリガーを同じアカウントとマシンのマッピングで、ただしホスト名を追加で選択して設定すると、実行するジョブの数が 2 倍になります。

   • たとえば、アカウント A1 をマシン テンプレート MT1 にマッピングしてトリガー T1 を設定したとします。この設定では、10 個のジョブがキューに登録されます。

     その後、同じトリガー T1 を、アカウント A1 をマシン テンプレート MT1 にマッピングして、ただし今回はホスト名 H1 も選択して設定するとします。この場合、同じ 10 個のジョブが再びキューに登録されます。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 menu, select the time zone according to which the queue trigger gets disabled.

11. From the Non-working days restrictions drop-down menu, 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 分には停止されます。
    • トリガーの [ジョブの実行を終了するスケジュールを設定] オプションは、手動で開始されたジョブのために保持されます。

    たとえば、トリガー T1 を作成し、以下のジョブ終了スケジュールをアクティブ化したとします。

    • ジョブの実行を終了するスケジュールを設定: 10 分後にジョブを停止

    • Schedule automatic "Kill", if the job does not stop:Kill job after 2 mins

      [オートメーション] > [トリガー] ページで、トリガー T1 に対して [ジョブを今すぐ開始] をクリックすると、[ジョブの開始] ページが開き、既に適用されているジョブ終了スケジュールが表示されます (トリガーの作成時に設定したものと同じ)。

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

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

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

      

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

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

      

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

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

      

13. [トリガーを自動的に無効化するスケジュールを設定] トグルを有効化して、トリガーを無効化する日時を入力します。タイム トリガーは、選択したタイム ゾーンで指定された日時に無効化されます。

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

トリガーを編集する

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

トリガーを無効化する

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

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

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

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

2. [トリガーを自動的に無効化するスケジュールを設定] オプションを有効化します。

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

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

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

   この値は、 Triggers.DisableWhenFailedCount パラメーターを使用してカスタマイズできます。

トリガーを有効化する

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

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

トリガーを削除する

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

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

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

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

非稼働日を管理する

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

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

   注:

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

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