Share this page

# updateStaffingProfileHeader

## Purpose

This operation updates a staffing profile header in PPM Center.

## Function

This operation updates 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 the following access grant requirement:

- Have the edit all staffing profiles access grant or the edit staffing profile 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:

- StaffingProfileHeaderType

- ParentEntityType

- ParentType

- ParentIdentifier

## Input

A StaffingProfileHeaderType object

## Return

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

## Java Interface

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

Parameters | Description
--- | ---
inputSP | Wrapper of the StaffingProfileHeaderType object

## Java Examples

Example: updates a staffing profile header

    private Long updateStaffingProfileHeader(String serviceURL,
    Long id) throws Exception{

        StaffingProfileHeaderType spHeaderType =
    StaffingProfileHeaderType.Factory.newInstance();
        updateTestSPHeaderWSBean(spHeaderType);
        StaffingProfileServiceStub stub = new
    StaffingProfileServiceStub(ctx, serviceURL);
        UpdateStaffingProfileHeaderDocument inDoc =
    UpdateStaffingProfileHeaderDocument.Factory.newInstance();

    UpdateStaffingProfileHeaderDocument.UpdateStaffingProfileHeader
    updateSPHeader = inDoc.addNewUpdateStaffingProfileHeader();

    updateSPHeader.setStaffingProfileHeaderWSBean(spHeaderType);

         // Invoke web service
         UpdateStaffingProfileHeaderResponseDocument outDoc =
    stub.updateStaffingProfileHeader(inDoc);
        id =
    outDoc.getUpdateStaffingProfileHeaderResponse().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

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: