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.
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.
ConfigurationName : string (max 100 chars)
The name of the test configuration that was used for the test run.
DateFinished : dateTime
The date and time when the test was finished.
DateStarted : dateTime
The date and time when the test started.
IsStoppedOnFail : string
Specifies if the test run should stop when the test item fails.
ProjId : integer
The ID of the project that contains the test.
RunByUserName : string (max 78 chars)
The name of the user who run the test, in the Lastname, Firstname format.
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.
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.
TestId : integer
The ID of the related test.
TestName : string
The name of the related test.
TestRunId : integer
The ID of the parent test run.
TestRunItemId : integer
The unique identifier of the test run item.
TestSetId : integer
The identifier of the test set that contains the related test.
TestSetName : string (max 100 chars)
The name of the test set that contains the related test.
Title : string
Reserved.
Version : integer
The version 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>