Public Events for Plan Status Changes

If you want Oracle PPM Cloud to signal whenever the status of a financial project plan, project budget, award budget, or project forecast changes, then you must use the ERP Business Events REST Endpoints to enable the feature.

For example, if you want to notify stakeholders to initiate subsequent tasks or automatically initiate other actions like a project forecast approval can initiate an event for invoice generation, then:

1. You, as a project application administrator, must enable this feature. Oracle PPM Cloud signals once the project manager or project administrator changes status on a project budget or project forecast.
2. Integration developers must create event handlers that subscribe to these signals and notify stakeholders to initiate subsequent tasks or automatically initiate other actions.

Note: This public event doesn't initiate on the deletion of the project budget, award budget, or project forecast version or on selective baseline of tasks in a financial project plan.

Attributes in the Payload for Plan Status Changes Event

This table lists and describes the attributes in the payload.

Attribute	Description
planVersionId	The unique identifier of the financial project plan, project budget, award budget, or project forecast version.
projectId	The identifier of the project.
priorPlanVersionId	The unique identifier of the financial plan version from which old values are derived. Rendered only when an old value for totalPcBrdndCost or totalPcRevenue attribute is present in the payload.
objectTypeCode	Code of the business object. Valid values are PROJECT_BUDGET, AWARD_BUDGET, or PROJECT_FORECAST.
eventType	The type of public event.
planStatusCode	Code of the financial plan status.
projectCurrency	The currency in which the project is planned.
totalPcBrdndCost	Total project currency burdened cost value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes.
totalPcRevenue	Total project currency revenue amounts.

Let's look at a sample payload that's generated when a budget version is created.

<PlanStatusChangedEventInfo xmlns="http://xmlns.vision.com/apps/projects/control/budgetsAndForecasts/planStatusChange/PlanStatusChangedEvent">
  <planVersionId>300100578142608</planVersionId>
  <projectId>300100578142593</projectId>
  <objectTypeCode>PROJECT_BUDGET</objectTypeCode>
  <projectCurrency>USD</projectCurrency>
  <eventType>PLAN_STATUS_UPDATE</eventType>
  <planStatusCode>
    <newValue>CURRENT_WORKING</newValue>
  </planStatusCode>
  <totalPcBrdndCost>
    <newValue>128988</newValue>
  </totalPcBrdndCost>
</PlanStatusChangedEventInfo>