文档WorkfrontWorkfront 指南

API版本11中的新增功能

最近更新： 2024年7月18日
  • 主题：

创建对象：

  • 开发人员
  • 已添加资源
  • 已删除资源
  • 已修改的资源

已添加资源

  • ReportableBudgetedHour
  • accessExpirationDate
  • 访问器ID
  • 客户ID
  • ID
  • userID
  • 访问器
  • 客户
  • 用户
  • ID
  • 对象代码
  • 客户ID
  • ID
  • loginAsSettingsID
  • 对象ID
  • 对象代码
  • 客户
  • ID
  • 对象代码
  • 客户ID
  • licenseType
  • ID
  • restrictedLoginAs
  • 客户
  • 其他规则
  • ID
  • 对象代码

ReportableBudgetedHour

ReportableBugedHour已作为报表资源添加到Adobe Workfront API。 它具有BudgetedHour中缺少的引用字段、核心字段和默认字段。

直接字段

  • allocationDate

    分配日期是您在资源规划者中为其预算小时数的周的第一天（星期日）。

  • budgetedHours

    预算小时数是资源管理器为资源在项目上需要完成的工作预算的时数

  • ID

    分配给特定可报告预算小时对象的唯一Workfront ID。

  • plannedBudgetedHours

  • projectID

    分配给特定项目的唯一Workfront ID。

  • roleID

    分配给特定工作角色的唯一Workfront ID。

  • userID

    分配给特定用户的唯一Workfront ID。

引用字段

  • 项目

    ReportableBudgetedHour关联的项目。

  • 角色

    与ReportableBudgetedHour关联的工作角色。

  • 用户

    ReportableBudgetedHour关联的用户。

核心字段
  • ID
  • name
  • 对象代码
默认字段
  • name
运营
  • 计数
  • GET
  • 报告
  • SEARCH

已删除资源

未删除API v11的资源。

已修改的资源

  • AccessLevelPermissions
  • AccessRequest
  • 访问规则
  • 审批
  • 批准路径
  • ApprovalProcess
  • 工作
  • 基线任务
  • 类别
  • 公司
  • CustomEnum
  • 客户
  • 客户首选项
  • DocMetadataLinkGroup
  • 文档
  • 迭代
  • 布局模板
  • 里程碑路径
  • 注释
  • Op任务
  • 参数
  • Portfolio
  • 计划
  • 项目
  • 校对审批
  • QueueDef
  • 保留时间
  • ResourcePlannerFilter
  • 风险
  • 计划报告
  • 记分卡问题
  • 任务
  • 团队
  • 模板
  • 模板分配
  • 模板任务
  • 时间表
  • 用户注释
  • 工作

AccessLevelPermissions

AccessLevelPermissions对象表示一组权限。 然后，这组权限可以与访问级别关联。

直接字段

以下字段添加了可能的值BUDGETING_INFORMATION。 这允许具有权限的用户在规划者中编辑优先级和预算小时数。

  • coreAction
  • 禁止操作
  • secondaryActions

Accessrequest

如果用户无权访问Workfront中他们需要的对象，则可以请求对该对象的访问权限。 AccessRequest对象表示此请求。

直接字段

  • 操作

    添加了可能的值BUDGETING_INFORMATION。 这允许具有权限的用户在规划者中编辑优先级和预算小时数。

访问规则

AccessRule对象表示自定义访问级别中的规则集，该规则集确定用户如何共享他们创建的项目。

直接字段

以下字段添加了可能的值BUDGETING_INFORMATION。 这允许具有权限的用户在规划者中编辑优先级和预算小时数。

  • coreAction
  • 禁止操作
  • secondaryActions

审批

给定工作项，如任务、文档或时间表，可能要求主管或其他用户签发该工作项。 审批对象表示在工作项上注销的操作。

直接字段

以下字段添加了验证器AT_DATE_BEFORE_YEAR和AT_DATE_AFTER_YEAR。 这些验证器指定相关对象的日期不能在1900年之前或2200年之后设置。

  • actualCompletionDate
  • actualStartDate
  • 约束日期
  • plannedCompletionDate
  • plannedStartDate

向公共API添加了以下字段，以提高计算EAC（完工估算）的透明度。

  • bcwp

    预算执行工作成本(BCWP)也称为实现值，是一个项目绩效指标，它表示计算此指标时实际完成的任务的预算成本。 对于任务，BCWP =实际完成百分比x任务预算。 对于项目，BCWP = SUM（所有父任务和单个任务的BCWP值）。

  • bcws

    计划工作预算成本(BCWS)也称为计划值，是一个项目性能量度，表示计算此量度时应该完成的任务的预算成本。 对于任务，BCWS =计划完成百分比x任务预算。 对于项目，BCWS = SUM（所有父任务和单个任务的BCWS值）。

以下字段添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

  • durationUnit
  • 工作单位

以下字段添加了标记CURRENCY

  • projectBudgetedCost
  • 项目净值

以下字段已从审批对象中删除。

  • 保留时间ID
  • timelineExceptionInfo

以下字段已添加到批准对象。

  • storyPoints
引用字段

  • reservedtime

    从审批对象中移除

收藏集字段

  • allConditions

    已添加到批准对象。

批准路径

ApprovalPath对象是批准流程中的分支。 批准路径基于与批准流程关联的对象的状态。

直接字段

  • durationUnit

    添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

ApprovalProcess

ApprovalProcess对象是可以与项目、任务或问题关联的多步批准。

直接字段

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

默认字段

  • isActive

    已添加

任务

任务对象表示工作项与分配给该工作项的用户、团队或组之间的连接。

直接字段

  • 工作单位

    添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

基线任务

基线是给定时刻项目性能的快照。 它们存储有关项目的关键信息，如关键日期、进度、成本和收入值。 创建基线时，也会在该基线的基线任务中捕获任务信息。

直接字段

  • durationUnit

    添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

类别

Category对象是自定义表单。 您可以为此对象生成报表，也可以将其显示在其他对象报表中。

直接字段

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

默认字段

  • isActive

    已添加

公司

Company对象表示由人员集合组成的组织。 公司与用户或项目相关联。

直接字段

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

默认字段

  • isActive

    已添加

CustomEnum

操作

已将以下操作添加到CustomEnum对象

  • getDefaultOpTaskConditionEnum
  • getDefaultProjectConditionEnum
  • getDefaultTaskConditionEnum
查询

已将以下查询添加到CustomEnum对象

  • opTaskConditions
  • 项目完成情况
  • taskConditions

客户

Customer对象表示一个使用Workfront实例的组织。

直接字段

  • customEnumType

    添加了可能的值：

    • CONDITION_PROJ（项目完成情况）
    • CONDITION_TASK（任务条件）
    • CONDITION_OPTASK（问题条件）
操作

已将以下操作添加到Customer对象

  • Goalenabled
  • updateLoginAsSettings

客户首选项

CustomerPreferences对象表示客户为其Workfront实例设置的首选项集。

  • name

    添加了可能的值：

    • password：password.eauthPolicy （密码复杂性要求）
    • password：password.minimumLength （最小密码长度）
    • password：mobileSessionTimeout（移动会话超时）
    • project.mgmt：default.project.usertimeoff（用户休息时间）
    • 时间表：default.timesheet.manualrole（手动控制角色）
    • proof：defaultNonRecipientRole (config.proofhq.defaultnonrecipientrole)
    • proof：defaultNonRecipientGuestRole (config.proofhq.defaultnonrecipientguestrole)

DocMetadataLinkGroup

操作

  • getMetadataDetailsForDocument

    已添加

文档

Document对象表示文件（如书面材料、图像或其他形式的信息）。

操作

已将以下操作添加到Document对象。

  • completeLargeDocument
  • createLargeDocument
  • createProofRest
  • getDocumentProofTemplate
  • getProofRecipients
  • getProofStages
  • getProofTemplate

迭代

小版本对象表示单个敏捷小版本。 迭代是离散的时间段，用于规划和完成Agile故事。

直接字段

以下字段已添加到“小版本”对象。

  • originaltotalpoints
  • 完成点数
  • totalPoint

布局模板

布局模板对象表示布局元素的特定排列，例如主菜单、导航面板或“主页”区域。 可以将布局模板分配给用户、团队、组或工作角色。

直接字段

  • showHomeTimestamps

    此字段已添加，并且是一个布尔参数。如果布局模板设置为在工作列表和日历中显示到期日期的时间戳，则值为true；如果设置为隐藏时间戳，则值为false。

默认字段

  • showHomeTimestamps

    已添加

里程碑路径

里程碑是表示它是项目关键点的任务指示标记。 通常用于表示重大事件，例如项目某一阶段的完成或一组关键活动。 MilestonePath对象是里程碑的集合。

直接字段

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

默认字段

  • isActive

    已添加

注释

Note对象是对Workfront对象所做的注释或更新。

直接字段

以下字段已添加到Note对象中。

  • proofID
收藏集字段

  • 赞

    已添加

Op 任务

OpTask对象通常称为“问题”。 问题是一个工作项，它通常表示存在阻止任务或项目完成的问题。 问题也可以是技术支持请求。 变更单、请求和错误也是问题。

直接字段

以下字段添加了验证器AT_DATE_BEFORE_YEAR和AT_DATE_AFTER_YEAR。 这些验证器指定相关对象的日期不能在1900年之前或2200年之后设置。

  • actualCompletionDate
  • actualStartDate
  • plannedCompletionDate
  • plannedStartDate

以下字段已添加到OpTask。

  • kanbanBoardID

    Kanban Board对象的唯一Workfront ID。

  • percentcomplete

    完成百分比是一个参数，它将返回问题的完成数量（百分比）。

  • storyPoints

  • 工作

收藏集字段

  • allConditions

    已添加

搜索字段

  • 工作

    已删除

默认字段

  • percentcomplete

    已添加

操作

已将以下操作添加到OpTask对象

  • 批量移动
  • copyIssue

参数

Parameter对象是一个自定义字段。

直接字段

  • 显示类型

    添加的可能值TYAH（预输入）。

  • refObjCode

    此字段已添加并引用引用引用对象的对象代码。 可以在API Explorer中找到所有对象的对象代码。

项目组合

Portfolio对象是争夺相同资源（通常是资金或人员来完成这些资源）的项目集合。

直接字段

  • 描述

    添加了验证器MAX_LENGTH ，它指定说明的长度不超过4000个字符。

项目群

项目群对象是项目组合中的子集，其中的相似项目可以分组在一起。

直接字段

  • 描述

    添加了验证器MAX_LENGTH ，它指定说明的长度不超过4000个字符。

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

  • name

    添加了验证器MAX_LENGTH ，它指定名称的长度不超过255个字符。

默认字段

  • isActive

    已添加

项目

项目是Workfront中的工作项，是Workfront帮助人们完成工作方式中的主要构建基块。 Project对象表示一组具有通用、特定目标的任务。

直接字段

以下字段添加了验证器AT_DATE_BEFORE_YEAR和AT_DATE_AFTER_YEAR。 这些验证器指定相关对象的日期不能在1900年之前或2200年之后设置。

  • actualCompletionDate
  • actualStartDate
  • plannedCompletionDate
  • plannedStartDate

向公共API添加了以下字段，以提高计算EAC（完工估算）的透明度。

  • bcwp

    预算执行工作成本(BCWP)也称为实现值，是一个项目绩效指标，它表示计算此指标时实际完成的任务的预算成本。 对于任务，BCWP =实际完成百分比x任务预算。 对于项目，BCWP = SUM（所有父任务和单个任务的BCWP值）。

  • bcws

    计划工作预算成本(BCWS)也称为计划值，是一个项目性能量度，表示计算此量度时应该完成的任务的预算成本。 对于任务，BCWS =计划完成百分比x任务预算。 对于项目，BCWS = SUM（所有父任务和单个任务的BCWS值）。

以下字段添加了标记CURRENCY

  • projectBudgetedCost
  • 项目净值

以下字段已从Project对象中删除。

  • timelineExceptionInfo
收藏集字段

  • allConditions

    已添加

ProofApproval

ProofApproval对象表示直接连接到验证的审批。

直接字段

  • isWaitingDecision

    此字段已添加，并且是一个布尔参数，如果验证等待决定，则值为true；如果验证等待决定，则值为false。

QueueDef

QueueDef对象表示队列，这是一个已发布到技术支持区域以允许用户向其提交问题的项目。

直接字段

以下字段添加了可能的值BUDGETING_INFORMATION。 这允许具有权限的用户在规划者中编辑优先级和预算小时数。

  • requestorCoreAction
  • requestorForbiddenActions

保留时间

ReservedTime对象表示在用户个人时间中指定的天数，表示用户将无法工作。

ReservedTime资源已添加标志REPORTABLE。

直接字段

以下字段删除了标记NOT_GROUPABLE。

  • endDate
  • extRefId
  • startDate

以下字段已从ReservedTime对象中删除。

  • taskID
引用字段

  • 任务

    已删除

运营

  • 编辑

    已添加

ResourcePlannerFilter

ResourcePlannerFilter对象是一组规则，用于确定哪些项目将显示在资源规划者中。

ResourcePlannerFilter资源添加了标记SHARABLE。 没有对该对象进行其他更改。

风险

风险对象表示可能会阻止项目按时完成或在预算内完成的可能事件。 在规划阶段的项目会增加风险，以在批准任何工作之前确定潜在的障碍。

直接字段

向Risk对象添加了以下字段：

  • enteredById

    最初创建对象的用户的ID。

  • entryDate

    用户在Workfront中提交对象的日期。

  • lastUpdateDate

    Last Update Date参数将返回对象上次更新的日期，

  • lastUpdatedByID

    上次更新者ID是一个参数，它将返回上次更新对象的用户的用户ID。

引用字段

已将以下引用字段添加到RIsk对象。

  • 输入者
  • lastUpdatedBy

计划报告

ScheduledReport对象表示已配置为计划提交的报表。

直接字段

  • pageSize

    添加了以下可能值：

    • A2
    • A1
    • A0

记分卡问题

ScoreCardQuestion对象表示已添加到记分卡的问题。 这些问题通常由Portfolio经理决定，这些问题的答案让经理能够了解项目与项目组合目标的符合程度。

直接字段

  • 显示类型

    可能附加值TYAH（预输入）

任务

Task对象表示作为实现最终目标（完成项目）的步骤而必须执行的工作项。

直接字段

以下字段添加了验证器AT_DATE_BEFORE_YEAR和AT_DATE_AFTER_YEAR。 这些验证器指定相关对象的日期不能在1900年之前或2200年之后设置。

  • actualCompletionDate
  • actualStartDate
  • 约束日期
  • plannedCompletionDate
  • plannedStartDate

向公共API添加了以下字段，以提高计算EAC（完工估算）的透明度。

  • bcwp

    预算执行工作成本(BCWP)也称为实现值，是一个项目绩效指标，它表示计算此指标时实际完成的任务的预算成本。 对于任务，BCWP =实际完成百分比x任务预算。 对于项目，BCWP = SUM（所有父任务和单个任务的BCWP值）。

  • bcws

    计划工作预算成本(BCWS)也称为计划值，是一个项目性能量度，表示计算此量度时应该完成的任务的预算成本。 对于任务，BCWS =计划完成百分比x任务预算。 对于项目，BCWS = SUM（所有父任务和单个任务的BCWS值）。

以下字段添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

  • durationUnit
  • 工作单位

以下字段已从Task对象中删除。

  • 保留时间ID

以下字段已添加到Task对象。

  • storyPoints
引用字段

  • reservedtime

    已删除

收藏集字段

  • allConditions

    已添加

团队

团队对象是可分配给工作项的用户的集合。

直接字段

  • agileEstimateType

    此字段已添加到Team对象。 Agile评估类型确定如何评估文章的工作负载。 如果以小时数进行估计，则这是添加到故事的已计划小时数。 如果以点为单位进行估计，则每个点都将根据点的设置方式向文章添加若干已计划小时数（默认值为8小时）。 Agile评估类型的可能值包括：

    • STORY_POINTS（故事点）
    • 小时（小时）
    • LEGACY_POINTS（小时作为点）

模板

Template对象表示项目的模式。 可通过模板创建项目以节省时间。 模板包含团队和任务，在使用模板时，这些团队和任务将被复制到项目中。

直接字段

  • isActive

    此字段已添加，并且是一个布尔参数，如果对象处于活动状态，则该参数的值为true ；否则为false。 设置为“活动”的对象会显示在下拉菜单和预输入字段中，并可附加到其他对象。 未设置为“活动”的对象在下拉菜单和要附加到其他对象的前置键入字段中不可见。

收藏集字段

  • 所有优先级

    已添加

默认字段

  • isActive

    已添加

模板分派

直接字段

  • 工作单位

    添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

TemplateTask

TemplateTask对象表示属于Template一部分的Task。 模板任务将成为使用模板的项目中的任务。

直接字段

以下字段添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

  • durationUnit
  • 工作单位
收藏集字段

  • 所有优先级

    已添加

时间表

工时表对象表示一个虚拟工时表，允许用户输入任务、项目和管理费用小时类型的实际工作小时数。

核心字段

  • 对象代码

    已删除

更新

可以更新Workfront中的工作项以通知用户当前状态。 Update对象表示这些更新之一。 更新可由用户输入或由Workfront系统创建。

直接字段

  • updateType

    添加了可能的值referenceObjectCustomData (enum.updatetypeenum.referenceobjectcustomdata)

查询

以下查询已添加到Update对象。

  • objectUpdatesMobile
  • updateThreadMobile

  • loginAsAccessRules

    已添加

已将以下操作添加到User对象。

  • hasGrantLoginAsAccess
  • isUserAdmin

  • userAdmin

    已添加

用户注释

操作

已将以下操作添加到User对象。

  • acknowledgeMyNotifications
  • unacknowledgedAllObjectsTypeCount
查询

  • myAllObjectTypesUnreadNotifications

    已添加

工作

Work对象是Task和OpTask都继承的公用接口，它们共享公用代码。

直接字段

以下字段添加了验证器AT_DATE_BEFORE_YEAR和AT_DATE_AFTER_YEAR。 这些验证器指定相关对象的日期不能在1900年之前或2200年之后设置。

  • actualCompletionDate
  • actualStartDate
  • 约束日期
  • plannedCompletionDate
  • plannedStartDate

向公共API添加了以下字段，以提高计算EAC（完工估算）的透明度。

  • bcwp

    预算执行工作成本(BCWP)也称为实现值，是一个项目绩效指标，它表示计算此指标时实际完成的任务的预算成本。 对于任务，BCWP =实际完成百分比x任务预算。 对于项目，BCWP = SUM（所有父任务和单个任务的BCWP值）。

  • bcws

    计划工作预算成本(BCWS)也称为计划值，是一个项目性能量度，表示计算此量度时应该完成的任务的预算成本。 对于任务，BCWS =计划完成百分比x任务预算。 对于项目，BCWS = SUM（所有父任务和单个任务的BCWS值）。

以下字段添加了可能的值ET。 此值表示经过的月时间单位，该值是指不考虑周末或节假日时的月。

  • durationUnit
  • 工作单位

以下字段已从工作对象中删除。

  • 保留时间ID

以下字段已添加到工作对象。

  • storyPoints
引用字段

  • reservedtime

    已删除

收藏集字段

  • allConditions

    已添加

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