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 |