powered by ASAP

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.
InclusiveGateway
Figure 1. Inclusive Gateway

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

Editor NewBPMN
Figure 2. Editor New BPMN
In an Inclusive Gateway, the process flow is split into one or more flows depending on the conditions.

  1. Search for the Command „ChooseItem“ under the „Commands“ tab on the left side.

    Editor ChooseItem Command
    Figure 3. Editor ChooseItem Command

  2. 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“

    Editor ChooseItem Command 2
    Figure 4. Editor ChooseItem Command 2

    1. Then add the Inclusive Gateway from the Controls to your workflow.

      Editor Inclusive Gateway
      Figure 5. Editor Inclusive Gateway

    2. 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.

      Editor SimpleOK Command 2
      Figure 6. Editor SimpleOK Command 2

    3. Add the conditions to the paths.

      Editor Inclusive Conditions
      Figure 7. Editor Inclusive Conditions

      1. for the first path:

        selectedItem == "1" || selectedItem == "1and2" ||selectedItem == "1and3" || selectedItem == "1and2and3"

      2. for the second path:

        selectedItem == "2" || selectedItem == "1and2" ||selectedItem == "2and3" || selectedItem == "7and8and9"

      3. for the third path:

        selectedItem == "3 || selectedItem == "1and3" ||selectedItem == "2and3" || selectedItem == "7and8and9"

    4. Then merge the paths through another Inclusive Gateway and add an end event to the BPMN

      Editor Inclusive Gateway Example
      Figure 8. Editor Inclusive Gateway Example

4. Test / Run the workflow

You can download the PAK Workflow Executor here.
You can download the Example Workflow here.

  1. Save your BPMN via the menu File → Save to your destination folder.

  2. Open the Workflow inside the Workflow Executor Application via the „Open new Workflow“ Button.

  3. Start the workflow with the Play Button on the right side.

Executor Inclusive Start
Figure 9. Executor Inclusive Gateway Start
Executor Inclusive ChooseItem Task
Figure 10. Executor Exclusive Gateway ChooseItem
Executor Inclusive SimpleOK
Figure 11. Executor Inclusive Gateway SimpleOK
Executor Inclusive End
Figure 12. Executor Inclusive Gateway End

5. Summary

In this tutorial we have learned to use the Inclusive Gateway with a simple workflow, and to configure it so that it can determine the path.