19.6.6 Creating Tasks from Task Definitions

Create tasks in an Oracle APEX application from existing task definitions.

Tasks are created by defining a Human Task - Create page process. When the page process is run, a new task is created based on the selected task definition. In order to be able to use this process, at least one Task Definition must exist as a shared component in the application.

To add a Human Task - Create page process to a specific page in the application:

1. View the page in Page Designer.
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
2. In either the Rendering or Processing tab, locate the node where the process will occur. Right-click and select Create Process.
3. Under Identification:
   1. Name - Specify the name of the process.
   2. Type - Select Human Task - Create.
4. Under Settings:
   1. Definition - Select the Task Definition.
   2. Subject - If specified here, this will override the subject in the task definition.
   3. Priority - If specified here, this will override the priority in the task definition.
   4. Initiator Item - The page item whose value can be used to specify who initiates the task. By default, the logged-in user running the page will be the initiator. This value can be specified to override the logged-in user, allowing a user to initiate a task on behalf of another user.
   5. Task ID Item - When specified, this saves the internal id of the task created when the page is run.
   6. Details Primary Key Item - When specified, this allows Oracle APEX to uniquely identify a record from the table a task is created from.
      For example, in the Sample Approvals app, entering P4_EMPNO allows the corresponding record in the EBA_DEMO_APPR_EMPtable to be updated when a Job Change Request is approved.
5. Configure the rest of the Process.
   For more information, see Creating Page Processes.
6. Set the Page Process Parameters.
   If the Task Definition has parameters specified, these appear in the Process Tree on the page. Parameters can be set to static values or page items. If a parameter is not required, it can be left as Null. If a parameter is marked Required in the Task Definition, it must be set in the process or there will be an error when saving the page.
7. Click Save.