Articles in the Integration CMDB
Knowledge base Articles complete Nodinite's integration CMDB by adding the human knowledge layer: the why, how, and who next to the technical architecture the Repository Model already holds.
- ✅ Link Articles to Integrations, Systems, Services, and the other Repository entities with the Articles card
- ✅ Share one Article with every Resource of an Application or Category
- ✅ Read the linked Articles where people work: Monitor Views, the Integration Landscape, and the entity lists
Walkthrough of the Articles card on an Integration from the Order-to-Cash demo: Edit on the card, find the runbook, Use links it at once, and a click in the card opens it to read.
How Articles Fit into the Integration CMDB
While other Repository Model entities document technical architecture (Systems, Services, Endpoints, Message Types), Articles capture:
- Operational procedures - "How to restart this Service when it fails"
- Business context - "Why this Integration exists and which departments depend on it"
- Troubleshooting guides - "Common error patterns and resolution steps"
- Design decisions - "Why we chose this architecture and what alternatives we considered"
- Institutional knowledge - "Contact John in Finance for approval on changes to this Integration"
Nodinite's CMDB isn't just configuration data, it's living documentation combining:
- Auto-populated technical architecture - Systems, Services, Endpoints appear from logged events
- Human-created business context - Articles explain why, how, who, when
- Operational metadata - Custom Metadata on entities provides governance
- Cross-references - Articles link to Integrations and Resources, showing exactly what they document
Documentation lives with the architecture it describes, not scattered across wikis, SharePoint sites, and email threads. When users view an Integration in the Integration Landscape or a Resource in a Monitor View, they see the available Articles without leaving the operational interface.
The Articles Card on Repository Entities
New 7.12
The add and edit pages of Integrations, Systems, Services, Contracts, Domains, Message Types, and Endpoints have an Articles card on the right. It lists the Articles that document the entity, and shows No Articles document this … yet when there are none. Click Edit on the card to choose the Articles that document it, without leaving the page. On an edit page, Use links the Article at once, outside the page's Save. On an add page, the chosen Articles wait until you save the entity (Linked when this Integration is saved.).
The Articles card sits with the other relation cards on the right of the page.
The link works both ways: the Article editor has a card for each of the seven kinds below Resources, so you can also pick the entities from the Article (see Link Repository entities). The reader shows the linked entities in its Relationships panel and Reference Explorer, and right-clicking a Service or Domain in a BPM lists its Articles.
The lists of the same seven entities show a button with the number of Articles on each row. Click it to read an Article in a reader dialog without leaving the list; see Read an Article without leaving the page.
Structured content
Organize your Articles on multiple levels, including Categories and Applications provided by the Monitoring Agents. An Article can also be associated with a single Resource if it's dedicated to a specific purpose.
This diagram illustrates how Articles can be structured and associated with Applications, Categories, Resources, and Tags.
For any given Resource, the total number of associated Articles is visible within the Monitor Views. New 7.12 Click the button to read an Article in a reader dialog on top of the Monitor View, or open it in a new tab; see Read an Article without leaving the page.
Example showing the number of Articles associated with a Resource in a Monitor View.
- Share Articles with Applications: make a single Article shared between all Resources belonging to one or more Applications.
- Share Articles with Categories: make a single Article shared between all Resources belonging to one or more Categories.
- Associate Articles with Selected Resources: make a single Article shared between selected Resources.
- Organize Articles with Tags: Nodinite Tags are unique string values that help users find a specific article as well as related articles. Nodinite comes with no predefined tags; this is your story to tell.
Where can I use the Knowledge Base Articles?
Access Knowledge Base Articles directly or from within Monitor Views when you tie them to Applications, Categories, or Resources. You can also access bound Articles using the Integration Landscape.
Keep article content reusable and connected to the architecture it explains:
- Insert Files from the File Library – reuse approved runbooks, schemas, sample data, and partner documents directly inside an Article from the File Library. The SharedFilePolicy System Parameter sets which file types can be uploaded to the File Library and how Shared File links open
- C4 Article Links – attach an Article to a bound C4 Diagrams node so readers can open the guidance without leaving the architecture view. The C4 article editor that opens from a node supports the full editor feature set (Templates, macros, Document Profiles, and the composite workspace), so a node-linked Article is just as capable as one created from the Articles list.