Public Events for Financial Project Plan Changes
If you want Oracle PPM Cloud to signal whenever task assignments are created or modified in a financial project plan or on selective baseline of tasks in a financial project plan, then you must use the ERP Business Events REST Endpoints to enable the feature.
For example, if you want to generate revenue whenever financial project plan changes occur, then:
-
You, as a project application administrator, must enable this feature. Oracle PPM Cloud signals when financial project progress is published.
-
Integration developers must create event handlers that subscribe to these signals and generate revenue whenever financial project plan changes occur.
Attributes in the Payload for Financial Project Plan Changes Event
This table lists and describes the attributes in the payload.
|
Attribute |
Description |
|---|---|
|
planVersionId |
The unique identifier of the financial project plan version. |
|
projectId |
The identifier of the project. |
|
planStatusCode |
Code of the financial plan status. |
|
projectCurrency |
The currency in which the project is planned. |
|
projectNumber |
The number of the project. |
|
eventType |
The type of public event. |
|
taskId |
Identifier of the project task that's modified as part of the financial project plan changes. |
|
taskNumber |
Number of the task. |
|
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 |
Unit of measure for the planned amounts. For example, HOURS for a Labor resource assignment. |
|
planningStartDate |
Planned start date of the resource assignment. This element contains both old and new values. |
|
planningEndDate |
Planned end date of the resource assignment. This element contains both old and new values. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
totalQuantity |
Total planned quantity for the resource assignment. This element contains both old and new values. A new resource assignment to the task has the same value for oldValue and newValue attributes.. |
|
totalTcRawCost |
Total transaction currency raw cost value of the resource assignment. This element contains both old and new values. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
totalTcBrdndCost |
Total transaction currency burdened cost value of the resource assignment. This element contains both old and new values. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
tcRawCostRate |
Total transaction currency raw cost rate value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
tcBrdndCostRate |
Total transaction currency burdened cost rate value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
totalPcRawCost |
Total project currency raw cost value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
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. |
|
totalPfcRawCost |
Total project functional currency raw cost value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
|
totalPfcBrdndCost |
Total project functional currency burdened cost value of the resource assignment. A new resource assignment to the task has the same value for oldValue and newValue attributes. |
Let's look at a sample payload that's generated when a new resource is added to a task.
<eb:business-event xmlsn:eb="http://vision.com/fabric/businessEvent" xmlsn:ob="http://xmlns.vision.com/apps/projects/control/projectPlan/planChange/PlanChangeEvent">
<eb:name>ob:PlanChangeEvent<eb:name>
<eb:content>
<ns0:PlanChangeEventInfo>
<planVersionId>100100075548718100100075548718</planVersionId>
<projectId>300100152392374</projectId>
<projectNumber>sk_pub_event</projectNumber>
<eventType>PLAN_UPDATE</eventType>
<planningResource>
<taskId>100100075548714</taskId>
<taskNumber>1</taskNumber>
<resourceName>Labor</ResourceName>
<rbsElementId>100000011550441</rbsElementId>
<resourceClass>PEOPLE</resourceClass>
<planningCurrency>USD</planningCurrency>
<unitOfMeasure>HOURS</unitOfMeasure>
<planningStartDate>
<newValue>2018-09-04</newValue>
<oldValue>2018-09-04</oldValue>
</planningStartDate>
<planningEndDate>
<newValue>2018-12-02</newValue>
<oldValue>2018-12-02</oldValue>
</planningEndDate>
<totalQuantity>
<newValue>234.00000000</newValue>
<oldValue>234.00000000</oldValue>
</totalQuantity>
<totalTcRawCost>
<newValue>2340.00000000</newValue>
<oldValue>2340.00000000</oldValue>
</totalTcRawCost>
<totalTcBrdndCost>
<newValue>3346.20000000</newValue>
<oldValue>3346.20000000</oldValue>
</totalTcBrdndCost>
<tcRawCostRate>
<newValue>10.00000000</newValue>
<oldValue>10.00000000</oldValue>
</tcRawCostRate>
<tcBrdndCostRate>
<newValue>14.30000000</newValue>
<oldValue>14.30000000</oldValue>
</tcBrdndCostRate>
<totalPcRawCost>
<newValue>2340.00000000</newValue>
<oldValue>2340.00000000</oldValue>
</totalPcRawCost>
<totalPcBrdndCost>
<newValue>3346.20000001</newValue>
<oldValue>3346.20000001</oldValue>
</totalPcBrdndCost>
<totalPfcRawCost>
<newValue>2340.00000000</newValue>
<oldValue>2340.00000000</oldValue>
</totalPfcRawCost>
<totalPfcBrdndCost>
<newValue>3346.20000001</newValue>
<oldValue>3346.20000001</oldValue>
</totalPfcBrdndCost>
</planningResource>
<nso:PlanChangeEventInfo>
</eb:content>
</eb:business-event>