Benutzerdefinierte Kategorien#
Benutzerdefinierte Kategorien ermöglichen dir, eigene Kategorien mit individuellen Attributen zu erstellen -- für alle Informationen, die in den Standard-Kategorien von i-doit nicht abgedeckt sind.
Konfiguration der Kategorie#
Du findest die Konfiguration unter Verwaltung → Datenstruktur → Benutzerdefinierte Kategorien. Über den Button Neu erstellst du eine neue Kategorie. Bestehende benutzerdefinierte Kategorien kannst du dort jederzeit nachträglich bearbeiten.
So konfigurierst du eine neue Kategorie Schritt für Schritt:
1. Eindeutigen Namen vergeben
Gib der Kategorie einen eindeutigen Namen, damit du sie in der Kategorie-Liste leicht identifizieren kannst.
2. Objekttypen zuweisen
Verknüpfe die Kategorie mit einem oder mehreren Objekttypen, damit sie dort zur Verfügung steht.
3. Kategorie-Typ festlegen
Wähle zwischen Single-Value- und Multi-Value-Kategorie (Listen-Kategorie). Wenn die Attribute pro Objekt nur einmal gepflegt werden müssen, reicht eine Single-Value-Kategorie. Benötigst du mehrere Einträge pro Objekt (z. B. mehrere Verträge), wähle eine Multi-Value-Kategorie.
4. Konstante hinterlegen
Hinterlege eine Konstante, um die Kategorie in Abfragen (z. B. in selbst geschriebenen Reports) referenzieren zu können. i-doit schlägt beim Erstellen automatisch eine Konstante vor -- du kannst sie bei Bedarf anpassen.
5. Icon auswählen (ab Version 37)
Du kannst ein eigenes Icon für die Kategorie auswählen. Klicke dazu auf Icon ändern und wähle aus der Sammlung oder lade ein eigenes Icon hoch. Maximale Dateigröße: 1024 KB. Erlaubte Formate: apng, avif, gif, jpg, jpeg, jfif, pjpeg, pjp, png, svg und webp.
Ausprägung der Kategorie#
Um deine Kategorie mit Attributen auszuprägen, fügst du über den Button Mehrere Felder hinzufügen beliebig viele Felder hinzu. Folgende Feldtypen stehen zur Auswahl:
| Feld | Beschreibung |
|---|---|
| Checkbox | Eine Checkbox die markiert werden kann. |
| Dateibrowser | Eine Datei referenzieren. |
| Datum 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 Feld Zusatz 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) | Wie Dialog+, nur mit beliebig vielen Werten. |
| HTML-Editor | Ein Textfeld, das einfache Textformatierungen wie zum Beispiel kursive Schrift erlaubt. |
| Ja-Nein-Feld | Eine einfache Ja-oder-Nein-Auswahl. |
| Link | Ein Feld zur Angabe eines Hyperlinks, der innerhalb der Kategorie angeklickt werden kann und dort weiterleitet. |
| Nur 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 Feld Zusatz 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) | Wie Objekt-Beziehung, nur mit beliebig vielen Objekten. |
| Objekt-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) | Wie Objekt-Browser, nur mit beliebig vielen Objekten. |
| Report | Zeigt einen Report an, dazu muss der Report im Feld Zusatz ausgewählt werden. |
| Textfeld | Ein einzeiliges Textfeld zur Eingabe von Freitext |
| Textfeld (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 + Uhrzeit |
| Zeit | Hier kann eine Uhrzeit zwischen 00:00 und 23:59 angegeben werden |
Zusätzlich sind folgende Elemente verfügbar:
| Feld | Beschreibung |
|---|---|
| Horizontale Linie | Eine Linie zur optischen Abgrenzung von Feldern und Inhalten |
| HTML | 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 fügt i-doit automatisch ein Beschreibungsfeld am Ende hinzu.
Die Reihenfolge der erstellten Attribute änderst du über die schraffierten Flächen am Anfang jeder Zeile per Drag'n'Drop.
Über den Button Entfernen löschst du Attribute.
Achtung!
Sobald die Kategorie in Verwendung ist, kannst du bestehende Feldtypen nicht mehr ändern -- um Datenverlust zu vermeiden. Entfernst du Felder aus der Konfiguration, verlierst du den Zugriff auf deren Inhalte. Danach musst du die Attribute über die Systemreparatur und Bereinigung neu indizieren.
Unterhalb der Konfiguration erfolgt eine Auswertung:
| Statistik | Beschreibung |
|---|---|
| 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#
Wenn du die benutzerdefinierte Kategorie über die API nutzen möchtest, benötigst du die technische Konfiguration. Du erreichst sie über den Button Technische Konfiguration anzeigen.
Dort kannst du die technischen Schlüssel für jedes Feld ändern, indem du auf Technischen Schlüssel ändern klickst.
Jetzt kannst du den Schlüssel ändern. i-doit prüft den neuen Wert automatisch, bevor du speichern kannst.
Achtung!
Das Ändern eines Schlüssels löst eine Migration der hinterlegten Daten zum neuen Schlüssel aus. Beachte folgende Regeln:
- Der Schlüssel darf nur die Zeichen a-z, 0-9 und _ enthalten.
- Er muss mindestens einen Buchstaben enthalten.
- Er darf nicht leer und nicht länger als 64 Zeichen sein.
- Er muss einzigartig sein.
Nachdem du die benutzerdefinierte Kategorie gespeichert hast, kannst du die neue technische Konfiguration anzeigen und verwenden.
