Join Wintertainment 2021 to share your stories, have fun, earn community badges, and more!

TraceabilityLinks_LoadByCriteria Operation

Applies to QAComplete 12.94 SaaS, last modified on December 06, 2021

Use the TraceabilityLinks_LoadByCriteria operation to:

  • Get TracebilityLink objects that match a specific condition. For example, created on a specific day.

  • Get all TracebilityLink objects in QAComplete projects (if no condition is specified).

The operation can get links from one or several projects. To specify a project to get links from, use the ProjId value in the AuthenticationData object in the request body. To get links from several projects, use the ProjIds value in the AuthenticationData object to specify the list of project IDs.

LoadByCriteria returns results in pages (subsets of data) rather than all at once. Pagination is controlled by the PageSize and PageNumber parameters. For information about working with paginated results, see LoadByCriteria Operations.

You can use the Sorting parameter to sort the TraceabilityLink objects before returning them from QAComplete.

Requirements

The authenticating user must belong to a security group that has access to the Manage and view traceability and Read, Add, and Update privileges for linked items.

Parameters

The operation uses the following parameters:

AuthenticationData  :  AuthenticationData, required

An AuthenticationData object with the login information and the ID of the project (or the list of project IDs) from which you want to get linked items.

Condition  :  string

An XML-formatted string that describes the links you want to get. For the syntax and examples, see Condition Syntax.

If you create SOAP requests manually, place the condition string inside CDATA.

To get all requirements, use an empty string or a null value.

Sorting  :  string

The order to sort the results before returning them from the web service. For example, by requirement ID or last updated date. The format is:

where property names are those of the TraceabilityLink object. If you omit ASC or DESC after a property name, requirements are sorted in ascending order.

Example values:

To keep the default sort order, use an empty string or a null value.

PageSize  :  integer, required

Limits the number of traceability links to return in one page. Possible values: 1..200.

The last page may have less items than PageSize. This means the end of the result set.

PageNumber  :  integer, required

A number starting from 1 that specifies the data page to return in the response. To get all pages, send several requests with increasing PageNumber values. For example, if PageSize is 100, PageNumber of 1 will return links 1..100, PageNumber of 2 – links 101..200 and so on.

If PageNumber exceeds the range, an empty array is returned. If PageNumber is the last page, this page may have less items than PageSize.

Result

An array of TraceabilityLink objects that contain the link information.

Example

Sample Code
Sample Request XML
Sample Response XML

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 1161 {The server returns an appropriate value here}
 

<?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>
    <TraceabilityLink_LoadByCriteriaResponse xmlns="http://www.pragmaticsw.com/">
      <TraceabilityLink_LoadByCriteriaResult>
        <TraceabilityLink>
          <LinkId>34</LinkId>
          <ProjId>10372</ProjId>
          <EntityCode>Bugs</EntityCode>
          <FKId>33</FKId>
          <LinkedEntityCode>Release</LinkedEntityCode>
          <LinkedFKId>23</LinkedFKId>
          <Status>In Progress</Status>
          <Title>FamilyAlbum: Release 1.0/Alfa/0.4.86</Title>
          <LinkType>Found in build</LinkType>
          <DateUpdated>2014-07-15T23:11:12.237</DateUpdated>
        </TraceabilityLink>
        <TraceabilityLink>
          <LinkId>56</LinkId>
          <ProjId>10372</ProjId>
          <EntityCode>Tests</EntityCode>
          <FKId>42</FKId>
          <LinkedEntityCode>Release</LinkedEntityCode>
          <LinkedFKId>23</LinkedFKId>
          <Status>In Progress</Status>
          <Title>FamilyAlbum: Release 1.0/Alfa/0.4.86</Title>
          <LinkType>Functional tests</LinkType>
          <DateUpdated>2014-07-23T16:05:20.249</DateUpdated>
        </TraceabilityLink>
      </TraceabilityLink_LoadByCriteriaResult>
    </TraceabilityLink_LoadByCriteriaResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 1171 {The server returns an appropriate value here}
 

<?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>
    <TraceabilityLink_LoadByCriteriaResponse xmlns="http://www.pragmaticsw.com/">
      <TraceabilityLink_LoadByCriteriaResult>
        <TraceabilityLink>
          <LinkId>34</LinkId>
          <ProjId>10372</ProjId>
          <EntityCode>Bugs</EntityCode>
          <FKId>33</FKId>
          <LinkedEntityCode>Release</LinkedEntityCode>
          <LinkedFKId>23</LinkedFKId>
          <Status>In Progress</Status>
          <Title>FamilyAlbum: Release 1.0/Alfa/0.4.86</Title>
          <LinkType>Found in build</LinkType>
          <DateUpdated>2014-07-15T23:11:12.237</DateUpdated>
        </TraceabilityLink>
        <TraceabilityLink>
          <LinkId>56</LinkId>
          <ProjId>10372</ProjId>
          <EntityCode>Tests</EntityCode>
          <FKId>42</FKId>
          <LinkedEntityCode>Release</LinkedEntityCode>
          <LinkedFKId>23</LinkedFKId>
          <Status>In Progress</Status>
          <Title>FamilyAlbum: Release 1.0/Alfa/0.4.86</Title>
          <LinkType>Functional tests</LinkType>
          <DateUpdated>2014-07-23T16:05:20.249</DateUpdated>
        </TraceabilityLink>
      </TraceabilityLink_LoadByCriteriaResult>
    </TraceabilityLink_LoadByCriteriaResponse>
  </soap12:Body>
</soap12:Envelope>

See Also

TraceabilityLinks_Add
TraceabilityLinks_Delete
TraceabilityLinks_Load
Traceability Operations
SOAP API Reference

Highlight search results