Diagrammi dei casi d’uso in Confluence

Un diagramma dei casi d’uso mostra chi usa un sistema e che cosa può farci ciascuno.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma dei casi d’uso all’inizio di un progetto per concordare il perimetro: gli attori fuori dal sistema, gli obiettivi dentro il suo confine, e quali obiettivi ne includono o estendono altri. Dice che cosa fa il sistema, non come.

Esempio

Questo è il codice del modello Online banking: attori, casi d’uso e relazioni include/extend dentro il confine di un sistema.

usecase-beta
  direction LR
  actor Customer
  actor BackOffice("Back office")
  actor FraudScreening("Fraud screening system")
  systemBoundary "Online banking"
    Login("Log in")
    ViewBalance("View balance")
    MakeTransfer("Make transfer")
    VerifySecondFactor("Verify second factor")
    ScreenTransaction("Screen transaction")
  end
  Customer --> Login
  Customer --> ViewBalance
  Customer --> MakeTransfer
  BackOffice --> ScreenTransaction
  FraudScreening --> ScreenTransaction
  MakeTransfer ..> : include VerifySecondFactor
  ScreenTransaction ..> : extend MakeTransfer

Vellnar Diagrams lo disegna così:

Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.

Aggiungerlo a una pagina di Confluence

  1. Modifica una pagina di Confluence e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
  3. Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
  4. Scegli Save. Il diagramma compare nella pagina.

La documentazione spiega l’editor, le impostazioni e le esportazioni.

Modelli

Il pulsante Templates dell’editor ha un modello pronto per questo tipo:

  • Online banking: Attori, casi d’uso e relazioni include/extend dentro il confine di un sistema.

Sintassi

Il codice inizia con usecase-beta. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.

Altro

  • Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
  • Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.