Diagrammi di flusso in Confluence
Un diagramma di flusso mostra i passi e le decisioni di un processo, dal primo passo a ogni possibile fine.
Ultimo aggiornamento
Quando usarlo
Usa un diagramma di flusso per una procedura che le persone devono seguire: un’approvazione, un runbook, una pipeline di rilascio, un percorso di onboarding. I rettangoli sono i passi, i rombi sono le decisioni e le frecce danno l’ordine. Se la domanda è “chi parla con chi, e quando”, è più adatto un diagramma di sequenza.
Esempio
Questo è il codice del modello Simple process: una richiesta che viene esaminata, approvata o rifiutata, poi eseguita.
flowchart LR
Start([Request received]) --> Review[Review request]
Review --> Approved{Approved?}
Approved -- Yes --> Do[Do the work]
Approved -- No --> Inform[Inform the requester]
Do --> Done([Done])
Inform --> Done
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
- Modifica una pagina di Confluence e scrivi
/mermaiddove vuoi il diagramma. - Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
- Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
- Scegli Save. Il diagramma compare nella pagina.
La documentazione spiega l’editor, le impostazioni e le esportazioni.
Modelli
Il pulsante Templates dell’editor ha 4 modelli pronti per questo tipo:
- Simple process: Una richiesta che viene esaminata, approvata o rifiutata, poi eseguita.
- Decision tree: Domande sì o no che portano all’azione giusta.
- Deployment pipeline: Build, test, staging e produzione con un controllo manuale.
- User onboarding: Dalla registrazione a un utente attivo, con l’invito facoltativo del team.
Sintassi
Il codice inizia con flowchart. 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.