Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: new pictures

...

Upon logging in, the dashboard and widgets are displayed. From here you can start to explore the IT documentation. Almost all functionalities of i-doit can be accessed from the main navigation bar (the black bar at the top).

Image RemovedImage Added

For better orientation you can take a look at the bread crumb navigation. From here you can access pages which are higher in the hierarchy.

Image RemovedImage Added

Groups, Types and Categorizations

Object type groups comprise object types which instantiate objects, which in turn inherit categories, which then include attributes. Got it? Again from the start:

 


Object Type Group

It is not uncommon that a lot of object types are in use in a living and well-maintained IT documentation. Object types of the same kind can be grouped in order to have a clear overview of this abundance of data. These object type groups appear in the main navigation bar (top section) of i-doit.

Image RemovedImage Added

In our example, we take a closer look at the object type group Hardware.

Image RemovedImage Added

Object Type

We refer to the combination of all objects of the same type as object type. Examples are Router, Server or Applications. Usually, this combination is also called a "Class". In ITIL© the term "CI Type" is used.

...

An object list exists for each object type. All objects that are associated with the selected object type are listed here, including some attributes. As an example we take a look at the object list for the object type "Virtual host".

Image RemovedImage Added

Object

You have to decide for each artefact to be documented as what you want to save it. For example, often a single server is seen as a product consisting of multiple parts. In this case, a server is created as an object in i-doit. In i-doit are all things we document in an IT documentation objects. It is of no importance if it is a physical device, like a server or client, or if it is a logical construct, such as a network or a service. An object is defined by its object type, which in turn determines what attributes can be filled with values for the object. In ITIL© the term "Configuration item (CI)" is used, whereas the term "Asset Value" is common in the asset management. We want to establish a more abstract and a more general and flexible definition by using the "Object" term.

...

Each object in i-doit receives a title. The title is documented as an attribute in the "General" category. This attribute is synonymously also called "Name" or "Object link".

Image RemovedImage Added

In this example, we focus on the object with the object title ESX1. You can get there with a click on the object link in the object list (as mentioned above).

...

Categories are displayed in the left navigation tree in the object view.

Image RemovedImage Added

The static categories are listed as icons above the left navigation tree.

Image RemovedImage Added

Usually, a category has two views: one for reading and one for editing. In order to edit the attributes in a category the Edit button in the action bar can be clicked.

Image RemovedImage Added

For our example we take a closer look at the Model category.

Image RemovedImage Added

Categories are assigned to object types, not to objects. Within an object type all objects have the same categories assigned to them.

...

The overview page is displayed on the selection of an object in the web GUI of i-doit. It consists of the General category and more optional categories which are assigned to the object type. These can be selected or deselected and also be sorted in the object type configuration.

Image RemovedImage Added

General Category

The General category belongs to those categories which are fixed components of each object. Therefore you cannot deselect it per object type. Important attributes, such as the object title, SYS-ID and the CMDB state and condition, can be found there.

Image RemovedImage Added

Global Category

...

An attribute is a documented value belonging to an object. Attributes of the same type are combined in i-doit. Example: The Serial number attribute in the Model category.

Image RemovedImage Added

Important attributes of different categories are combined to one view, which is shown above each category. These primary attributes are SYS-ID, Purpose (both in the General category), Relationship, Location, Contact assignment and Primary access URL (Access category). Additionally, a QR code which contains the link to the overview page is shown next to them.

Image RemovedImage Added

Attribute Field

Attributes of objects are saved and edited via form fields in the web GUI of i-doit. Hence these fields are called attribute fields. They can vary: There are single-line and multi-line text fields, date fields, HTML editors, object browsers, dialogue-plus fields and many more.

Image RemovedImage Added

Relationships

IT components can not only be documented individually, but they can also be put in relation to each other. There are already various pre-configured types of relationships which can be adjusted and modified. Each relationship is a separate object (with no need for a license) which is automatically created, edited or deleted.