Click here for a complete list of operations.
Requirement_Retrieve
Retrieves a list of requirements in the system that match the provided filter
Test
The test form is only available for requests from the local machine.SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /spira/services/v2_2/ImportExport.asmx HTTP/1.1 Host: api.inflectra.com Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://www.inflectra.com/SpiraTest/Services/v2.2/Requirement_Retrieve" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Requirement_Retrieve xmlns="http://www.inflectra.com/SpiraTest/Services/v2.2/"> <remoteFilters> <RemoteFilter> <PropertyName>string</PropertyName> <IntValue>int</IntValue> <StringValue>string</StringValue> <MultiValue> <Values xsi:nil="true" /> <IsNone>boolean</IsNone> </MultiValue> <DateRangeValue> <StartDate>dateTime</StartDate> <EndDate>dateTime</EndDate> <ConsiderTimes>boolean</ConsiderTimes> </DateRangeValue> </RemoteFilter> <RemoteFilter> <PropertyName>string</PropertyName> <IntValue>int</IntValue> <StringValue>string</StringValue> <MultiValue> <Values xsi:nil="true" /> <IsNone>boolean</IsNone> </MultiValue> <DateRangeValue> <StartDate>dateTime</StartDate> <EndDate>dateTime</EndDate> <ConsiderTimes>boolean</ConsiderTimes> </DateRangeValue> </RemoteFilter> </remoteFilters> <startingRow>int</startingRow> <numberOfRows>int</numberOfRows> </Requirement_Retrieve> </soap:Body> </soap:Envelope>
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Requirement_RetrieveResponse xmlns="http://www.inflectra.com/SpiraTest/Services/v2.2/"> <Requirement_RetrieveResult> <RemoteRequirement> <RequirementId>int</RequirementId> <ProjectId>int</ProjectId> <StatusId>int</StatusId> <AuthorId>int</AuthorId> <OwnerId>int</OwnerId> <ImportanceId>int</ImportanceId> <ReleaseId>int</ReleaseId> <Name>string</Name> <Description>string</Description> <CreationDate>dateTime</CreationDate> <LastUpdateDate>dateTime</LastUpdateDate> <Summary>boolean</Summary> <CoverageCountTotal>int</CoverageCountTotal> <CoverageCountPassed>int</CoverageCountPassed> <CoverageCountFailed>int</CoverageCountFailed> <CoverageCountCaution>int</CoverageCountCaution> <CoverageCountBlocked>int</CoverageCountBlocked> <PlannedEffort>int</PlannedEffort> <TaskEstimatedEffort>int</TaskEstimatedEffort> <TaskActualEffort>int</TaskActualEffort> <TaskCount>int</TaskCount> </RemoteRequirement> <RemoteRequirement> <RequirementId>int</RequirementId> <ProjectId>int</ProjectId> <StatusId>int</StatusId> <AuthorId>int</AuthorId> <OwnerId>int</OwnerId> <ImportanceId>int</ImportanceId> <ReleaseId>int</ReleaseId> <Name>string</Name> <Description>string</Description> <CreationDate>dateTime</CreationDate> <LastUpdateDate>dateTime</LastUpdateDate> <Summary>boolean</Summary> <CoverageCountTotal>int</CoverageCountTotal> <CoverageCountPassed>int</CoverageCountPassed> <CoverageCountFailed>int</CoverageCountFailed> <CoverageCountCaution>int</CoverageCountCaution> <CoverageCountBlocked>int</CoverageCountBlocked> <PlannedEffort>int</PlannedEffort> <TaskEstimatedEffort>int</TaskEstimatedEffort> <TaskActualEffort>int</TaskActualEffort> <TaskCount>int</TaskCount> </RemoteRequirement> </Requirement_RetrieveResult> </Requirement_RetrieveResponse> </soap:Body> </soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /spira/services/v2_2/ImportExport.asmx HTTP/1.1 Host: api.inflectra.com Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <Requirement_Retrieve xmlns="http://www.inflectra.com/SpiraTest/Services/v2.2/"> <remoteFilters> <RemoteFilter> <PropertyName>string</PropertyName> <IntValue>int</IntValue> <StringValue>string</StringValue> <MultiValue> <Values xsi:nil="true" /> <IsNone>boolean</IsNone> </MultiValue> <DateRangeValue> <StartDate>dateTime</StartDate> <EndDate>dateTime</EndDate> <ConsiderTimes>boolean</ConsiderTimes> </DateRangeValue> </RemoteFilter> <RemoteFilter> <PropertyName>string</PropertyName> <IntValue>int</IntValue> <StringValue>string</StringValue> <MultiValue> <Values xsi:nil="true" /> <IsNone>boolean</IsNone> </MultiValue> <DateRangeValue> <StartDate>dateTime</StartDate> <EndDate>dateTime</EndDate> <ConsiderTimes>boolean</ConsiderTimes> </DateRangeValue> </RemoteFilter> </remoteFilters> <startingRow>int</startingRow> <numberOfRows>int</numberOfRows> </Requirement_Retrieve> </soap12:Body> </soap12:Envelope>
HTTP/1.1 200 OK Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <Requirement_RetrieveResponse xmlns="http://www.inflectra.com/SpiraTest/Services/v2.2/"> <Requirement_RetrieveResult> <RemoteRequirement> <RequirementId>int</RequirementId> <ProjectId>int</ProjectId> <StatusId>int</StatusId> <AuthorId>int</AuthorId> <OwnerId>int</OwnerId> <ImportanceId>int</ImportanceId> <ReleaseId>int</ReleaseId> <Name>string</Name> <Description>string</Description> <CreationDate>dateTime</CreationDate> <LastUpdateDate>dateTime</LastUpdateDate> <Summary>boolean</Summary> <CoverageCountTotal>int</CoverageCountTotal> <CoverageCountPassed>int</CoverageCountPassed> <CoverageCountFailed>int</CoverageCountFailed> <CoverageCountCaution>int</CoverageCountCaution> <CoverageCountBlocked>int</CoverageCountBlocked> <PlannedEffort>int</PlannedEffort> <TaskEstimatedEffort>int</TaskEstimatedEffort> <TaskActualEffort>int</TaskActualEffort> <TaskCount>int</TaskCount> </RemoteRequirement> <RemoteRequirement> <RequirementId>int</RequirementId> <ProjectId>int</ProjectId> <StatusId>int</StatusId> <AuthorId>int</AuthorId> <OwnerId>int</OwnerId> <ImportanceId>int</ImportanceId> <ReleaseId>int</ReleaseId> <Name>string</Name> <Description>string</Description> <CreationDate>dateTime</CreationDate> <LastUpdateDate>dateTime</LastUpdateDate> <Summary>boolean</Summary> <CoverageCountTotal>int</CoverageCountTotal> <CoverageCountPassed>int</CoverageCountPassed> <CoverageCountFailed>int</CoverageCountFailed> <CoverageCountCaution>int</CoverageCountCaution> <CoverageCountBlocked>int</CoverageCountBlocked> <PlannedEffort>int</PlannedEffort> <TaskEstimatedEffort>int</TaskEstimatedEffort> <TaskActualEffort>int</TaskActualEffort> <TaskCount>int</TaskCount> </RemoteRequirement> </Requirement_RetrieveResult> </Requirement_RetrieveResponse> </soap12:Body> </soap12:Envelope>