Diagrammi a blocchi in Confluence

Un diagramma a blocchi dispone i blocchi su una griglia che controlli tu, colonna per colonna.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma a blocchi quando la posizione di ogni elemento ha un significato: i livelli di un sistema, le zone di una rete, un rack. Un diagramma di flusso decide la disposizione al posto tuo; un diagramma a blocchi tiene ogni blocco nella colonna e nella riga che gli hai dato.

Esempio

Questo è il codice del modello Layered services: un API gateway, quattro servizi e un event bus su una griglia.

block-beta
  columns 4
  gateway["API gateway"]:4
  space:4
  orders["Orders"] billing["Billing"] inventory["Inventory"] notify["Notifications"]
  space:4
  bus["Event bus"]:4
  gateway --> orders
  gateway --> billing
  gateway --> inventory
  gateway --> notify
  orders --> bus
  billing --> bus
  inventory --> bus
  notify --> bus

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 2 modelli pronti per questo tipo:

  • Layered services: Un API gateway, quattro servizi e un event bus su una griglia.
  • Network zones: Zone pubblica, privata e dati, con il traffico permesso tra loro.

Sintassi

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