Diagrammi a corsie in Confluence

Un diagramma a corsie è un processo diviso in corsie, una per ogni persona o sistema che fa il lavoro.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma a corsie quando i passaggi di mano contano quanto i passi: una contestazione che attraversa cliente, negozio e banca, o un rilascio che attraversa tre team. Ogni passo sta nella corsia di chi lo esegue, quindi ogni freccia che attraversa una corsia è un passaggio di mano.

Esempio

Questo è il codice del modello Chargeback dispute: una contestazione tra titolare della carta, negozio, gateway di pagamento e circuito.

swimlane-beta
  subgraph cardholder [Cardholder]
    dispute([Open dispute])
    outcome([Receive decision])
  end
  subgraph shop [Online shop]
    collect[Collect evidence]
    submit[Send evidence]
    refund[Issue refund]
  end
  subgraph gateway [Payment gateway]
    notify[Notify merchant]
    forward[Forward evidence]
  end
  subgraph network [Card network]
    request[Request evidence]
    decide{Cardholder wins?}
    close[Close dispute]
  end
  dispute --> request
  request --> notify
  notify --> collect
  collect --> submit
  submit --> forward
  forward --> decide
  decide -->|Yes| refund
  decide -->|No| close
  refund --> outcome
  close --> outcome

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:

  • Chargeback dispute: Una contestazione tra titolare della carta, negozio, gateway di pagamento e circuito.

Sintassi

Il codice inizia con swimlane-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.