メインコンテンツへスキップ

はじめに

トリガーは workflow アプリケーションでのみ利用可能です。
スケジュールトリガーを使用すると、指定した時刻または間隔で workflow を実行できます。これは、日次レポートの生成やスケジュールされた通知の送信など、繰り返し発生するタスクに最適です。

スケジュールトリガーの追加

workflow キャンバスで右クリックし、ブロックを追加 > 始める > スケジュールトリガー を選択します。
1 つの workflow は、並行して実行される複数のスケジュールトリガーで開始できます。並行分岐に同一の連続したノードが含まれている場合、共通セクションの前に変数集約ノードを追加して分岐をマージできます。これにより、各分岐で同じノードを個別に重複して追加することを回避できます。

スケジュールトリガーの設定

トリガーのスケジュールは、デフォルトのビジュアル設定または Cron 式を使用して設定できます。 設定後、次の 5 回のスケジュール実行時刻を確認できます。
スケジュールトリガーは出力変数を生成しませんが、workflow をトリガーするたびにシステム変数 sys.timestamp(各 workflow 実行の開始時刻)を更新します。

ビジュアル設定を使用

単純な毎時、毎日、毎週、または毎月のスケジュールに使用します。毎週および毎月の頻度では、複数の曜日や日付を選択できます。

Cron 式を使用

平日の午前 9 時から午後 5 時まで 15 分ごと、といったより複雑で正確なタイミングパターンに使用します。
LLM を使用して Cron 式を生成できます。

標準フォーマット

Cron 式は、workflow の実行スケジュールを定義する文字列です。スペースで区切られた 5 つのフィールドで構成され、それぞれが異なる時間単位を表します。
各フィールド間に 1 つのスペースがあることを確認してください。
* * * * *
| | | | |
| | | | |── 曜日 (0-7 または SUN-SAT、0 と 7 は両方とも日曜日)
| | | |──── 月 (1-12 または JAN-DEC)
| | |────── 日 (1-31)
| |──────── 時間 (0-23)
|────────── 分 (0-59)
曜日の両方のフィールドが指定されている場合、トリガーはどちらかのフィールドに一致する日付でアクティブになります。例えば、1 2 3 4 4 は、4 月 3 日および 4 月の毎週木曜日に workflow をトリガーします。4 月 3 日が木曜日である場合に限定されません。

特殊文字

文字
説明
*「毎」を意味します。時間フィールドの * は「毎時」を意味します。
,複数の値を区切ります。曜日フィールドの 1,3,5 は「月曜日、水曜日、金曜日」を意味します。
-値の範囲を定義します。時間フィールドの 9-17 は「午前 9 時から午後 5 時まで」を意味します。
/ステップ値を指定します。フィールドの */15 は「15 分ごと」を意味します。
L「最後」を意味します。

フィールドでは、「その月の最終日」を意味します。

曜日フィールドでは:
  • 単独で使用すると、「週の最終日」を意味します。
  • 数字と組み合わせると、「その月の最後の指定された曜日」を意味します。
フィールドの L は「1 月 31 日、4 月 30 日、または閏年でない年の 2 月 28 日」を意味します。

曜日フィールドの L は日曜日を意味します。

曜日フィールドの 5L は「その月の最後の金曜日」を意味します。
?「任意」または「特定の値なし」を意味します。

曜日フィールドに値を指定した場合、フィールドを無視するために ? を使用できます。逆も同様です。

必須ではありません。* も同様に機能するためです。
毎週月曜日にタスクを実行するには、フィールドを * の代わりに ? に設定する方がより正確です。

定義済み表現

  • @yearly:年に一度、1 月 1 日の午前 0 時に実行。
  • @monthly:月に一度、月の初日の午前 0 時に実行。
  • @weekly:週に一度、日曜日の午前 0 時に実行。
  • @daily:日に一度、午前 0 時に実行。
  • @hourly:毎正時に実行。

スケジュールCron 式
平日の午前 9 時0 9 * * MON-FRI または 0 9 * * 1-5
毎週水曜日の午後 2 時 30 分30 14 * * WED
毎週日曜日の午前 0 時0 0 * * 0
毎週火曜日の 2 時間ごと0 */2 * * 2
毎月初日の午前 0 時0 0 1 * *
1 月 1 日と 6 月 1 日の午後 12 時0 12 1 JAN,JUN *
毎月最終日の午後 5 時0 17 L * *
毎月最終金曜日の午後 10 時0 22 * * 5L

スケジュールトリガーのテスト

  • このステップを実行:スケジュールトリガーは設定されたスケジュールを無視して即座に実行されます。
  • テスト実行:スケジュールトリガーは次回の予定実行時刻まで待機します。