Aller au contenu

Exemple de diagramme d'activité UML : actions, décisions, forks et couloirs

Un exemple de diagramme d'activité UML pour le traitement d'une commande : décisions et fusions, fork et join pour le parallélisme, couloirs et aide-mémoire des symboles.

· Fondateur et développeur

Publié le

Diagramme d'activité UML avec les couloirs Customer, Warehouse et Billing : nœud initial, Place order, décision In stock? avec sorties gardées, Backorder items, une fusion, un fork vers Pack items et Create invoice, un join, Ship order et un nœud final, avec une légende en dessous.

Demandez à trois personnes comment une commande circule dans votre entreprise et vous pourriez obtenir trois réponses. L'une dit que la facture part avant l'emballage, une autre après l'expédition, et personne ne sait ce qui se passe quand un article est en rupture de stock. Un organigramme sur tableau blanc aide jusqu'au moment où deux choses se produisent en même temps et où les flèches suggèrent un ordre qui n'existe pas.

Un diagramme d'activité UML est fait pour cela : des étapes, des décisions, du travail parallèle et qui fait chaque partie. Cet article construit pas à pas un exemple de traitement de commande, avec un aide-mémoire des symboles, les règles de jetons qui le sous-tendent, les erreurs courantes et une comparaison des diagrammes d'activité avec les organigrammes, BPMN et les diagrammes d'états.

Ce que montre un diagramme d'activité

Un diagramme d'activité montre un comportement sous forme d'actions reliées par des flux. Les règles viennent de la spécification UML 2.5.1, publiée par l'Object Management Group (OMG) en décembre 2017 et toujours la version formelle en vigueur au moment de la rédaction (novembre 2026). Le chapitre 15 (Activities) et le chapitre 16 (Actions) définissent la notation.

Utilisez-en un quand la question porte sur l'ordre du travail : un processus métier qui traverse plusieurs équipes, le scénario derrière un cas d'utilisation ou une pipeline avec des branches et des étapes parallèles. Utilisez une machine à états quand la question est de savoir dans quel état se trouve une commande, un diagramme de séquence quand il s'agit de savoir quel service appelle quel autre, et un diagramme de classes quand il s'agit de la structure des données.

Symboles du diagramme d'activité

UML réutilise deux formes pour quatre nœuds de contrôle : la décision et la fusion sont toutes deux des losanges, le fork et le join sont tous deux des barres. Comptez les flux entrants et sortants pour les distinguer.

Symbole Apparence Signification
Nœud initial Petit cercle plein Point de départ du flux
Action Rectangle arrondi avec un groupe verbal Une étape de travail
Flux de contrôle Flèche, éventuellement avec une [garde] Ordre d'exécution
Nœud de décision Losange, un flux entrant, plusieurs sortants Envoie chaque jeton dans une seule direction, choisie par les gardes
Nœud de fusion Losange, plusieurs flux entrants, un sortant Combine des chemins alternatifs sans attendre
Nœud fork Barre, un flux entrant, plusieurs sortants Démarre tous les flux sortants en concurrence
Nœud join Barre, plusieurs flux entrants, un sortant Attend chaque flux entrant, puis continue
Fin d'activité Cible : cercle plein dans un anneau Termine toute l'activité
Fin de flux Cercle avec un X Termine uniquement le flux qui l'atteint
Nœud d'objet Rectangle avec un nom, ou une broche sur une action Données transmises entre les actions
Partition Couloir nommé à une extrémité Regroupe les actions d'un participant

Dans la spécification, le fork et le join sont «simplement un segment de ligne» ; les outils l'épaississent en barre. La spécification précise aussi que les partitions sont «familièrement appelées» couloirs (swimlanes).

Comment les jetons circulent dans le diagramme

UML définit ces symboles avec des jetons, comme des pions sur un plateau de jeu. Au démarrage de l'activité, un jeton de contrôle se trouve sur le nœud initial. Une action s'exécute une fois que chaque flux entrant lui propose un jeton, puis elle propose un jeton sur chaque flux sortant. Une décision envoie chaque jeton sur au plus un flux sortant, celui dont la garde est vraie ; une fusion laisse passer chaque jeton directement ; un fork copie le jeton sur tous les flux sortants ; un join attend que chaque flux entrant propose un jeton, puis en émet un. Le premier jeton qui atteint un nœud de fin d'activité termine l'activité, y compris tout ce qui tourne encore.

Deux conséquences surprennent ceux qui ont d'abord appris les organigrammes :

  • Deux flèches vers une action signifient attendre les deux, un join implicite. Si les flèches viennent des deux branches d'une décision, une seule porte un jeton et l'action ne démarre jamais. Les chemins alternatifs doivent d'abord se rejoindre sur une fusion.
  • Deux flèches depuis une action signifient faire les deux, un fork implicite. C'est permis, mais les lecteurs le manquent ; dessinez plutôt une barre fork.

Construire l'exemple pas à pas

  1. Dessinez d'abord les partitions : Customer, Warehouse et Billing. Les couloirs forcent à poser tôt les questions de responsabilité.
  2. Démarrez le flux. Un nœud initial dans le couloir Customer mène à Place order.
  3. Ajoutez la décision. Dans le couloir Warehouse, une décision vérifie le stock, avec les gardes [in stock] et [out of stock]. Les gardes doivent s'exclure mutuellement et couvrir tous les cas ; la garde prédéfinie [else] d'UML récupère le reste.
  4. Fusionnez les chemins. Les commandes en rupture de stock passent par Backorder items, puis les deux chemins se rejoignent sur une fusion. La fusion est obligatoire : un fork accepte exactement un flux entrant, et une action avec deux flux entrants attendrait les deux.
  5. Faites un fork du travail parallèle. Une barre fork démarre Pack items (Warehouse) et Create invoice (Billing). Concurrent signifie qu'aucun n'attend l'autre, pas qu'ils s'exécutent au même instant.
  6. Faites un join avant l'expédition. Une barre join attend que les deux soient terminés ; seulement alors Ship order s'exécute.
  7. Terminez l'activité. Un nœud de fin d'activité suit Ship order. Les nœuds de contrôle ne sont pas du travail, ils peuvent donc se trouver dans n'importe quel couloir ; celui-ci est dans le couloir Customer, juste au-dessus de Ship order.

Dans PlantUML, le même flux est du texte brut : |Customer| pour les couloirs, if, else et endif pour les décisions, et fork, fork again et end fork pour le travail parallèle. La mise en page est automatique : vous échangez du contrôle contre de la rapidité.

Erreurs courantes

Erreur Ce qui ne va pas Correction
Un fork sans join La première branche qui atteint la fin d'activité termine l'activité et arrête l'autre Faire un join des branches, ou terminer chacune par une fin de flux
Une décision pour du travail parallèle Une seule branche s'exécute Utiliser une barre fork
Une fusion là où il faut un join L'action suivante peut s'exécuter deux fois, une par jeton Utiliser une barre join
Un join après une décision Une seule branche porte un jeton, le join attend donc indéfiniment Utiliser un losange de fusion
Gardes non étiquetées ou qui se chevauchent Les lecteurs devinent ; UML laisse indéfini l'ordre d'évaluation des gardes Des gardes qui s'excluent mutuellement, plus [else]
Noms d'actions vagues Traitement ne dit rien du travail Un verbe et un objet : Pack items

La troisième et la quatrième ligne sont en miroir : une fusion n'attend jamais, un join peut attendre indéfiniment. Avant de partager un diagramme, suivez un jeton à travers chaque branche.

Diagrammes d'activité, organigrammes, BPMN et diagrammes d'états

Diagramme d'activité Organigramme BPMN Diagramme de machine à états
Montre Les étapes d'un comportement, avec données et travail parallèle Étapes et décisions Processus entre participants, avec événements et messages Les états d'un objet et les événements qui les changent
Travail parallèle Barres fork et join Pas de symbole dans le jeu courant Passerelle parallèle Régions orthogonales
Qui fait quoi Partitions (couloirs) Couloirs dans les organigrammes interfonctionnels Pools et lanes Non représenté
Standard UML 2.5.1 (OMG) ISO 5807 (1985), suivi de façon lâche BPMN 2.0.2 (OMG) UML 2.5.1 (OMG)
Idéal pour Comportement logiciel, flux de cas d'utilisation, pipelines Croquis rapides pour tout public Automatisation de processus, flux entre organisations Cycles de vie de commandes ou d'abonnements

Les diagrammes d'activité et BPMN sont cousins : tous deux définissent le comportement avec des jetons, et BPMN 2.0.2 précise aussi une sémantique d'exécution pour les moteurs de processus. Choisissez BPMN pour les processus exécutables et les messages entre organisations (voir l'exemple de diagramme BPMN), une machine à états pour le cycle de vie d'un objet (voir l'exemple de diagramme d'états), un organigramme pour des lecteurs qui n'apprendront jamais UML, et un diagramme d'activité quand le travail parallèle et la précision du sens comptent.

Le diagramme d'activité du traitement de commande

Diagramme d'activité UML avec les couloirs Customer, Warehouse et Billing : nœud initial, Place order, décision In stock? avec sorties gardées, Backorder items, une fusion, un fork vers Pack items et Create invoice, un join, Ship order et un nœud final, avec une légende en dessous.

17 composants · 12 connexions

Ouvrir dans Archboard
Contenu du diagramme
  • Customer
  • Warehouse
  • Billing
  • Place order
  • In stock?
  • Backorder items
  • Pack items
  • Ship order
  • Create invoice
  • [in stock]
  • [out of stock]
Une activité de traitement de commande répartie en trois couloirs. Une décision envoie les commandes en rupture de stock vers une étape de réapprovisionnement, une fusion réunit les deux chemins, puis un fork et un join font tourner emballage et facturation en parallèle avant l'expédition.

Comment le lire :

  • Trois couloirs : Customer, Warehouse et Billing, chacun contenant ses propres actions.
  • Partez du cercle plein : le client passe la commande et le flux descend dans le couloir Warehouse.
  • La décision In stock? a deux sorties gardées : [in stock] va vers la fusion, [out of stock] fait un détour par Backorder items, en orange. Les marques Y et N sont les repères de sortie intégrés à l'éditeur ; ce sont les gardes qui portent le sens UML.
  • Le petit losange est la fusion où les deux chemins se rejoignent.
  • La première barre est le fork qui démarre Pack items et Create invoice ; la seconde est le join qui fait attendre les deux à Ship order.
  • La cible au-dessus de Ship order termine l'activité, et le tableau sous les couloirs répète la règle de jeton de chaque nœud de contrôle.

Dessiner des diagrammes d'activité clairement

  • Choisissez une seule direction. Des couloirs horizontaux avec un flux de gauche à droite conviennent aux pages larges ; des couloirs verticaux avec un flux vers le bas conviennent aux longs processus.
  • Nommez les actions avec un verbe et un objet : Pack items, Create invoice. Une action qui demande un paragraphe est une sous-activité ; dessinez-la comme une action d'appel de comportement, marquée du petit symbole de râteau d'UML, et détaillez-la dans son propre diagramme.
  • Mettez les gardes sur les flux. Une question dans le losange aide les lecteurs, mais ce sont les gardes entre crochets qui portent le sens.
  • Dessinez chaque fusion et chaque join. Les joins et forks implicites sont permis mais invisibles.
  • Gardez peu de couloirs. Trois à cinq restent lisibles ; à huit, scindez le processus.
  • Omettez ce qui ne change pas le flux, comme la journalisation ou les nouvelles tentatives à l'intérieur d'une étape, et n'ajoutez des nœuds d'objet que lorsque les données comptent.

Pour des couloirs sans le reste d'UML, voir l'exemple de diagramme à couloirs.

Le construire dans Archboard

  1. Connectez-vous avec Google ou GitHub et créez un diagramme.
  2. Ajoutez trois nœuds Cadre du pack Base comme couloirs horizontaux : Customer, Warehouse et Billing.
  3. Ajoutez une petite Ellipse du pack Base avec un remplissage foncé comme nœud initial.
  4. Ajoutez cinq nœuds Processus du pack Logigramme dans leurs couloirs : Place order, Backorder items, Pack items, Create invoice et Ship order.
  5. Ajoutez un nœud Décision du pack Logigramme étiqueté In stock?, et un petit Losange du pack Base pour la fusion. Étiquetez les sorties [in stock] et [out of stock].
  6. Pour le fork et le join, ajoutez deux nœuds Carré fins et hauts du pack Base avec un remplissage foncé.
  7. Pour la fin d'activité, ajoutez une Icône du pack Base avec l'icône record-circle-outline, un point dans un anneau.
  8. Reliez les nœuds, puis ajoutez deux annotations Texte de Base et un bloc Markdown du pack Base avec le tableau de légende.

Si le flux existe sous forme d'organigramme Mermaid, l'outil Mermaid vers diagramme vous donne un premier brouillon modifiable à affiner avec ces nœuds. Pour un organigramme simple avec des couloirs, commencez par le créateur d'organigrammes.

L'exemple utilise 15 nœuds de diagramme et reste dans les limites de l'offre Free.

FAQ

Qu'est-ce qu'un diagramme d'activité en UML ? Un diagramme de comportement qui montre un processus sous forme d'actions reliées par des flux, avec des décisions, un fork et un join pour le travail parallèle, et des couloirs pour dire qui fait quoi. UML 2.5.1 le définit au chapitre 15.

Quelle est la différence entre un fork et une décision ? Une décision envoie chaque jeton sur un seul flux sortant, choisi par les gardes. Un fork envoie une copie sur chaque flux sortant, si bien que les branches s'exécutent en concurrence. Les décisions sont des losanges ; les forks sont des barres.

Quelle est la différence entre une fin d'activité et une fin de flux ? Une fin d'activité, une cible, termine toute l'activité et chaque flux qu'elle contient. Une fin de flux, un cercle avec un X, termine uniquement le flux qui l'atteint.

Comment fonctionnent les couloirs dans un diagramme d'activité ? Les couloirs sont des partitions d'activité UML. Chaque couloir regroupe les actions d'une personne, d'une équipe ou d'un système ; les flux traversent librement les couloirs, et les couloirs ne changent pas la façon dont les jetons circulent.

Un diagramme d'activité est-il la même chose qu'un organigramme ? Non, même s'ils se ressemblent. Les diagrammes d'activité ajoutent le fork et le join, des nœuds d'objet pour les données, des partitions et des règles de jetons qui donnent à chaque symbole un sens précis.

Commencez gratuitement — un siège, sans carte bancaire.

Articles associés

← Retour au blog

Ouvrez un canevas en une minute

Connectez-vous avec Google ou GitHub. Gratuit pour un siège. Passez à un forfait supérieur quand l’équipe vous rejoint.