メインコンテンツへスキップ
⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

はじめに

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

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

ワークフローキャンバスで右クリックし、ブロックを追加 > 始める > スケジュールトリガー を選択します。

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

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

ビジュアル設定を使用

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

Cron 式を使用

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

標準フォーマット

Cron 式は、ワークフローの実行スケジュールを定義する文字列です。スペースで区切られた 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 月の毎週木曜日にワークフローをトリガーします。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

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

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