System Design troubleshooting
Resolve source, reference, layout, saving, and version problems.
AAL System Design 0.2 · Dictionary 0.2.0
Common errors and recovery
Find the symptom, check its likely cause, and make the smallest repair. Keep your source and unsaved work while you investigate.
Common errors and recovery
| Symptom | Likely cause | Recovery |
|---|---|---|
| Unknown element type | The type ID or dictionary version does not match. | Search the dictionary for the exact type ID and check the version. |
| Duplicate ID | Two declarations use the same identity. | Give the new object a unique ID and update its intended references. |
| Invalid properties | A field has the wrong type or malformed JSON. | Correct the typed field or JSON object indicated by Inspector. |
| Canvas does not match invalid source | The canvas retains the last valid model. | Repair the reported diagnostics; check that the canvas updates. |
| Lines overlap | Their paths need adjustment. | Select a connector and adjust its route. Dragging a label only moves text. |
| Route changed after Auto Layout | Auto Layout resets manual bends. | Undo restores the previous positions and routes. |
| Response or telemetry is missing | It may be hidden. | Check View visibility before recreating relations. |
| Save is unavailable or fails | The destination or operation reported a problem. | Inspect location status and the error. Keep unsaved work, retry when resolved, or export a project backup. |
Artwork and language boundaries
Resource definitions link to catalog sources and usage information. Generic artwork identifies a category when official artwork is unavailable.
Use the right reference
- System Design examples describe architecture; they are not deployable cloud configuration.
- Use C4 documentation for C4 authoring and this guide for System Design.
- Shared canvas gestures work consistently, while domain fields, references, and validation remain specific to each capability.