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:

• positionLineType

• effortContourType

• effortCellType

• assignmentType

• promisedAssignmentType

• skillProficiencyType

• userDataType

• resultObjectType

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