Now that we are familiar with the structure of the IT documentation we will take a more detailed look at the attribute fields which are available in the i-doit web GUI.
Each attribute that can be edited is represented by a form field. This applies to default categories as well as to custom categories. Almost all attribute fields can be .
An example for a read-only attribute field is the
Object ID which is generated automatically by MySQL/MariaDB.
Single-line Text Fields
Text fields consisting of a single line can be used for all kinds of texts. The character limit is around 255 symbols. An example is the
Serial number in the
HTML-Editor/Multiline Text Fields
Text fields consisting of multiple lines can have any kind of text in multiple lines. The character limit is set to around 65000 symbols. It's possible to switch from a simple text field to a HTML-editor in order to format the text. This happens at
Administration → System settings → User interface → WYSIWYG Editor in Categories. "WYSIWYG" stands for "What You See Is What You Get".
Almost all category entries possess the description attribute at the end, which is displayed as HTML-editor by default.
Dialogue Field (Drop Down)
The dialogue field is a selection field (drop down). The values that can be selected in this field are pre-defined and can generally not be altered. If no value is to be selected, the dash ( - ) can be selected instead if possible.
An example for an attribute which may be edited centrally is the
CMDB-Status in the
Dialog-Plus-Field (expanded Drop Down)
The dialog-plus field is similar to the dialogue field. Furthermore, additional values can be defined. To do so either the icon to the right of the attribute field or the Dialog-Admin can be used. The attributes
Purpose in the
General category are examples for this.
|Deleting is only possible via the Dialog-Admin. This function should be used exclusively by administrators, since all field values will be irreversibly removed from all entries.|
For the attribute fields mentioned above, only one value can be selected in each case. In order to select multiple values the Multi-Dialog-Plus-Field exists. Additional values can be added from a drop-down menu. In some cases there are additional buttons for (de-)selecting all values or for inverting the selection.
An example for this is the
DNS domain attribute in the
Host address category.
Clicking the single-line text field will open a calendar. If you click the desired date it is transferred to the text field. As an alternative you can use the format
yyyy.mm.dd for entering the date manually.
Accounting category contains the example attribute
Date of purchase.
Units and Intervals
A drop-down field for setting units and intervals exists next to suitable attribute fields. These can be time units, measuring units, weight units, time frames and so on.
Warranty period in the
Accounting category is an example for this.
Costs are documented as decimal numbers (or simplified as real numbers without decimal places). Dots and commas can be used as separators for the decimal places. The attribute field also shows the configured currency. This is determined at
Administration → CMDB settings → General configuration → Monetary format.
An example for this is the
Investment costs in the
Some single-line text fields are intended to have URIs in them. A link will be generated from this, which the user can then click to get forwarded.
Access category offers this attribute field for example.
In order to create a relationship between two or more objects, the object browser is used for most cases. An additional browsers is used for some special cases. The single-line text field is complemented by two icons on the right side.
Clicking on the magnifier-icon opens the corresponding browser. The icon next to it (a clip with a blocking signal) detaches existing or selected relations.
The object-browser is built in a way which depends on which kind of relationship is going to be documented. Hence not all functions described here are available in all cases. The selection of filters if often limited as for example only objects of particular object types may be selected.
An example is the
Contact browser which is available for the
Purchased at attribute in the
This browser establishes a 1-to-1 relation of the type
Location to an object which is defined as a . The
Location selection is displayed when clicking the magnifier icon. This looks similar to the
Location view (see above). This browser appears in the
Browser with Sub-Selection
Sometimes it's necessary not only to select the object but also an attribute of this object. Examples for this are the attributes
Connected with in the
Port (Network) category. There an input or output is selected from the
Connection (Cabling) category and the possibility to select software relations in the
Service components category.