Adobe Workfront Fusion のインスタントトリガー(Web フック)

多くのサービスでは、サービスで特定の変更が発生した場合に即座に通知を受け取る Web フックが用意されています。これらの通知を処理するには、インスタントトリガーを使用することをお勧めします。これらは Adobe Workfront Fusion のタグによって簡単に認識できます。

サービスが Web フックを提供しない場合は、ポーリングトリガーを使用してサービスを定期的にポーリングする必要があります。

Workfront Fusion の Web フックの紹介ビデオについては、以下を参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro またはそれ以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件は不要。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration、Workfront Fusion for Work Automation

製品

現在の製品要件:Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、組織は Adobe Workfront に加えて Adobe Workfront Fusion も購入する必要があります。Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

Web フックのキューを表示する

受信 Web フックからのメッセージはすべて、Web フックのキューに保存されます。

  1. 左側のメニューで、「Web フック」をクリックします。

  2. キューを表示する Webhook を見つけます。

  3. トラックのアイコンと受信した Web フックの数を含むボタンをクリックします。

    note note
    NOTE
    「データは機密情報」オプションの設定に関係なく、受信 Web フックデータは常にキューに保存されます( Adobe Workfront Fusion のシナリオ設定パネルで説明されています)。シナリオでデータが処理されるとすぐに、そのデータはシステムから完全に削除されます。

インスタントトリガーをスケジュールする

シナリオにインスタントトリガーが含まれる場合、シナリオが直ちに実行されるようにスケジュールできます。

この場合、Workfront Fusion がサービスから新しいデータを受信すると、シナリオはすぐに実行されます。シナリオの実行後、キュー内で待機中の保留中の Web フックの総数がカウントされ、シナリオは保留中の Web フックの数と同じ数のサイクルを実行し、サイクルごとに 1 つの Web フックを処理します。詳しくは、 Adobe Workfront Fusion でのシナリオの実行、サイクル、フェーズを参照してください。

NOTE
  • サイクルは、シナリオ実行とは異なります。1 回のシナリオ実行で複数のサイクルを実行できます。

  • 即時実行がスケジュールされたインスタントトリガーでシナリオを実行する場合、次の例外が適用されます。

    • 2 つの実行間の間隔は、料金プランに基づく最小間隔の影響を受けません。

      例えば、シナリオの実行が完了すると、Web フックのキューが再度チェックされます。保留中の Web フックがある場合は、シナリオが直ちに再実行され、保留中の Web フックがすべて再度処理されます。

    • サイクルの最大数のシナリオ設定は無視され、100 に設定されます。つまり、1 回のシナリオの実行中に処理される保留中の Web フックが 100 個以下になります(1 サイクルあたり 1 イベントの割合で)。

即時以外のスケジュール設定を使用する場合、シナリオは指定した間隔で実行されます。間隔中に複数の Web フックがキューに集まる可能性があるため、1 回のシナリオ実行でより多くの Web フックを処理するには、最大サイクル数をデフォルトの 1 よりも大きい値に設定することをお勧めします。

  1. シナリオ下部のシナリオ設定アイコン をクリックします。
  2. 表示される「シナリオ設定」ボックスで、「最大サイクル数」ボックスに数値を入力して、シナリオを実行するたびに実行するキューからの 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 日が経過した場合、自動的に削除され、登録解除されます。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43