スケジュールトリガー

スケジュールトリガー（Schedule Trigger）ノードは、スケジュールに従ってワークフローを自動で実行します。たとえば、20 分ごと、毎日 9:00、平日の 18:30 などです。スケジュールは、選んだタイムゾーンで解釈されるルールのリストで、いずれかのルールが一致するたびにワークフローが実行されます。トリガーは無料で、スイッチがオンの間だけ実行されます。

使いどころ

• 毎日の画像、ニュースの要約、名言の動画など、生成したコンテンツを毎日公開します。
• Web スクレイピング（Web Scrape）や Telegram チャンネルフィード（Telegram Channel Feed）で、ソースを定期的に確認します。
• エディターを開かずに、週次や月次のレポートを作ります。
• Webhook トリガー（Webhook Trigger）と組み合わせて、同じワークフローを、スケジュールでも必要なときにも実行します。

クイックスタート

スケジュールをオンにする

スケジュールは、スイッチがオンの間だけ実行されます。ノードを配置してワークフローを保存すると、スケジュールは登録されますが、開始はされません。オンにするまで、ノードには一時停止中と表示されます。

• 設定パネルでは、上部のスイッチを使います。スイッチには、スケジュールはオンですまたはスケジュールは一時停止中ですと表示されます。
• エディター上部のバーでは、ワークフローにスケジュールトリガーがあると、スケジュールボタンが表示されます。ボタンには、スケジュール：オン、スケジュール：オフ、または 1/2 件のスケジュールがオンのように表示されます。クリックすると、ワークフローのすべてのスケジュールをオンにします。すべてがすでにオンの場合はオフにします。どちらの場合も、ワークフローが保存されます。

スイッチをオフにすると、同じようにスケジュールが一時停止します。インポートしたワークフローやテンプレートでは、スケジュールは必ず一時停止の状態で始まります。API、SDK、MCP で書き込んだスケジュールは、ノードの active フィールドが true の場合にだけオンになります。

スケジュールをオンにせずに、今すぐ分岐を試すには、設定パネルの下部にあるここから実行をクリックします。どこにも接続していないトリガーには、実行を始める分岐がありません。その場合は、代わりにワークフロー全体を実行してください。

設定

ルール

各ルールには、トリガーの間隔と、それに対応するフィールドがあります。

• 起点は固定：「N 日、N 週、N か月ごと」は、暦の固定された時点から数えます。ワークフローを保存し直しても、実行される日がずれることはありません。
• cron の形式：フィールドは、分、時、日、月、曜日の順です。日と曜日の組み合わせも含め、すべてのフィールドが一致する必要があります。一部の cron ツールでは、日と曜日はどちらか一方が一致すれば実行されます。0 と 7 は、どちらも日曜日を表します。

実行タイミング

保存する前に、設定パネルの実行タイミングに、ルールの意味が表示されます。

• スケジュールの説明文と、1 日あたりの実行回数。
• 今日の実行を示す 24 時間のバー。
• 次の 3 回の実行と、それぞれまでの残り時間。

ノードには、同じ概要、次の実行、スケジュールが有効か一時停止中かが表示されます。プレビューはサーバーと同じ計算を使うので、実際に起きることがそのまま表示されます。

スケジュールによる実行の仕組み

• 1 分に 1 回：Nodaro はすべてのスケジュールを 1 分ごとに確認し、ルールがその分に一致すると実行を開始します。再起動の後や時刻が巻き戻ったときでも、同じ分が 2 回実行されることはありません。時刻の切り替えで飛ばされた分は、その日はスキップされます。
• 一度に 1 つの実行：ワークフローの前回の実行がまだ続いている場合、その分の実行はスキップされます。
• 最大実行回数：その回数だけ実行すると、スケジュールは止まります。スケジュールは登録されたままなので、続けるには上限を引き上げるか、空欄にしてください。
• 出力：出力のペイロードが、実行の時刻を渡します。

スケジュールによる実行で動く範囲

ほかのノードに接続したトリガーは、その分岐だけを実行します。つまり、トリガーより後のノードと、それらが入力として必要とするすべてのノードです。分岐の外にあるノードは実行されず、そのまま残ります。どこにも接続していないトリガーは、ワークフロー全体を実行します。そのため、1 つのワークフローに複数のトリガーを置き、それぞれに自分の分岐を開始させることができます。

ノードが接続されているとみなされるのは、線で結んだ接続があるとき、トリガーが入力を渡すグループ（Group）の中にあるとき、またはフィールドのマッピングで結ばれているときです。設定パネルには、どちらに当てはまるかが「接続済み：このトリガー以降の分岐のみが実行されます。」または「未接続：ワークフロー全体が実行されます。」と表示されます。トリガーが制限するのは、そのトリガーが開始した実行だけです。エディターからの手動実行、API からの実行、公開したアプリの実行が、トリガーの分岐に限定されることはありません。

トラブルシューティング

• ノードに「一時停止中」と表示される：スイッチがオフです。設定パネルか、上部のバーにあるスケジュールボタンでオンにしてください。
• ノードに「実行不可」と表示される：ルールが実行できない状態です。たとえば、式のない cron ルールや、曜日のない週単位のルールです。または、サーバーが認識できないタイムゾーンが設定されています。問題を修正して、もう一度保存してください。
• 実行される時刻がずれる：タイムゾーンを確認してください。空欄の場合、ルールは UTC を使います。
• 実行がスキップされた：その時点で、ワークフローの前回の実行がまだ続いていました。
• 以前のスケジュールが実行されなくなった：ルールの仕組みができる前に保存されたスケジュールは、スケジュールがルールに書き換えられた状態で開き、一時停止の状態で始まります。オンにしてください。実行は時計の区切りに合わせて行われるようになったため、「5 分ごと」は :00、:05、:10…の時点を意味します。

API から

GET /v1/workflows/<id>/triggers は、ワークフローのトリガーを一覧表示します。スケジュールの設定はノードと同じルールを使い、kind、every、hour、minute、weekdays（0 が日曜日、6 が土曜日）、dayOfMonth、cron に加えて、省略可能な timezone と maxExecutions を持ちます。スケジュールを一時停止するには、ノードのスイッチを使ってください。PATCH /v1/workflow-triggers/<id> で送った一時停止は、次にワークフローを保存するまでしか続きません。API から直接作成したスケジュールはどのノードにも属さず、ワークフローにスケジュールトリガーが 2 つある場合、そのようなスケジュールはワークフロー全体を実行します。Webhook を参照してください。