updateStaffingProfileACL

Purpose

This operation updates the ACL of a staffing profile header in PPM Center.

Function

This operation enables external applications to update the ACL for a staffing profile identified by staffing profile ID. On success, the operation returns the ACL of the staffing profile.

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

• Have the edit staffing profile access grant or the edit all staffing profiles access grant

• In the staffing profile ACL list

Related information

The following data types:

• StaffingProfileACLType

• Entry

Input

This operation requires the following inputs:

• A StaffingProfileACLType object.

• The staffing profile ID

Return

The staffing profile ID

Java Interface

public long updateStaffingProfileACL(long id, com.mercury.itg.ws.rm.vo.StaffingProfileSecurableWSBean inputACL)

Parameters	Description
id	Staffing profile ID
inputACL	Wrapper of the StaffingProfileACLType object array

Java Examples

Example: updates a staffing profile's ACL

private Long updateStaffingProfileACL(String serviceURL, Long
id) throws Exception{

    StaffingProfileACLType spACL =
StaffingProfileACLType.Factory.newInstance();
    updateTestSPHeaderACL(spACL);
    StaffingProfileServiceStub stub = new
StaffingProfileServiceStub(ctx, serviceURL);
    UpdateStaffingProfileACLDocument inDoc =
UpdateStaffingProfileACLDocument.Factory.newInstance();
    UpdateStaffingProfileACLDocument.UpdateStaffingProfileACL
updateSPACL = inDoc.addNewUpdateStaffingProfileACL();
    updateSPACL.setInputACL(spACL);
    updateSPACL.setId(id);

    // Invoke web service
    UpdateStaffingProfileACLResponseDocument outDoc =
stub.updateStaffingProfileACL(inDoc);
    id =
outDoc.getUpdateStaffingProfileACLResponse().getStaffingProfile
Id();

    return id;
}

Errors and Exceptions

Possible root cause descriptions:

Message Code	Message	Cause(s)	Possible Corrective Action
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
rm.ws.exception.userName	User {0} does not exist	The user does not exist in PPM Center	Verify that the user exists in PPM Center
rm.ws.exception.canNotEditManager	You are not allowed to edit staffing profile manager {0}	You are trying to edit the access grants of a staffing profile manager	Remove the access grants of the staffing profile manager from the ACL list you input
rm.ws.exception.duplicateACLUsers	You added duplicate entries for User, please remove the duplicate user {0}	There are duplicate entries for the user in the inputted ACL list	Remove the duplicate entries for the user from the ACL list you input
rm.ws.exception.disabledResource	You are not allowed to add disabled user {0}	You are trying to add a disabled user	Remove the disabled user from the ACL list you input