注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
FoundryはANDおよびORトリガーの任意のネストをサポートしており、特定のカスタマイズされたトリガーを作成することができます。
タイムトリガーとは、指定された瞬間に満たされるトリガーです。
タイムトリガーは、指定された瞬間にのみ満たされます。指定された瞬間が過ぎると、タイムトリガーは満たされなくなります。
タイムトリガーは、cron式とタイムゾーンを使用して定義されます。
スケジュールエディタは、cron式を書かずにシンプルなタイムトリガーを定義するための使いやすいインターフェースを提供しています。
より複雑なタイムトリガーは、カスタムcron式を書く必要がある場合があります。
スケジュールエディタは、5つのフィールドを持つ標準のUnix cron式フォーマットを使用します。
+--------- 分
| +------- 時
| | +----- 月の日にち
| | | +--- 月
| | | | +- 週の日にち
| | | | |
* * * * *
スケジュールエディターでは、各フィールドに以下の値を設定することができます：
| フィールド | 許可される値 | 特殊文字 | 備考 |
|---|---|---|---|
| 分 | 0-59 | * - / , | |
| 時 | 0-23 | * - / , | |
| 月の日 | 1-31 | * - / , L | |
| 月 | 1-12 または JAN-DEC | * - / , | |
| 曜日 | 0-6 または SUN-SAT | * - / , L # | 7 も日曜日として扱います |
特殊文字の意味は以下の通りです：
アスタリスク (*): すべての値を指定します。
例:
| 分 | 意味 |
|---|---|
* | 毎分 |
ハイフン (-): 値の範囲を指定します。
例:
| 分 | 意味 |
|---|---|
10-20 | 10 から 20 までの分、両端を含む |
スラッシュ (/): ステップ範囲の値を指定します。
ステップ範囲は、値または範囲を使用して定義することができます：
例:
| 分 | 意味 |
|---|---|
25/10 | 25 から始まる毎10分（25, 35, 45, 55） |
25-45/10 | 25 から 45 までの毎10分、両端を含む（25, 35, 45） |
カンマ (,): 値、範囲、またはステップ範囲のリストを指定します。
例:
| 分 | 意味 |
|---|---|
10,20,30 | 分の 10, 20, 30 |
10,20-30 | 分の 10 と 20 から 30 まで、両端を含む |
10,25-45/10 | 分の 10 と 25 から 45 までの毎10分、両端を含む |
L (L): 最後の値を指定します。
L の意味は、使用方法によります：
例:
| 月の日 | 意味 |
|---|---|
L | 月の最終日 |
| 曜日 | 意味 |
|---|---|
L | 週の最終日（土曜日） |
2L | 月の最終火曜日 |
ハッシュ (#): 月の第n週の曜日を指定します。
例:
| 曜日 | 意味 |
|---|---|
2#4 | 月の第4火曜日 |
時間トリガーは、cron 式が現在の日時と一致したときに満たされます。
月の日フィールドと曜日フィールドの両方が * でない場合、現在の日時と一致する方があればトリガーが満たされます。
例:
| Cron Expression | 意味 |
|---|---|
30 9 * * 1 | 月曜日の 9:30 |
30 17 * 2 1 | 2月の月曜日の 17:30 |
0 9-17 10 * * | 月の10日の 9:00 から 17:00 までの毎時 |
0 9-17/2 10 * * | 月の10日の 9:00 から 17:00 までの2時間ごと |
0 9,17 10 * * | 月の10日の 9:00 と 17:00 |
0/5 9-17 15 3 * | 3月の15日の 9:00 から 17:55 までの5分ごと |
0/5 9,17 15 3 * | 3月の15日の 9:00 から 9:55 と 17:00 から 17:55 までの5分ごと |
0 9 L * * | 月の最終日の 9:00 |
0 9 L 2 * | 2月の最終日の 9:00 |
0 9 * * L | 土曜日の 9:00 |
0 9 * * 2L | 月の最終火曜日の 9:00 |
0 9 * 4 3#1 | 4月の第1週の水曜日の 9:00 |
0 9 20 * 4 | 月の20日と木曜日の 9:00 |
すべての時間トリガーは、指定されたタイムゾーンの実時間で評価されます。cron 式を満たす実時間が発生するたびに時間トリガーが満たされます。時間の変更は以下のように扱われます：
例:
イベントトリガーは、指定したイベントが発生したときに一度だけ満たされるトリガーです。
イベントが発生した後もイベントトリガーは満たされたままで、スケジュールが実行されるまで満足状態が続きます。
現在、スケジュールエディターは以下のイベントタイプをサポートしています：
複合トリガーは、AND トリガーと OR トリガーを使用して複数のコンポーネントトリガーを組み合わせて作成します。
AND トリガーは、そのコンポーネントトリガーの接続を作成します。OR トリガーは、そのコンポーネントトリガーの選言を作成します。例:
以下の例では、T1, T2 は時間トリガーで、E1, E2 はイベントトリガーです。
| トリガー | 意味 |
|---|---|
AND(T1, E1) | E1 が発生した場合に T1 で満たされます |
OR(T1, E1) | T1 または E1 が発生したときに満たされます |
AND(T1, T2) [1] | T1 と T2 の両方を満たす時間に満たされます |
OR(T1, T2) | T1 または T2 のいずれかで満たされます |
AND(E1, E2) | E1 と E2 の両方が発生したときに満たされます |
OR(E1, E2) | E1 または E2 のいずれかが発生したときに満たされます |
AND(T1, OR(E1, E2)) | E1 または E2 のいずれかが発生した場合に T1 で満たされます |
OR(T1, AND(E1, E2)) | T1 または E1 と E2 の両方が発生したときに満たされます |
[1] 複数の時間トリガーを持つ AND トリガーを作成すると、すべての時間トリガーが一致したときにのみ満たされます。例えば、毎日のトリガーと毎時のトリガーを持つ AND トリガーは、1日に1回しか満たされません。代わりに、より具体的な単一の時間トリガーを使用すべきです。上記の例では、AND トリガーは毎日のトリガーだけに置き換えるべきです。