GetItem

Description

This method gets the attributes for an item with a specified ID.

Arguments

Parameter	Datatype	Description
token	string	A security token authorizing access to the web service.
id	int	The ID of the top level project hierarchy from which to get items. The top level project has an ID value of 1.
attributeKeys	string[]	A list of XML system names for the desired attributes to be returned.

XML request

The following request specifies items of type Agile_Release under the root, and requests the start date attribute of the releases to be returned.

      <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
      xmlns:agil="http://serena.com/Agile">
      <soapenv:Header/>
      <soapenv:Body>
      <agil:GetItems>
      <agil:token>authtoken</agil:token>
      <agil:rootId>1</agil:rootId>
      <agil:typeName>Agile_Release</agil:typeName>
      <agil:attributeKeys>
      <agil:string>Agile_IntervalStartDate</agil:string>
      </agil:attributeKeys>
      <agil:filter>
      <agil:FilterRule>
      <agil:key></agil:key>
      <agil:op></agil:op>
      <agil:value></agil:value>
      </agil:FilterRule>
      </agil:filter>
      </agil:GetItems>
      </soapenv:Body>
      </soapenv:Envelope>

XML response

    <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
    <GetItemsResponse xmlns="http://serena.com/Agile">
    <GetItemsResult>
    <Item>
    <id>387</id>
    <parentId>371</parentId>
    <name>The Release Name</name>
    <itemType>Agile_Release</itemType>
    <attributes>
    <ItemAttribute>
    <key>Agile_IntervalStartDate</key>
    <value>2010-02-25T08:00:00</value>
    </ItemAttribute>
    </attributes>
    </Item>
    </GetItemsResult>
    </GetItemsResponse>
    </soap:Body>
    </soap:Envelope>