Cómo dibujar un diagrama de secuencia UML

Escribe el escenario como una frase antes de dibujar nada."Un huésped reserva una habitación que está libre" es un escenario. "Reservar" no lo es: es un caso de uso, que cubre toda ejecución incluidas las que fallan, y un diagrama que intenta ser todas ellas es el que acaba con ochenta mensajes. Si tu frase contiene la palabra "o", tienes dos escenarios o un fragmento alt, y conviene decidir cuál antes de seguir.

Después lista los participantes a los que ese escenario toca de verdad, y colócalos de izquierda a derecha en el orden en que los alcanza. El actor va el primero por la izquierda. Cuatro o cinco es el rango de trabajo; si tienes siete, al menos dos son detalles de implementación sobre los que el flujo no razona, y borrarlos no perderá nada que el lector necesitara.

Dibuja la ejecución en la que todo funciona, de arriba abajo, sin ningún fragmento. Ese es el diagrama de la cabecera, y está terminado como pieza de trabajo aunque no lo esté como diagrama: el orden está resuelto, que es la parte cara.

Dos convenciones llevan casi todo el significado. La etiqueta de un mensaje es una operación con sus argumentos, no una descripción: isFree(dates, roomType)le dice al lector qué debe ofrecer el receptor, mientras que "comprueba la disponibilidad" le cuenta una historia que ya sabía. Y toda respuesta es discontinua: una flecha sólida de vuelta es una segunda llamada, y significa otra cosa.

Las barras de activación son opcionales en UML 2.5.1 y merece la pena dibujarlas. Son lo único del diagrama que muestra que una llamada síncrona bloquea a quien la hace durante todo el intercambio anidado que hay debajo, que suele ser justo el hecho que el diagrama se dibujó para establecer.

Solo ahora añade los fragmentos, y añádelos de uno en uno, preguntándole a cada uno: ¿cambia esta rama lo que el lector tiene que construir? Una rama que devuelve un error y para rara vez lo hace, y se registra mejor en el texto del caso de uso. Una rama que hace otro trabajo, como ofrecer fechas alternativas arriba, siempre lo hace, y su sitio es el diagrama.

Envuelve el marco alrededor del punto donde los caminos divergen, no alrededor de todo el diagrama. El alt de arriba empieza después de que vuelve el veredicto de disponibilidad, porque todo lo anterior es común a los dos desenlaces; un marco alrededor de los nueve mensajes sería técnicamente legal y no le diría al lector nada sobre dónde está la decisión.

Luego para en una pantalla. Esto no es una recomendación blanda: un diagrama de secuencia existe para hacer visible un orden de un vistazo, y un diagrama que hay que desplazar ha renunciado a eso y se ha quedado con todo el coste. Cuando un flujo no quepa, córtalo por una costura natural, nombra cada mitad y desde la primera remite a la segunda con un fragmento ref, o dibuja por encima del conjunto un diagrama global de interacción.

Tres flujos terminados de los que copiar: los ejemplos trabajados.