Sub Workflow Module¶

The Sub Workflow Module initiates new workflow instances (sub-workflows) from within the same process.

sub workflow module

The main and sub-workflows share the same XML data. Selecting this module type presents a configuration form with the following options:

Pool: Select the pool from which to launch the sub-workflow task.

Task: Once a pool is selected, this dropdown displays the available tasks within that pool. Choose the task to initiate.

Mode: Three operational modes are available:

Create child instances and continue: After creating the sub-workflow instances, the main workflow proceeds to the next task(s).
Synchronize child instances and continue: The main workflow synchronizes with the created sub-workflows. Upon revisiting the parent task in the main workflow, all related sub-workflows are updated based on the XML data. For example, if a sub-workflow is removed from the XML, it will be terminated when the main workflow returns to the parent task.
Wait for all child instances to complete: The main workflow pauses in a "Join state" until all sub-workflow instances complete. Only then does it proceed to the next task(s).

XPath: Specify the XML node name used to create sub-workflow instances.

Condition: (Optional) Apply a condition to filter the nodes selected via the XPath.

Row Id XPath: (Required for "Synchronize child instances and continue" mode) Specify the XPath to the ID node located within the node defined by the XPath field. This is crucial for proper sub-workflow updates.

Sync Data XPath: (Optional, used with Row Id XPath) If the Row Id XPath is insufficient to identify updated sub-workflow data within the XML, specify an additional node for synchronization purposes. For instance, if a sub-workflow's XML contains an AssignedTo node, changing this value will affect the sub-workflow (e.g., reassigning the task).