Adobe Workfront Fusion中的即時觸發器(webhook)
許多服務都會提供Webhook,以便在服務發生特定變更時傳送即時通知。 若要處理這些通知,建議您使用立即觸發程式。 您可以在Adobe Workfront Fusion中輕鬆辨識這些專案,因為其標籤:
如果服務不提供Webhook,您需要使用輪詢觸發程式來定期輪詢服務。
如需Workfront Fusion中Webhook的影片簡介,請參閱:
存取需求
您必須具有下列存取權才能使用本文中的功能:
若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。
如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權。
檢視webhook的佇列
所有來自傳入webhook的訊息都會儲存在webhook的佇列中。
-
按一下左側功能表中的 Webhooks。
-
尋找您要檢視其佇列的Webhook。
-
按一下帶有卡車圖示和已接收Webhook數量的按鈕。
note note NOTE 無論您如何設定選項資料是機密的(在 Adobe Workfront Fusion🔗的案例設定面板中說明),傳入的webhook資料一律會儲存在佇列中。 在案例中處理資料後,資料就會從系統中永久刪除。
排程即時觸發程式
如果您的案例包含立即觸發器,您可以排程案例立即執行:
在此情況下,當Workfront Fusion從服務收到新資料時,您的情境會立即執行。 執行案例後,系統會計算佇列中等待的擱置Webhook總數,而案例執行的週期與擱置Webhook相同,每個週期處理一個Webhook。 如需詳細資訊,請參閱 Adobe Workfront Fusion🔗中的案例執行、週期和階段。
-
週期與案例執行不同。 1個案例執行中可以有多個週期。
-
當您使用排定為立即的立即觸發程式執行案例時,將會套用下列例外:
-
根據定價計畫,兩個執行之間的間隔不受最小間隔的限制。
例如,一旦案例完成執行,就會再次檢查webhook的佇列。 如果有任何擱置中的Webhook,情境會立即再次執行,並再次處理所有擱置中的Webhook。
-
「最大週期數」情境設定會忽略並設為100,這表示在單一情境執行期間不會處理超過100個擱置中的Webhook (每個週期為1個事件)。
-
如果您使用立即以外的任何其他排程設定,情境會依您指定的間隔執行。 由於間隔期間可在佇列中收集數個webhook,因此建議將最大週期數設定為比預設1更高的值,以便在一次案例執行中處理更多webhook:
- 按一下案例底部的案例設定圖示 。
- 在出現的 情境設定 方塊中,在 最大循環數 方塊中輸入數字,以表示每次執行情境時,您要從佇列中執行的Webhook數目。
速率限制
目前的速率限製為每秒5個Webhook。 如果超過限制,則會傳回429狀態代碼。
非作用中Webhook的到期
已超過120小時未指派給任何情境的webhook會被移除。
Webhook裝載
Workfront Fusion儲存webhook裝載30天。 存取webhook裝載時,若在裝載建立超過30天後進行,會導致''無法從儲存空間讀取檔案。''
錯誤處理
當您的案例中出現具有立即觸發器的錯誤時,案例:
- 立即停止 — 設定為立即執行時。
- 嘗試3次不成功後停止(3個錯誤) — 案例設定為依排程執行時。
如果案例執行期間發生錯誤,webhook會在即時觸發器的復原階段重新放入佇列中。 在此情況下,您可能會修正該案例並重新執行。 如需詳細資訊,請參閱文章案例執行、週期和 Adobe Workfront Fusion中的階段復原。
如果您的案例中存在Webhook回應模組,則會將錯誤傳送至Webhook回應。 Webhook回應模組一律在最後執行(在Scenario設定中的自動認可選項未啟用的情況下)。 如需詳細資訊,請參閱文章Webhooks中的回應Webhooks。
自訂Webhook
您可以建立自己的Webhook。 如需詳細資訊,請參閱Webhooks。
Webhook停用
如果符合下列任一條件,Webhook就會自動停用:
- webhook已超過5天未連線至任何案例
- webhook僅用於非使用中情況,這些情況已非使用中超過30天。
如果停用的Webhook未連線至任何情境且處於停用狀態超過30天,則會自動刪除和取消註冊。