WorkItem

Represents a logical unit of work, such as a user story, task, or bug, used to track the progress of metadata and configuration data changes within a Lifecycle Center project. A work item moves through multiple development lifecycle stages until all development work is complete and the work item is part of the release pipeline.

Introduced in API version 64.0.

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

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the Lifecycle Center user assigned to this work item. Lifecycle Center uses this field only to display the user’s name in the UI. This is a relationship field.

    This field is a relationship field.

  • Relationship name: AssignedTo

  • Relationship type: relationship

  • Refers to: User

  • Type: textarea
  • Properties: Create, Nillable, Update
  • Description: A detailed description of the work item. Lifecycle Center uses this field only to display the description in the UI.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the user who approved the work item for promotion.

    This field is a relationship field.

  • Relationship name: DevelopmentApprovedBy

  • Relationship type: relationship

  • Refers to: User

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the development environment where this work item was developed.

    This field is a relationship field.

  • Relationship name: DevelopmentEnvironment

  • Relationship type: relationship

  • Refers to: DevopsEnvironment

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the current pipeline stage associated with this work item.

    This field is a relationship field.

  • Relationship name: DevopsPipelineStage

  • Relationship type: relationship

  • Refers to: DevopsPipelineStage

  • Type: reference

  • Properties: Create, Filter, Group, Sort, Update

  • Description:

    The ID of the Lifecycle Center project to which the work item belongs. This is a relationship field.

    This field is a polymorphic relationship field.

  • Relationship name: DevopsProject

  • Relationship type: polymorphic

  • Refers to: DevopsProject, FtestMain

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Type: boolean

  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update

  • Description:

    Indicates whether a team member has approved the work item for promotion. The default value is false.

    The default value is false.

  • Default value: false

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 68.0
  • Type: datetime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 66.0
  • Description: The date and time the work item feature branch was last synced with the source control repository.
  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: A unique identifier for the work item, typically using a WI- prefix.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the parent work item, if this work item is a subtask of a larger unit of work

    This field is a relationship field.

  • Relationship name: ParentWorkItem

  • Relationship type: relationship

  • Refers to: WorkItem

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the branch used for rebase operations to resolve dependencies.

    This field is a relationship field.

  • Relationship name: RebaseBranch

  • Relationship type: relationship

  • Refers to: SourceCodeRepositoryBranch

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the DevopsRequestInfo record that tracks the rebase operation status.

    This field is a relationship field.

  • Relationship name: RebaseStatus

  • Relationship type: relationship

  • Refers to: DevopsRequestInfo

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A reference to the change request for this work item in the source control system. In GitHub, a change request is called a pull request (PR) and the ID is the PR number.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the feature branch in the source control repository where changes for this work item are stored. Lifecycle Center initially sets this value when the work item moves to IN_PROGRESS. The value persists until the work item becomes part of a pipeline stage.

    This field is a relationship field.

  • Relationship name: SourceCodeRepositoryBranch

  • Relationship type: relationship

  • Refers to: SourceCodeRepositoryBranch

  • Type: picklist

  • Properties: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update

  • Description:

    The current state of the work item in the release cycle. The default value is NEW.

    The default value is NEW.

  • Possible values:

    • NEW — NEW (default) — The initial status upon creation; work hasn’t yet started.
    • IN_PROGRESS — IN_PROGRESS — Active development in the development environment.
    • IN_REVIEW — IN_REVIEW — Changes are committed and a pull request is created for team review.
    • READY_TO_PROMOTE — READY_TO_PROMOTE — The work item is approved and is ready for promotion to the first pipeline stage.
    • PROMOTED — PROMOTED — The work item is promoted to a pipeline stage.
    • MERGE_CONFLICT — MERGE_CONFLICT — Indicates that the work item has conflicts that must be resolved before promotion.
    • NEVERED — NEVERED — The work item is inactive and won’t be promoted.
    • COMBINED — COMBINED — The work item was merged into another work item to resolve conflicts or dependencies.
    • CLOSED — CLOSED — Work is complete, fully tested, and promoted through the entire pipeline.

  • Default value: NEW

  • Type: string
  • Properties: Create, Filter, Group, Sort, Update
  • Description: A brief description or title of the work item.

Use this object to track the progress of a task and the user assigned to it. You can develop and commit changes either within a connected development environment or by using your own external development tools.

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.