Tutoriel jBPM en Français : ❌ Gateway Exclusive (XOR)

   🚀 Introduction

La ❌ Gateway Exclusive (XOR) dans jBPM est utilisée lorsque seul un chemin parmi plusieurs alternatives doit être emprunté.
Elle évalue les conditions sur les flux de séquence sortants et dirige le processus vers la première condition qui s’avère vraie.

C’est idéal pour les workflows de type approuver/rejeter.

🛠️ Prérequis

  • jBPM / Business Central & KIE Server installés

  • ☕ JDK 11+ (ou JDK 17)

  • Un utilisateur avec le rôle manager

  • Accès : http://localhost:8080/business-central

📝 Étape 1 : Créer un nouveau processus

  1. Se connecter à Business Central

  2. Créer un projet : xor-approval

  3. ➕ Ajouter un Business Process : XorApprovalProcess

    • Id : com.example.xorapproval

    • Package : com.example

🎨 Étape 2 : Concevoir le workflow

  1. Ajouter un nœud Start (Début)

  2. Ajouter une Tâche Humaine, assignée au rôle manager

  3. ❌ Ajouter une Gateway Exclusive (XOR)

  4. ✅ Ajouter un nœud End (Fin) pour le chemin Approuvé

  5. ❌ Ajouter un autre nœud End (Fin) pour le chemin Rejeté

  6. Connecter les nœuds :

    Start → Tâche Humaine → XOR Gateway → Fin Approuvée / Fin Rejetée

📊 Étape 3 : Définir les données

  • Ajouter une variable de processus :

    • Nom : approved

    • Type : Boolean

  • Dans le formulaire de la tâche humaine, permettre à l’utilisateur de définir approved = true ou approved = false

⚙️ Étape 4 : Configurer les conditions de la Gateway

  • ✅ Chemin Approuvé → condition :

    approved == true

  • ❌ Chemin Rejeté → condition :

    approved == false

Si aucune condition ne correspond, le processus peut rester bloqué — assurez-vous qu’au moins un chemin soit toujours valide.

🔨 Étape 5 : Construire et déployer

  1. Sauvegarder le processus

  2. Build & Install le projet

  3. Déployer sur le KIE Server

▶️ Étape 6 : Exécuter le processus

  1. Aller dans Manage → Process Definitions

  2. ▶️ Lancer une nouvelle instance de XorApprovalProcess

  3. La tâche humaine est assignée → ouvrir le formulaire → choisir approuver ou rejeter

📌 Étape 7 : Observer le résultat

  • ✅ Si approved = true → le flux suit le chemin de fin Approuvée

  • ❌ Si approved = false → le flux suit le chemin de fin Rejetée

🛠️ Dépannage

  • ❌ La tâche n’apparaît pas ? → Vérifier que l’utilisateur a bien le rôle manager

  • ⚠️ Les deux chemins se déclenchent ? → Vérifier que les conditions sont mutuellement exclusives

  • Le processus reste bloqué au XOR ? → Ajouter un chemin par défaut s’il y a cas non couvert

👉 Source code: https://github.com/LearnITWithShikha/GatewayExamples

🎯 Conclusion

La ❌ Gateway Exclusive (XOR) est le moyen le plus simple de prise de décision dans jBPM. Elle garantit que seul un chemin est emprunté selon des données de processus ou une entrée utilisateur.

Cet exemple a montré comment construire un flux approuver/rejeter, un modèle fréquent dans les processus métiers réels.

En maîtrisant les gateways XOR, vous pouvez :

  • Simplifier les workflows d’approbation

  • Contrôler les branchements de processus

  • ✅ Assurer une logique de prise de décision claire

Ensuite, essayez de combiner les Gateways XOR avec des Tâches Humaines et des Service Tasks pour construire des workflows d’entreprise encore plus pratiques.


💼 Support professionnel disponible

Si vous rencontrez des problèmes sur des projets réels liés au développement backend d’entreprise ou à l’automatisation des workflows, je propose des services de conseil payants, de débogage en production, de support projet et de formations ciblées.

Les technologies couvertes incluent Java, Spring Boot, PL/SQL, Azure, ainsi que l’automatisation des workflows (jBPM, Camunda BPM, RHPAM).

📧 Contact: ishikhanirankari@gmail.com | info@realtechnologiesindia.com

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