19.6.8 About Task States and Transitions

Learn about the task lifecycle in the Oracle APEX approval component.

Tasks have their own lifecycle in the Oracle APEX approval component. A state is the current location of the task in the task lifecycle, while a transition refers to the movement of a task between different states. Transitions can occur as part of the normal task lifecycle, or they can occur due to an exception or a user interruption.

An errored state occurs when there is a non-recoverable error during the execution of the task, including:

• an underlying database error
• a code bug
• an invalid Task Definition
• an error during execution of the action specified for the Task Definition

A canceled state occurs when the initiator of the task explicitly cancels the task.

Task states and possible transitions are available in the following diagram, or in the Table 19-1 table.

Description of the illustration approvals_state_diagram.png

Table 19-1 Task States and Transitions

Task State	Lifecycle Stage	Category	Possible Transitions
Created	Initial	Normal	Unassigned, when there are multiple potential owners Assigned, when there is one potential owner Errored, when there is a non-recoverable error during execution
Unassigned	Intermediate	Normal	Assigned, when a user claims the task or delegates the task Errored, when there is a non-recoverable error during execution Canceled, when the initiator cancels the task
Assigned	Intermediate	Normal	Completed, when the owner approves or rejects the task Unassigned, when the owner releases the task Assigned, when a user delegates the task to another potential owner Errored, when there is a non-recoverable error during execution Canceled, when the initiator cancels the task
Completed	Final	Normal	None
Errored	Final	Exception	None
Canceled	Final	User Interrupted	None