Network Diagrams
Network diagrams are interactive diagram canvases scoped to a site and linked to assets on the canvas.
What a diagram is linked to
Section titled “What a diagram is linked to”| Link | Meaning |
|---|---|
| Site | Required scope (site_id). Drives hierarchy import, entity picker filters, and asset validation on save. |
| Assets | Derived from inventory nodes linked to CMDB assets; stored in diagram_asset_links when you save the canvas. |
| Inventory nodes | Site, zone, VLAN, and asset nodes on the canvas reference ITSM records via itsm_ref in diagram data. |
| Edges | Visual connections only (stored in diagram JSON). |
Diagrams are not linked to changes (change records), incidents, problems, or maintenance windows at the database level.
Routes
Section titled “Routes”/diagrams— list/diagrams/:id— editor and viewer
- Open a diagram and set Site, Name, and Description in the properties panel when nothing is selected on the canvas (fields save automatically).
- Add nodes from the palette or Import hierarchy from the diagram site.
- Connect nodes on the canvas; drag the dots at each end of a connection to reconnect it to another node.
- Double-click a connection to edit its label on the canvas. Use the Connection panel for line type, color, width, dashed style, and arrow.
- Save writes the full diagram (nodes and edges). Optional Auto-save (30s) persists the canvas every 30 seconds when there are changes and no unlinked inventory nodes.
- The Status section shows unsaved canvas changes, auto-save activity, unlinked inventory nodes, and linked asset count.
Requires module.diagrams.
Manual test checklist
Section titled “Manual test checklist”- Open diagram → no failed PATCH with empty
site_id; site select stays enabled. - Change site → PATCH with UUID; settings save without blocking the dropdown.
- Edit name/description → auto-save within ~500 ms.
- Double-click an edge → inline label editor; Enter/blur saves, Escape cancels.
- Drag edge endpoint handles → reconnect to another node; undo restores prior connection.
- Connection panel: change type, color, width, dashed, arrow without Apply.
- Enable auto-save → after canvas edits, within 30 s canvas persists; skipped when inventory nodes are unlinked.
- Save still prompts when unlinked inventory nodes exist.