ItemManagement Webservice Methods

This section describes the Web service API calls that are available in the ItemManagement API. The calls represent the Web service operations that are invoked from a client and performed on the Serena Agile Planner server. The calls receive one or more arguments from the client, perform an operation on the server, and return an XML response to the client when applicable.

The following table lists all supported calls in alphabetical order, followed by a brief description of each operation. Select a call to view detailed information including:

Description
A brief description of the call.
Parameters
A table describing the parameters for each call. Both simple and complex types are listed for each argument. For each complex type parameter, you can click the parameter name for a detailed description. For more information on these types, see Item Management Types.
Response
A brief description of the call's response. For each complex type response, you can click the response name for a detailed description.
Usage
Any notes, additional details, and concerns regarding the call are addressed here.
Faults
Possible error values are listed here.
XML
An example of the actual XML payload being sent is displayed here. The XML not only shows the call and its respective elements, you can also see detailed examples of each argument and how to format the expected data.

Calls Available

Call	Description
AssignWorkItem	This method moves a work item assigned to one backlog by assigning it to a new backlog.
CreateItem	This method creates an item, with a specified set of properties and attributes.
CreateWorkItem	This method creates a work item, with a specified set of properties and attributes.
DeleteItem	This method deletes a specified item.
GetWorkItem	This method gets attributes associated with a work item with a specified ID.
GetWorkItemChangeForTransaction	This method gets a list of changes made to a work item with a specified ID.
GetWorkItemList	This method gets a list of work items in a specified backlog.
MapAgileWorkItem	This method maps an item in Serena Agile Planner with another application, such as Serena Business Manager.
UpdateItem	This method updates the attributes associated with an item.
UpdateWorkItem	This method updates the attributes associated with a work item.
DeleteWorkItem	This method deletes a specified work item.
GetItem	This method gets the attributes for an item with a specified ID.
GetItems	This method gets a list of items matching a specified pattern.
GetAgileToSBMMappings	This method gets an XML document specifying the relationship between attributes in Serena Agile Planner and Serena Business Manager.