Public Events for Project Task Progress Status Changes
If you want Oracle PPM Cloud to signal whenever project task progress status changes, then you must use the ERP Business REST Endpoints to enable the feature. Keep in mind that creating or deleting tasks doesn't generate signals.
For example, if you want to initiate an activity in another application whenever task status changes to In Progress, then:
-
You, as a project application administrator, must enable this feature. Oracle PPM Cloud signals when project task progress status changes.
-
Integration developers must create event handlers that subscribe to these signals and initiate an activity whenever the project task progress status changes to In Progress.
Attributes in the Payload for Project Task Progress Status Changes Event
This table lists and describes the attributes in the payload.
Attribute |
Description |
---|---|
ProjElementId |
Unique identifier of the task. This value is the same as Task ID. |
ProjectId |
Unique identifier of the project. |
ElementType |
Indicates if the task is financially tracked or tracked for execution only. Valid values are EXECUTION and FINANCIAL. |
ProgressStatusCode |
The code for the status of work completed on the task. Valid values are NOT_STARTED, IN_PROGRESS, and COMPLETED. |
OldProgressStatusCode |
The previous code for the status of work completed on the task. Valid values are NOT_STARTED, IN_PROGRESS, and COMPLETE. |
BillableFlag |
Indicates that transactions charged to the task can be billed to customers. Valid values are Y, N, and null. The value is Y when the transactions are billable. The value is N or null when the transactions aren't billable. |
ChargeableFlag |
Indicates that something is eligible to be charged to a task. Valid values are Y, N, and null. The value is Y when the transactions are chargeable. The value is N when the transactions aren't chargeable. |
ActualStartDate |
The date that work commenced on a task as opposed to the planned start date for the task. |
ActualFinishDate |
The actual finish date for the task as opposed to a planned finish date for the task. |
StartDate |
The date that work or information tracking begins on a project. The format is DD-MM-YYYY. |
FinishDate |
The date that work or information tracking completes for a project. The format is DD-MM-YYYY. |
PercentComplete |
Indicates the percentage of work completed for the task. |
LastUpdatedBy |
Name of the person who last updated the task. |
Sample Payload for Project Task Progress Status Changes Event
Let's look at a sample payload that's generated when the status of a Project Task changes from Not Started to In Progress.
<content>
<ProjectTaskProgressStatusChangedInfo xmlns="http://vision/apps/projects/projectManagement/common/publicModel/entity/events/schema/ProjPlanLineEO">
<ProjElementId>
<oldValue value="300100111675917"/>
<newValue value="300100111675917"/>
</ProjElementId>
<ProjectId>
<oldValue value="300100082280694"/>
<newValue value="300100082280694"/>
</ProjectId>
<ElementType>
<oldValue value="EXECUTION"/>
<newValue value="EXECUTION"/>
</ElementType>
<ProgressStatusCode>
<oldValue value="NOT_STARTED"/>
<newValue value="IN_PROGRESS"/>
</ProgressStatusCode>
<OldProgressStatusCode>
<oldValue value="NOT_STARTED"/>
<newValue value="NOT_STARTED"/>
</OldProgressStatusCode>
<BillableFlag>
<oldValue value="N"/>
<newValue value="N"/>
</BillableFlag>
<ChargeableFlag>
<oldValue value="N"/>
<newValue value="N"/>
</ChargeableFlag>
<ActualStartDate>
<oldValue value="False"/>
<newValue value="01-01-2019"/>
</ActualStartDate>
<ActualFinishDate>
<oldValue value=""/>
<newValue value=""/>
</ActualFinishDate>
<StartDate>
<oldValue value="01-01-2019"/>
<newValue value="01-01-2019"/>
</StartDate>
<FinishDate>
<oldValue value="05-01-2019"/>
<newValue value="05-01-2019"/>
</FinishDate>
<PercentComplete>
<oldValue value="0"/>
<newValue value="25"/>
</PercentComplete>
<LastUpdatedBy>
<oldValue value="Connor.Horton"/>
<newValue value="Connor.Horton"/>
</LastUpdatedBy>
</ProjectTaskProgressStatusChangedInfo>
</content>