jBPM Workflow Tutorial: ⚙️ Complex Gateway

 🚀 Introduction

The ⚙️ Complex Gateway in jBPM is used for advanced synchronization and branching rules that cannot be modeled using other gateways.
It allows you to specify complex conditions, such as:

  • “Wait for any 2 out of 3 tasks before proceeding”

  • “Proceed when either Task A is done OR both Task B and Task C are complete”

  • “Loop until a specific condition is satisfied”

⚙️ Complex Gateways are less common, but very useful in sophisticated workflows.

🛠️ Prerequisites

  • 💻 jBPM/Business Central & KIE Server installed

  • ☕ JDK 11+ or JDK 17

  • 👨‍💼 Users assigned to required Human Tasks

  • 🌐 Access: http://localhost:8080/business-central

📝 Step 1: Create a New Process

  1. 🔑 Log in to Business Central

  2. 📂 Create a project: complex-gateway-demo

  3. ➕ Add Business Process: ComplexProcess

    • Id: com.example.complex

    • Package: com.example

🎨 Step 2: Design the Workflow

  1. 🔵 Add a Start node

  2. ➕ Add a Parallel Gateway (to split into multiple tasks)

  3. 👤 Add Task A, Task B, and Task C

  4. ⚙️ Add a Complex Gateway (Join)

  5. ✅ Add an End node

🔗 Flow:
Start → ➕ Split → (Task A, Task B, Task C) → ⚙️ Complex Join → End

📊 Step 3: Define Complex Synchronization Rule

  • Open the Complex Gateway properties

  • Example rule: Wait for any 2 of 3 tasks to complete before proceeding

In jBPM, this is modeled with Activation Condition + Completion Condition.

Example Pseudo Expression

activationCondition = "numberOfCompletedInstances >= 2"
completionCondition = "numberOfActiveInstances == 0"

This means:

  • Gateway activates when 2 out of 3 tasks are done

  • Process moves forward when no more active instances remain (or when the condition is met).

⚙️ Step 4: Build and Deploy

  1. 💾 Save the process

  2. 🛠️ Build & Install

  3. 📦 Deploy to KIE Server

▶️ Step 5: Run the Process

  1. Go to Manage → Process Definitions

  2. ▶️ Start a new instance of ComplexProcess

  3. 👤 Complete any 2 of the 3 tasks (Task A, Task B, Task C)

  4. ⚙️ Complex Gateway will trigger → process moves to End

📌 Step 6: Example Use Cases

  • 👨‍👩‍👧 Group approvals: require at least 2 out of 3 managers to approve

  • 🏦 Banking: require 2 of 3 signatures for high-value transactions

  • 🏥 Healthcare: proceed when two medical checks are complete, even if a third is pending


👉 Watch jBPM Workflow Tutorial: ⚙️ Complex Gateway in Action better:

Here's a quick video to help you understand jBPM Workflow Tutorial: ⚙️ Complex Gateway in Action better: Coming soon YouTube: Learn IT with Shikha


🛠️ Troubleshooting

  • ❌ Process stuck at Complex Gateway? → Ensure activation/completion conditions are correctly defined

  • ⚠️ Moves too early? → Condition logic may be too loose

  • 🔄 Never moves forward? → Condition logic may be too strict (no path satisfied)

🎯 Conclusion

The ⚙️ Complex Gateway is a powerful but rarely used gateway in jBPM, perfect for advanced branching and synchronization rules.

It allows you to:

  • Wait for N out of M tasks

  • Combine multiple conditions before proceeding

  • Handle sophisticated approval scenarios

By mastering Complex Gateways, you can design enterprise-grade workflows that require flexible and intelligent decision-making beyond basic XOR, OR, and AND flows.


💼 Professional Support Available

If you are facing issues in real projects related to enterprise backend development or workflow automation, I provide paid consulting, production debugging, project support, and focused trainings.

Technologies covered include Java, Spring Boot, PL/SQL, Azure, and workflow automation (jBPM, Camunda BPM, RHPAM).

Comments

Post a Comment

Popular posts from this blog

jBPM Installation Guide: Step by Step Setup

  jBPM Installation Guide – Step by Step for Beginners If you are starting with jBPM (Java Business Process Management) , the first step is to set up your environment. In this guide, we’ll walk through how to install jBPM, configure it, and run your first business process. 🔎 What is jBPM? Before we dive into installation, a quick recap: jBPM is an open-source Business Process Management (BPM) suite , written in Java, that allows you to model, execute, and monitor workflows using BPMN 2.0 standards. It can run standalone , embedded in applications , or deployed on a Java EE server . 🖥️ Prerequisites Before installing jBPM, make sure you have: Java JDK 11 or later (Java 17 is commonly used) Maven 3.x (for building and managing dependencies) Git (optional, if you want to clone sample projects) A Database (H2, MySQL, PostgreSQL, or Oracle) – jBPM ships with H2 for testing At least 4GB RAM (8GB recommended for Workbench & KIE Server) 📦 Download ...
Read more

Scopes of Signal in jBPM

Image
💡 Introduction Signals in jBPM 7 are a core part of event-driven workflow design. They allow asynchronous communication between process instances, making it possible to start , interrupt , or coordinate processes without direct linking. However, signals can have different scopes , which define how far the signal travels and who receives it . Let’s explore the four available scopes in detail: 🔹 Process Scope 🔹 Default Scope 🔹 External Scope 🔹 Project Instance Scope 🧩 1️⃣ Process Scope 📘 Definition Process scope signals are local to a single process instance or its child subprocesses . They are not visible outside that instance hierarchy. 📋 Use Case Used for communication inside the same process , like triggering subprocesses or event sub-processes. 🖼️ Process Scope Example Below is an example of a simple process-scoped signal. Only this process (or its subprocess) will catch this signal. ⚙️ 2️⃣ Default Scope 📘 Definition The default scope ...
Read more

OOPs Concepts in Java | English | Object Oriented Programming Explained

Image
🔹OOPS (Object Oriented Programming System) in Java Object-Oriented Programming (OOPS) is a programming paradigm that uses classes and objects to design software. It simplifies development and maintenance by applying key concepts: 📌 Class: Class   is a user-defined data type which defines its properties and its functions. Class is the only logical representation of the data. For example, Human beings in an organisation is a class like Employee. The age, name, department, salary etc. of a human being/employee are its properties, and the jobs performed by the employees in an organisation are known as functions.  The class does not occupy any memory space till the time an object is instantiated. A class is a user-defined data type that defines properties and functions. For example: Class: Employee Properties: name, age, salary Functions: work(), attendMeeting() A class does not occupy memory until an object is created. ...
Read more