What’s new in API version 14
- Topics:
- Workfront API
CREATED FOR:
- Developer
Adobe Workfront released API version 14 on September 9, 2021. API version 14 features the following changes from version 14.
Added resources
No resources were added for API version 14.
Removed resources
No resources were removed for API verson 14.
Modified resources
The following resources were modified for API version 14.
BillingRecord (BILL)
A BillingRecord object records the revenue, hours, or expenses that can be billed. This information can be used to create invoices in an external accounting system.
For more information on billing records, see Create billing records.
The BillingRecord object added the flag DATA_EXTENDIBLE.
-
categoryID
Added. A Category is a Custom Form. This parameter was added to support the ability to add Custom Forms to BillingRecord objects.
-
category
Added. A Category is a custom form. This parameter was added to support the ability to add custom forms to BillingRecord objects.
-
objectCategories
Added. This represents a collection of Categories (custom forms) associated with the BillingRecord object.
-
calculateDataExtension
Added. This action recalculates the expressions in custom form fields.
Category (CTGY)
A Category object is a custom form.
-
catObjCode
Added possible value:
- BILL (BillingRecord)
This value was added to support the ability to add custom forms to BillingRecord objects.
-
isObjectFrozenInPendingApprovalStatus
This action takes the parameters objID and objCode, and returns a boolean.
CustomEnum (CSTEM)
The CustomEnum object aids with converting status codes into human-readable text.
-
getGroupStatuses
Added. This query supports the ability to create and manage statuses for groups and subgroups.
For more information, see Manage group statuses.
Customer (CUST)
A Customer object represents an organization that uses an instance of Workfront.
This is an internal object.
CustomerPreferences (CUSTPR)
A CustomerPreferences object represents the set of preferences that a customer has set for their instance of Workfront.
-
name
Added possible value:
- Allow users to add images in updates (updates:images.toggle)
This parameter supports the ability to add images into work item updates.
For more information, see Update work.
DocumentVersion (DOCV)
A DocumentVersion object represents a specific version of a file (such as written material, images, or other forms of information).
For more information about document versions, see Upload a new version of a document.
-
lastCallbackDate
Added. This field records the date and time of the last callback from Workfront Proof, if the version is associated to a proof.
Group (GROUP)
A Group object represents a set of users and teams. Groups often represent departmental structure.
For more information on groups, see Groups vs. teams in Adobe Workfront.
-
addSubgroups
Added. This action takes an array of groupIDs and adds those groups as subgroups to the specified group.
NoteTag (NTAG)
A NoteTag object represents the act of tagging a user or team in an update to a work item.
For more information on tagging in updates, see Tag others on updates.
The following operations were added to the NoteTag object:
-
COUNT
-
GET
-
REPORT
-
SEARCH
Project (PROJ)
Projects are work items within Workfront, and are a main building block in the way Workfront helps people to do work. A Project object represents a group of tasks with a common, specific goal.
-
updateBusinessCaseSource
Added.
QueueDef (QUED)
A QueueDef object represents a Queue, which is a project that has been published to the Help Desk area to allow users to submit issues to it.
For more information on Request Queues, see Create a Request Queue.
-
searchByPath
Added. This action supports the ability to find requests by using the path through the request queue and topic groups.
For more information on searching request queues by path, see Create requests and generate drafts in the Workfront web app in Create and submit Adobe Workfront requests.
Resource Allocation (RSALLO)
A Resource Allocation object represents the estimate of resources needed for a given project. This object is used only in the legacy Resource Planner. For the corresponding field in the new Resource Planner, use Budgeted Hour (BGHR).
The Resource Allocation object removed the flag REPORTABLE.
Role (ROLE)
A Role object (job role) represents a functional capacity or a skill set a user might fill, such as Designer or Product Manager.
For information on job roles, see Job role overview.
-
isActive
Added. This is a boolean parameter that has a value of true if an object is Active and false if it is not. Objects that are set to Active appear in drop-down menus and type-ahead fields and can be attached to other objects.
-
isActive
Added
Template (TMPL)
A Template object represents a pattern for a project. Projects can be created from templates to save time. A template contains a team and tasks, which will be copied to any project created from the template.
-
groupID
Added. This field was added to support the ability to associate groups with templates.
For more information, see Edit project templates.
-
group
Added. This field was added to support the ability to associate groups with templates.
For more information, see Edit project templates.