How to use an Inclusive Gateway
1. What You Will Learn
After finishing this tutorial you will be able to use Inclusive Gateways correctly and to properly incorporate them
into your PAK Workflows in the Editor. You can download the Editor
here.
|
An Inclusive Gateway is also a division point of the business process. Unlike the exclusive gateway, an Inclusive Gateway may trigger the execution of more than one out-going flows. |
2. Prerequisites
To complete this guide you need:
-
Roughly 10 minutes
-
Installed PAK Editor
-
Installed PAK Workflow Executor
|
This HowTo does not contain a detailed introduction to the editor. Click here to learn everything about the PAK Workflow Editor. |
3. Build the workflow
First you have to create a new BPMN
| In an Inclusive Gateway, the process flow is split into one or more flows depending on the conditions. |
-
Search for the Command „ChooseItem“ under the „Commands“ tab on the left side.
Figure 3. Editor ChooseItem Command -
Add the Command to your workflow and configure its properties as shown in the picture.
Inputs:
-
descriptiveText: „Choose your Task“
-
issueKeyList: „1,2,3,1and2,1and3,2and3,1and2and3“
Figure 4. Editor ChooseItem Command 2-
Then add the Inclusive Gateway from the Controls to your workflow.
Figure 5. Editor Inclusive Gateway -
Create three SimpleOK tasks, connect the Inclusive Gateway with edges to the three
tasks and configure the properties of the tasks as shown in the picture.
Figure 6. Editor SimpleOK Command 2 -
Add the conditions to the paths. (Learn more about pathing conditions here)
Figure 7. Editor Inclusive Conditions-
for the first path:
selectedItem == "1" || selectedItem == "1and2" ||selectedItem == "1and3" || selectedItem == "1and2and3"
-
for the second path:
selectedItem == "2" || selectedItem == "1and2" ||selectedItem == "2and3" || selectedItem == "7and8and9"
-
for the third path:
selectedItem == "3 || selectedItem == "1and3" ||selectedItem == "2and3" || selectedItem == "7and8and9"
-
-
Then merge the paths through another Inclusive Gateway and add an end event to the BPMN
Figure 8. Editor Inclusive Gateway Example
-
|
In this example all paths are filled with a condition, but the gateway also allow us to let exact one path empty. The empty path will be considered to be the default path when no other conditional path matches. That is very useful for cases where none of the conditionals may match as they could be logically non exclusive eg. one being number == 1 and the other number == 2. |
4. Test / Run the workflow
|
You can download the PAK Workflow Executor here. |
|
You can download the Example Workflow here. |
-
Save your BPMN via the menu File → Save to your destination folder.
-
Open the Workflow inside the Workflow Executor Application via the „Open new Workflow“ Button.
-
Start the workflow with the Play Button on the right side.
