Come creare UML in modo facile e automaticodi

Stefano Trojani

Plant UML

Agile Tester & QA

Chi Sono

Lavoro come Tester Funzionale e QA in un team Agile (Scrum). Analizzo i flussi e le funzionalità per poi generare la documentazione per i test (test plan con di base flussi UML, Use Case, Test Case). Gestisco il Test Plan di progetto documentando tutto sulla Confluence (integrata con Jira).

Lavoro molto spesso con tool di automazione (Selenium Ide, webserver python). Scrivo manuali e documentazione sull'utilizzo di prodotti email (PEC, email, Exchange, Active Sync, Mobile...) e formo il personale coinvolto (area commerciale, marketing, customer care).

Mi occupo di scrivere contenuti tecnici e marketing di prodotto.

Cos’è Plant UMLPlantUml viene utilizzato per disegnare diagramma UML, utilizzando una descrizione testo leggibile semplice e umano.

ATTENZIONE, non impedisce un diagramma incoerente (es: avere due classi che ereditano le une dalle altre).

Quindi è più uno strumento di disegno di uno strumento di modellazione.

http://plantuml.com/

Dove si trova Plant UML

Qui il sito ufficiale

http://plantuml.com/ http://plantuml.com/download.html

Qui il download

Casi di utilizzo

Come Agile Tester sono spesso chiamato a fare dei grafici in UML per meglio analizzare flussi, funzionalità o sequenze.

A volte utilizzo il sempre verde e gratis ArgoUML (http://argouml.tigris.org/ )

Ma devo dire che la modifica dei grafici relizzati con Plant UML è estremamente più facile, in primis, perché il sorgente del grafico E’ il grafico stesso

Casi di utilizzo di questo manuale

I tool indispensabili dell’Agile Tester

Sebbene Plan UML sia versabile e possa fare molti grafici UML mi concentro in questo manuale sui 3 fondamentali grafici che un Agile Tester deve sempre fare, allegati al suo Test Plan

- Use Case Diagram- Sequence Diagram- Activity Diagram

Use Case DiagramDefinizione:

In UML, gli Use Case Diagram (UCD o diagrammi dei casi d'uso) sono diagrammi dedicati alla descrizione delle funzioni o servizi offerti da un sistema, così come sono percepiti e utilizzati dagli attori che interagiscono col sistema stesso.

Sono impiegati soprattutto nel contesto della Use Case View (vista dei casi d'uso) di un modello, e in tal caso si possono considerare come uno strumento di rappresentazione dei requisiti funzionali di un sistema.

Tuttavia, è possibile ipotizzare l'uso degli UCD in altri contesti; durante laprogettazione, per esempio, potrebbero essere usati per modellare i servizi offerti da un determinato modulo o sottosistema ad altri moduli o sottosistemi.

In molti modelli di processo software basati su UML, la Use Case View e gli Use Case Diagram che essa contiene rappresentano la vista più importante, attorno a cui si sviluppano tutte le altre attività del ciclo di vita del software (processi del genere prendono l'appellativo di processi Use Case Driven).

Use Case Diagram: com’è fatto

Esempio

Un classico e semplice esempio grafico di Use Case Diagram

Vediamo come realizzarlo con Plant UML

Use Case Diagram - 1 di 3comando risultato

title Titolo <b>semplice</b> crea un titolo al grafico

actor PIPPO Attore PIPPO

rectangle NomeContesto { } crea area

(attività 1) crea attività (attività 1)

<|-- --|> Freccia con la capoccia

<-- --> Freccia con la punta

-- Linea

<.. ..> Freccia tratteggiata

PIPPO --> (attività 2) : descrizione collega l'attore all'attività con una descrizione

note right of (attività 2)una notaa compendioend note 

crea una nota legata all'attività

Use Case Diagram - 2 di 2Sorgente Plant UML Grafico Generato

Use Case Diagram - 3 di 3Note

1) Tipi di frecciePer impostazione predefinita, i collegamenti tra le classi hanno due trattini - e sono orientati in verticale. E 'possibile l'utilizzo del link orizzontale mettendo un trattino singolo (o punto) es:  -> -|> .> invece di --> --|> ..> 2) direzione forzata delle freccieE 'anche possibile cambiare la direzione della freccia con l'aggiunta di sinistra, destra, su o giù parole chiave all'interno della freccia::attore: -left-> (attività) :attore: -right-> (attività) :attore: -up-> (attività) :attore: -down-> (attività) 3) Direzione del graficoE' possibile decidere la direzione del flusso contop to bottom direction (dall'alto verso il basso)left to right direction (da sinistra a destra)

Sequence DiagramDefinizione:

Un Sequence Diagram (in italiano: Diagramma di sequenza) è un diagramma previsto dall'UML utilizzato per descrivere uno scenario.

Uno scenario è una determinata sequenza di azioni in cui tutte le scelte sono state già effettuate; in pratica nel diagramma non compaiono scelte, né flussi alternativi.Normalmente da ogni Activity Diagram sono derivati uno o più Sequence Diagram; se per esempio l'Activity Diagram descrive due flussi di azioni alternativi, se ne potrebbero ricavare due scenari, e quindi due Sequence Diagram alternativi.

Dalla versione 2 dell'UML è stata introdotta la possibilità di indicare nello stesso diagramma anche delle sequenze alternative.

Il Sequence Diagram descrive le relazioni che intercorrono, in termini di messaggi, tra Attori, Oggetti di business, Oggetti od Entità del sistema che si sta rappresentando.

Sequence Diagram: com’è fatto

Esempio

Un classico e semplice esempio grafico di Use Sequence Diagram

Vediamo come realizzarlo con Plant UML

Sequence Diagram - 1 di 2comando risultato

actor TJ genera un attore (TJ) va dichiarato prima

"Oggetto 1" -> "Oggetto 2": descrizione genera due oggetti legati da freccia con descrizione

"Oggetto 2" -> "Oggetto 1": ritorno genera due oggetti legati da freccia con descrizione

"Oggetto 1" --> "Oggetto 3()": descrizione genera due oggetti legati da freccia tratteggiata con descrizione

 "Oggetto 3()" --> "Oggetto 3()" un'attivtà che richiama se stessa

activate "Oggetto 2"/deactivate "Oggetto 2" Attiva, disattiva

Sequence Diagram - 2 di 2Sorgente Plant UML Grafico Generato

Activity DiagramDefinizione:

L'Activity Diagram (in italiano: Diagramma delle attività) è un diagramma definito all'interno dello Unified Modeling Language (UML) che definisce le attività da svolgere per realizzare una data funzionalità.

Può essere utilizzato durante la progettazione del software per dettagliare un determinato algoritmo. Più in dettaglio, un activity diagram definisce una serie di attività o flusso, anche in termini di relazioni tra le attività, i responsabili per le singole attività e i punti di decisione.

L'activity diagram è spesso usato come modello complementare allo Use Case Diagram, per descrivere le dinamiche con cui si sviluppano i diversi use case.

Activity Diagram: com’è fatto

Esempio

Un classico e semplice esempio grafico di Use Activity Diagram

Vediamo come realizzarlo con Plant UML

Activity Diagram - 1 di 2comando risultato

(*) genera il dot iniziale/finale

--> freccia di collegamento

-->[label] freccia di collegamento con label

-down-> freccia di collegamento (default) verso il basso

-right-> freccia di collegamento verso destra

-left-> freccia di collegamento verso sinistra

-up-> freccia di collegamento verso l'alto

(*) --> "Attività 1" genera il dot iniziale con la prima attività

-->[label] "Atttività 2" Collega con una freccia (con una label) alla seconda attività

 if "Attività 3" then -->[true] "Attività 4"else-->[false] "Attività 5"--> (*)endif 

Genera gli IF (rombo) della sintassi (if, then, else, endif)

--> ===B1=== --> "Attività parallela 1" --> ===B2=== ===B1=== --> "Attività parallela 2" --> ===B2===

crea attività parallele  

Activity Diagram - 2 di 2Sorgente Plant UML Grafico Generato

"Il successo non è definitivo e l'insuccesso non è fatale. L'unica cosa che conta davvero è il coraggio di continuare" Winston Churchill

Grazie :-)