Work Item (sf_devops__Work_Item__c)

Represents a collection of metadata changes in a project. A work item can be associated with an environment in which the work is performed. If it’s not connected to an environment, the VCS Event object handles the changes. A work item goes through a number of development lifecycle stages until all development work is complete and the work item is part of the release pipeline. This object is available in all orgs that have DevOps Center installed.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field	Type	Properties	Description
`Name`	string	Autonumber, Defaulted on create, Filter, idLookup, Sort	Name of this Work Item record.
`sf_devops__Assigned_To__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the DevOps Center user that this work item is assigned to. DevOps Center uses this field only to display the user’s name in the UI. This field is a relationship field. Relationship name: sf_devops__Assigned_To__r. Relationship type: Lookup. Refers to: User.
`sf_devops__Branch__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the Branch record that contains all the information about the feature branch associated with this work item. DevOps Center initially sets this value when the work item transitions to `IN_PROGRESS`. The value stays set until the work item becomes a member of the change bundle. This field is a relationship field. Relationship name: sf_devops__Branch__r. Relationship type: Lookup. Refers to: sf_devops__Branch__c.
`sf_devops__Change_Bundle__c`	reference	Create, Filter, Group, Nillable, Sort, Update	If this work item is part of a bundle, this field references the Change Bundle record that this work item belongs to. This field is a relationship field. Relationship name: sf_devops__Change_Bundle__r. Relationship type: Lookup. Refers to: sf_devops__Change_Bundle__c.
`sf_devops__Combine_Status__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the Async Operation Result record associated with the most recent attempt to combine other work items with this work item. This field is a relationship field. Relationship name: sf_devops__Combine_Status__r. Relationship type: Lookup. Refers to: sf_devops__Async_Operation_Result__c.
`sf_devops__Combined_With__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the other work item that this work item has been combined with. This field is a relationship field. Relationship name: sf_devops__Combined_With__r. Relationship type: Lookup. Refers to: sf_devops__Work_Item__c.
`sf_devops__Concluded__c`	string	Create, Filter, Group, Nillable, Sort, Update	If this field is set to a value, the work item has finished being used for active development or promotion. A work item is done when it’s either reached the last stage of the pipeline or a user has set its status to `NEVERED`.
`sf_devops__Cross_Environment_Combination__c`	boolean	Create, Defaulted on create, Filter, Group, Sort, Update	If `true`, this work item is the result of a combination operation where metadata came from multiple development environments. The default value is `false`.
`sf_devops__Description__c`	textarea	Create, Nillable, Update	Description of the work item. DevOps Center uses this field only to display the description in the UI.
`sf_devops__Development_Approved_By__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the user who clicked the Ready to Promote button for this work item in DevOps Center. This field is a relationship field. Relationship name: sf_devops__Development_Approved_By__r. Relationship type: Lookup. Refers to: User.
`sf_devops__Development_Approved__c`	boolean	Create, Defaulted on create, Filter, Group, Sort, Update	If `true`, a user has clicked the Ready to Promote button for this work item in DevOps Center and the work item shows up in the Approved Work Items column in the pipeline. The default value is `false`.
`sf_devops__Development_Environment__c`	string	Filter, Nillable, Sort	Environment in which the work for this work item was developed. This field is a calculated field.
`sf_devops__Environment__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Environment in which active development work for this work item is happening. DevOps Center clears this field value when the work item’s status is `PROMOTED`. This field is a relationship field. Relationship name: sf_devops__Environment__r. Relationship type: Lookup. Refers to: sf_devops__Environment__c.
`sf_devops__Operation_Status__c`	reference	Create, Filter, Group, Nillable, Sort, Update	If this work item is part of a remote operation, this field references the Async Operation Result record for that operation. DevOps Center clears this field value when the operation terminates. This field is a relationship field. Relationship name: sf_devops__Operation_Status__r. Relationship type: Lookup. Refers to: sf_devops__Async_Operation_Result__c.
`sf_devops__Project__c`	reference	Create, Filter, Group, Sort	Reference to the parent project of this work item. This field is a relationship field. Relationship name: sf_devops__Project__r. Relationship type: Master-detail. Refers to: sf_devops__Project__c.
`sf_devops__Promoted_From_Environment__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the development environment that this work item was originally promoted from. When a user promotes a work item, DevOps Center clears the Environment field value of its associated Work Item record. However, DevOps Center must still know which environment the work item was originally promoted from so it can do further processing. So when the first promotion of a work item completes, DevOps Center sets this field to the value of the Environment field before it’s cleared. This field is a relationship field. Relationship name: sf_devops__Promoted_From_Environment__r. Relationship type: Lookup. Refers to: sf_devops__Environment__c.
`sf_devops__Promoted__c`	boolean	Create, Defaulted on create, Filter, Group, Sort, Update	If `true`, then this work item has been promoted at least one time. The default value is `false`.
`sf_devops__Rebase_Branch__c`	reference	Create, Filter, Group, Nillable, Sort, Update	Reference to the Branch record that this work item is using as its rebase branch. This field is a relationship field. Relationship name: sf_devops__Rebase_Branch__r. Relationship type: Lookup. Refers to: sf_devops__Branch__c.
`sf_devops__Review_Remote_Reference__c`	string	Create, Filter, Group, Nillable, Sort, Update	Unique ID of the change request for this work item. In GitHub, a change request is called a pull request (PR) and the ID is the PR number. DevOps Center clears this field when the work item’s status changes to `IN_REVIEW`. As the work item moves through the pipeline stages, DevOps Center creates change requests and updates this field with the new ID. When the work item becomes a member of a change bundle, DevOps Center clears this field and no longer sets it.
`sf_devops__State__c`	string	Filter, Nillable, Sort	Current state of this work item. Valid values: `NEW`, `IN_PROGRESS`, `IN_REVIEW`, `APPROVED`, `PROMOTED`, `CLOSED`, or `NEVERED`.
`sf_devops__Subject__c`	string	Create, Filter, Group, Sort, Update	Subject of the work item. DevOps Center uses this field only to display the subject in the UI.

See Also