createStaffingProfileHeader

Purpose

This operation creates a staffing profile header in PPM Center.

Function

This operation enables external applications to create a staffing profile header in PPM Center. The operation returns the ID of the staffing profile created in PPM Center.

To perform this operation, the user must meet one of the following access grant requirements:

Have both the create staffing profile access grant and the edit staffing profile access grant
Have the edit all staffing profiles access grant

Apart from the access grant requirement, the user must also meet one of the following:

Be the manager of the staffing profile
In the staffing profile ACL list
Be the manager of the project associated with the staffing profile

Related Information

The following data types:

Input

A StaffingProfileHeaderType object

Return

The staffing profile ID will be returned if the staffing profile is created successfully.

Java Interface

public long createStaffingProfileHeader(com.mercury.itg.ws.rm.vo.StaffingProfileHeaderWSBean inputSP)

Parameters	Description
inputSP	Wrapper of the StaffingProfileHeaderType object

Java Examples

Example: creates a staffing profile header

private Long createStaffingProfileHeader(String serviceURL)
throws Exception{

     Long id = null;
     StaffingProfileHeaderType spHeaderType =
StaffingProfileHeaderType.Factory.newInstance();
    generateTestSPHeaderWSBean(spHeaderType);
    StaffingProfileServiceStub stub = new
StaffingProfileServiceStub(ctx, serviceURL);
    CreateStaffingProfileHeaderDocument inDoc =
CreateStaffingProfileHeaderDocument.Factory.newInstance();

CreateStaffingProfileHeaderDocument.CreateStaffingProfileHeader
createSPHeader = inDoc.addNewCreateStaffingProfileHeader();

createSPHeader.setStaffingProfileHeaderWSBean(spHeaderType);
    // Invoke web service
    CreateStaffingProfileHeaderResponseDocument outDoc =
stub.createStaffingProfileHeader(inDoc);
    id =
outDoc.getCreateStaffingProfileHeaderResponse().getStaffingProf
ileId();

    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.staffingProfileNoName	Staffing profile name can not be null	Staffing profile name is not specified	Specify a staffing profile
rm.ws.exception.startPeriodOutOfRange	Start period is out of range	The start period is out of the period range stored in the database	Make sure the start period exists in the PPM_FISCAL_PERIODS view
rm.ws.exception.finishPeriodOutOfRange	Finish period is out of range	The finish period is out of the period range stored in the database	Make sure the finish period exists in the PPM_FISCAL_PERIODS view
rm.ws.exception.finishBeforeStart	Finish date is before start date	The finish date is before the start date	Make sure the finish data is after the start date
rm.ws.exception.Region	Region is not found	The region is not found	Make sure the region exists before calling the Web service operation
rm.ws.exception.duplicateStaffingProfileName	The name of the staffing profile you are trying to create already exists. Please try a different name	The name of the staffing profile already exists.	Enter a different name
rm.ws.exception.missingStaffingProfileManager	Missing staffing profile manager	The user doesn't enter the manager of staffing profile	Specify the staffing profile manager
rm.ws.exception.staffingProfileManager	Staffing profile manager is not found	The staffing profile manager is not found	Check if the staffing profile manager exists
rm.ws.exception.resourcePool	Resource pool is not found	The resource pool is not fond	Check if the resource pool exists
rm.ws.exception.missingStaffingProfileType	Missing staffing profile type	The staffing profile type is not specified	Specify a staffing profile type
rm.ws.exception.notValidParentType	Not a valid staffing profile parent type	The staffing profile parent type is invalid	Make sure to enter a valid staffing profile parent type. The possible values are: Freestanding Organization Unit. Asset Proposal Project
rm.ws.exception.notValidParentIndentifier	Missing parent entity name or id	The name or ID of parent entity is not specified	Specify a name or ID for parent entity.
rm.ws.exception.staffingProfileWorkLoadCategory	Staffing profile work load category is not found	Staffing profile work load category is not found	Enter a valid staffing profile work load category
rm.ws.exception.missingWorkLoadCategory	Missing staffing profile work load category	The staffing profile is NOT linked to a project and its work load category is null	Specify a staffing profile work load category
rm.ws.exception.project	Project is not found	The project name or ID is not found	Enter a valid project name or ID
rm.ws.exception.staffingprofileNotValidProject	Not a valid linked project	The linked project is invalid	Enter a valid linked project
rm.ws.exception.staffingprofileStartNotEqualProjectStart	Staffing profile start period does not equal to linked project start period {0}	The staffing profile start period does not equal to its linked project start period	Make sure the staffing profile start period is equal to the linked project start period
rm.ws.exception.missingParentProposal	Linked proposal is not found	The linked proposal is not found	Enter a valid linked proposal
rm.ws.exception.staffingprofileNotValidProposal	Not a valid linked proposal	The linked proposal is invalid	Enter a valid linked proposal
rm.ws.exception.staffingprofileStartNotEqualProposalStart	Staffing profile start date does not equal to linked proposal start date	The staffing profile start date does not equal to the linked proposal start date	Make sure the staffing profile start date is equal to the linked proposal start date
rm.ws.exception.missingParentOrgUnit	Linked organization unit is not found	The linked organization unit is not found	Enter an existing organization unit
rm.ws.exception.staffingprofileNotValidOrgUnit	Not a valid linked organization unit	The linked organization unit is invalid	Enter a valid linked organization unit
rm.ws.exception.missingParentAsset	Linked asset is not found	The linked asset is not found	Enter an existing linked asset
rm.ws.exception.staffingprofileNotValidAsset	Not a valid linked asset	The linked asset is invalid	Enter a valid linked asset
rm.ws.exception.unknowType	Unknown staffing profile parent type	The staffing profile parent type is unknown	Make sure to enter a valid staffing profile parent type. The possible values are Freestanding Organization Unit. Asset Proposal Project
rm.ws.exception.missingStatus	Missing status	The staffing profile's status is not specified	Specify a staffing profile status
rm.ws.exception.notValidStatus	Not a valid status	The staffing profile status is invalid	Enter a valid staffing profile status
rm.ws.exception.invalidCreateBaselineStatus	Not allowed to create a baseline staffing profile	You try to create a baseline staffing profile	Specify a valid staffing profile status except the following: Baseline Approved
rm.ws.exception.invalidCreateApprovedStatus	Not allowed to create a approved staffing profile	You try to create a approved staffing profile	Specify a valid staffing profile status except the following: Baseline Approved
rm.ws.exception.notValidBudget	Not a valid budget to synchronize with staffing profile	The budget to synchronize with staffing profile is invalid	Specify a valid budget to synchronize with staffing profile
rm.ws.exception.notSpecifyBudget	You need specify a budget name when set the staffing profile synchronize with budget	The budget name is not specified when set the staffing profile synchronize with budget	Specify a budget name