A Component or Reference might have many Fields, but they are both a part of the workspace’s model and belong to a component or reference type.
You may want to add important pieces of information that are searchable or filtered as custom fields. For example, for a server, you would add an IP-address. For an application, you would probably add a Maintainer or system owner.
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.
All components have some standard Fields, such as "type" and "last modified." When you are editing a component or reference, you can easily add additional fields. You can do this by clicking the “Add Field” button within the field area in the Pages View. This will add the Field to all components or references of that type.
You can manage and edit fields from the main menu. Here you can create, edit and delete fields:
Click the Menu on the top right of the screen.
Under “Workspace”, you will find “Manage Fields.”
You can also edit or add new fields while editing a component or reference. Right-click the object and click “Edit properties” to bring up the following editor menu:
Edit Field
On the Manage Fields screen, you can edit or delete existing fields, or add new ones:
Field Types
A field can be of different data types:
Text
Number
Email
URL
Text Paragraph
Date Time
Checkbox
List
Select Multiple List
User
URL
Brief description of each field type
Text: a field that stores alphanumeric characters of variable length.
Number: a field that stores numerical values.
Email: a field that stores email addresses.
URL: a field that stores web addresses.
Text Paragraph: a field that stores longer pieces of text, often used for notes or descriptions.
Date Time: a field that stores dates and times in a specific format.
Checkbox: a field that stores true or false values, often used for checklists or to indicate completion of a task.
List: a field that allows users to select from a predefined list of options.
Select Multiple List: a field that allows users to select multiple options from a predefined list.
User: a field that references a user within the Ardoq platform.
URL: a field that stores web addresses.
Number Field Formatting
Number fields are displayed according to the user's selected locale. In addition, the number field can either be formatted as a plain number or as a currency. When creating or editing a number field, there is a drop-down where the formatting can be defined.
Visualizations Adjusted By Field Values
Fields that use numerical values can change the visualizations, such as the Treemap. Click the “By custom field” and select the field from the drop-down menu. Your visualization will then automatically be recalculated according to represent the field you selected.
For fields that apply to both the parent and the child, the visualization will present the accumulated value:
FAQ
Is there any reserved field type?
Yes, Ardoq has a reserved field type that cannot be changed. Some of them are listed in table below for your reference:
description | isPublic
icon |
If you still have questions or need more information, browse our Knowledge Base or reach out to us from our website or using in-app chat.