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:
|
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
|
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:
|
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:
|
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 |