文件WorkfrontWorkfront 指南

事件訂閱版本設定

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

Workfront有兩個版本的事件訂閱。 本文會說明兩者之間的差異。

新版本並非變更Workfront API，而是變更事件訂閱功能。

升級或降級事件訂閱的功能可確保事件結構變更時，現有訂閱不會中斷，讓您測試和升級至新版本，不會有事件訂閱的間隙。

將事件訂閱升級或降級至另一個版本時，在版本變更後的五分鐘內，您會收到每個事件傳送的重複事件。 重複專案包括事件訂閱版本1和版本2各一個。 這可確保不會因為變更事件訂閱版本而遺漏任何事件。

如需用於升級或降級事件訂閱的端點資訊，請參閱文章事件訂閱API中的事件訂閱版本設定。

IMPORTANT
下列版本將影響事件訂閱版本設定：
  • 25.2版 （2025年4月10日）：在25.2版之後建立的所有新訂閱皆建立為版本2。
  • 2026年1月15日：所有剩餘的第1版訂閱都會移轉至第2版。

第1版與第2版之間的變更

已對事件訂閱版本2進行下列變更：

一般變更

受影響的欄位
第1版（先前行為）
第2版（變更）
修正動作
計算的引數值
從包含自訂表單的範本建立的任何物件若包含已計算的引數值，將會傳送CREATE事件，然後會傳送UPDATE與引數值（包括已計算的欄位及其值）。
當從包含具有計算引數值的自訂表單的範本建立物件時，只會傳送CREATE事件，且會包含包括計算欄位的引數值。
如果您有UPDATE個事件的訂閱，且預期在使用計算的引數值建立物件後會收到UPDATE個事件，則您將不會再收到該UPDATE個事件。 如果您希望在建立物件時檢視計算的引數值，則必須建立額外的CREATE訂閱。
多重選取型別欄位

針對包含多選型別欄位變更的任何事件型別，如果欄位僅包含一個值，則會轉換為並以字串形式傳送。 否則，會以陣列形式傳送。

範例：

  • myMultiSelectField: ["oneValue"] 已轉換並以myMultiSelectField: "oneValue"傳送。
  • myMultiSelectField: ["first", "second"] 以myMultiSelectField: ["first", "second"]傳送。

無論陣列中有多少值，都會以陣列的形式傳送。

範例：

  • myMultiSelectField: ["oneValue"] 以myMultiSelectField: ["oneValue"]傳送。
  • myMultiSelectField: ["first", "second"] 以myMultiSelectField: ["first", "second"]傳送。
如果您的訂閱在多重選取欄位上使用篩選器，且值為字串，則必須使用具有值為陣列的相同篩選器建立新訂閱。

物件特定變更

物件代碼
受影響的欄位
第1版（先前行為）
版本2 （變更）
補救動作
指派
  • projectID
  • taskID
  • opTaskID
  • customerID
更新此物件時，UPDATE事件有時會錯誤地顯示受影響的欄位從null變更為ID value。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果受影響的欄位有篩選器，則只有在這些欄位實際變更時，才會收到UPDATE事件，而不會在任何其他值已變更時收到。
檔案
  • referenceObjID
在此物件上更新任何引數值時，UPDATE事件未正確地顯示從null到object id受影響的欄位變更。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果受影響的欄位有篩選器，則只有在這些欄位實際變更時，才會收到UPDATE事件，而不會在任何其他值已變更時收到。
  • groups
刪除檔案時，DELETE事件將受影響的欄位錯誤地顯示為之前狀態的空白陣列。
DELETE事件正確顯示處於之前狀態的受影響欄位。
無。 DELETE事件仍會傳送，但現在會顯示受影響欄位的正確資料。
DOCV
  • proofDecision
  • proofName
  • proofProgress
更新此物件時，將會傳送兩個UPDATE事件。 第一個事件未包含受影響的欄位，而第二個事件包含。
所有欄位更新（包括受影響的欄位）都只會出現在一個UPDATE事件中，而不會傳送第二個不必要的事件。
無。 如果受影響的欄位有篩選條件，事件會在第一個事件中傳送。
費用
  • topReferenceObjCode
  • referenceObjectName
在費用上更新任何引數值時，UPDATE事件錯誤地顯示了topReferenceObjCode從EXPNS到PROJ的變更，以及referenceObjectName從null到string value of project name的變更。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果受影響的欄位有篩選器，則只有在這些欄位實際變更時，才會收到UPDATE事件，而不會在任何其他值已變更時收到。
  • topReferenceObjCode
  • referenceObjectName
刪除Expense物件時，會傳送UPDATE事件，並在傳送DELETE事件之前將受影響的欄位變更為Null。
未傳送額外的UPDATE事件。 DELETE事件具有先前狀態中受影響欄位的正確值。
如果您有UPDATE事件中受影響欄位的篩選器，且您希望在物件被刪除時收到該篩選器，則您將不再收到該UPDATE事件。 如果您希望在刪除物件時看到這些欄位，則必須建立額外的DELETE訂閱。
HOUR
  • projectID
  • taskID
  • roleID
  • timesheetID
  • hourTypeID
  • projectOverheadID
  • referenceObjID
  • referenceObjCode
  • securityRootID
刪除此物件時，DELETE事件將受影響的欄位錯誤地顯示為null在之前的狀態。
DELETE事件正確顯示受影響欄位在「之前」狀態。
無。 DELETE事件仍會傳送，但現在會顯示受影響欄位的正確資料。
OPTASK
  • rootGroupID
在此物件上更新任何引數值時，UPDATE事件未正確地顯示從null到ID value受影響的欄位變更。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果您在受影響的欄位上有篩選器，則只有在欄位實際變更時，才會收到UPDATE事件，而不會在任何其他引數值已變更時收到。
  • resolveProjectID
  • resolveTaskID
  • resolvingObjID
更新此物件時，UPDATE事件有時會錯誤地顯示受影響的欄位從null變更為ID value。
所有UPDATE事件將顯示受影響欄位的正確值。
專案
  • rootGroupID
在此物件上更新任何引數值時，UPDATE事件未正確地顯示從null到ID value受影響的欄位變更。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果您在受影響的欄位上有篩選器，則只有在欄位實際變更時，才會收到UPDATE事件，而不會在任何其他引數值已變更時收到。
  • convertedOpTaskID
更新此物件時，UPDATE事件有時會錯誤地顯示受影響的欄位從null變更為ID value。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果您在受影響的欄位上有篩選器，則只有在欄位實際變更時，才會收到UPDATE事件，而不會在任何其他引數值已變更時收到。
任務
  • rootGroupID
在此物件上更新任何引數值時，UPDATE事件未正確地顯示從null到ID value受影響的欄位變更。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果您在受影響的欄位上有篩選器，則只有在欄位實際變更時，才會收到UPDATE事件，而不會在任何其他引數值已變更時收到。
  • convertedOpTaskID
更新此物件時，UPDATE事件有時會錯誤地顯示受影響的欄位從null變更為ID value。
所有UPDATE事件都會顯示受影響欄位的正確值。
無。 如果您在受影響的欄位上有篩選器，則只有在欄位實際變更時，才會收到UPDATE事件，而不會在任何其他引數值已變更時收到。

更新Workfront Fusion案例中的事件訂閱版本

Workfront Fusion使用事件訂閱來監視Workfront中的變更以觸發情境。 您可以使用「Workfront >更新事件裝載版本」模組，更新Fusion直接在案例中使用的事件訂閱版本。

如需使用此模組的說明，請參閱Workfront Fusion檔案中的Workfront模組。

如需在事件訂閱升級期間保留Workfront Fusion案例的資源，包括網路研討會影片，請參閱在事件訂閱V2升級期間保留Fusion案例。

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