19.6.3.1 About Task Definitions

The approvals component allows Oracle APEX to create tasks for user approval.

Task Definitions contain information about tasks that require human action, including notification settings. Task definitions exist on the application level in the Shared Components section, and are made up of participants, parameters, and actions:

• Task Definition Participants - Users that have permission to act on individual tasks. Participants can be:
  • Potential Owners - Users that can claim unassigned tasks. Tasks can have multiple potential owners.
  • Actual Owners - Users that can make changes to assigned tasks, including approving or rejecting the task.
  • Task Initiators - Users that can cancel tasks they have initiated.
  • Business Administrators - Users that have administration rights to all tasks created by a specific task definition.
• Task Definition Parameters - Attributes that can be visible on the task details page. These constitute the payload of the task.
• Task Definition Actions - Possible events that can happen when specific criteria are met. Available actions are:
  • Claim
  • Complete
  • Delegate
  • Update Comment
  • Update Priority
  • Release
  • Cancel
  • Create

Task Definitions can be updated at any time. However, updates made to the Task Definition do not affect existing tasks. Updates are only applicable for task instances created after the Task Definition is saved.