readStaffingProfileACL

Purpose

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

Function

This operation enables external applications to read 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 view staffing profile access grant

• In the staffing profile ACL list

Related information

The following data types:

• StaffingProfileACLType

• Entry

Input

The staffing profile ID.

Return

A StaffingProfileACLType object.

Java Interface

Public com.mercury.itg.ws.rm.vo.StaffingProfileSecurableWSBean    
readStaffingProfileACL(long id)

Parameters	Description
id	Staffing profile ID

Java Examples

Example: reads a staffing profile's ACL

private StaffingProfileACLType readStaffingProfileACL(String
serviceURL, Long id) throws Exception{

    StaffingProfileACLType spACL = null;

    StaffingProfileServiceStub stub = new
StaffingProfileServiceStub(ctx, serviceURL);
    ReadStaffingProfileACLDocument inDoc =
ReadStaffingProfileACLDocument.Factory.newInstance();
    ReadStaffingProfileACLDocument.ReadStaffingProfileACL
readSPACL = inDoc.addNewReadStaffingProfileACL();
    readSPACL.setId(id);

    // Invoke web service
    ReadStaffingProfileACLResponseDocument outDoc =
stub.readStaffingProfileACL(inDoc);
    spACL =
outDoc.getReadStaffingProfileACLResponse().getReturn();

    return spACL;
}

Errors and Exceptions

Possible root cause descriptions:

Message Code	Message	Cause(s)	Possible Corrective Action
rm.ws.exception.StaffingProfileNotExist	Staffing profile does not exist	The staffing profile cannot be found by using the staffing profile id	Specify a valid staffing profile ID
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