DevopsPipelnStgProm

Represents a stage promotion in DevOps Center. Stage promotion moves one or more work items to the next stage in the pipeline. This object is available in API version 66.0 and later.

Supported Calls

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

Fields

Field Details
CompletionDate
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time when the stage promotion operation was completed.
LastReferencedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.
LastViewedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view indirectly.
Name
Type
string
Properties
Autonumber, Defaulted on create, Filter, idLookup, Sort
Description
A unique name for the pipeline stage promotion record.
PipelineStageId
Type
reference
Properties
Create, Filter, Group, Sort
Description
The ID of the target pipeline stage to which the work items are promoted.
This field is a relationship field.
Relationship Name
PipelineStage
Relationship Type
Master-detail
Refers To
DevopsPipelineStage (the parent object)
RequestInfoId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The ID of the associated DevopsRequestInfo record that tracks this event.
This field is a relationship field.
Relationship Name
RequestInfo
Refers To
DevopsRequestInfo
Status
Type
picklist
Properties
Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort
Description
The current state of the promotion operation.
Possible values are:
  • CANCELLED
  • ERROR
  • FINALIZING
  • INTERRUPTED
  • IN_PROGRESS
  • NEW
  • SUCCESS
The default value is NEW.

Usage

Use this object to track the execution and outcome of a stage promotion. During promotion, work item branches merge into a target stage branch and deploys the associated metadata and configuration data to the environment linked to that stage.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

DevopsPipelnStgPromChangeEvent
Change events are available for the object.
DevopsPipelnStgPromFeed
Feed tracking is available for the object.
DevopsPipelnStgPromHistory
History is available for tracked fields of the object.
DevopsPipelnStgPromOwnerSharingRule
Sharing rules are available for the object.
DevopsPipelnStgPromShare
Sharing is available for the object.