Tutoriel jBPM en Français : Début → Tâche Humaine → ✅ Fin (Étape par Étape)

  🚀 Ce que vous allez construire

Un processus minimal jBPM avec trois nœuds : Début → Tâche Humaine → Fin. Vous allez le déployer depuis Business Central, lancer une instance, et compléter la tâche humaine comme utilisateur assigné.

⚙️ Prérequis

  • Environnement jBPM / Business Central & KIE Server (versions communautaires 7.x ou 8.x)
  • ☕ JDK 11+ (JDK 17 fonctionne aussi)
  • Utilisateur avec les rôles : admin, analyst, developer, manager, kiemgmt
  • Accès navigateur : http://localhost:8080/business-central

📝 Étape 1 : Créer un projet dans Business Central

  1. Se connecter → Design → Projects → Add Project
  2. Nommer le projet : hr-approval
  3. ➕ Ajouter un asset → Business Process → nom : SimpleApproval

🎨 Étape 2 : Dessiner le processus (Début → Tâche Humaine → ✅ Fin)

  1. ➕ Ajouter un nœud Start (Début)
  2. Ajouter une User Task (Tâche Humaine)
  3. ✅ Ajouter un nœud End (Fin)
  4. Connecter Début → Tâche Humaine → Fin

Configurer la Tâche Humaine :
Nom : Approve Request → Nom de tâche : approve-request → Acteurs : manager

📊 Étape 3 : Définir les données (optionnel)

  • Ajouter une variable de processus : approved:Boolean
  • Mapper la sortie de la tâche humaine → variable de processus
⚡ Étape 4 : Générer un formulaire simple
  • Générer automatiquement un formulaire pour la tâche humaine
  • Le formulaire contient une case à cocher pour approved

🔨 Étape 5 : Valider et construire le projet

  • Sauvegarder le processus
  • Construire & Installer (Build & Install)
  • Vérifier le déploiement sur le KIE Server
▶️ Étape 6 : Démarrer le processus

Aller dans Manage → Process Definitions → Démarrer une nouvelle instance de SimpleApproval

👤 Étape 7 : Réclamer et compléter la tâche humaine

  1. Aller dans Manage → Tasks
  2. ✋ Réclamer la tâche (Claim)
  3. ▶️ Démarrer la tâche (Start)
  4. ✅ Compléter la tâche (par exemple : approved = true)
🔄 Étape 8 : (Optionnel) Utiliser l’API REST
POST /kie-server/services/rest/server/containers/{containerId}/processes/com.example.simpleapproval/instances
PUT  /kie-server/services/rest/server/containers/{containerId}/tasks/{taskId}/states/completed
Body: {"approved": true}

🛠️ Étape 9 : Dépannage rapide

  • ❌ Pas de tâche visible ? → Vérifier que l’utilisateur appartient au rôle manager
  • ⚠️ Le build est fait mais le container n’apparaît pas ? → Vérifier que le conteneur est démarré
  • 🔄 Erreur 405 ? → S’assurer d’utiliser le bon verbe HTTP (PUT ou POST) et que le containerId est exact

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

🎯 Conclusion

Le workflow Tâche Humaine montre comment des personnes peuvent participer activement à des processus automatisés en réclamant et complétant des tâches qui leur sont assignées. Ce simple processus Début → Tâche Humaine → Fin est le fondement des systèmes d’approbation ou de révision dans le monde réel.

En suivant ce tutoriel, vous avez appris à :

  • Assigner des tâches à des acteurs ou groupes
  • Générer et utiliser des formulaires de tâche
  • Réclamer, démarrer et compléter des tâches via l’interface ou l’API REST

À partir d’ici, vous pouvez enrichir ce workflow en ajoutant : des Gateways pour des branchements conditionnels, des Service Tasks pour l’intégration système, des Script Tasks pour l’automatisation. Maîtriser les Tâches Humaines est essentiel car presque tous les processus d’entreprise impliquent une interaction humaine — cet exemple pose les bases pour construire des workflows de niveau entreprise avec jBPM.


💼 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

🌐 Website: IT Trainings | Digital lectern | Digital rostrum | Digital metal podium



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