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