TestRunItem Object

Applies to QAComplete 12.80 SaaS, last modified on April 20, 2021

A TestRunItem object represents a record in the run history of a test. QAComplete creates it when you add a new TestRun object. Using QAComplete SOAP API, you can load and update test run items.

Requirements

To manage a test run item, the web service user must be in a security group that has the corresponding privileges – Read or Update – for Test Library. You can view or set these privileges in  > Setup > Security > Security Groups > Manage Security Rights > select user group.

Properties

TestRunItemId  :  integer

The unique identifier of the test run item.

TestSetId  :  integer

The identifier of the test set that contains the related test.

ProjId  :  integer

The ID of the project that contains the test.

TestRunId  :  integer

The ID of the parent test run.

TestId  :  integer

The ID of the related test.

Title  :  string

Reserved.

Version  :  integer

The version of the related test.

Seq  :  integer

The ordinal number of the test run item in the test run. Default value: 0.

StatusCode  :  string (max 100 chars)

The status of the test run. Possible values:

  • Awaiting Run – Test is not run yet.

  • Passed – Test is finished successfully.

  • Failed – Test is failed.

  • Blocked – Test is unfinished and marked as Blocked.

  • Skipped – The test set run was stopped before the related test was run.

DateStarted  :  dateTime

The date and time when the test started.

DateFinished  :  dateTime

The date and time when the test was finished.

RunTime  :  integer

How long the test item was run in seconds.

RunTimeFormated  :  string (max 100 chars)

How long the test item was run in the hh:mm:ss format.

IsStoppedOnFail  :  string

Specifies if the test run should stop when the test item fails.

RunByUserName  :  string (max 78 chars)

The name of the user who run the test, in the Lastname, Firstname format.

ConfigurationName  :  string (max 100 chars)

The name of the test configuration that was used for the test run.

TestSetName  :  string (max 100 chars)

The name of the test set that contains the related test.

AvgRunTime  :  integer

The average time of the related test runs in seconds.

AvgRunTimeFormated  :  string

The average time of the related test runs in the hh:mm:ss format.

TestName  :  string

The name of the related test.

Relevant Operations

Example

XML

<TestRunItem>
  <TestRunItemId>1354</TestRunItemId>
  <TestSetId>254</TestSetId>
  <ProjId>10372</ProjId>
  <TestRunId>358</TestRunId>
  <TestId>468</TestId>
  <Version>2</Version>
  <Seq>1</Seq>
  <DateStarted>2014-07-29T13:24:18:027</DateStarted>
  <DateFinished>2014-07-29T13:26:31:069</DateFinished>
  <RunTime>134</RunTime>
  <RunTimeFormated>00:02:14</RunTimeFormated>
  <IsStoppedOnFail>N</IsStoppedOnFail>
  <RunByUserName>Doe, John</RunByUserName>
  <ConfigurationName>Windows 7 (32-bit)</ConfigurationName>
  <TestSetName>Regression Tests - Release 3.1.0</TestSetName>
  <AvgRunTime>139</AvgRunTime>
  <AvgRunTimeFormated>00:02:19</AvgRunTimeFormated>
  <TestName>Test input data</TestName>
</TestRunItem>

See Also

TestRunItems_Load Operation
Test Run Item Operations

Highlight search results