A TestRun
object represents one record in the run history of a test or test set. Using QAComplete SOAP API, you can add, load, and update test runs.
Requirements
To manage test runs, the web service user must be in a security group that has the corresponding privileges – Read, Add or Update – for Test Library. You can view or set these privileges in > Setup > Security > Security Groups > Manage Security Rights > select user group.
Properties
TestRunId : integer
The unique identifier of the test run.
TestSetId : integer
The ID of the related test set.
0 if the test run includes a single test, not a test set.
TestSetName : string (max 100 chars)
The name of the related test set.
TestConfigId : integer
The ID of the test configuration that was used for the test run.
ConfigurationName : string (max 100 chars)
The name of the test configuration that was used for the test run.
ReleaseId : integer
The ID of the linked release.
ProjId : integer
The ID of the project that contains the test run.
RunByUserId : integer
The ID of the user who run the test.
RunByUserName : string (max 78 chars)
The name of the user who run the test, in the Lastname, Firstname
format.
IsSequential : string (max 2 chars)
Y
if the tests in the test set run must be run in the order specified in the test set.
N
otherwise.
StatusCode : string (max 100 chars)
The test run status. Possible values:
-
Awaiting Run – The test run is not started yet.
-
In Progress – The test run is in progress.
-
Passed – The test run finished successfully.
-
Failed – There were failed tests in the test run.
-
Paused – The test run was paused to continue it later.
-
Blocked – The test run was paused and marked as Blocked.
-
Incomplete – The test run was stopped, but some test items are skipped.
ExecutionType : string (max 100 chars)
The test run type. Possible values:
-
Manual – Manual test.
-
Auto – Automated test.
DateStarted : dateTime
The date and time the test run was started.
DateFinished : dateTime
The date and time the test run was finished.
NbrTests : integer
The number of tests in the related test set.
If the test run includes a single test, NbrTests
is always 1.
NbrPassed : integer
The number of passed tests in the test run.
NbrFailed : integer
The number of failed tests in the test run.
NbrBlocked : integer
The number of blocked tests in the test run.
NbrAwaitingRun : integer
The number of the tests that are not run yet.
RunTime : integer
The test run time, in seconds.
RunTimeFormated : string (max 100 chars)
The test run time in the hh:mm:ss
format.
ReleaseName : string (max 100 chars)
The full name of the related release.
TestId : integer
If the test run includes a single test, not a test set (TestSetId is 0), use TestId to specify the ID of the related test.
HostId : integer
The ID of the host where the test or test set will run.
ConfigurationName : string (max 100 chars)
The name of the test configuration that was used for the test run.
DateFinished : dateTime
The date and time the test run was finished.
DateStarted : dateTime
The date and time the test run was started.
ExecutionType : string (max 100 chars)
The test run type. Possible values:
-
Manual – Manual test.
-
Auto – Automated test.
HostId : integer
The ID of the host where the test or test set will run.
IsSequential : string (max 2 chars)
Y
if the tests in the test set run must be run in the order specified in the test set.
N
otherwise.
NbrAwaitingRun : integer
The number of the tests that are not run yet.
NbrBlocked : integer
The number of blocked tests in the test run.
NbrFailed : integer
The number of failed tests in the test run.
NbrPassed : integer
The number of passed tests in the test run.
NbrTests : integer
The number of tests in the related test set.
If the test run includes a single test, NbrTests
is always 1.
ProjId : integer
The ID of the project that contains the test run.
ReleaseId : integer
The ID of the linked release.
ReleaseName : string (max 100 chars)
The full name of the related release.
RunByUserId : integer
The ID of the user who run the test.
RunByUserName : string (max 78 chars)
The name of the user who run the test, in the Lastname, Firstname
format.
RunTime : integer
The test run time, in seconds.
RunTimeFormated : string (max 100 chars)
The test run time in the hh:mm:ss
format.
StatusCode : string (max 100 chars)
The test run status. Possible values:
-
Awaiting Run – The test run is not started yet.
-
In Progress – The test run is in progress.
-
Passed – The test run finished successfully.
-
Failed – There were failed tests in the test run.
-
Paused – The test run was paused to continue it later.
-
Blocked – The test run was paused and marked as Blocked.
-
Incomplete – The test run was stopped, but some test items are skipped.
TestConfigId : integer
The ID of the test configuration that was used for the test run.
TestId : integer
If the test run includes a single test, not a test set (TestSetId is 0), use TestId to specify the ID of the related test.
TestRunId : integer
The unique identifier of the test run.
TestSetId : integer
The ID of the related test set.
0 if the test run includes a single test, not a test set.
TestSetName : string (max 100 chars)
The name of the related test set.
![](/qacomplete/docs/_assets/commonImages/plus-btn2.png)
Relevant Operations
Remarks
Depending on the specified StatusCode
property QAComplete changes the Awaiting Run statuses of the child TestRunItem
objects to the corresponding values.
Example
XML
<TestRun>
<TestRunId>358</TestRunId>
<TestSetId>0</TestSetId>
<TestConfigId>24</TestConfigId>
<ConfigurationName>Windows 7 (32-bit)</ConfigurationName>
<ReleaseId>14</ReleaseId>
<ProjId>10372</ProjId>
<RunByUserId>27942</RunByUserId>
<RunByUserName>Doe, John</RunByUserName>
<IsSequential>N</IsSequential>
<StatusCode>In Progress</StatusCode>
<ExecutionType>Manual</ExecutionType>
<DateStarted>2014-07-29T13:24:18:027</DateStarted>
<DateFinished>0001-01-01T00:00:00</DateFinished>
<NbrTests>1</NbrTests>
<NbrPassed>0</NbrPassed>
<NbrFailed>0</NbrFailed>
<NbrBlocked>0</NbrBlocked>
<NbrAwaitingRun>1</NbrAwaitingRun>
<RunTime>15</RunTime>
<RunTimeFormated>00:00:15</RunTimeFormated>
<TestId>2112</TestId>
<HostId>167</HostId>
</TestRun>
See Also
TestRuns_Add Operation
TestRuns_Load Operation
Test Run Operations