Neben den Standard-Kategorien in i-doit können eigene (benutzerdefinierte) Kategorien erstellt werden, um zusätzliche Attribute zu dokumentieren, die in den Standard-Kategorien nicht enthalten sind.
Konfiguration der Kategorie
Die Konfiguration der benutzerdefinierten Kategorien ist unter Verwaltung
→ CMDB Einstellungen
→ Benutzerdefinierte Kategorien
zu finden.Über den Button Neu
wird eine benutzerdefinierte Kategorie erzeugt. Existieren bereits benutzerdefinierte Kategorien, können diese nachträglich bearbeitet werden.
Im ersten Schritt ist es notwendig, die Kategorie mit einem eindeutigen Namen zu bezeichnen, damit sie in der Kategorie-Liste identifiziert werden kann.
Weiterhin muss die Kategorie mit einem oder mehreren Objekttypen verknüpft werden, damit diese genutzt werden kann.
Danach muss festgelegt werden, ob es sich um eine Single- oder Multi-Value-Kategorie (Listen-Kategorie) handeln soll. Wenn Attribute gepflegt werden soll, die in ihrer Kombination eindeutig sind, ist die Konfiguration als Single-Value-Kategorie ausreichend. Sollen jedoch die Werte mehrfach gepflegt werden, so ist eine Multi-Value-Kategorie die richtige Wahl. Auf diese Weise ist es möglich, mehrfache Einträge in einer Kategorie zu speichern.
Um auf die Kategorie bei Abfragen (zum Beispiel in selbst geschriebenen Reports) zugreifen zu können, sollte außerdem eine Konstante hinterlegt werden. Diese Konstante wird beim Erstellen der Kategorie automatisch vorgeschlagen und darf geändert werden.
Ausprägung der Kategorie
Um eine Kategorie auszuprägen, können beliebig viele Attribute über den Button Mehrere Felder hinzufügen
hinzugefügt werden. Hier stehen folgende Feldtypen zur Auswahl:
Checkbox
Eine Checkbox die markiert werden kannDateibrowser
Eine Datei referenzierenDatum und Uhrzeit
Ein Feld zum Eintragen eines Datums und/oder einer Uhrzeit; innerhalb der Kategorie steht hier ein Kalender zur Verfügung, mit dem die Auswahl ermöglicht wird.Dialog+
Dialog-Plus-Felder, die mit eigenen Werten befüllt werden können, sodass diese wiederverwendbar sind. Über den Identifier im FeldZusatz
kann das Dialog-Plus-Feld auch in anderen Kategorien genutzt werden, sodass dort die bereits eingetragenen Werte zur Verfügung stehen. Hierfür ist es notwendig, denselben Identifier in beiden Kategorien einzutragen.Dialog+ (Mehrfachauswahl)
WieDialog+
, nur mit beliebig vielen WertenHTML-Editor
Ein Textfeld, das einfache Textformatierungen wie zum Beispiel kursive Schrift erlaubtJa-Nein-Feld
Eine einfache Ja-oder-Nein-AuswahlLink
Ein Feld zur Angabe eines Hyperlinks, der innerhalb der Kategorie angeklickt werden kann und dort weiterleitetNur Zahlen sind erlaubt
Ein Feld in dem nur Zahlen eingetragen werden können.Objekt-Beziehung
Bei der Verwendung einer Objektbeziehung wird eine vollwertige Beziehung erzeugt. Das FeldZusatz
erlaubt die Auswahl der Beziehungsart und den damit verbundenen Beziehungstext. Diese Beziehungen sind auch im CMDB Explorer aufzufinden. Wenn möglich, ist dieser Feldtyp dem oben genannten Objekt-Browser zu bevorzugen.Objekt-Beziehung (Mehrere Objekte)
WieObjekt-Beziehung
, nur mit beliebig vielen ObjektenObjekt-Browser
Ein Feld zur Erzeugung einer Verknüpfung mit einem anderen Objekt. Hierbei handelt es sich nur um eine Referenzierung und nicht um eine vollwertige Beziehung. Eine solche Referenzierung wird daher nicht im CMDB Explorer erscheinen.Objekt-Browser (Mehrere Objekte)
WieObjekt-Browser
, nur mit beliebig vielen ObjektenReport
Zeigt einen Report an, dazu muss die ID des Report in das Zusatz Feld eingetragen werden.Textfeld
Ein einzeiliges Textfeld zur Eingabe von FreitextTextfeld (maskiert)
Ein einzeiliges Textfeld zur Eingabe von maskiertem Freitext. Der Inhalt ist nur in der Datenbank sichtbar.Textfeld (Mehrzeilig)
In diesem mehrzeiligen Textfeld können längere Texte hinterlegt werden.Datum und Uhrzeit
Ein Feld für Datum oder für Datum + UhrzeitZeit
Hier kann eine Uhrzeit zwischen 00:00 und 23:59 angegeben werden
Zusätzlich sind folgende Elemente verfügbar:
Horizontale Linie
Eine Linie zur optischen Abgrenzung von Feldern und InhaltenHTML
Die Möglichkeit in der Konfiguration der Kategorie HTML-Code zu hinterlegen, der in der Kategorie interpretiert wird. Der Quellcode wird in der Konfiguration der Kategorie eingetragen und kann nicht beim Aufruf der Kategorie in der Dokumentation durch die Anwender eingetragen werden.Javascript
Die Möglichkeit in der Konfiguration der Kategorie Javascript-Code zu hinterlegen, der in der Kategorie interpretiert wird. Der Quellcode wird in der Konfiguration der Kategorie eingetragen und kann nicht beim Aufruf der Kategorie in der Dokumentation durch die Anwender eingetragen werden.
Wie bei fast jeder anderen Kategorie wird bei einer benutzerdefinierten automatisch ein Beschreibungsfeld
am Ende angehangen.
Die Reihenfolge der erstellten Attribute kann über die schraffierten Flächen am Anfang jeder Zeile per Drag'n'Drop verändert werden.
Über den Button Entfernen
können Attribute gelöscht werden.
Achtung!
Sobald die Kategorie in Verwendung ist, ist das Ändern von bestehenden Feldtypen nicht mehr möglich, um Datenverlust zu vermeiden.
Sollten Felder in der Konfiguration entfernt werden, kann man auf deren Inhalte nicht mehr zugreifen.
Anschließend müssen die Attribute über die Systemtools neu indiziert werden.
Unterhalb der Konfiguration erfolgt eine Auswertung:
Kategorieeinträge gesamt
: Wie oft wurde die Kategorie gespeichert? Pro Objekt werden die Einträge (bei Single-Value also einmal, bei Multi-Value pro Eintrag) zusammen gerechnet.Gepflegte Werte
: Jedes Attribut, das ausgefüllt und gespeichert wurde, wird Objekt-übergreifend zusammen gezählt.
Sobald deine Kategorie konfiguriert und ausgeprägt wurde, kannst du die Schaltfläche Speichern
verwenden, damit die Kategorie in den ausgewählten Objekttypen zur Verfügung steht.
Technische Konfiguration
Um die benutzerdefinierte Kategorie über die API nutzen zu können, hilft die technische Konfiguration. Diese ist über den Button Technische Konfiguration anzeigen
erreichbar.