インスタントトリガー（Webhook）
多くのサービスでは、サービス内で特定の変更（イベント）が発生したときに即座に通知を配信する Webhook を提供しています。 これらのイベントを処理するには、インスタント トリガーを使用することをお勧めします。 インスタントトリガーは、特定のコネクタのモジュールのリストに Instant タグを表示します。
コネクタに Webhook が含まれていない場合は、次のいずれかを実行できます。
- Webhook モジュールを使用してカスタム Webhook を作成します。
詳しくは、Web フックを参照してください。 - ポーリングトリガーを使用して、サービスを定期的にポーリングします。
詳しくは、 シナリオのスケジュール設定 を参照してください
Workfront Fusion の web フックの概要ビデオについて詳しくは、次を参照してください。
アクセス要件
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
任意のAdobe Workfront ワークフローパッケージと任意のAdobe Workfront Automation and Integration パッケージ WorkfrontUltimate Workfront Fusion を追加購入したWorkfront Primeおよび Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 ワークまたはそれ以上 |
| 製品 | 組織がWorkfront Automation and Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件 を参照してください。
Webhook の詳細の表示
Webhook エリアで、Webhook のリストを表示できます。
-
Webhook エリアを開くには、左側のナビゲーションで Webhook アイコン
ここには、Webhook のリストが表示されます。
-
特定の Webhook を検索するには、検索語句を「検索」ボックスに入力します。
-
Webhook をコピーするには、その Webhook の行の URL の近くにあるコピーアイコン
-
Webhook を無効または有効にするには、その Webhook の行のステータス列にあるトグルを無効または有効にします。
-
Webhook キューがいっぱいかどうかを確認するには、「完全なキュー」列を確認します。 この列の数値は、現在キューにあるアイテムの数です。
-
Webhook で処理された操作を表示するには、その Webhook のフルキュー列の 操作 をクリックします。
-
Webhook の有効期限が切れているかどうかを確認するには、「有効期限」列を確認します。 期限切れの Webhook がシナリオに添付されていないか、120 時間イベントを受信していません。
-
Webhook が使用されるシナリオを表示するには、その Webhook のシナリオ列の シナリオ ボタンをクリックします。
-
この Webhook に使用されている接続を表示するには、その Webhook の接続列にある 接続 ボタンをクリックします。
-
列の非表示または以前に非表示にした列の表示を行うには、列 アイコン
インスタントトリガーをスケジュールする
インスタント トリガーを構成すると、実行時に選択するように求められます。
Workfront Fusion がサービスから新しいイベントを受け取るとすぐにシナリオを実行するには、「Immediately」を選択します。 これらのイベントは直ちにキューに送信され、データを受信するのと同じ順序で、シナリオで 1 つずつ処理されます。
シナリオを実行すると、キューで待機している保留中のイベントの合計数がカウントされ、保留中のイベントがあるサイクルと同じ数のサイクルがシナリオで実行され、サイクルごとに 1 つのイベントが処理されます。
サイクルについて詳しくは、 シナリオの実行、サイクル、フェーズ を参照してください。
-
サイクルは、シナリオ実行とは異なります。1 つのシナリオ実行に複数のサイクルを含めることができます。
-
実行するようにスケジュールされたインスタント・トリガーを使用してシナリオを実行する場合は、次の例外
Immediately適用されます。-
2 回の実行の間隔は、料金プランに基づく最小の間隔の対象ではありません。
例えば、シナリオの実行が完了すると、Web フックのキューが再度チェックされます。保留中の Web フックがある場合は、シナリオが直ちに再実行され、保留中の Web フックがすべて再度処理されます。
-
「最大サイクル数」シナリオ設定は無視され、100 に設定されます。これは、単一のシナリオ実行時に（サイクルあたり 1 イベントの割合で） 100 個を超える保留中の Webhook が処理されないことを意味します。
-
即時以外のスケジュール設定を使用する場合、シナリオは指定した間隔で実行されます。この間隔のキューには複数の Webhook が収集される可能性があるので、「 最大サイクル数 」オプションをデフォルトの 1 より大きい値に設定して、1 回のシナリオ実行でより多くの Webhook を処理することをお勧めします。
- シナリオの下部にある シナリオ設定 アイコン
- 表示される シナリオ設定 パネルで、「最大サイクル数」フィールドに数値を入力して、シナリオを実行するたびに実行するキューのイベント数を指定します。
キューに残っているイベントは、次回シナリオを実行するときに、「最大サイクル数」フィールドで設定された数まで処理されます。
Webhook ガードレール
Workfront Fusion では、パフォーマンスを高めるために、Webhook 用に次のガードレールが用意されています。
レート制限
現在のレート制限は、1 秒あたり 5 Web フックです。制限を超えた場合は、429 のステータスコードが返されます。
非アクティブな Web フックの有効期限
120 時間を超えてどのシナリオにも割り当てられていない Web フックは削除されます。
Web フックペイロード
Workfront Fusion は、Webhook ペイロードを 30 日間保存します。 Webhook ペイロードの作成後 30 日以上にアクセスすると、Failed to read file from storage. というエラーが発生する
エラー処理
インスタントトリガーでシナリオにエラーが発生した場合は、次のようになります。
- シナリオが実行されるように設定されている場合は、直ちに停止します 直ちに 。
- シナリオがスケジュールどおりに実行されるように設定されている場合に、3 回失敗（3 回のエラー）すると停止します。
シナリオの実行中にエラーが発生した場合、そのイベントはインスタントトリガーのロールバックフェーズでキューに戻されます。 このような場合は、シナリオを修正して再実行できます。
詳細については、「シナリオの実行、サイクル、およびフェーズ」の記事の ロールバック を参照してください。
シナリオに Web フックの応答モジュールがある場合、エラーは Web フックの応答に送信されます。Webhook 応答モジュールは常に最後に実行されます（シナリオ設定の 自動コミット オプションが有効になっていない場合）。
詳しくは、Webhook の記事の Webhook への応答 を参照してください。
Webhook の無効化
次のいずれかに該当する場合、Web フックは自動的に非アクティブ化されます。
- Web フックが 6 日以上どのシナリオにも接続されていない
- Web フックが、非アクティブなシナリオ（非アクティブになってから 30 日を超えたシナリオ）でのみ使用される。
非アクティブ化された Webhook は、シナリオに接続されていない場合や、30 日以上非アクティブ化されている場合、自動的に削除され登録解除されます。
カスタム Web フック
独自の Web フックを作成できます。詳しくは、Web フックを参照してください。
リソース
サイクルについて詳しくは、 シナリオの実行、サイクル、フェーズ を参照してください。