- 4 minutes to read

Add or manage C4 Diagram Set

Use this administrator guide when you manage C4 Diagram Sets for governance and lifecycle control in Nodinite. A C4 Diagram Set groups the C4 Diagrams for one software system, so how you add, change, and remove each Diagram Set decides how well the architecture story stays connected.

Understanding the Set Lifecycle

flowchart LR Add["fa:fa-square-plus Add Diagram Set
default Roles pre-selected"] --> Edit["fa:fa-pen Edit Set Properties"] Add --> Import["fa:fa-file-import Import"] Import --> Review["fa:fa-list-check Diagram Assistance review"] Edit --> Review Review --> SoftDelete["fa:fa-trash Delete
restorable"] style Add fill:#2678BD,color:#fff style Edit fill:#2678BD,color:#fff style Import fill:#2678BD,color:#fff style Review fill:#93d16d,color:#000 style SoftDelete fill:#FFD525,color:#000

Everyday work (blue) cycles through add, edit, and import, with Diagram Assistance as the quality check (green); Delete (yellow) can be restored, and Permanently Delete (red) is the only irreversible operation. A set can also be permanently deleted while it's live.

Operation Required right Read more
Add Diagram Set Create (global) Permission Set for C4 Diagram Sets
Edit Set Properties Modify (global or per set) Role-Based Access for C4 Diagram Sets
Import Create (global); the Import button is hidden without it. New 7.12 Plus the Repository rights C4 needs Import, Permission Set for C4 Diagram Sets
Navigation between diagrams New 7.12 None: it's inferred when a diagram opens, so there is nothing to sync Navigation Between C4 Diagrams
Delete and Restore New 7.12 Modify; deleted sets show with Include deleted Getting Started: Add or manage C4 Diagram Set

Administrative workflow

  1. Open the set from the C4 Diagram Sets overview.
  2. Edit properties and verify the Roles and Tags; a set has no owner field, access is by its Roles. The edit dialog of the Diagram Set, Edit Diagram Set, has one Tags field; its dropdown opens inside the dialog.
  3. Import or generate diagrams as needed (Generate from Integration Landscape, or C4 Dynamic on a BPM).
  4. Validate set quality using Diagram Assistance (Coverage and Review Impacts).
  5. Delete sets you no longer need; they can be restored. Use Permanently Delete only when retention and governance allow it.

Edit Diagram Set dialog of Contoso Order to Cash with Name, Description, Web Site, one Tags field and Set Mode, and the Roles panel with two Roles (7.12)
The Edit Diagram Set dialog: one Tags field under Web Site, then Set Mode.

Roles on a C4 Diagram Set

The Roles panel of the Diagram Set editor decides which Roles get per-set access. When you create a new C4 Diagram Set, the panel inherits its defaults from the DefaultRolesInViews System Parameter: the Roles listed there are pre-selected. Click Edit to add or remove Roles before saving, and the remove icon on a row to take a Role off the set.

Add the Role Contoso: Operations to the C4 Diagram Set Contoso Order to Cash, allow Modify and deny Access, animated walkthrough (7.12)
Animated walkthrough: add a Role and set its two rights on this set; Deny on Access wins.

  1. In the Roles panel, click Edit, filter the All tab, and tick the Role (Contoso: Operations).
  2. Open the Selected tab. Each Role has two rights on the set: Access (Allow or Deny) and Modify (Allow, Deny, or Inherited). A Role you add starts with Access = Allow and Modify = Inherited.
  3. Set the rights. The Set permit list offers Allow, Deny, and Inherited. Deny on Access greys out Modify: a Role that can't open the set can't change it.
  4. Click Confirm and close, then Save.

Assign Roles to Diagram Set, Selected tab with Administrators and Contoso: Operations, and the Modify Set permit list open with Allow, Deny and Inherited (7.12)
The Set permit list in the Assign Roles to Diagram Set dialog.

The global rights, such as Create, are in the Permission Set for C4 Diagram Sets.

Edit Diagram Set dialog of Contoso Order to Cash with the Roles panel highlighted, listing the built-in Administrators Role (7.12)
The Roles panel shows the number of assigned Roles (#1), each Role's description, and icons for its permissions on this set.

In the Nodinite Web Client, open the sets from Repository → Diagram Sets, and click Add Diagram Set to create a new one. The C4 Diagram Sets link on the Mapify card in the Administration Overview opens the same list (see C4 Diagram Sets Administration Overview).

Scope and Mode

When you set up or edit a set, treat Architecture Scope as the architectural identity of each diagram, and choose Layered Mode or Free Draw intentionally (see Diagram Set Fundamentals). Promoting a Draft diagram to Active archives the previous Active version (Diagram Lifecycle).

Operational recommendation

For the complete user-interface walkthrough with screenshots and command order, use the business-focused guide:

This split keeps administration guidance focused on governance decisions while still reusing the same operational flow. The Repository Model reference for the same lifecycle is Add or manage C4 Diagram Set (Repository Model).

Next Steps