Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Review
Div

...

style

...

width: 30%; float: right;
idtoc
Panel
titleContents

Table of Contents
outlinetrue
stylenone
printablefalse

Now that we you are familiar with the structure of the IT documentation we will let's take a more detailed closer look at the attribute fields which are available in the i-doit web provides in the Web GUI.

Overview

Each attribute that which can be edited is represented by a form field. This applies both to default categories as well as to the standard categories and the custom categories. Almost all every attribute fields field can be declared as mandatory fields field and/or be configured to have assigned with validation options.

 Image Added

Image Removed

 

Attributes that cannot Attributes which can't be edited either do not have an no attribute field in the edit editing view or they only have one a field with the a read-only option.

An example for a dynamically created attribute an attribute which was created dynamically without an attribute field is the FQDN in the Host Addressaddress category. The FQDN consists is comprised of the attributes Hostname Host name and DNS Domain.

 

Image RemovedImage Added

An example for a read-only attribute field is the Object ID which is generated automatically by MySQL/MariaDB.

 Image Added

Image Removed

Single-line Text Fields

Text fields consisting of a single line can be used for all kinds of textsYou can enter any desired text in single-line text fields. The character limit length is around limited to 255 symbolscharacters. An example is the Serial the serial number in the Model Modell category.

 Image Added

Image Removed

 

HTML

...

Editor/ Multiline Text Fields

Text fields consisting of multiple lines can have any kind of text in multiple Multiline text fields can contain any desired text in several lines. The character limit length is set limited to around approximately 65000 symbols. It's possible to switch from characters. From a simple text field you can switch to a an HTML - editor in order to format the your text. This happens at

You can switch to the editor by selecting Administration → System settings Settings → User interface → WYSIWYG Editor in Categories. "WYSIWYG" stands for means "What You See Is What You Get".

The HTML-editor possesses further Editor also has other formatting options which you can be activated at activate via Administration System settings Settings → User interface → Activate all WYSIWYG Editor Functionsfunctions.

Almost all every category entries possess entry has the description Description attribute at the end , which is displayed as a standard presented as HTML - editor by default.

 

Image Removed

 

...

Image Added

Dialog Field (Drop Down)

The dialogue This dialog field is a drop-down selection field (drop down). The values that can be selected in this field from which you can choose one single value are pre-defined set and can generally not be altered. If no value is to be selected, usually you can't edit them. If you don't want to select any of the given values, you can choose the dash (-) can be selected instead , if possible.

The In our example you can see the Condition in the General category General serves as an example.

 

Image Removed

 Image Added

An example for an attribute which may can be edited centrally is the CMDB -Statusstatus in the General category.

Dialog

...

Plus

...

Field (

...

Extended Drop Down)

The dialog - plus field is similar to the dialogue dialog field. Furthermore, additional values can be defined. To do so either In addition, you can set further values. For this purpose, you can either use the icon to the right of the attribute field or the Dialog-Admin can be used. The .

Examples are the attributes Category and Purpose in the General category are examples for this.

 

Image Removed

 

Clicking Image Added

When you click on the icon opens , the List browser via which additional values can be added and existing ones can be edited.

Image Removed

 

opens with which you can add further values or change existing values.

Image Added

Deleting is only possible
Info
titleNote
Please note

You can only delete data via the Dialog-Admin.

This function should be used exclusively by administrators, since all field values will be irreversibly removed

Only administrators should use this function as removed field values are deleted irrevocably from all entries.

Multi-Dialog-Plus

...

Field (Multiselection)

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 You can only select one value with the above mentioned selection fields. But if you want to select more values at the same time, you can use the multi-dialog-plus field. You can add further values with help of a drop-down menu. In some cases there are additional buttons for (de-)selecting with which you can select/ deselect all values or for inverting the reverse your selection.

An The example for this is illustrates the DNS domainDomain attribute in the Host address category.

 Image Added

Image Removed

 

Date Field

Clicking You can use the date field for date entries. When you click on the single-line text field will open , a calendar opens. If you With a click on the desired date, the date it is transferred to copied into the text field. As an alternative you can use You can also enter the date manually in the format yyyytt.mm.dd for entering the date manuallyyyyy.

The Accounting category contains the example attribute Date of purchase.

 

Image Removed

 

Our example shows the Date of Purchase attribute in the Acccounting category.

Image Added

Units and Intervals

A Beside the attribute fields there is a drop-down field for setting units and intervals exists next to suitable attribute fields. These with which you can determine values in order to document units or intervals. These values can be time units, measuring measurement units, weight units, time frames and so on.

The Warranty period in the Accounting category is an example for this.

 

Image Removed

 periods etc.

As an example you can see the  Period of warranty in the Acccounting category.

Image Added

Costs

Costs are documented as decimal numbers (or simplified as real numbers without decimal placesdigits). Dots You may use decimal points and commas can be used as separators for the decimal places. The attribute field also as separation characters. Additionally, the attribute field shows the configured currency. This is determined at You can determine the currency with Administration → CMDB settings → General configuration settings → Monetary format festgelegt.

An example for this is As an example you can see the Investment costs attribute in the Accounting Acccounting category.

 

Image Removed

 

...

Image Added

Some single-line text fields are intended to have URIs in them. A link will be generated from this, for entering URLs. Such an entry is used to generate a link on which the user can then click to get forwardedopen it.

The Access category offers this attribute field for example.

 

Image Removed

 

Object-Relations

In order to For example, you can find this kind of attribute field in the Access category.

Image Added

Object Relationships

To create a relationship between two or more objects , you can use the object browser is used for most cases. An additional browsers is used for some special casesgeneral cases; for special cases there are other browsers. The single-line text field is complemented supplemented by two icons on to the right side.

The text field is writable if a 1When you can create a one-to-1 one relationship can be established between two objects. While typing suggestions are already being shown. The , you can write into the text field. Word suggestions are made during typing. When you can create a one-to-n relationsship, the text field is in the read-only mode if a 1-to-n relationship can be established.

Clicking With a click on the magnifier - icon opens the corresponding right browser opens. The icon next to it (a icon beside the magnifier icon, a paper clip with a blocking signal) detaches , dissolves existing or recently selected relationsrelationships.

 Image Added

Image Removed

 

Object

...

Browser

The object - browser is built in a way which depends has a unique setup, depending on which kind of relationship type is going to be documented. Hence For this reason, not all functions described here which are described in the follwoing text are available in at all casestimes. The Often the selection of filters if often limited as is restricted, because, for example, you are only allowed to choose objects of particular certain object types may be selected.

A single selection is the only possibility ff the selection of the object that is to be referenced is done via radio buttons. If the Image Removed-buttons are available however, multiple selections are When you select the referenced object via radio buttons, you can only make a single choice. But if the Image Added add buttons are available, multiple choice is possible.

There are multiple several tabs in the upper areapart of the window:

  • Object viewView: The object view is sorted by filters. If the matching right object is missing it can be created via , you can create it with the Create new object button. Filters:
    • by object type: Choose First you select the object type first, then the object /sor objects.
    • by object groups: All If you use the object type object-group, objects can be listed per object-group if the object type object-group is used.
    • by person groups: All persons per person group are listed.
    • by relations: The kind of relation has to be selected first, then all All relationship objects are listed, whereby you initially have to choose the type of relationship.
    • by date: Objects are sorted by date. The You have the following options are: newly created, newly updated, created this month, created last month.
  • Location view: The location in the tree with all its paths is displayed from which the matching object can be selectedcreated, from here you can select the right object.
  • Search: Here the objects can be searched via the object titleyou can search for objects by means of object titles.
  • Reports: Objects are listed utilizing with help of already created reports.
  • Selected objects: The In this tab all selected objects that are already selected are shown in this tabare displayed. Via the button Create a new object-group from selection button you can create an object of the type object - group which is created and is then filled with the selected your selection of objects.

All current changes modifications are listed in the Loglog.

An example is the Contact browser which is available for As an example you can see the Contact Browser from the Accounting category with the Purchased at attribute in the Accounting category.

 

Image Removed

 Image Added

Location Selection

This browser establishes builds a 1one-to-1 relation one relationship of the type Location to with an object which is defined as a location. The With a click on the magnifying glass, the Location selection is displayed when clicking the magnifier icon. This looks activated. It is similar to the Location view (see above). This The browser appears can be found in the Location  category. 

Image Added

Image Removed

 

Image Removed

 

Image Added

Browser with

...

Subselection

Sometimes it's necessary you not only have to select the object but also an attribute of this object. Examples for this are the attributes Connected with attribute in the Port (Network) category . There where you have to choose an input or output is selected from of the Connection Connectors (CablingWiring)category and the possibility to select chose software relations in the Service componentsComponents category.

 

Image Removed

 

...

titleNote

...

Image Added

When the browser is

...

divided and therefore has a subselection and radio buttons, you have to make a selection in both columns. Take for example the wiring of two devices: if you select only the connected object but not the corresponding

...

connection in the object browser

...

, your entry won't be the saved.