Anotación de texto
Un comentario adjunto al diagrama que añade contexto sin cambiar el comportamiento del proceso — la forma de documentar lo que no cabe en las etiquetas.
Qué es una anotación de texto
Una anotación de texto es un elemento de documentación en BPMN — un rectángulo con el lado izquierdo abierto, conectado al elemento que anota mediante una línea de asociación punteada. No tiene efecto alguno sobre el flujo del proceso ni sobre la ejecución del token. Su único propósito es añadir información que no cabe en la etiqueta del elemento anotado.
Las anotaciones de texto son el equivalente de los comentarios en el código: imprescindibles cuando el diagrama no se explica solo, perjudiciales cuando sustituyen a un buen diseño. Si necesita cinco anotaciones para explicar por qué una actividad existe, el problema no es la falta de anotaciones — es que la actividad debería modelarse de otra manera.
Cuándo las anotaciones añaden valor
- Restricciones legales o de negocio que afectan a un paso — «este paso debe realizarse dentro de los límites del Reglamento X».
- Reglas de excepciones que no justifican un camino completo — «si la factura es de una filial, usar el proceso interno simplificado».
- Contexto técnico para desarrolladores — «este servicio tiene un SLA de 2 segundos; configurar timeout en 5 segundos».
- Decisiones de diseño — «se optó por esta estructura por compatibilidad con el sistema legado; revisar en la próxima migración».
Las anotaciones de texto en LucidFlow
LucidFlow genera anotaciones de texto cuando el documento fuente incluye notas aclaratorias, referencias normativas o restricciones que no se traducen en actividades o compuertas. En el lienzo, puede añadir anotaciones manualmente a cualquier elemento. Las anotaciones se preservan en la exportación BPMN 2.0 XML y son visibles en cualquier herramienta que soporte el estándar.
Preguntas frecuentes
¿Las anotaciones de texto afectan a la ejecución del proceso?
No. Las anotaciones de texto son puramente informativas. Un motor BPMN las ignora completamente durante la ejecución. Su valor es para los lectores humanos del diagrama, no para el motor.
¿Puede una anotación de texto conectarse a varios elementos?
Técnicamente, una anotación se conecta a un único elemento mediante una línea de asociación. Si necesita anotar varios elementos con el mismo texto, es señal de que ese contexto debería estar en la documentación del proceso, no en el diagrama.
¿Las anotaciones de texto tienen un límite de longitud?
La especificación BPMN no fija límite. En la práctica, si una anotación necesita más de dos o tres líneas, considere si esa información no pertenece a un documento de procedimiento externo al que el diagrama puede hacer referencia.