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