使用API來同步處理程式與服務的資料
以下是您運用API來同步處理程式和服務資料的常見方式。
近乎即時的更新
Adobe Workfront使用「事件訂閱」(通常稱為Webhook),透過API將支援物件和動作的近乎即時更新傳送至您所需的端點。 您可能會在5秒內收到有關新物件和動作的更新,但平均而言,更新大約會在1秒後送達。 如需有關支援的物件型別、支援的動作型別、技術細節以及如何設定事件訂閱的範例,請參閱事件訂閱API和事件訂閱傳遞需求。
批次更新
批次更新是透過定期向Workfront伺服器提出請求來設定系統以進行更新的一種方式。 有很多方法可以做到,但一般而言,程式包含讓您的服務向Workfront API伺服器提出要求,以及搜尋自上次要求呼叫以來已建立或修改的物件。 如需有關潛在要求呼叫和實用引數的資訊,請參閱API基本知識文章中的GET行為區段。
當您設定批次更新的服務時,請謹記以下一些重要事項:
輸入日期
輸入日期是使用ISO 8601格式來儲存。 此標準包含日期、時間和時區資訊。
範例: ISO 8601日期格式
2020-05-18T17:00:00:000-0600
建立物件的日期和上次修改物件的日期分別儲存為「entryDate」和「lastUpdateDate」。 如需Workfront物件、其關聯欄位和欄位名稱的深入資訊,請參閱API總管。 請注意,任何指定Workfront物件的entryDate都不會變更,因為每次修改物件時,lastUpdatedDate都會變更。
範例: 使用 lastUpdateDate 欄位來要求問題物件的GET。 此請求將傳回自指定日期以來更新的所有問題。
GET
https://<domain>.my.workfront.com/attask/api/v15.0/OPTASK/search?fields=ID,name,lastUpdateDate&$$LIMIT=200&lastUpdateDate=2020-05-13T18:18:37.255Z&lastUpdateDate_Mod=gte
日誌專案物件
如果您想要取得有關物件上特定欄位的變更,則可以查詢「Journal Entry」物件。 Workfront Journal Entry物件可設定為每次修改特定物件欄位時,記錄這些欄位的相關資訊,請參閱設定系統更新以取得更多詳細資料。
將欄位設定為記錄為日誌專案物件的一部分時,每次修改該欄位時都會建立對應的日誌專案。 然後,您可以使用類似以下的API呼叫來查詢Journal Entry物件:
GET https://{{domain}}.my.workfront.com/attask/api/v15.0/JRNLE/search?fields=newTextVal,oldTextVal,newDateVal,oldDateVal,newNumberVal,oldNumberVal,entryDate,objObjCode,objID,fieldName&fieldName=name&objObjCode=OPTASK&entryDate=2020-05-13T18:18:37.255Z&entryDate_Mod=gte