API 15版的新增功能

最後更新： 2025年5月5日

主題：

建立對象：

開發人員

Adobe Workfront於2022年6月14日發行API第15版。 API第15版具有第14版的下列變更。

新增的資源

方案(INITIV)
Issdef (ISSDEF)
物件整合(OBJINT)
RichTextGroupParameterValue (GRCVAL)
TaskDef (TSKDEF)
使用者核准(USRAPV)

方案(INITIV)

方案物件會在Workfront情境規劃工具中建立職位角色的種類和數量、固定成本和計畫福利的估計值。

如需方案的詳細資訊，請參閱情境規劃工具🔗中的方案概觀。

直接欄位	customerID 這是內部物件。持續時間 endDate和startDate之間的時間量。 endDate 方案的計畫完成日期。 enteredByID 與提交請求之使用者相關聯的ID。識別碼與動作相關聯的ID 行動方案ID 與方案相關聯的ID。 lastPublishedDate 上次在Workfront情境規劃工具中發佈行動方案的日期。名稱方案的名稱 planID 與方案相關聯的計畫ID。 planName 與方案關聯的計畫名稱。專案識別碼與方案相關聯的專案ID。情境ID 與方案關聯的Workfront情境規劃工具中的情境ID。 startDate 方案的計劃開始日期。
參考欄位	客戶 enteredBy 專案
核心欄位	識別碼名稱物件代碼
營運	計數 GET 報告搜尋

Issdef (ISSDEF)

IssueDef物件代表關於問題格式的一組資料。此物件可附加到專案或範本，並影響新增到該專案或範本的問題。

直接欄位	識別碼 isInlineAddEnabled
核心欄位	識別碼物件代碼

物件整合(OBJINT)

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

直接欄位	customerID 這是內部物件。 entryDate ObjectIntegration輸入Workfront系統的日期和時間。識別碼特定ObjectIntegration物件的唯一Workfront ID。 integrationType ObjectIntegration物件用來建立連結的外部軟體。可能的值包括： JIRA SALESFORCE ANAPLAN linkedObjectID objID 與ObjectIntegration相關聯的Workfront物件。 objObjCode 與ObjectIntegration相關聯之Workfront中物件的物件程式碼。 param1 param2 param3 URL
參考欄位	客戶
核心欄位	識別碼物件代碼

TaskDef (TSKDEF)

TaskDef物件代表關於工作格式的一組資料。此物件可附加到專案或範本，並影響新增到該專案或範本的任務。

直接欄位	autoCalcPlannedHours 識別碼
參考欄位	defaultApprovalProcess
集合欄位	物件類別
核心欄位	識別碼物件代碼

使用者核准(USRAPV)

直接欄位	approverID customerID 識別碼 requestedDate requestorID 狀態 userID
參考欄位	核准者客戶要求者使用者
核心欄位	識別碼物件代碼
預設欄位	approverID requestorID 狀態 userID
動作	核准拒絕
營運	新增計數 DELETE GET 報告搜尋

已移除的資源

未移除API版本15的資源。

已修改的資源

AccessLevel (ACSLVL)
AccessLevelPermissions (ALVPER)
AccessRequest (ACSREQ)
存取規則(ACSRUL)
核准(APPROVAL)
類別(CTGY)
CategoryParameter (CTGYPA)
客戶偏好設定(CUSTPR)
DocumentFolder (DOCFDR)
DocumentVersion (DOCV)
群組（群組）
日誌專案(JRNLE)
LinkedFolder (LNKFDR)
Op任務/問題(OPTASK)
引數（引數）
Portfolio（連線埠）
方案(PRGM)
專案（專案）
QueueDef (QUED)
ScoreCardQuestion (SCOREQ)
任務（任務）
範本(TMPL)
時程表(TSHET)
檢視(UIVIEW)
更新（更新）
使用者(USER)
使用者附註(USRNOT)
工作（工作）

AccessLevel (ACSLVL)

AccessLevel物件與使用者相關聯，並描述決定使用者可存取內容的AccessLevelPermissions集合。

如需存取層級的詳細資訊，請參閱存取層級。

直接欄位

fieldAccessPrivileges (string[])

已新增下列可能值：
- VTMAWMG （檢視與我的群組相關聯的團隊）
- VALLTM （檢視所有團隊）

AccessLevelPermissions (ALVPER)

AccessLevelPermissions物件代表存取、建立或修改Workfront物件的特定許可權。然後，這些許可權可以與存取層級相關聯。

直接欄位

coreAction (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
forbiddenActions (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
secondaryActions (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)

AccessRequest (ACSREQ)

如果使用者無權存取Workfront中他們需要的物件，他們可以請求存取該物件。 AccessRequest物件代表此要求。

直接欄位

動作（字串）

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
autoShareAction （字串）

已新增下列可能值：
- WDL

存取規則(ACSRUL)

AccessRule物件代表自訂存取層級中的規則集，可決定使用者如何共用他們建立的專案。

直接欄位

coreAction (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
forbiddenActions (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
secondaryActions (string[])

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)

核准(APPROVAL)

指定的工作專案，例如工作、檔案或時程表，可能需要主管或其他使用者登出該工作專案。 Approval物件代表在工作專案上簽核的動作。

直接欄位

resourcePlannerBudgetedHours

參考欄位

方案

已新增。

方案物件會在Workfront情境規劃工具中建立職位角色的種類和數量、固定成本和計畫福利的估計值。
issueDef

已新增。
taskDef

已新增。

集合欄位

物件整合

已新增。

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

類別(CTGY)

類別物件是自訂表單。

直接欄位

catObjCode （字串）

已新增下列可能值：
- 群組（群組）
objTypes (string[])

已新增。

此引數是可附加自訂表單的可能物件陣列。新增此項是為了支援將自訂表單附加到多種物件型別的功能。

可能的值：

CMPY，連線埠， PRGM，專案，任務， OPTASK，使用者， DOCU，費用， ITRN，帳單，群組

集合欄位

objTypes (string[])

已新增。

此引數是可附加自訂表單的可能物件陣列。新增此項是為了支援將自訂表單附加到多種物件型別的功能。

可能的值：

CMPY，連線埠， PRGM，專案，任務， OPTASK，使用者， DOCU，費用， ITRN，帳單，群組

CategoryParameter (CTGYPA)

直接欄位

hideFormulaFromDescription

已新增。
journaledObjCodes

已新增。
rawCustomExpression

已新增。

客戶偏好設定(CUSTPR)

CustomerPreferences物件代表客戶已針對其Workfront例項設定的偏好設定集。

直接欄位

名稱

已新增下列值：
- password:sharePointV2IntegrationEnabled (啟用SharePoint (Graph API)整合)
  
  此值支援更新的Sharepoint整合。
- project.mgmt:default.project.allowcreatewithouttemplate （允許使用者在不使用範本的情況下建立專案）
- project.mgmt:taskissue.delegate (config.taskissue.delegate)

DocumentFolder (DOCFDR)

檔案可整理到資料夾中。您可以在個人的「檔案」區域中建立個人資料夾。 DocumentFolder物件代表其中一個資料夾。

DocumentFolder物件已新增旗標SHARABLE。

DocumentVersion (DOCV)

DocumentVersion物件代表檔案的特定版本（例如書面材料、影像或其他形式的資訊）。

如需檔案版本的詳細資訊，請參閱上傳檔案的新版本。

直接欄位

externalIntegrationType

已新增下列值：
- SHAREPOINT_V2 (SharePoint (Graph API))
  
  此值支援更新的Sharepoint整合。

群組（群組）

群組物件代表一組使用者和團隊。群組通常代表部門結構。

如需群組的詳細資訊，請參閱群組與團隊。

群組物件已新增旗標DATA_EXTENDIBLE

直接欄位

已新增下列欄位：

類別識別碼

類別是自訂表單。新增此引數是為了支援新增自訂Forms至群組物件的功能。
isActive

如果物件為「作用中」，則此為布林值引數；如果物件為「非作用中」，則此值為false。設定為「作用中」的物件會出現在下拉式選單和預先輸入欄位中，並可附加到其他物件。

參考欄位

已新增下列欄位：

核准者
客戶
要求者
使用者

集合欄位

已新增下列欄位：

物件類別
objectIntegrations

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

預設欄位

已新增下列欄位：

isActive

如果物件為「作用中」，則此為布林值引數；如果物件為「非作用中」，則此值為false。設定為「作用中」的物件會出現在下拉式選單和預先輸入欄位中，並可附加到其他物件。

動作

已新增下列欄位：

calculateDataExtension

此動作會重新計算自訂表單欄位中的運算式。
completeGroupInfo
linkExternalObject
unlinkExternalObject

日誌專案(JRNLE)

JournalEntry物件可設定為每次修改特定物件欄位時，記錄這些欄位的相關資訊。當欄位設定為記錄為日誌專案物件的一部分時，每次修改該欄位時都會建立對應的日誌專案。

直接欄位

changeType

已新增下列值：

DW （下載）

LinkedFolder (LNKFDR)

LinkedFolder物件代表連結自外部檔案提供者(例如Google Drive或Dropbox)的資料夾。

如需連結資料夾的詳細資訊，請參閱從外部應用程式連結檔案。

直接欄位

externalIntegrationType

已新增下列值：
- SHAREPOINT_V2 (SharePoint (Graph API))
  
  此值支援更新的Sharepoint整合。

Op任務/問題(OPTASK)

OpTask物件通常稱為「問題」。問題指工作專案，通常表示發生問題而無法完成任務或專案。問題也可以是服務檯請求。變更單、請求和錯誤也是問題。

動作

已新增下列動作：

bulkMoveWithOptions
getRequestPath

已修改下列動作：

複製問題

已新增欄位 parentID

引數（引數）

Parameter物件是自訂欄位。

直接欄位

已新增下列欄位：

fieldDefinition

下列欄位已修改：

資料型別

已新增可能的值WIDGET (Widget)

此值支援在自訂表單中使用影像。
displayType

已新增可能的值WIDGET (Widget)

此值支援在自訂表單中使用影像。

Portfolio（連線埠）

Portfolio物件是競爭相同資源（通常是金錢或人力）的專案集合。

集合欄位

objectIntegrations

動作

linkExternalObject
unlinkExternalObject

方案(PRGM)

計畫物件是投資組合中專案的子集，其中類似的專案可以分組在一起。

集合欄位

objectIntegrations

動作

linkExternalObject
unlinkExternalObject

專案（專案）

專案是Workfront內的工作專案，也是Workfront協助人們完成工作的主要建置組塊。 Project物件代表具有共同特定目標的一組任務。

直接欄位

resourcePlannerBudgetedHours

參考欄位

方案

方案物件會在Workfront情境規劃工具中建立職位角色的種類和數量、固定成本和計畫福利的估計值。
issueDef
taskDef

集合欄位

objectIntegrations

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

QueueDef (QUED)

QueueDef物件代表佇列，這是已發佈至服務檯區域的專案，可讓使用者向其提交問題。

如需請求佇列的詳細資訊，請參閱建立請求佇列。

直接欄位

requestorCoreAction

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)
requestorForbiddenActions

已新增下列可能值：
- EDIT_TEAMS_I_AM_ON （編輯我所在的團隊）
- EDIT_TEAMS_I_GROUP_ADMIN (編輯我管理的群組中的團隊（僅限群組管理員）)

ScoreCardQuestion (SCOREQ)

ScoreCardQuestion物件代表已新增至計分卡的問題。這些問題通常由Portfolio經理決定，而他們的答案可讓經理瞭解專案與產品組合目標的對齊程度。

如需計分卡問題的詳細資訊，請參閱建立計分卡。

直接欄位

displayType

已新增可能的值WIDGET (Widget)

任務（任務）

Task物件代表作為達成最終目標（完成專案）的步驟而必須執行的工作專案。

集合欄位

objectIntegrations

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

範本(TMPL)

Template物件代表專案的模式。可以從範本建立專案以節省時間。範本包含專案團隊和任務，這些專案將會複製到從範本建立的任何專案中。

參考欄位

issueDef
taskDef

時程表(TSHET)

時程表物件代表虛擬時程表，可讓使用者輸入任務、專案和管理費用時數型別的實際工作時數。

核心欄位

下列欄位已移除：

物件代碼

檢視(UIVIEW)

直接欄位

uiviewType

下列可能的值已移除：
- FOUR_COL （四欄式配置）
- UPDATES （更新）
- UPDATESTOOLBAR_FEED （更新）
- WORKINGON （正在處理）
- CUSTOMDATA （自訂資料）
- CUSTOMDATA_UPDATE （更新自訂資料）
- STATUS_UPDATE （狀態更新）
- OPTASK_STATUS_UPDATE （狀態更新）
- PROJ_STATUS_UPDATE （狀態更新）
- PROJECT_TIMEENTRY （狀態更新）
- DLIST （詳細清單）
- DLIST_SECTION （詳細清單區段）

更新（更新）

Workfront中的工作專案可以更新，以隨時通知使用者目前的狀態。 Update物件代表其中一項更新。更新可由使用者輸入，或由Workfront系統建立。

直接欄位

updateType

已新增可能的值documentVersionDownload (enum.updatetypeenum.documentversiondownload)

使用者(USER)

使用者物件代表擁有Workfront帳戶的人員，該帳戶可以登入並與系統互動。

參考欄位

userApproval

動作

getUsersAvailableTime
resetRopgPassword

使用者附註(USRNOT)

UserNote物件是通知。

直接欄位

eventType

已新增下列可能值：
- DUP （要求您校稿檔案）
- DUV （可讓您檢視檔案）

工作（工作）

Work物件是Task和OpTask都繼承的公用介面，並在兩者之間共用公用程式碼。

集合欄位

objectIntegrations

在某些情況下，可以直接將Workfront工作專案連結到外部軟體產品中的物件。 ObjectIntegration物件代表此連結。

recommendation-more-help