Annotation Textuelle(Text Annotation)
Une note à crochet ouvert qui ajoute une explication en texte libre au diagramme sans affecter l'exécution.
L'Annotation Textuelle (Text Annotation) est la note de marge du modélisateur : règles métier que la notation ne peut exprimer, SLA, références à des politiques, clarifications pour les lecteurs. Reliée par une association en pointillés à son sujet, elle se dessine sous la forme d'un crochet carré ouvert accompagné de texte.
Utilisée à bon escient, c'est de l'or documentaire ; utilisée à outrance, elle ensevelit le diagramme.
Quand l'utiliser et l'éviter
Quand l'utiliser
Pour consigner une règle ou une prémisse que la notation seule ne peut transmettre.
Pour documenter des SLA, des exceptions ou des références à côté d'une activité.
Pour guider les lecteurs peu familiers du processus.
Quand NE PAS l'utiliser
En substitut d'une modélisation correcte — si cela affecte le flux, modélisez-le avec de vrais éléments.
En volume — trop de notes détruisent la lisibilité.
Pour des données circulant dans le processus — c'est un Objet de Données.
Exemple métier
Annoter une règle de SLA
Ouvrez cet exemple dans l'éditeur de processus HEFLO et explorez le diagramme de l'intérieur.
Ouvrir dans l'éditeur HEFLO →Étape par étape
- Examiner la demande porte l'Annotation Textuelle (surlignée) : « SLA : 48 heures ouvrées ».
- L'association en pointillés relie la note à sa tâche.
- La sémantique exécutable reste intacte — la note informe les humains, pas les moteurs.
Différences
Annotation Textuelle vs comportement modélisé
Si la note décrit quelque chose qui *devrait se produire* (une échéance, une escalade), envisagez de le modéliser (bordure temporisée, événement d'escalade) à la place — les annotations documentent, elles n'exécutent pas.
FAQ
Une annotation textuelle change-t-elle l'exécution ?
Jamais — elle est ignorée par les moteurs. Son public est le lecteur humain.
Comment est-elle reliée à un élément ?
Par une Association en pointillés vers ce qu'elle commente — tâche, événement, passerelle ou flux.