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.
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