Keywords: Components, Component types, Grid Editor, context, what is a component
Components are at the core of creating a workspace in Ardoq. We'll take you through them step-by-step, with a little help from our video tutorial. Let's get started!
What Is a Component?
Components are the core data elements in your workspace. A component must be of a type that belongs to a model. For the “Small application model” example, the top-level components can be of type Application. If the application has any child components; they can only be of the type Service:
When a thing is identifiable by a single field value it can be a field; but when that field value itself has dependent field values it needs to be broken out as a separate component connected via a reference. Example: A Server component has a field on it called 'Operating System' e.g Windows, Linux. But when you want to record the support dates of the Operating System, then Operating System needs to be a component in its own right.
Every Workspace has a Metamodel with a certain set of component types. The name, color, shape, or image of these can be changed to reflect the framework or the way your organization understands the architecture.
Each component's description is the main content of a component or just “plain text” via the Rich Text editor. The Rich Text editor is shown in the Pages view by default; you can open the markdown editor from the Top Bar and watch your edits appear in real-time in the Pages view.
How to Create Components
The Grid Editor is the easiest way to enter data manually, including creating new Components. Open the Grid Editor by clicking the bar at the bottom of the screen. You can also pop out the Grid Editor in its own window by clicking on the pop-out button to the right:
Click in the name field and start typing. Hitting the Enter key saves the new Component and moves you down to the next row where you can continue typing. Check out the article on the Grid Editor to learn all the details.
Remember that everything in Ardoq is context-sensitive, so what you are creating is always based on the chosen component. If you want to create a component, then select the workspace for that component type.
If you want to create a child of a component, then select that component.
This hopefully helps you get started. If you still feel stuck or need more information, reach out to us via our website or by using the in-app chat.