CTestRun

Contains information for a specific test run.

To generate manual test runs from one test case, use generateTestRuns. To generate manual test runs from multiple test cases, use generateBatchTestRuns.

To create a defect from a test run, use createDefectForTestRun.

Extends

CItemToTrack

Fields

Field Type Description
recordid long Unique test run record ID.
testrunnumber long Unique test run number. If the project is configured to not automatically assign numbers, the value is 0.
summary string Test run summary.
state string Current workflow state. Read only.
createdbyuser string User who generated the test run. Set to the current SOAP user if another value is not specified. See Formatting name fields for formatting information.
datetimecreated DateTime Date the test run was generated.
locationaddedfrom string Method used to generate the test run. Read only.
modifiedbyuser string User who last modified the test run.
datetimemodified DateTime Date the test run was last modified.
customFieldList CField[] Custom field values for the test run.
eventlist CEvent[] Workflow events associated with the test run.
actualhours double Total number of actual effort hours. Read only.
estimatedhours double Number of estimated hours to complete the test run. Read only.
remaininghours double Number of remaining hours to complete the test run. Read only.
variance double Difference between actualhours and remaininghours compared to estimatedhours. Read only.
storypoints long Unit-less quantity representation of time remaining.
percentdone long Percent complete for the test run. Read only.
testcasenumber long Unique number for the test case the test run was generated from.
testcaserecordid long Unique record ID of the test case that the test run was generated from.
type string Dropdown list value. Use getDropdownFieldValuesForTable to retrieve a list of available values.
testrunset string Name of the test run set the test run belongs to. Use getDropdownFieldValuesForTable to retrieve a list of available values.
isautomated boolean Indicates if the test run is an automated test.
estimatedtime string Estimated run time (hh:mm:ss).
steps string Test run steps and expected results. See Test case and manual test run markup codes for information about available codes to indicate steps, comments, and results.
problemstatement string Contents of the Problem Statement field. Only visible if stepsmode is not set to Grid View.
testVariants CTestCaseVariantField[] List of test variants in the test run.
attachmentlist CFileAttachment[] CFileAttachment items associated with the test run.
sccFileList CSCCFileRecord[] Source control files attached to the test run.
stepsmode string Display mode for the test run. Read only.

Returned by

Used in

saveTestRun