1. Implementing Project Financial Management and Grants Management
  2. Public Events for Unplanned Project Costs

Public Events for Unplanned Project Costs

If you want Oracle PPM Cloud to signal whenever unplanned resources are added to or updated on the financial project plan, then you must use the ERP Business Events REST Endpoints to enable the feature.

For example, if you want to notify the project manager of an unplanned project cost, then:

  1. You, as a project application administrator, must enable this feature. Oracle PPM Cloud signals when there are unplanned project costs on the financial project plan.
  2. Integration developers must create event handlers that subscribe to these signals and track unplanned project costs on the financial project plan.

Set the Enabled Indicator for the UnplannedProjectCost Business Event Code

Use the ERP Business Events REST API to set the enabled indicator to TRUE for the UnplannedProjectCost Business Event Code. Once you set it. you can subscribe to the event in Oracle Integration Cloud to perform additional actions when an unplanned project cost is identified.

The following examples show how to retrieve and update the business event record:

ERP Business Events REST API Definition - /fscmRestApi/resources/11.13.18.05/erpBusinessEvents/

  • Submit a GET request on the REST resource to retrieve the Business Event ID for the UnplannedProjectCost Business Event Code.
  • Submit a PATCH request on the REST resource to update the enabled indicator: /fscmRestApi/resources/11.13.18.05/erpBusinessEvents/{ErpBusinessEventId}

Example of contents of the request body in JSON format:

{

"EnabledFlag": true

}

Attributes in the Payload for Unplanned Project Costs Event

This table lists and describes the attributes in the payload.

Attribute Description

planVersionId

The unique identifier of the financial project plan version.

projectID

Unique identifier of the project.

projectNumber

The number of the project.

eventType

The type of public event.

planningResource

Resource used for financial planning in the financial project plan.

taskId

Identifier of the project task that's modified as part of the financial project plan changes.

taskNumber

Number of the task.

planningElementId

Identifier of the task assignment on the financial project plan.

resourceName

Name of the resource assigned to the task in the financial project plan.

rbsElementId

Identifier of the resource included in the financial project plan.

resourceClass

Resource class of the resource. For, example, LABOR for Labor resources and, EQUIPMENT for equipment type resources.

planningCurrency

The currency in which the resource is planned.

unitOfMeasure

The unit of measure for the resource.

totalActualQuantity

Total actual quantity of resource effort spent on a task or project, including labor and equipment.

totalTCActualRawCost

Total actual currency raw cost value of the resource assignment.

totalTCActualBrdndCost

Total actual currency burdened cost value of the resource assignment.

totalPCActualRawCost

Total actual raw cost amounts in project currency of the resource assignment.

totalPCActualBrdndCost

Total actual burdened cost amounts in project currency of the resource assignment.

totalPFCActualRawCost

Total actual raw cost amounts in project ledger currency of the resource assignment.

totalPFCActualBrdndCost

Total actual burdened cost amounts in project ledger currency of the resource assignment.

totalPlannedQuantity

Total planned quantity for the resource assignment.

totalTCRawCost

Total planned currency raw cost amounts of the resource assignment.

totalTCBrdndCost

Total planned burdened cost amounts of the resource assignment.

totalPCRawCost

Total planned currency raw cost value of the resource assignment.

totalPCBrdndCost

Total planned currency burdened cost value of the resource assignment.

totalPFCRawCost

Total planned project ledger currency raw cost value of the resource assignment.

totalPFCBrdndCost

Total planned project ledger currency burdened cost value of the resource assignment.
Let's look at a sample payload that's generated when unplanned resources are added to the financial project plan:
<?xml version="1.0" encoding="UTF-8"?>
 <inputVariable>
   <ns0:UnplannedProjectCostInfo xmlns:ns0="http://xmlns.vision.com/apps/projects/control/budgetsAndForecasts/unplannedProjectCost/UnplannedProjectCost" xmlns:xsi="http://www.vision.org/2001/XMLSchema-instance">
  <ns0:projectId>300100550701997</ns0:projectId>
  <ns0:projectNumber>TM001</ns0:projectNumber>
  <ns0:planVersionId>100100464971689</ns0:planVersionId>
  <ns0:eventType>UNPLANNED_RESOURCES</ns0:eventType>
  <planningResource>
    <taskId>100100464971678</taskId>
    <taskNumber>1.2</taskNumber>
    <planningElementId>100100465342518</planningElementId>
    <resourceName>Vision Operations</resourceName>
    <rbsElementId>100100464971659</rbsElementId>
    <resourceClass>FINANCIAL_ELEMENTS</resourceClass>
    <planningCurrency>USD</planningCurrency>
    <unitOfMeasure>DOLLARS</unitOfMeasure>
    <totalActualQuantity>0</totalActualQuantity>
    <totalTCActualRawCost>3000.00000000</totalTCActualRawCost>
    <totalTCActualBrdndCost>3000.00000000</totalTCActualBrdndCost>
    <totalPCActualRawCost>3000.00000000</totalPCActualRawCost>
    <totalPCActualBrdndCost>3000.00000000</totalPCActualBrdndCost>
    <totalPFCActualRawCost>3000.00000000</totalPFCActualRawCost>
    <totalPFCActualBrdndCost>3000.00000000</totalPFCActualBrdndCost>    
  </planningResource>
  <planningResource>
    <taskId>100100464971680</taskId>
    <taskNumber>1.1</taskNumber>
    <planningElementId>100100465342519</planningElementId>
    <resourceName>Vision Operations</resourceName>
    <rbsElementId>100100464971659</rbsElementId>
    <resourceClass>FINANCIAL_ELEMENTS</resourceClass>
    <planningCurrency>USD</planningCurrency>
    <unitOfMeasure>DOLLARS</unitOfMeasure>
    <totalActualQuantity>0</totalActualQuantity>
    <totalTCActualRawCost>3000.00000000</totalTCActualRawCost>
    <totalTCActualBrdndCost>3000.00000000</totalTCActualBrdndCost>
    <totalPCActualRawCost>3000.00000000</totalPCActualRawCost>
    <totalPCActualBrdndCost>3000.00000000</totalPCActualBrdndCost>
    <totalPFCActualRawCost>3000.00000000</totalPFCActualRawCost>
    <totalPFCActualBrdndCost>3000.00000000</totalPFCActualBrdndCost>    
  </planningResource>
</ns0:UnplannedProjectCostInfo>
</inputVariable>