DevopsTestSuiteExecution

Records the individual execution lifecycle, results, and metrics of a specific test suite within a DevOps pipeline stage. It tracks granular outcomes like code coverage, pass/fail rates, and links directly back to the overarching test suite group. This object is available in API version 67.0 and later.

Supported Calls

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

Fields

Field Details
Coverage
Type
percent
Properties
Create, Filter, Nillable, Sort, Update
Description
The automated code coverage percentage for example, Apex test coverage, achieved during this specific test suite execution.
DevopsTestSuiteGroupExecId
Type
reference
Properties
Create, Filter, Group, Sort, Update
Description
References the parent DevopsTestSuiteGroupExec record that coordinates this and other related test suite executions within the pipeline stage.
Relationship Name
DevopsTestSuiteGroupExec
Refers To
DevopsTestSuiteGroupExec
DevopsTestSuiteId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
References the definition of the DevopsTestSuite being executed.
This field is a relationship field.
Relationship Name
DevopsTestSuite
Refers To
DevopsTestSuite
DevopsTestSuiteStageId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
References the specific stage configuration or environment step (DevopsTestSuiteStage) where this execution takes place.
This field is a relationship field.
Relationship Name
DevopsTestSuiteStage
Refers To
DevopsTestSuiteStage
ExecutionEndTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time when the test suite finished executing. This field remains null while the execution is actively InProgress.
ExecutionStartTime
Type
dateTime
Properties
Create, Filter, Sort, Update
Description
The precise date and time when the execution of this test suite commenced.
ExternalIdRef
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
A unique identifier used to map or reference this test run to an external CI/CD engine, testing framework, or third-party tool execution ID.
FailureCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of individual test cases or assertions that failed during this test suite run.
FailureRate
Type
percent
Properties
Create, Filter, Nillable, Sort, Update
Description
The calculated percentage of failed tests relative to the total number of tests run in this suite.
LastReferencedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last accessed this record indirectly, such as through a related list or lookup context.
LastViewedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last explicitly viewed this record's detail page or list view.
LearnMore
Type
url
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
A URL pointing to supplemental documentation, internal run logs, or troubleshooting guides relevant to this test suite execution.
Name
Type
string
Properties
Autonumber, Defaulted on create, Filter, idLookup, Sort
Description
A system-generated unique auto-number identifier assigned to the test suite execution record.
OwnerId
Type
reference
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Identifies the user or queue that owns this specific test suite execution record.
Relationship Name
Owner
Refers To
Group, User
QualityGateStatus
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Represents the final evaluation outcome of any automated quality policies or compliance criteria established for this test suite.
Possible values are:
  • Error
  • Failed
  • InProgress
  • Passed
The default value is Passed.
ReportUrl
Type
url
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The web link to the complete, detailed test execution report or artifacts (e.g., JUnit XML, HTML dashboard) generated by the runner.
ResultDetails
Type
textarea
Properties
Create, Nillable, Update
Description
A raw block of summary text, error logs, stack traces, or console output detailing why a test failed or stalled.
Status
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The operational state of the test suite run execution process itself.
Possible values are:
  • Error
  • Failed
  • InProgress
  • Passed
The default value is Passed.
SuccessCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of individual test cases or assertions that completed successfully without errors.
SuccessRate
Type
percent
Properties
Create, Filter, Nillable, Sort, Update
Description
The calculated percentage of passing tests relative to the total number of tests run in this suite.