See all operations
GET: projects/{project_id}/test-runs/{test_run_id}
Description
Retrieves a single test run in the system. Only returns the generic information
that is applicable for both automated and manual tests. Consider using
TestRun_RetrieveAutomatedById or TestRun_RetrieveManualById if you need
the automation/manual specific data for the test run
How to Execute
To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):
https://api.inflectra.com/spira/services/v7_0/RestService.svc/projects/{project_id}/test-runs/{test_run_id}
Request Parameters
|
Name
|
Description
|
|
project_id
|
The id of the current project
|
|
test_run_id
|
The id of the test run
|
Request Body
Return Data
The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.
|
Property
|
Description
|
|
TestRunId
|
The id of the test run
|
|
Name
|
The name of the test run (usually the same as the test case)
|
|
TestCaseId
|
The id of the test case that the test run is an instance of
|
|
TestCaseGuid
|
The guid of the test case that the test run is an instance of
|
|
TestRunTypeId
|
The id of the type of test run (automated vs. manual)
|
|
TesterId
|
The id of the user that executed the test
The authenticated user is used if no value is provided
|
|
TesterGuid
|
The guid of the tester.
|
|
ExecutionStatusId
|
The id of overall execution status for the test run
Failed = 1;
Passed = 2;
NotRun = 3;
NotApplicable = 4;
Blocked = 5;
Caution = 6;
|
|
ReleaseId
|
The id of the release that the test run should be reported against
|
|
ReleaseGuid
|
The guid of the release
|
|
TestSetId
|
The id of the test set that the test run should be reported against
|
|
TestSetGuid
|
The guid of the test set
|
|
TestSetTestCaseId
|
The id of the unique test case entry in the test set
|
|
StartDate
|
The date/time that the test execution was started
|
|
EndDate
|
The date/time that the test execution was completed
|
|
BuildId
|
The id of the build that the test was executed against
|
|
EstimatedDuration
|
The estimated duration of how long the test should take to execute (read-only)
This field is populated from the test case being executed
|
|
ActualDuration
|
The actual duration of how long the test should take to execute (read-only)
This field is calculated from the start/end dates provided during execution
|
|
TestConfigurationId
|
The id of the specific test configuration that was used
|
|
ReleaseVersionNumber
|
version number of the release this test run was run against.
|
|
ProjectId
|
The id of the project that the artifact belongs to
|
|
ProjectGuid
|
The guid of the project that the artifact belongs to
|
|
ArtifactTypeId
|
The type of artifact that we have
|
|
ConcurrencyDate
|
The datetime used to track optimistic concurrency to prevent edit conflicts
|
|
CustomProperties
|
The list of associated custom properties/fields for this artifact
|
|
IsAttachments
|
Does this artifact have any attachments?
|
|
Tags
|
The list of meta-tags that should be associated with the artifact
|
|
Guid
|
The unique identifier for the artifact
|
<RemoteTestRun xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<ArtifactTypeId>0</ArtifactTypeId>
<ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
<CustomProperties i:nil="true" />
<Guid i:nil="true" />
<IsAttachments>false</IsAttachments>
<ProjectGuid i:nil="true" />
<ProjectId>0</ProjectId>
<Tags i:nil="true" />
<ActualDuration i:nil="true" />
<BuildId i:nil="true" />
<EndDate i:nil="true" />
<EstimatedDuration i:nil="true" />
<ExecutionStatusId>0</ExecutionStatusId>
<Name i:nil="true" />
<ReleaseGuid i:nil="true" />
<ReleaseId i:nil="true" />
<ReleaseVersionNumber i:nil="true" />
<StartDate>0001-01-01T00:00:00</StartDate>
<TestCaseGuid i:nil="true" />
<TestCaseId>0</TestCaseId>
<TestConfigurationId i:nil="true" />
<TestRunId i:nil="true" />
<TestRunTypeId>0</TestRunTypeId>
<TestSetGuid i:nil="true" />
<TestSetId i:nil="true" />
<TestSetTestCaseId i:nil="true" />
<TesterGuid i:nil="true" />
<TesterId i:nil="true" />
</RemoteTestRun>
{"TestRunId":null,
"Name":null,
"TestCaseId":0,
"TestCaseGuid":null,
"TestRunTypeId":0,
"TesterId":null,
"TesterGuid":null,
"ExecutionStatusId":0,
"ReleaseId":null,
"ReleaseGuid":null,
"TestSetId":null,
"TestSetGuid":null,
"TestSetTestCaseId":null,
"StartDate":"0001-01-01T00:00:00",
"EndDate":null,
"BuildId":null,
"EstimatedDuration":null,
"ActualDuration":null,
"TestConfigurationId":null,
"ReleaseVersionNumber":null,
"ProjectId":0,
"ProjectGuid":null,
"ArtifactTypeId":0,
"ConcurrencyDate":"0001-01-01T00:00:00",
"CustomProperties":null,
"IsAttachments":false,
"Tags":null,
"Guid":null}