Resource Management Web Service

This section details the methods and parameters for the Resource Management Web Service. The Resource Management Web Service is available at the URL http://<asppserver>/PPM/WebServices/ResourceManagement.asmx, where <appserver> is the application server. The WSDL for this set of methods can be retrieved at the URL http://<asppserver>/PPM/WebServices/ResourceManagement.asmx?wsdl.

The Resource Management Web Service enables you to create, modify, and delete resource allocations programmatically. An allocation contour of a single resource can be created against a single investment, whether an allocation already exists or not. If the allocation already exists, the contour is added to the allocation; if not, a new allocation is created. Any part of an existing allocation contour can also be modified. An existing contour can be modified by calling this web service; the values passed as parameters will override the values of an existing contour. Finally, contours can be deleted for allocations, resources and/or projects.

Several of the methods use a parameter called attribute[]. This is an array of key/value pairs where the key is the XML name of the attribute, and the value is the string representation of the value. The value string will need to be formatted in such a way that it can be converted into the correct type to match the attribute type.

Note: The Resource Management web service provides a WSDL. Although the WSDL indicates that some parameter arrays are optional, passing a null value into these arrays can in some instances generate runtime exceptions. It is recommended to pass an empty array, rather than a null, to the web service.

Date types should be in ISO 8061 format and will be assumed to be in UTC.

List attributes can be set by supplying the list item name for the value.

URL Link attributes are a composite made up of three parts: URL, DisplayName, and UseDisplayName. If an attribute key is specified by using its XML name, then the URL and DisplayName portions will be set to the value supplied. You may get/set any part of a URL Link by appending ",part=<part>" to the XML name of the attribute key. For example: