Anotación de Texto(Text Annotation)
Una nota con corchete abierto que añade una explicación en texto libre al diagrama sin afectar la ejecución.
La Anotación de Texto (Text Annotation) es la nota al margen del modelador: reglas de negocio que la notación no puede expresar, SLA, referencias a políticas, aclaraciones para los lectores. Conectada mediante una asociación punteada a su objeto, se representa como un corchete cuadrado abierto acompañado de texto.
Usada con criterio es documentación de gran valor; usada en exceso, entierra el diagrama.
Cuándo usar y evitar
Cuándo usar
Para registrar una regla o premisa que la notación por sí sola no puede transmitir.
Para documentar SLA, excepciones o referencias junto a una actividad.
Para guiar a lectores poco familiarizados con el proceso.
Cuándo NO usar
Como sustituto de un modelado correcto — si afecta el flujo, modélelo con elementos reales.
En exceso — demasiadas notas destruyen la legibilidad.
Para datos que viajan a través del proceso — eso es un Objeto de Datos.
Ejemplo de negocio
Anotar una regla de SLA
Abra este ejemplo en el editor de procesos de HEFLO y explore el diagrama por dentro.
Abrir en el editor HEFLO →Paso a paso
- Revisar la solicitud lleva la Anotación de Texto (resaltada): “SLA: 48 horas hábiles”.
- La asociación punteada vincula la nota con su tarea.
- La semántica ejecutable permanece intacta — la nota informa a las personas, no a los motores.
Diferencias
Anotación de Texto vs. comportamiento modelado
Si la nota describe algo que *debería ocurrir* (un plazo, una escalada), considere modelarlo (límite de temporizador, evento de escalada) en su lugar — las anotaciones documentan, no ejecutan.
Preguntas frecuentes
¿Una anotación de texto cambia la ejecución?
Nunca — los motores la ignoran. Su destinatario es el lector humano.
¿Cómo se vincula a un elemento?
Mediante una Asociación punteada hacia aquello que comenta — tarea, evento, compuerta o flujo.