25.1.9.1.11.1 Choosing Event for an Action

Choose the task event that should trigger an email, push notification, or code action.

When creating an action, choose an event from the table below that determines when your action triggers. Then, decide whether you want to send an email, send a push notification, or execute code. If the action should trigger only in certain conditions, configure an appropriate server-side condition.

When using the Execute Code option, you can write in-line PL/SQL as part of the action definition. However, for easiest maintenance it's best to organize your code into a PL/SQL package procedure or function, then invoke that packaged program unit from the action's PL/SQL block.

Tip:

Call ADD_TO_HISTORY in the APEX_HUMAN_TASK package from your Execute Code action to add a custom message to the task history.

Table 25-3 Pre-Defined Task Events

Event	Happens When
Create	Initiator creates task
Claim	Potential owner claims task
Delegate	Business administrator delegates task
Update Comment	A user adds a new comment to task
Update Priority	Business administrator changes task priority
Update Parameter	Actual owner sets the value of updatable task parameter
Release	Actual owner releases task so another potential owner can claim it
Cancel	Business administrator cancels task
Request Information	Actual owner request more information, typically from task initiator
Submit Information	User submits requested additional information
Before Expire	Less than Before Expire Interval left before task expires
Expire	Task expired
Complete	Actual owner completes task