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.
- 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.
- Integration developers must create event handlers that subscribe to these signals and notify stakeholders to initiate subsequent tasks or automatically initiate other actions.
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>