Annotation textuelle
Un crochet avec du texte libre attaché à un nœud — les notes que le diagramme seul ne pourrait pas capturer.
Ce qu'est une annotation textuelle
Une annotation textuelle est un petit rectangle ouvert avec un crochet angulaire sur un côté, contenant du texte libre. Elle s'attache à n'importe quel nœud ou flux via une ligne d'association en pointillés. Les annotations n'ont aucune sémantique d'exécution — elles ne changent pas ce que fait le processus ; elles ajoutent simplement un commentaire humain que les formes BPMN formelles ne peuvent pas porter.
Les annotations sont la façon de capturer le « pourquoi » quand le « quoi » est le flux lui-même. « Cette étape prend 48 heures parce que le SLA du partenaire externe est de 2 jours ouvrés. » « On le fait manuellement aujourd'hui parce que l'API du fournisseur est limitée à 100 requêtes/heure. » « Si cela échoue deux fois, la réglementation oblige une escalade au directeur juridique. » Aucune de ces informations ne va dans un libellé de tâche, mais un lecteur qui ne les connaît pas ne peut pas juger le processus.
Quand les annotations aident, quand elles encombrent
- Aident quand la raison d'être d'un choix de conception n'est pas évidente à la lecture des formes — « on garde cela manuel parce que le volume est inférieur à 5/mois ».
- Aident quand une contrainte réglementaire ou de conformité conditionne une étape — « SOX impose une double validation à ce stade ».
- Aident quand un SLA, une limite de débit ou une contrainte de performance est attachée à un nœud spécifique.
- Encombrent quand l'annotation se contente de répéter le libellé de l'activité ou d'expliquer un concept que le lecteur est censé connaître.
Les annotations textuelles dans LucidFlow
LucidFlow génère des annotations quand le document source contient du vocabulaire de justification — « parce que », « en raison de », « comme l'exige ». Les annotations générées sont attachées à l'activité précise à laquelle elles se rapportent et survivent à l'export BPMN. Les annotations sont aussi la façon dont le Copilote IA remonte des avertissements lors de l'optimisation : « cette tâche ne peut pas être automatisée sans un accord fournisseur signé » apparaît comme une annotation sur le nœud concerné avant toute modification structurelle proposée.
Questions fréquentes
Les annotations textuelles font-elles partie de BPMN 2.0 ou sont-elles propres à un outil ?
Elles font partie de BPMN 2.0 — `textAnnotation` est un élément canonique. Elles font l'aller-retour en XML correctement, de sorte qu'un diagramme annoté dans LucidFlow affichera ses annotations intact dans Camunda, Visio ou tout outil conforme.
Une annotation peut-elle être attachée à plusieurs nœuds ?
Oui — une seule annotation peut avoir des lignes d'association vers plusieurs nœuds, utile quand la note s'applique à une portion du processus plutôt qu'à une étape unique.
Dois-je mettre les informations de durée et de coût dans des annotations ?
Non — durée et coût appartiennent aux métadonnées de l'activité (attributs durée, coût, fréquence), pas dans des annotations en prose. Les moteurs et tableaux de bord peuvent utiliser des valeurs structurées, pas du texte libre. Les annotations sont pour le raisonnement qui n'a pas de champ structuré.