Adobe Workfront Fusion のインスタントトリガー(Web フック)
多くのサービスでは、サービスで特定の変更が発生した場合に即座に通知を受け取る Web フックが用意されています。これらの通知を処理するには、インスタントトリガーを使用することをお勧めします。これらは Adobe Workfront Fusion のタグによって簡単に認識できます。
サービスが Web フックを提供しない場合は、ポーリングトリガーを使用してサービスを定期的にポーリングする必要があります。
Workfront Fusion の web フックの概要ビデオについて詳しくは、次を参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
Web フックのキューを表示する
受信 Web フックからのメッセージはすべて、Web フックのキューに保存されます。
-
左側のメニューで、「Web フック」をクリックします。
-
キューを表示する Webhook を見つけます。
-
トラックのアイコンと受信した Web フックの数を含むボタンをクリックします。
note note NOTE 「データは機密情報」オプションの設定に関係なく、受信 Web フックデータは常にキューに保存されます( Adobe Workfront Fusion のシナリオ設定パネルで説明されています)。シナリオでデータが処理されるとすぐに、そのデータはシステムから完全に削除されます。
インスタントトリガーをスケジュールする
シナリオにインスタントトリガーが含まれる場合、シナリオが直ちに実行されるようにスケジュールできます。
この場合、Workfront Fusion がサービスから新しいデータを受信すると、シナリオはすぐに実行されます。シナリオの実行後、キュー内で待機中の保留中の Web フックの総数がカウントされ、シナリオは保留中の Web フックの数と同じ数のサイクルを実行し、サイクルごとに 1 つの Web フックを処理します。詳しくは、 Adobe Workfront Fusion でのシナリオの実行、サイクル、フェーズを参照してください。
-
サイクルは、シナリオ実行とは異なります。1 回のシナリオ実行で複数のサイクルを実行できます。
-
即時実行がスケジュールされたインスタントトリガーでシナリオを実行する場合、次の例外が適用されます。
-
2 つの実行間の間隔は、料金プランに基づく最小間隔の影響を受けません。
例えば、シナリオの実行が完了すると、Web フックのキューが再度チェックされます。保留中の Web フックがある場合は、シナリオが直ちに再実行され、保留中の Web フックがすべて再度処理されます。
-
サイクルの最大数のシナリオ設定は無視され、100 に設定されます。つまり、1 回のシナリオの実行中に処理される保留中の Web フックが 100 個以下になります(1 サイクルあたり 1 イベントの割合で)。
-
即時以外のスケジュール設定を使用する場合、シナリオは指定した間隔で実行されます。間隔中に複数の Web フックがキューに集まる可能性があるため、1 回のシナリオ実行でより多くの Web フックを処理するには、最大サイクル数をデフォルトの 1 よりも大きい値に設定することをお勧めします。
- シナリオ下部のシナリオ設定アイコン をクリックします。
- 表示される「シナリオ設定」ボックスで、「最大サイクル数」ボックスに数値を入力して、シナリオを実行するたびに実行するキューからの Web フックの数を示します。
レート制限
現在のレート制限は、1 秒あたり 5 Web フックです。制限を超えた場合は、429 ステータスコードが返されます。
非アクティブな Web フックの有効期限
120 時間を超えてどのシナリオにも割り当てられていない Web フックは削除されます。
Web フックペイロード
Workfront Fusion は、30 日間、Web フックペイロードを保存します。作成後 30 日を超える Web フックペイロードにアクセスすると、「ストレージからファイルを読み取れませんでした。」というエラーが発生します。
エラー処理
インスタントトリガーでシナリオにエラーが発生した場合は、次のようになります。
- 即時停止 - シナリオが即時に実行されるように設定されている場合。
- 3 回失敗すると停止(エラーが 3 回) - シナリオがスケジュールどおりに実行されるように設定されている場合。
シナリオの実行中にエラーが発生した場合、Web フックは、インスタントトリガーのロールバックフェーズ中にキューに戻されます。このような状況では、シナリオを修正して再実行することができます。詳しくは、 Adobe Workfront Fusion でのシナリオの実行、サイクル、フェーズの記事のロールバックを参照してください。
シナリオに Web フックの応答モジュールがある場合、エラーは Web フックの応答に送信されます。Webhook の応答モジュールは、常に最後に実行されます(シナリオ設定の「自動コミット」オプションが有効になっていない場合)。詳しくは、Web フックの記事の Web フックへの応答を参照してください。
カスタム Web フック
独自の Web フックを作成できます。詳しくは、Web フックを参照してください。
Webhook の無効化
次のいずれかに該当する場合、Web フックは自動的に非アクティブ化されます。
- Web フックが 6 日以上どのシナリオにも接続されていない
- Web フックが、非アクティブなシナリオ(非アクティブになってから 30 日を超えたシナリオ)でのみ使用される。
非アクティブ化された web フックは、いかなるシナリオにも接続されておらず、非アクティブ状態となって 30 日が経過した場合、自動的に削除され、登録解除されます。