🧩
New! Render PlantUML diagrams directly inside GitHub with our official browser extension — No server. No tokens. No tracking. Zero permissions but clipboard. — Try it out and let us know what you think!

Diagramme de cas d'utilisation

Un diagramme de cas d'utilisation montre comment des acteurs externes interagissent avec un système : qui fait quoi, et quelles fonctionnalités le système expose. Il offre une vue d'ensemble des exigences fonctionnelles, utile dès les premières phases de conception pour aligner les parties prenantes.

Avec PlantUML, vous décrivez les acteurs, les cas d'utilisation et leurs relations en texte. Le diagramme est généré automatiquement.

Voir les commandes communes pour les fonctionnalités disponibles dans tous les types de diagrammes.

Cas d'utilisation

Les cas d'utilisation sont mis entre parenthèses (car deux parenthèses forment un ovale).

Vous pouvez aussi utiliser le mot-clé usecase pour définir un cas d'utilisation. Et vous pouvez définir un alias avec le mot-clé as. Cet alias sera ensuite utilisé lors de la définition des relations.

Acteurs

Le nom définissant un acteur est placé entre deux points.

Vous pouvez également utiliser le mot-clé actor pour définir un acteur. Un alias peut être attribué à l'aide du mot-clé as et peut être utilisé ultérieurement à la place du nom de l'acteur, par exemple lors de la définition des relations.

Les exemples suivants montrent que la définition des acteurs est facultative.

Changer le style d'acteur

Vous pouvez changer le style d'acteur de stick man (par défaut) à :

Stick man (par défaut)

Un==== homme impressionnant ====

[Réf. QA-10493]

Homme creux

[Réf. PR#396]

Description des cas d'utilisation

Si vous voulez une description sur plusieurs lignes, vous pouvez utiliser des guillemets.

Vous pouvez aussi utiliser les séparateurs suivants: -- .. == __. Et vous pouvez mettre un titre dans les séparateurs.

WARNING
 This translation need to be updated. 
WARNING

Utiliser un package

Vous pouvez utiliser des packages pour regrouper des acteurs ou des cas d'utilisation

Vous pouvez utiliser rectangle pour modifier l'affichage du paquet

Exemples très simples

Pour lier les acteurs et les cas d'utilisation, la flèche --> est utilisée.

Plus il y a de tirets - dans la flèche, plus elle sera longue. Vous pouvez ajouter un libellé sur la flèche, en ajoutant un caractère : dans la définition de la flèche.

Dans cet exemple, vous voyez que User n'a pas été défini préalablement, et qu'il est implicitement reconnu comme acteur.

Héritage

Si un acteur ou un cas d'utilisation en étend un autre, vous pouvez utiliser le symbole <|--.

Notes

Vous pouvez utiliser les mots clés note left of , note right of , note top of , note bottom of pour définir les notes en relation avec un objet.

Une note peut également être définie seule avec des mots-clés, puis liée à d'autres objets en utilisant le symbole .. .

Stéréotypes

Vous pouvez ajouter des stéréotypes lors de la définition des acteurs et des cas d'utilisation en utilisant << et >>.

Changer les directions des flèches

Par défaut, les liens entre les classes ont deux tirets -- et sont orientés verticalement. Il est possible de mettre des liens horizontaux en mettant un seul tiret (ou un point) comme ceci:

Vous pouvez aussi changer le sens en renversant le lien :

Il est possible de changer la direction d'une flèche en utilisant les mots-clé left, right, up ou down à l'intérieur de la flèche :

Vous pouvez abréger les noms des flèches en indiquant seulement le premier caractère de la direction (par exemple -d- pour -down-) ou les deux premiers caractères (-do-).

Il est conseillé de ne pas abuser de cette fonctionnalité : Graphviz qui donne d'assez bon résultats quoique non "garantis".

Découper les diagrames

Le mot-clé newpage est utilisé pour découper un diagrame en plusieurs images.

De droite à gauche

Le comportement général de construction des diagrammes est de haut en bas.
Il est possible de changer pour aller plutôt de la droite vers la gauche avec la commande left to right direction. Le résultat est parfois meilleur dans ce cas.

_See also 'Change diagram orientation' on [Deployment diagram](deployment-diagram) page._

La commande Skinparam

Utilisez la commande skinparam pour changer la couleur et la mise en forme du texte du schéma.

Vous pouvez utiliser cette commande :

Vous pouvez aussi spécifier les polices et les couleurs pour les acteurs et cas d'utilisation avec des stéréotypes.

WARNING
 This translation need to be updated. 
WARNING

Exemple complet

Business Use Case

Vous pouvez ajouter / pour créer un Business Use Case.

Business Use Case

Acteur commercial

[Réf. QA-12179]

Modifier la couleur et le style des flèches (style en ligne)

Vous pouvez modifier la couleur ou le style des flèches individuelles en utilisant la notation suivante en ligne

[Réf. QA-3770 et QA-3816] [Voir une fonctionnalité similaire sur le diagramme de déploiement ou le diagramme de classes]

Modifier la couleur et le style d'un élément (style en ligne)

Vous pouvez modifier la couleur ou le style d'un élément individuel en utilisant la notation suivante

[Réf. QA-5340 et adapté de QA-6852]

Afficher les données JSON sur le diagramme Usecase

Exemple simple

[Ref. QA-15481]

Pour un autre exemple, voir la page JSON.