See all operations
POST: projects/{project_id}/test-runs/search?starting_row={starting_row}&number_of_rows={number_of_rows}&sort_field={sort_field}&sort_direction={sort_direction}
Description
Retrieves a list of test runs in the system that match the provided filter/sort
Doesn't include the test run steps
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/search?starting_row={starting_row}&number_of_rows={number_of_rows}&sort_field={sort_field}&sort_direction={sort_direction}
Request Parameters
Name
|
Description
|
project_id
|
The id of the current project
|
starting_row
|
The first row to return (starting with 1)
|
number_of_rows
|
The number of rows to return
|
sort_field
|
The field we want to sort on
|
sort_direction
|
The direction of the sorting (asc|desc)
|
Request Body
<ArrayOfRemoteFilter xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<RemoteFilter>
<DateRangeValue i:nil="true" />
<IntValue i:nil="true" />
<MultiValue i:nil="true" />
<PropertyName i:nil="true" />
<StringValue i:nil="true" />
</RemoteFilter>
</ArrayOfRemoteFilter>
[{"PropertyName":null,
"IntValue":null,
"StringValue":null,
"MultiValue":null,
"DateRangeValue":null}]
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.
<ArrayOfRemoteTestRun xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<RemoteTestRun>
<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>
</ArrayOfRemoteTestRun>
[{"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}]