API 17版的新增功能
建立對象：
- 開發人員
Adobe Workfront於2023年10月12日發行API第17版。 API第17版具有第16版的下列變更。
新增的資源
外部檔案(EXTDOC)
ExternalDocument物件是位於Workfront外部的檔案儲存提供者中的檔案或其他數位資產。 這些資產可以連結至Workfront或從中連結。
| 直接欄位 |
|
| 核心欄位 |
|
| 預設欄位 |
|
| 動作 |
|
| 查詢 |
|
| 營運 |
|
使用者位置(USRLOC)
| 直接欄位 |
|
| 參考欄位 |
|
| 核心欄位 |
|
已移除的資源
未移除API版本17的資源
已修改的資源
已針對API版本17修改下列資源。
基線(BLIN)
基準線是專案在指定時間的效能快照。 這類檔案會儲存專案的關鍵資訊，例如關鍵日期、進度、成本和收入值。
基準線物件已移除旗標 INLINE_EDITABLE。
記帳記錄(BILL)
BillingRecord物件會記錄可記帳的收入、時數或費用。 此資訊可用於在外部會計系統中建立商業發票。
BillingRecord物件已移除旗標 INLINE_EDITABLE。
公司(CMPY)
Company物件代表由人員集合組成的組織。
| 直接欄位 |
|
客戶偏好設定(CUSTPR)
CustomerPreferences物件代表客戶已針對其Workfront例項設定的偏好設定集。
-
名稱
新增可能的值「config.defaultToNewHomeDescription」 (customer：config.defaultToNewHome)>/p？
這可讓組織將新的「首頁」體驗設為使用者的預設體驗。
DocumentVersion (DOCV)
DocumentVersion物件代表檔案的特定版本（例如書面材料、影像或其他形式的資訊）。
-
externalIntegrationType
已新增可能的值「Frame.io」(FRAMEIO)
-
fileType
新增可能的值「enum.filetype.site」(site)
匯率（匯率）
ExchangeRate物件代表Workfront中設定的貨幣匯率。 ExchangeRate物件不是動態的。
已新增下列欄位：
-
endDate
-
startDate
-
getCustomerCurrencies
已新增。
費用(EXPN)
費用代表專案期限內可能產生的非人力成本。
Expense物件已移除旗標 INLINE_EDITABLE。
群組（群組）
群組物件代表一組使用者和團隊。 群組通常代表部門結構。
-
defaultInterface
已移除
Hour (HOUR)
Hour物件代表使用者在時程表上記錄的一小時。
Hour物件已移除旗標 INLINE_EDITABLE。
反複專案(ITRN)
反複專案物件代表單一敏捷反複專案。 反複專案是用來規劃和完成敏捷內文的離散時段。
反複專案物件已移除旗標 INLINE_EDITABLE。
日誌專案(JRNLE)
JournalEntry物件可設定為每次修改特定物件欄位時，記錄這些欄位的相關資訊。 當欄位設定為記錄為日誌專案物件的一部分時，每次修改該欄位時都會建立對應的日誌專案。
-
changeType
已新增下列可能值：
- 已新增核准者(AAA)
- 已新增檢閱者(AAR)
- 已移除的檢閱者(ARR)
- 已移除核准者(ARA)
- 決定已核准(ADA)
- 決定已核准變更(ADC)
- 決策需求工作(ADN)
- 決定已撤銷(ADR)
- 核准者已變更(AAC)
- 檢閱者已變更(ARC)
- 檢閱完成(RDC)
- 檢閱已撤銷(RDR)
- Publish (PUB)
Kanban面板(KNBNBD)
Kanban展示板用於追蹤敏捷環境中的任務。
Kanban Board物件已移除旗標 INLINE_EDITABLE。
LinkedFolder (LNKFDR)
LinkedFolder物件代表連結自外部檔案提供者(例如Google Drive或Dropbox)的資料夾。
-
externalIntegrationType
新增可能的值「Frame.io (FRAMEIO)」
Op任務/問題(OPTASK)
OpTask物件通常稱為「問題」。 問題指工作專案，通常表示發生問題而無法完成任務或專案。 問題也可以是服務檯請求。 變更單、請求和錯誤也是問題。
問題物件已移除旗標 INLINE_EDITABLE。
專案（專案）
專案是Workfront內的工作專案，也是Workfront協助人們完成工作的主要建置組塊。 Project物件代表具有共同特定目標的一組任務。
專案物件已移除旗標 INLINE_EDITABLE。
專案使用者(PRTU)
ProjectUser物件代表與特定專案相關聯的使用者。
-
識別碼
已新增。
-
識別碼
已新增。
費率（費率）
Rate物件代表Workfront中的計費費率。
Rate物件已移除旗標 INLINE_EDITABLE。
已新增下列動作以支援費率卡功能：
-
deleteRateForRole
-
editRatesForRole
-
getUsedClassifierIds
-
setRatesFromRateCard
已修改 setRatesForRole 動作以新增下列欄位：
- 分類器ID
- currencyCode
- sourceRateCardID
風險（風險）
風險物件代表可能阻止專案按時完成或在預算內完成的事件。 在計畫階段中會為專案新增風險，以在核准任何工作之前識別潛在障礙。
風險物件已移除旗標 INLINE_EDITABLE。
角色/工作角色(ROLE)
角色物件（工作角色）代表使用者可能填入的功能容量或技能集，例如Designer或產品經理。
-
defaultInterface
已移除
任務（任務）
Task物件代表作為達成最終目標（完成專案）的步驟而必須執行的工作專案。
Task物件已移除旗標 INLINE_EDITABLE。
團隊(TEAMOB)
Team物件是可指派至工作專案的「使用者」集合。
-
defaultInterface
已移除
團隊成員(TEAMMB)
TeamMember物件是與特定專案團隊相關聯的使用者。
-
識別碼
已新增。
-
識別碼
已新增。
範本使用者(TMTU)
-
識別碼
已新增。
-
識別碼
已新增。
時程表(TSHET)
時程表物件代表虛擬時程表，可讓使用者輸入任務、專案和管理費用時數型別的實際工作時數。
-
物件代碼
已移除
更新（更新）
Workfront中的工作專案可以更新，以隨時通知使用者目前的狀態。 Update物件代表其中一項更新。 更新可由使用者輸入，或由Workfront系統建立。
-
changeType
已新增下列值：
- 已新增核准者(assetapprovalAddApprover)
- 已新增稽核者(assetapprovalAddReviewer)
- 已移除核准者(assetapprovalRemoveApprover)
- 已移除稽核者(assetapprovalRemoveReviewer)
- 決定已核准(assetapprovalDecisionApproved)
- 決定需求工作(assetapprovalDecisionNeedsWork)
- 決定已核准變更(assetapprovalDecisionApprovedChanges)
- 決定已撤銷(assetapprovalDecisionRevoced)
- 核准者已變更(assetapprovalApproverChanged)
- 檢閱者已變更(assetapprovalReviewerChanged)
- 檢閱完成(assetapprovalReviewerDecisionComplete)
- 檢閱已撤銷(assetapprovalReviewerDecisionRevoced)
- 外部檔案傳送錯誤(externalDocumentSendError)
- 檔案版本已發佈(documentVersionPublish)
- 連結的資料夾工作流程(linkedFolderWorkflow)
使用者(USER)
使用者物件代表擁有Workfront帳戶的人員，該帳戶可以登入並與系統互動。
使用者物件已移除旗標 INLINE_EDITABLE。
-
工作時間
此欄位已新增，是介於0和1之間的數字，代表使用者每天可花費在專案工作（非經常性工作）的時間百分比。 值1表示使用者可以將100%的時間花在專案工作上。
- userLocations
使用者群組(USRGPS)
-
識別碼
已新增。
-
識別碼
已新增。
使用者附註(USRNOT)
UserNote物件是通知。
-
changeType
已新增下列值：
- 檔案需要您的核准(AAA)
- 檔案需要您的稽核(AAR)
- 檔案不再需要您的核准(ARA)
- 檔案不再需要您的檢閱(ARR)
- 檔案需求（使用者）核准(ATA)
- 檔案需求（使用者）稽核(ATR)
- 檔案不再需要（使用者）核准(RTA)
- 檔案不再需要（使用者）的稽核(RTR)
- 檔案已核准(ADA)
- 檔案已核准變更(ADC)
- 檔案需求工作(ADN)
- （使用者）已將（檔案）標示為已核准。 不再需要您的核准。 (AAN)
- （使用者）已將（檔案）標示為已核准，但有變更。 不再需要您的核准。 (ACN)
- （使用者）已將（檔案）標示為需要工作。 不再需要您的核准。 (AWN)
- 檔案需要您立即稽核而非核准(AAC)
- 檔案現在需要您的核准而非稽核(ADN)
- 檔案已檢閱(RDC)
- 檔案已檢閱(TRC)
- （使用者）已檢閱（檔案）為完成。 不再需要您的評論。 (TRN)
使用者角色(USRROL)
-
識別碼
已新增。
-
識別碼
已新增。