updatePositionLines

Purpose

This operation updates position lines of a staffing profile in PPM Center.

Function

This operation enables external applications to update position lines of staffing profile identified by staffing profile ID in PPM Center. The operation returns the resultObjectType object.

To perform this operation, the user must meet the following conditions:

  • Have the edit staffing profile access grant

  • In the Staffing profile ACL list

  • Be the project manager and resource manager

Related information

The following data types:

Input

An array of positionLineType object.

Return

An array of resultObjectType object

Java Interface

public OperationResultWSBean[]
updatePositionLines(PositionLineWSBean[] ids)

Parameters

Description

ids

Wrapper of the positionLineType object array

Java Examples

Example: updates position lines

private ResultObjectType[] updatePositionLines(String
serviceURL, PositionLineType[] ids) throws Exception{
    ResultObjectType[] resultType = null;
    StaffingProfileServiceStub stub = new
StaffingProfileServiceStub(ctx, serviceURL);
    UpdatePositionLinesDocument inDoc =
UpdatePositionLinesDocument.Factory.newInstance();
    UpdatePositionLinesDocument.UpdatePositionLines updatePL
= inDoc.addNewUpdatePositionLines();
    updatePL.setPositionLineArray(ids);
    // Invoke web service
    UpdatePositionLinesResponseDocument outDoc =
stub.updatePositionLines(inDoc);
    resultType =
outDoc.getUpdatePositionLinesResponse().getPositionIdArray()
;
    
    return resultType;
}

Errors and Exceptions

Possible root cause descriptions:

Message Code

Message

Cause(s)

Possible Corrective Action

exception.exceededThreshold

The web service call exceeds the threshold limit for processing. Please batch your updates

The number of position lines in one Web service call is limited to 50.

The web service call exceeds the threshold limit for processing

Reduce the number of position lines in the Web service call

exception.authorization

You do not have the privilege to take this action. Please consult your PPM Administrator

You do not have the required access grants for this operation

Verify that your account has the required access grants

exception.cannotLoadPosition

Position id {0} does not exist.

The position ID does not exist

Specify a different position ID

exception.invalidStaffingProfileId

Staffing profile id {0} is invalid for position id {1}

The position's staffing profile ID is not equal to the staffing profile ID in the positionLineType object

Make sure the position's s staffing profile id is equal to the staffing profile id in the positionLineType object

exception.cannotEditStaffingProfile

User cannot edit staffing profile {0}

You do not have the required access grants for this operation

Verify that your account has the required access grants

exception.cannotAssignResources

User cannot assign resources to position {0}

You are not the resource pool manager or resource manager

Verify that your account has the required access grants

exception.hasDuplicateAssignments

Position {0} has duplicate assignments in input XML

The position has duplicate assignments in the Web service call

Specify a different assignment for the position

exception.hasDuplicateSkills

Position {0} has duplicate skills in input XML

The position has duplicate skills in the Web service call

Specify a different skill for the position