See all operations
POST: projects/{project_id}/test-sets
Description
Creates a new test set in the system. You must send at least the "Name" (string), "Description" (string), "TestSetStatusId" (integer between 1 and 5), and "TestRunTypeId" (integer between 1 and 2) fields in the body
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/v6_0/RestService.svc/projects/{project_id}/test-sets
Request Parameters
Name
|
Description
|
project_id
|
The id of the current project
|
Request Body
Property
|
Description
|
TestSetId
|
The id of the test set
|
IndentLevel
|
(Not used in this version of the API)
|
TestSetStatusId
|
The id of the test set's status
|
CreatorId
|
The id of the user who created the test set
If no value is provided, the authenticated user is used
|
OwnerId
|
The id of the user who the test set is assigned-to
|
ReleaseId
|
The id of the release that the test set is assigned-to
|
AutomationHostId
|
The id of the automation host the test set is assigned-to
|
TestRunTypeId
|
The id of the type of test set (1 = Manual, 2 = Automated)
|
RecurrenceId
|
The id of the recurrence pattern the test set is scheduled for
|
Name
|
The name of the test set
|
Description
|
The detailed description of the test set
|
CreationDate
|
The date the test set was originally created
|
LastUpdateDate
|
The date the test set was last modified
|
PlannedDate
|
The date that the test set needs is planned to be executed on
|
ExecutionDate
|
The date that the test set was last executed by a tester
|
TestSetFolderId
|
The ID of the test set folder this test set belongs to (NULL = root)
|
IsAutoScheduled
|
Is this test set auto-scheduled when a build associated with the release runs
|
IsDynamic
|
Is this a dynamic test set
|
DynamicQuery
|
The underlying query if this is a dynamic test set
|
TestConfigurationSetId
|
The id of any test configuration set to be used with this test set
|
BuildExecuteTimeInterval
|
The interval between a build finishing and the test being execution (if auto-scheduled)
|
ProjectId
|
The id of the project that the artifact belongs to
|
ConcurrencyDate
|
The datetime used to track optimistic concurrency to prevent edit conflicts
|
CustomProperties
|
The list of associated custom properties/fields for this artifact
|
Tags
|
The list of meta-tags that should be associated with the artifact
|
<RemoteTestSet xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v6_0.DataObjects">
<ArtifactTypeId>0</ArtifactTypeId>
<ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
<CustomProperties i:nil="true" />
<IsAttachments>false</IsAttachments>
<ProjectId>0</ProjectId>
<Tags i:nil="true" />
<ActualDuration i:nil="true" />
<AutomationHostId i:nil="true" />
<BuildExecuteTimeInterval i:nil="true" />
<CountBlocked i:nil="true" />
<CountCaution i:nil="true" />
<CountFailed i:nil="true" />
<CountNotApplicable i:nil="true" />
<CountNotRun i:nil="true" />
<CountPassed i:nil="true" />
<CreationDate>0001-01-01T00:00:00</CreationDate>
<CreatorId i:nil="true" />
<CreatorName i:nil="true" />
<Description i:nil="true" />
<DynamicQuery i:nil="true" />
<EstimatedDuration i:nil="true" />
<ExecutionDate i:nil="true" />
<IndentLevel i:nil="true" />
<IsAutoScheduled>false</IsAutoScheduled>
<IsDynamic>false</IsDynamic>
<LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
<Name i:nil="true" />
<OwnerId i:nil="true" />
<OwnerName i:nil="true" />
<PlannedDate i:nil="true" />
<ProjectName i:nil="true" />
<RecurrenceId i:nil="true" />
<RecurrenceName i:nil="true" />
<ReleaseId i:nil="true" />
<ReleaseVersionNumber i:nil="true" />
<TestConfigurationSetId i:nil="true" />
<TestRunTypeId i:nil="true" />
<TestSetFolderId i:nil="true" />
<TestSetId i:nil="true" />
<TestSetStatusId>0</TestSetStatusId>
<TestSetStatusName i:nil="true" />
</RemoteTestSet>
{"TestSetId":null,
"IndentLevel":null,
"TestSetStatusId":0,
"CreatorId":null,
"OwnerId":null,
"ReleaseId":null,
"AutomationHostId":null,
"TestRunTypeId":null,
"RecurrenceId":null,
"Name":null,
"Description":null,
"CreationDate":"0001-01-01T00:00:00",
"LastUpdateDate":"0001-01-01T00:00:00",
"PlannedDate":null,
"ExecutionDate":null,
"CountPassed":null,
"CountFailed":null,
"CountCaution":null,
"CountBlocked":null,
"CountNotRun":null,
"CountNotApplicable":null,
"CreatorName":null,
"OwnerName":null,
"ProjectName":null,
"TestSetStatusName":null,
"ReleaseVersionNumber":null,
"RecurrenceName":null,
"TestSetFolderId":null,
"EstimatedDuration":null,
"ActualDuration":null,
"IsAutoScheduled":false,
"IsDynamic":false,
"DynamicQuery":null,
"TestConfigurationSetId":null,
"BuildExecuteTimeInterval":null,
"ProjectId":0,
"ArtifactTypeId":0,
"ConcurrencyDate":"0001-01-01T00:00:00",
"CustomProperties":null,
"IsAttachments":false,
"Tags":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.
Property
|
Description
|
TestSetId
|
The id of the test set
|
IndentLevel
|
(Not used in this version of the API)
|
TestSetStatusId
|
The id of the test set's status
|
CreatorId
|
The id of the user who created the test set
If no value is provided, the authenticated user is used
|
OwnerId
|
The id of the user who the test set is assigned-to
|
ReleaseId
|
The id of the release that the test set is assigned-to
|
AutomationHostId
|
The id of the automation host the test set is assigned-to
|
TestRunTypeId
|
The id of the type of test set (1 = Manual, 2 = Automated)
|
RecurrenceId
|
The id of the recurrence pattern the test set is scheduled for
|
Name
|
The name of the test set
|
Description
|
The detailed description of the test set
|
CreationDate
|
The date the test set was originally created
|
LastUpdateDate
|
The date the test set was last modified
|
PlannedDate
|
The date that the test set needs is planned to be executed on
|
ExecutionDate
|
The date that the test set was last executed by a tester
|
CountPassed
|
How many passed test cases are in the set
|
CountFailed
|
How many failed test cases are in the set
|
CountCaution
|
How many cautioned test cases are in the set
|
CountBlocked
|
How many blocked test cases are in the set
|
CountNotRun
|
How many test cases in the set have not been run
|
CountNotApplicable
|
How many test cases in the set are not applicable
|
CreatorName
|
The display name of the user that created the test set
|
OwnerName
|
The display name of the user that the test set is assigned-to
|
ProjectName
|
The display name of the project that the test set belongs to
|
TestSetStatusName
|
The display name of the status of the test set
|
ReleaseVersionNumber
|
The version number of the release the test set is scheduled for
|
RecurrenceName
|
The display name of the recurrence pattern
|
TestSetFolderId
|
The ID of the test set folder this test set belongs to (NULL = root)
|
EstimatedDuration
|
The total estimated duration for all the test cases in this set
|
ActualDuration
|
The total actual duration for all the test cases in this set
|
IsAutoScheduled
|
Is this test set auto-scheduled when a build associated with the release runs
|
IsDynamic
|
Is this a dynamic test set
|
DynamicQuery
|
The underlying query if this is a dynamic test set
|
TestConfigurationSetId
|
The id of any test configuration set to be used with this test set
|
BuildExecuteTimeInterval
|
The interval between a build finishing and the test being execution (if auto-scheduled)
|
ProjectId
|
The id 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
|
<RemoteTestSet xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v6_0.DataObjects">
<ArtifactTypeId>0</ArtifactTypeId>
<ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
<CustomProperties i:nil="true" />
<IsAttachments>false</IsAttachments>
<ProjectId>0</ProjectId>
<Tags i:nil="true" />
<ActualDuration i:nil="true" />
<AutomationHostId i:nil="true" />
<BuildExecuteTimeInterval i:nil="true" />
<CountBlocked i:nil="true" />
<CountCaution i:nil="true" />
<CountFailed i:nil="true" />
<CountNotApplicable i:nil="true" />
<CountNotRun i:nil="true" />
<CountPassed i:nil="true" />
<CreationDate>0001-01-01T00:00:00</CreationDate>
<CreatorId i:nil="true" />
<CreatorName i:nil="true" />
<Description i:nil="true" />
<DynamicQuery i:nil="true" />
<EstimatedDuration i:nil="true" />
<ExecutionDate i:nil="true" />
<IndentLevel i:nil="true" />
<IsAutoScheduled>false</IsAutoScheduled>
<IsDynamic>false</IsDynamic>
<LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
<Name i:nil="true" />
<OwnerId i:nil="true" />
<OwnerName i:nil="true" />
<PlannedDate i:nil="true" />
<ProjectName i:nil="true" />
<RecurrenceId i:nil="true" />
<RecurrenceName i:nil="true" />
<ReleaseId i:nil="true" />
<ReleaseVersionNumber i:nil="true" />
<TestConfigurationSetId i:nil="true" />
<TestRunTypeId i:nil="true" />
<TestSetFolderId i:nil="true" />
<TestSetId i:nil="true" />
<TestSetStatusId>0</TestSetStatusId>
<TestSetStatusName i:nil="true" />
</RemoteTestSet>
{"TestSetId":null,
"IndentLevel":null,
"TestSetStatusId":0,
"CreatorId":null,
"OwnerId":null,
"ReleaseId":null,
"AutomationHostId":null,
"TestRunTypeId":null,
"RecurrenceId":null,
"Name":null,
"Description":null,
"CreationDate":"0001-01-01T00:00:00",
"LastUpdateDate":"0001-01-01T00:00:00",
"PlannedDate":null,
"ExecutionDate":null,
"CountPassed":null,
"CountFailed":null,
"CountCaution":null,
"CountBlocked":null,
"CountNotRun":null,
"CountNotApplicable":null,
"CreatorName":null,
"OwnerName":null,
"ProjectName":null,
"TestSetStatusName":null,
"ReleaseVersionNumber":null,
"RecurrenceName":null,
"TestSetFolderId":null,
"EstimatedDuration":null,
"ActualDuration":null,
"IsAutoScheduled":false,
"IsDynamic":false,
"DynamicQuery":null,
"TestConfigurationSetId":null,
"BuildExecuteTimeInterval":null,
"ProjectId":0,
"ArtifactTypeId":0,
"ConcurrencyDate":"0001-01-01T00:00:00",
"CustomProperties":null,
"IsAttachments":false,
"Tags":null}