TestRun Object

Applies to QAComplete 12.84 SaaS, last modified on July 19, 2021

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.

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

Highlight search results