plantUML

PlantUML – Diagramme d’activités

Notice de base + exemples

Cette notice décrit les bases indispensables de PlantUML pour modéliser des processus informatiques avec des diagrammes d’activités UML.

Norme retenue : UML – Activity Diagram
Outil : PlantUML

---

1. Structure minimale (obligatoire)

Tout diagramme PlantUML doit être encadré par :

@startuml
@enduml

Sans ces balises, aucun rendu n’est possible.

---

2. Début et fin du processus

start
stop

• start : point d’entrée unique
• stop / end : fin du processus (succès ou erreur)

---

3. Actions (traitements)

Une action représente une étape de traitement.

:Nom de l'action;

Bonnes pratiques

• Verbe à l’infinitif + complément
• Une action = une responsabilité

Exemples

:Vérifier droits utilisateur;
:Calculer total HT;
:Enregistrer données;

---

4. Conditions (if / else)

Permet de représenter une décision logique.

if (Condition ?) then (Oui)
  :Action si vrai;
else (Non)
  :Action si faux;
endif

Règles

• La condition est une question fermée
• Les branches sont nommées (Oui / Non)

---

5. Boucles

While (test avant)

while (Condition ?) is (Oui)
  :Action répétée;
endwhile (Non)

Repeat (test après)

repeat
  :Action;
repeat while (Condition ?) is (Oui)

---

6. Parallélisme (fork / join)

Permet d’exécuter plusieurs actions en parallèle.

fork
  :Action A;
fork again
  :Action B;
end fork

À utiliser uniquement pour un vrai parallélisme.

---

7. Couloirs (swimlanes)

Les swimlanes représentent les responsabilités.

|Utilisateur|
:Action utilisateur;

|Application|
:Traitement applicatif;

|Système|
:Log, tâche technique;

Convention recommandée

• Utilisateur
• Application
• Services / API
• Base de données
• Système / Logs

---

8. Notes

note right
  Texte explicatif
end note

Ou :

:Action;
note right: Détail important

---

9. Titre du diagramme

title ACT-DOMAINE-PROCESSUS-v1.0

---

10. Exemple minimal

@startuml
start
:Hello PlantUML;
stop
@enduml

---

11. Exemple standard

@startuml
title ACT-AUTH-CONNEXION-v1.0

|Utilisateur|
start
:Saisir identifiants;

|Application|
:Vérifier droits;
if (Accès autorisé ?) then (Oui)
  :Créer session;
  |Système|
  :Écrire log succès;
  stop
else (Non)
  :Refuser accès;
  |Système|
  :Écrire log erreur;
  stop
endif
@enduml

---

12. Règles de qualité

• 1 diagramme = 1 processus
• Toujours un start
• Toute erreur mène à un stop
• Logs explicitement représentés
• Diagrammes versionnés

---

Fin de la notice.