文件WorkfrontWorkfront 指南

API 15版的新增功能

Last update: Tue Nov 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer

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

新增的資源

方案(INITIV)

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

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

直接欄位

  • customerID

    這是內部物件。

  • 期間

    endDate和startDate之間的時間量。

  • endDate

    方案的計畫完成日期。

  • enteredById

    與提交請求之使用者相關聯的ID。

  • ID

    與動作相關聯的ID

  • 行動方案ID

    與方案相關聯的ID。

  • lastPublishedDate

    上次在Workfront情境規劃工具中發佈行動方案的日期。

  • 名稱

    方案的名稱

  • planid

    與方案相關聯的計畫ID。

  • planName

    與方案關聯的計畫名稱。

  • projectID

    與方案相關聯的專案ID。

  • scenarioID

    與方案關聯的Workfront情境規劃工具中的情境ID。

  • startDate

    方案的計劃開始日期。

參考欄位

  • 客戶

  • 輸入者

  • 專案

核心欄位

  • ID

  • 名稱

  • 物件代碼

作業

  • 計數

  • GET

  • 報告

  • SEARCH

Issdef (ISSDEF)

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

直接欄位

  • ID

  • isInlineAddEnabled

核心欄位

  • ID

  • 物件代碼

物件整合(OBJINT)

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

直接欄位

  • customerID

    這是內部物件。

  • entryDate

    ObjectIntegration輸入Workfront系統的日期和時間。

  • ID

    特定ObjectIntegration物件的唯一Workfront ID。

  • integrationtype

    ObjectIntegration物件用來建立連結的外部軟體。 可能的值包括：

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • 物件ID

    與ObjectIntegration相關聯的Workfront物件。

  • 物件代碼

    與ObjectIntegration相關聯之Workfront中物件的物件程式碼。

  • param1

  • param2

  • param3

  • URL

參考欄位
  • 客戶
核心欄位

  • ID

  • 物件代碼

TaskDef (TSKDEF)

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

直接欄位

  • autoCalcPlannedHours

  • ID

參考欄位
  • defaultProvalProcess
集合欄位
  • 物件類別
核心欄位

  • ID

  • 物件代碼

使用者核准(USRAPV)

直接欄位

  • approverID

  • customerID

  • ID

  • requestedDate

  • 要求者ID

  • 狀態

  • userID

參考欄位

  • 核准者

  • 客戶

  • 要求者

  • 使用者

核心欄位

  • ID

  • 物件代碼

預設欄位

  • approverID

  • 要求者ID

  • 狀態

  • userID

動作

  • 核准

  • 拒絕

作業

  • 新增

  • 計數

  • DELETE

  • GET

  • 報告

  • SEARCH

已移除的資源

未移除API版本15的資源。

已修改的資源

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

    已新增.

集合欄位

  • objectIntegrations

    已新增.

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

類別(CTGY)

類別物件是自訂表單。

直接欄位

  • catObjCode （字串）

    已新增下列可能值：

    • 群組（群組）

  • 物件型別 (string[])

    已新增.

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

    可能的值：

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

集合欄位

  • 物件型別 (string[])

    已新增.

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

    可能的值：

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

CategoryParameter (CTGYPA)

直接欄位

  • hideFormalFromDescription

    已新增.

  • journaledObjCodes

    已新增.

  • rawCustomExpress

    已新增.

客戶偏好設定(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

直接欄位

已新增下列欄位：

  • categoryID

    類別是自訂表單。 新增此引數是為了支援新增自訂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

已修改下列動作：

  • copyissue

    已新增欄位 parentID

引數（引數）

Parameter物件是自訂欄位。

直接欄位

已新增下列欄位：

  • fieldDefinition

下列欄位已修改：

  • 資料型別

    已新增可能的值 WIDGET (Widget)

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

  • 顯示型別

    已新增可能的值 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經理決定，而他們的答案可讓經理瞭解專案與產品組合目標的對齊程度。

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

直接欄位

  • 顯示型別

    已新增可能的值 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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43