This operation creates one or more new resource pool objects in PPM Center.

Function and Parameters

This operation creates one or more (maximum 1,000) new resource pool objects, identified by resource pool ID in PPM Center.

The user performing this operation must have the following access grants:

  • Create Resource Pools

  • Edit Resource Pool or Edit All Resource Pools

Required Fields:

  • Name

  • Region

Optional Fields:

  • ID

  • Description

  • Parent

  • Org unit

  • Manager

  • Note

  • Child

  • Access Control

If these optional fields are not set, no defaults are used.


This operation has the following limitations:

  • User data cannot be created.

  • This operation assumes basic data exists in the database. The following data must exist in any production PPM Center instance.

    • Resources

    • Users

    • Parent resource pool

    • Org Unit

    • Region

    All values provided in the parameters must comply with what is expected in PPM Center. The possible values are provided above when each parameter is described.

  • If a data problem occurs with any data provided for the resource pools, the entire data set is rejected. No resource pools are created.

Related Information

updateResourcePools - update fields of an existing resource pool.


An array of ResourcePools.


An array of ResourcePoolReferences.

Java Interface

CreateResourcePoolsResponseDocument createResourcePools( CreateResourcePoolsDocument in)




Wrapper of the resource pool array object (WSResourcePoolBean[]).

See the following example for the construction.

The bean includes the following fields:

  • Long id;

  • String name;

  • String description;

  • ResourcePoolRefernce parent;

  • RegionReference region;

  • OrgUnitReference orgUnit;

  • List manager;

  • List Notes;

  • ResourcePoolRefernce[] child;

  • ResourcePoolAccessControlBean[] aces;


Wrapper for the resource pool ref array (ResourcePoolReference[]).

See the following example for retrieving the bean and its fields.

Java Examples

Example: create a new resource pool.

* Test creating a resource pool with values for all fields, reading it back out and searching for it.
public long testCreateResourcePool() throws Exception {
       // create the resource pool object
ResourcePool resourcePool1 =
ResourcePool resourcePool2 =
      // call the service
ResourcePoolReference[] resourcePoolReference =
createResourcePools(new ResourcePool[] { resourcePool1,
resourcePool2 });
        // return first pool ID
return resourcePoolReference[0].getId();
     * This is a wrapper method around the createResourcePools
web service. It handles the details of creating
    * the document, invoking the web service and unwrapping the
     * @param resourcePools Zero or more resource pools to
create in PPM.
     * @return A resource pool reference for each object that
was successfully created.
     * @throws Exception
    ResourcePoolReference[] createResourcePools(ResourcePool[]
resourcePools) throws Exception {
        ResourceServiceStub service = new
ResourceServiceStub(ctx, WSURL);
    CreateResourcePoolsDocument createResourcePoolsDoc =
    CreateResourcePoolsResponseDocument responseDocCreate =
CreateResourcePoolsResponse responseCreate =
debugPrint(responseCreate, "create response");
return responseCreate.getResourcePoolRefArray();
    public static ResourcePool
createTestResourcePoolObject(String name) {
        ResourcePool resourcePool =
        // resource pool name
        // description
        resourcePool.setDescription("A resource pool created
programmatically through web services ");
        // region
        // pool managers
        // set parent pool
        resourcePool.addNewParent().setName("parent pool
        // add children pool
        resourcePool.addNewChild().setName("child pool name");
        // org unit
        resourcePool.addNewOrgUnit().setName(" org unit name");
        // add notes
        Note note = resourcePool.addNewNote();
        note.setContent("Note content");
        // set access control list
        for (int i = 0; i < usersInACL.length; i++) {
            ResourcePoolAccessControlBean acb =
           ResourceReference aceUser = acb.addNewUser();
        return resourcePool;

Errors and Exceptions

When an error occurs on this operation, you will receive a description of the root cause in the log or in the response message.

The server log file content is similar to the following:

Exception in thread "main" org.apache.axis2.AxisFault:
<exception:exceptionDetails xmlns:exception="http://">
<exception:detail>[root cause description] </exception:detail>

Possible root cause descriptions:


Message Code



Possible Corrective Action

The maximum number of resource pools to process in a single web service transaction may not exceed 1000.

The number of resource pools exceeds 1,000.

Break up the list of resource pools into smaller chunks and process over multiple transactions.

A resource pool with the name "{0}" already exists. Enter a different name.

A resource pool with the name already exists.

Enter a different name.

Cannot create resource pool as it would introduce a cyclical parent-child relationship between the resource pools {0} and {1}.

Two resource pools have each other as parents.

Make sure that the resource pools do not have each other as parents.

Resource pool region is required. Specify a region for each resource pool.

The region for a resource pool is not specified.

Specify the region for the resource pool.

Resource pool name cannot be blank. Provide a name for each resource pool.

The resource pool name is not set for a pool.

Set the resource pool name.

Description cannot be longer than 650 characters.

Description of a resource pool is more than 650 characters.

Reduce length of description.

Name cannot be longer than 260 characters.

Name of a resource pool is great than 260.

Reduce length of name.


Entity Validation errors if region, manager, resource pool does not exist.

Resource pool region, manager, or parent resource pool does not exist.

Ensure that Resource pool region, manager, and parent resource pool exist for all pools to be created before this web service call.