Embedded Sub-Processes

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Process wizard > Model Process > Modeling for execution > Sub-Processes >

Embedded Sub-Processes


Embedded Sub-Processes are compound activities that contain other activities, gateways, events, etc., and are fully dependent on the parent process; they do not exist as a separate process. They share the same information or data with the parent process, and can have a Transactional definition.



Bare in mind that when Bizagi enters an embedded sub-process, it does not create a new case, but its activities are associated with the container process.

This means that you are not able to analyze the embedded process separately, because there are no distinct cases.


To demonstrate how to transform a task to an Embedded Sub-Process we will use the following diagram:




The diagram refers to a Purchase Request Process. We are going to transform the Quotations task to an Embedded Sub-Process.


1. In the First step of the Bizagi Process Wizard, click Edit Process.




2. Right-click the Task that you wish to convert to an embedded Sub-Process, in this case the Quotations task, and select the option Transform to Sub-Process.




3. The Sub-Process wizard will launch in a new window showing the Sub-Process types. Select the Embedded option.




4. A properties window will display the following:






Transactional Check-box

Sets the Sub-Process as Transactional.

Processes (drop-down list)

Displays the existing processes list and sets the selected one as the Sub-Process.

Add button

Allows to create a new process.

Process version (drop-down list)

Displays the selected process version. If a new process is created, its version will be 1.0.


Displays a preview of the process selected. If a new process is selected, the Diagram box will be empty.

Status Bar

Presents the Sub-Process status configuration horizontally.


To define the Sub-Process, you can either select an existing Process or create a new one:


To set an existing Process:

Click the drop down list and select the desired one. Select the Process version. Click the Finalize button.




To create a new Process:

1. Click the Add button on the properties window.




2. Type the desired name and click the create button.




3. Select the Process from the drop down list and click the Finalize button.




4. Once the Sub-Process is created, you can immediately edit it.

Right-click the newly created Sub-Process (Quotations) and select the Edit Sub-Process option.




5. The window will display the Sub-Process diagram. In this instance the Sub-Process is newly created, so a Pool will be ready for you to start modeling.




6. When finished, click Close. Then select Yes in the confirmation window to save the model.




Your Quotations embedded Sub-Process has been successfully created.


Embedded Sub-Processes should have the same Process Entity as the parent process. When a case enters an embedded Sub-Process the information of the parent process will be available navigating the same Xpaths.


Keep in mind that you should go to the Process Wizard to configure its data model and its forms.



The access type of the embedded Sub-Process must be defined as Module in the process' properties.

If not defined as Module, the process will not be listed in the Sub-Process wizard as Embedded even though it has been created.

In the Expert View, right-click the process' version (1.0, 1.1) and select Properties. Make sure Module is selected in the Access Type option.





These Sub-Processes should always have the same Process Entity as the parent process in order to work correctly. When a case enters an embedded Sub-Process the information of the parent process will be available in the exact same XPath. The data navigation will not change form one process to the other.

All events and tasks in these Sub-Processes must be finished in order for the Sub-Process to finish. If an event or Task is pending to be executed the Sub-Process will not finish. Even if they reach a Terminate End Event.