スケジューリングと自動化
スケジュール、イベント、API を使用してワークフロー実行を自動トリガーする
Supervity におけるスケジューリングは、特定の時刻またはイベントに応じて ワークフロー実行を自動的にトリガー できます。
重要な区別：
- スケジュールが実行をトリガーする
- ワークフローが実行を定義する
- オペレーターが動作を計画し統制する
スケジューリングは作業が いつ開始されるか を制御し、どのように行われるか は制御しません。
Supervity におけるトリガー
Supervity は実行を開始する複数の方法をサポートします。
スケジュールはトリガーの一種です。
| トリガータイプ | 目的 |
|---|---|
| Manual | ユーザーによる実行 |
| Schedule | 時間ベース自動化 |
| Webhook | 外部イベント駆動実行 |
| API | プログラム実行 |
すべてのトリガーは最終的にワークフローの 実行（ジョブ） を作成します。
スケジュールタイプ
繰り返しスケジュール
繰り返しスケジュールは固定間隔で実行をトリガーします。
サポートされるパターン：
- 毎日（特定時刻）
- 毎週（特定曜日）
- 毎月（特定日）
- 毎時（N 時間ごと）
- カスタム cron 式
例
- every weekday at 9:00 am
- first monday of each month
- every 2 hours during business hours
一回限りスケジュール
一回限りスケジュールは将来の特定時刻に単一実行をトリガーします。
一般的なユースケース：
- 遅延アクション
- リマインダー
- 延期処理
- 時間ベース承認
スケジュールの作成
スケジュールページから
- schedule に移動する
- create schedule をクリックする
- 既存のワークフローを選択する
- タイミングを設定する
- 入力を提供する（必要な場合）
- スケジュールを有効化する
保存済みオペレーターまたはワークフローから
- 保存済みオペレーターを開く（My Operators から）
- schedule をクリックする
- タイミングとオプションを設定する
- 保存して有効化する
スケジュールはワークフローを参照しますが、変更はしません。
スケジュール設定
必須フィールド
- workflow — 実行構造
- schedule type — 繰り返しまたは一回限り
- timezone — 正確性に不可欠
- active status — 実行の有効化または一時停止
オプション制御
- 失敗時の再試行
- 最大再試行回数
- 実行タイムアウト
- 成功または失敗通知
- 事前入力された入力値
スケジュールはワークフローロジックとは独立して調整できます。
タイムゾーンと信頼性
すべてのスケジュールは 設定されたタイムゾーン で実行されます。
ベストプラクティス：
- 常にタイムゾーンを明示的に設定する
- デフォルトに依存しない
- グローバルシステムには utc を使用する
- 次回実行プレビューを検証する
サマータイムの変更は自動的に処理されます。
Webhook トリガー（イベントベース自動化）
Webhook により 外部システム がリアルタイムでワークフロー実行をトリガーできます。
Webhook の仕組み
- supervity が webhook url を生成する
- 外部システムが http リクエストを送信する
- ペイロードがワークフロー入力になる
- 実行が作成され実行される
Webhook ペイロードの例
Webhook セキュリティ
Webhook は以下をサポートします。
- オプションの認証
- ペイロード検証
- レート制限
- IP 許可リスト
Webhook トリガー実行はスケジュール実行と同じ実行・ガバナンスルールに従います。
連携ベーストリガー
一部の連携は自動的にイベントを発行します。
例：
- 新着メール受信
- ファイルアップロード
- カレンダーイベント作成
- フォーム送信
内部的には Webhook トリガーと同様に動作します。
スケジュールの管理
表示と監視
schedule ページには以下が表示されます。
- 有効および一時停止中のスケジュール
- 次回実行時刻
- 前回実行ステータス
- 関連ワークフロー
一時停止と再開
- 一時停止すると今後の実行が停止する
- 実行履歴は保持される
- 設定は失われない
編集または削除
- 編集は今後の実行にのみ影響する
- 削除するとスケジュールが除去される
- 基盤のワークフローとオペレーターは変更されない
実行監視
すべてのスケジュール実行で以下が生成されます。
- 実行ログ
- ステップレベルのステータス
- 入力と出力
- 再試行履歴
失敗は可視で対処可能です。
→ 参照：ワークフローの解説
一般的なスケジューリングパターン
日次レポート
週次クリーンアップ
リアルタイムアラート
ビジネスプロセス自動化
エラーハンドリングと安全策
スケジュールは以下をサポートします。
- バックオフ付き再試行
- 実行タイムアウト
- 失敗通知
- 手動介入
実行が繰り返し失敗する場合、明確に表面化し、サイレントにループしません。
ガバナンスとアクセス制御
- 認可されたユーザーのみがスケジュールを作成・編集できる
- すべてのスケジュール変更がログ記録される
- 実行履歴は監査可能
- スケジュール実行でも承認ステップは適用される
スケジューリングはガバナンスをバイパスしません。
ベストプラクティス
安全な設計
- スケジュール前にワークフローを手動テストする
- 低頻度から開始する
- 失敗通知を有効化する
信頼性のある設計
- 重複する長時間実行スケジュールを避ける
- 重いワークロードを分散する
- 初期実行を密に監視する
スケールを意識した設計
- 操作をバッチ化する
- 並列ステップを使用する
- 実行メトリクスを追跡する
次のステップ
- 実行を理解する → ワークフローの解説
- 意思決定を委任する → オペレーターの理解
- プログラムからトリガーする → API リファレンス
- ガバナンスを追加する → 人間によるレビューと承認
スケジューリングは 作業がいつ開始されるか を定義します。
ワークフローは 何が起きるか を定義します。
オペレーターは どのように実行すべきか を決定します。