- 基本情報
- ベスト プラクティス
- テナント
- フォルダー コンテキスト
- 自動化
- プロセス
- ジョブ
- トリガー
- トリガーについて
- トリガーを管理する
- cron 式を使用する
- ログ
- 監視
- キュー
- アセット
- ストレージ バケット
- Test Suite - Orchestrator
- その他の構成
- Integrations
- クラシック ロボット
- ホストの管理
- 組織管理者
- トラブルシューティング

Orchestrator ユーザー ガイド
トリガーを管理する
linkタイム トリガーを作成する
link- フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。
- トリガーの種類として [時間] を選択します。
- 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。
- [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。
- [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。
- [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。
- [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。
説明
動的に割り当て
動的に割り当て
アカウントとマシンが明示的に選択されていない動的割り当てでは、最初に利用可能になったユーザーとマシンで、フォアグラウンド プロセスを複数回実行できます。バックグラウンド プロセスは、ビジーであるかどうかにかかわらず、任意のアカウントによって実行されます (十分な数のランタイムがある場合)。
[動的に割り当て] オプションを使用すれば、1 つのジョブでプロセスを最高 10,000 回実行できます。
アカウント
プロセスは、特定のアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
マシン
プロセスは、選択したマシン テンプレートに接続されたいずれかのホスト マシンで実行されます。マシンのみを指定すると、Orchestrator がアカウントを動的に割り当てます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。
有効なアカウントとマシンのマッピングを選択
プロセスは、特定のアカウントとマシンのペアで実行できます。
注: トリガーに使用されるマッピングの一部であるアカウントを削除したり、トリガーが存在するフォルダーへの割り当てを解除したりすることはできません。アカウントがトリガーで実行ターゲットとして設定されておらず、削除できるようになっていることを確認します。 - プロセスに入力引数がある場合、[引数] タブで、その引数の値を設定します。
- [タイムゾーン] ドロップダウンから、トリガーをオフにするタイムゾーンを選択します。注:
- トリガーのタイムゾーンはテナントのタイムゾーンには依存しません。タイム トリガーの実行に別のタイム ゾーンを設定できます。
- 夏時間 (DST) を使用する地域は、協定世界時 (UTC) との時差に基づいてリストに表示されます。DST の期間中でも UTC 時差の値は増加しません。たとえば、DST の期間でもロンドンのタイムゾーンは UTC+00:00 と表示されます。
- DST を考慮するためにタイムゾーンを調整する必要はありません。Orchestrator のスケジュール メカニズムがジョブの起動時に自動的に DST を考慮するからです。12:00 に実行がスケジュールされているジョブは、冬時間、夏時間のいずれでも 12:00 に実行されます。
- トリガーの実行頻度を選択します (分、時間、日、週、月、カスタム)。このセクションの右側で、選択したオプション (頻度、正確な時間、または cron 式) に応じて詳細を設定します。Orchestrator はオープンソース ライブラリを使用して cron の記述を解析して表示します (詳細についてはこちらを参照)。注:
cron 式は非稼働日と組み合わせて使用できます。つまり、トリガーが cron 式を使用して、除外日に当たる日に実行されるよう設定されている場合、その日はスキップされて、トリガーが次に利用可能な日に再スケジュールされます。
- 特定の非稼働日にトリガーの起動を停止する場合は、[非稼働日制限] ドロップダウンから非稼働日カレンダーを選択します。
- [ジョブの実行を終了] オプションを有効化して、ジョブの終了方法を選択します。注: ここで指定した時間は、ジョブがキューに置かれた場合でも設定に従って経過します。たとえば、午後 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 分以上「停止中」ステートが続いているジョブに対して強制終了が試行されます。
- ドロップダウンから [停止] を選択 - ジョブが「保留中」または「実行中」ステートになってから指定した期間が経過した後に、実行の終了を試行します (期間を最短 1 分、最長 10 日、1 日は 23 時間 59 分として設定)。
- [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。タイム トリガーは、選択したタイム ゾーンで指定された日時に無効化されます。
- ジョブの開始用に設定されたアカウントとマシンのコンテキストを維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] チェックボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。
キュー トリガーを作成する
link- フォルダーで [オートメーション] > [トリガー] に移動し、[トリガー] ページの [新しいトリガーを追加] をクリックします。[トリガーを作成] ページが表示されます。
- トリガーの種類として [キュー] を選択します。
- 簡単に識別できるように、[名前] フィールドにトリガーの名前を追加します。
- [プロセス名] ドロップダウンから、タイム トリガーを設定するプロセスを選択します。
- [ジョブの優先度] ドロップダウンから、ジョブの優先度を選択します。既定値は [継承] で、ジョブの優先度は選択されたプロセスに定義された優先度と同じになります。
- [ジョブの種類] ドロップダウンから、ランタイムの種類 (トリガーによって起動されたジョブを実行する実行スロットの種類) を選択します。
- [実行ターゲット] タブで、ジョブの割り当てメカニズムと実行ターゲットを選択します。
説明
アカウント
プロセスは、特定のアカウントにより実行されます。アカウントのみを指定すると、Orchestrator によりマシンが動的に割り当てられます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
マシン
プロセスは、選択したマシン テンプレートに接続されたいずれかのホスト マシンで実行されます。マシンのみを指定すると、Orchestrator がアカウントを動的に割り当てます。アカウントとマシンの両方を指定すると、ジョブはそのアカウントとマシンのペアで開始されます。
注:ジョブの種類に一致したランタイムが、関連するマシン テンプレートに割り当てられていることを確認してください。アクティブなフォルダーに関連付けられた、接続済みのホスト マシンだけが表示されます。
- プロセスに入力引数がある場合、[引数] タブで、その引数の値を設定します。
- [最初のジョブをトリガーする、アイテムの最小数です。]、[同時に許可されている保留中および実行中のジョブの最大数です。]、[指定した数のアイテムが追加されるたびにジョブをトリガー] の各フィールドに値を入力します。
説明
最初のジョブをトリガーするアイテムの最小数
アイテム処理ジョブは、ターゲット キューに少なくともこの数の新しいアイテムが追加された後にのみ開始されます。 延期済みのキュー アイテムはカウントされません。
同時に許可される保留中および実行中のジョブの最大数
一緒にカウントされる、許可された保留中および実行中のジョブの最大数。 同時に 2 つ以上のジョブを許容する場合は、次に示す 3 番目のオプションを定義する必要があります。
指定した数のアイテムが追加されるたびにジョブをトリガー
新しいジョブをトリガーする新しいキュー アイテムの数 ([最初のジョブをトリガーするアイテムの最小数] オプションで設定された数に追加)。
- [タイムゾーン] ドロップダウンから、キュー トリガーを無効化する基準となるタイムゾーンを選択します。トリガーのタイムゾーンはテナントのタイムゾーンには依存しません。
- 特定の非稼働日にトリガーの起動を停止する場合は、[非稼働日制限] ドロップダウンから非稼働日カレンダーを選択します。
- [指定日時でトリガーを無効化] トグルを有効化して、トリガーを無効化する日時を入力します。キュー トリガーは、手順 10 で選択したタイム ゾーンでの、指定された日時に無効化されます。
- ジョブの開始用に設定されたアカウントとマシンのコンテキストを維持するには、[ジョブの再開時にアカウントとマシンの割り当てを維持する] チェックボックスをオンにします。これにより、ライセンスとリソースの使用状況が最適化されます。
トリガーを編集する
link該当する [編集] ボタンをクリックして、必要に応じて変更を行い、[トリガーを編集] ウィンドウで [更新] をクリックします。
トリガーを無効化する
linkトリガーを無効化するには、対応する [その他のアクション] ボタンをクリックしてから、[無効化] をクリックします。無効化されたタイム トリガーの前には アイコンが表示されます。無効化されたキュー トリガーの前には
アイコンが表示されます。
または、それを選択して [無効化] をクリックします。
将来の特定の日時に、トリガーを自動的に無効化することもできます。これを行うには、次の手順に従います。
- 該当する [編集] ボタンをクリックします。
- [指定日時でトリガーを無効化] オプションを有効化します。
- 希望の日付と時刻を入力します。トリガーのタイム ゾーンは、トリガーが無効化されるときに影響します。
- [更新] をクリックすると、変更が反映されます。既定では、過去 1 日間正常に起動できていないトリガーが起動に 10 回失敗すると、そのトリガーは自動的に無効化されます。この値は
Triggers.DisableWhenFailedCount
パラメーターを使用してカスタマイズできます。
トリガーを有効化する
linkトリガーを有効化するには、対応する [その他のアクション] ボタンをクリックし、[有効化] をクリックします。有効化されたタイム トリガーは、その前に アイコンでマークされます。有効化されたキュー トリガーは、その前に
でマークされます。
または、該当するスケジュールを選択して [有効化] をクリックします。
トリガーを削除する
linkトリガーを削除するには、該当する [その他のアクション] ボタンをクリックし、次に [削除] をクリックします。
または、該当するスケジュールを選択して [削除] をクリックします。
トリガーにより開始されたジョブを表示する
link指定のスケジュールにより開始したジョブを表示するには、[その他のアクション] ボタンをクリック後、[ジョブを表示] をクリックします。[ジョブ] ウィンドウが表示され、選択されたトリガーにより過去に実行されたすべてのジョブ (該当する場合) が表示されます。
非稼働日を管理する
link新しいカレンダーを作成する
- [設定] ページで [非稼働日] タブを開きます。以前に定義されたすべてのカレンダーのリストがアルファベット順に表示されます。
BankHoliday カレンダーが存在する場合、ここに表示されます。非稼働日を定義した Orchestrator を 19.10 にアップグレードすると、このカレンダーが作成されます。
- [追加] をクリックして新しいカレンダーを作成し、強調表示されている空白のフィールドに、そのカレンダーの名前を入力します。名前は一意とする必要があり、最大 150 文字の英数字を入力できます。名前のないカレンダーや空白文字のみの名前のカレンダーは作成できません。
- [保存] をクリックするか、キーボードの Enter キーを押して、新しいカレンダーを保存します。カレンダーが保存されて、カレンダー リストに表示されます。
- 選択したカレンダーに、手動入力、.csv ファイルのアップロード、またはこれらの組み合わせで非稼働日を定義します。
- [トリガー] ページで、新しいトリガーの作成時または既存のトリガーの編集時に、[非稼働日の制限] ドロップダウンから希望のカレンダーを選択します。注: 非稼働日を使用する場合、トリガーのタイム ゾーンはテナントのタイム ゾーン ([テナント] > [設定] > [全般] タブ) と同じである必要があります。カレンダーの制限は別々のタイムゾーンで適用できないためです。タイム ゾーンが明示的に定義されていないテナントは、ホストからタイム ゾーンを継承します。
- [更新] をクリックすると、変更が反映されます。カレンダーに行う変更はすべて、その後そのカレンダーに関連するすべてのトリガーに入力されます。
手動で非稼働日を選択する
- カレンダーをクリックして選択します。ウィンドウの右側のカレンダーは、それに応じて更新されます。
- 表示されたカレンダーで、トリガーの起動を停止する日付をクリックします。選択した日付を再度クリックすると、選択解除します。
- 非稼働日として選択された日付を保存するには、[保存] をクリックします。
.csv ファイルをアップロードする
.csv ファイルから、選択したカレンダーに一連の日付を直接アップロードできます。正常にアップロードされるように、事前定義した形式でデータをファイルに入力しておく必要があります。アップロードしたファイルの新しい日付によって、カレンダーに既に保存されている日付が上書きされます。
ExcludedDate
が必要です。その列には、すべての非稼働日を、YYYY-MM-DD
、YYYY/MM/DD
、または YYYY MM DD
の形式で入力する必要があります。
詳細については、下記の「例」セクションをご覧ください。
オプション 1
- 選択したカレンダーで、[CSV をアップロード] をクリックします。
- 希望の .csv ファイルに移動し、選択して、[開く] をクリックします。 Orchestrator はファイルを解析して、フォーマット ルールを満たしていることを確認します (以下の例のセクションをご覧ください)。
- 確認ダイアログで [はい] をクリックして、カレンダーに既に含まれている日付をアップロードされたファイルの新しい日付で上書きします。
- 変更されたカレンダーを保存するには、[保存] をクリックします。
オプション 2
.
ファイルをドラッグして、選択したカレンダーの上部にドロップします。Orchestrator によってファイルが解析され、フォーマット ルールを満たしていることが確認されます (以下の「例」セクションをご覧ください)。- 確認ダイアログで [はい] をクリックして、カレンダーに既に含まれている日付をアップロードされたファイルの新しい日付で上書きします。
- 変更されたカレンダーを保存するには、[保存] をクリックします。
例
次に示す .csv ファイルの内容をカレンダーにアップロードするとします。このようなファイルを容易に作成するには、データを Excel ファイルに入力して .csv ファイルとして保存します。
または、すべての列ヘッダーを入力済みの .csv ファイルをダウンロードして、ニーズに合わせてカスタマイズすることもできます。
このファイルには、列ヘッダー ExcludedDate が事前定義されています。すべての非稼働日を、YYYY-MM-DD、YYYY/MM/DD、または YYYY MM DD のいずれかの形式でこの列に入力します。
カレンダーの名前を変更する
- 設定ページの [非稼働日] タブでカレンダーを選択します。
- カレンダーの名前を変更します。
- 変更された名前を保存するには、[保存] をクリックします。
カレンダーを削除する
- 設定ページの [非稼働日] タブでカレンダーを選択します。
- [削除] をクリックします。
- ポップアップ ウィンドウで [はい] をクリックして、意図しているとおりか確認します。カレンダーが削除されます。注: トリガーに割り当てられていないカレンダーのみを削除できます。
カレンダーから非稼働日を削除することもできます。非稼働日をクリックすると、その日はマークされなくなります。変更は必ず保存してください。