トリガー：スケジュールの設定方法
この記事では、トリガー機能のうち、スケジュールの設定方法について紹介します。
【できるようになること】
- スケジュールの新規登録
- スケジュールの編集
AUTOROでは、あらかじめ登録した時刻にロボットを稼働させる運用が可能です。
毎日17時に実行、金曜のみ9～19時の間だけ1時間おきに実行、月末日のみ実行、などのスケジュールを登録できます。
2023年8月より「スケジュール」画面は「トリガー」画面に名称を変更しました。
スケジュールの登録方法
スケジュールの登録方法を紹介します。
- トリガー画面に遷移します
- トリガー画面右上の「追加」をクリックします。
- ポップアップから「スケジュール実行」をクリックします
- 「ワークフローを選択」の項目をクリックします。
- 定期実行するワークフロー名を選択します。
※選択できるのは同一プロジェクト内のワークフローのみです。
- 何月？：実行する月を数字で指定します。毎月の場合は「*」を設定。
- 何日？：実行する日を数字で指定します。毎日の場合は「*」を設定。
- 何時？：実行する時間を数字で指定します。毎時の場合は「*」を設定。
- 何分？：実行する分をプルダウンから選択します。チェックマークをつけると10分毎。※1分単位の指定は後述するCronで設定します。
- 何曜日？：実行する曜日にチェックマークをつけます。
現在時間から、10件分の実行予定時間を確認することができます。意図した時間が予約されているか確認しましょう。
- 「次の10件のスケジュールを確認」をクリックします。
予約された実行時間に、ワークフローが実行されなかった場合、指定のコラボレーターに通知されます。
通知されるのは以下の場合です。
- ロボットに空きがなく、キューに溜まったとき
[送信元]AUTORO<noreply@autoro.io> [件名]スケジュールエラー通知 [AUTORO] [本文] <ユーザー名> さん 設定された時刻にワークフローが実行されませんでした。 ロボットに空きがなかったため、実行キューに追加されました。ロボットが空き次第実行されます。 プロジェクト名 <プロジェクト名> ワークフロー名 <ワークフロー名> 実行予定時刻 <実行予定時刻> 詳細を確認する このメールは、AUTOROより自動で送信しています。 https://www.autoro.io/ オートロ株式会社
- AUTORO側の不具合で、キューに溜まったとき
[送信元]AUTORO<noreply@autoro.io> [件名]スケジュール遅延通知 [AUTORO] [本文] <ユーザー名> さん 設定された時刻にワークフローが実行されませんでした。 実行を試みましたが、スケジュールはキューに追加されました。稼働中のロボットに空きが生じたら直ちに実行されます。 プロジェクト名 <プロジェクト名> ワークフロー名 <ワークフロー名> 実行予定時刻 <実行予定時刻> 詳細を確認する このメールは、AUTOROより自動で送信しています。 https://www.autoro.io/ オートロ株式会社
エラーが発生した場合には通知されないのでご注意ください。
- 最後に「このスケジュール設定を登録する」ボタンを押します。
- トリガー一覧に登録したスケジュール設定が表示されていれば、設定完了です。
細かい時間指定のためのCron設定例
スケジュール登録の際にCronを使用すると、上述の方法より細かい時間指定をすることが可能です。
Cronは、5つの項目（分・時・日・月・曜日）をスペース区切りで記述し、
実行タイミングを数値や記号（* や / など）で指定するスケジュール設定形式です。
記述例 ： 0 2 * * *
→ 毎日2時0分に実行する設定です。
細かい時間指定の例
- 毎日、9～19時までの2時間おき
- 毎週金曜、全時間、15分おき
- 13日の金曜日
- 平日の13時～14時、16時～17時台の30分、五十日(ごとうび)、1月3月5月7月8月10月12月で曜日は問わない
以下に、Cronの指定方法とCronの一例をご紹介します。
Cronは、5つの項目を左から順に指定するルールで記述します。
分 時 日 月 曜日
■ 各項目の意味
分 ： 0〜59
時 ： 0〜23
日 ： 1〜31
月 ： 1〜12
曜日 ： 0〜7（0と7は日曜）
または、SUN、MON、TUE、WED、THU、FRI、SAT
■ よく使う記号
* ： すべて（毎回）
, ： 複数指定（例：1,15）
– ： 範囲指定（例：1-5）
/ ： 間隔指定（例：*/10）
# ： 第n番目曜日（例：MON#2）
L ： 月の最終日
■ 例0 9 * * 1-5
→ 平日(月〜金)の9時0分に実行します。
- スケジュール登録フォームを開きます。
- スケジュールのCron欄に直接Cronを入力します。
※「何月？」～「何曜日？」で作成したCronを編集することも可能です。 - 「次の10件のスケジュールを確認」で、Cronによるスケジュールを確認します。
- スケジュールを登録します。
| スケジュール条件 | Cron |
|---|---|
| 毎月の月末日、15:30 | 30 15 L * * |
| 毎月の第3水曜、0:11 | 11 0 * * WED#3 |
| 毎日、9～19時、2時間おき | 0 9-19/2 * * * |
| 毎週金曜、全時間、15分おき | */15 * * * FRI |
| 平日、8～22時59分、20分おき | */20 8-23 * * ,MON-FRI |
| 13日、金曜日、全時間、4分おき | */4 * 13 * FRI |
| 平日、13～14時台、16～17時台の30分おき | */30 13-14,16-17 * * MON,TUE,WED,THU,FRI |
| 毎日、4,6,9,11月の30日、17時45分 | 45 17 30 4,6,9,11 |
| 平日、五十日(ごとうび)、13～14時、16時～17時台の30分、1,3,5,7,8,10,12月 | 30 13-14,16-17 5-29/5,31 1,3,5,7,8,10,12 MON-FRI |
祝日については、スケジュールやCronだけでは判定できません。
AUTOROでは、Googleが提供する日本の祝日カレンダーを利用し、ワークフローがスケジュールによって実行されたタイミングが祝日か否かを判断することができます。
詳細は以下記事をご参照ください。
最終営業日の判定は、cronでは指定ができません。
最終営業日に実行したい場合は、以下の記事をご参照ください。