Skip to content

Benutzerdefinierte Felder

Benutzerdefinierte Felder (Custom Fields) erweitern die Host-Informationen um individuelle Datenfelder. Sie koennen fuer jedes Modul eigene Felder definieren.

Konzept

Custom Fields ergaenzen die Standard-Host-Daten um zusaetzliche Informationen, die in Ihrer Organisation relevant sind, z.B.:

  • Standort-Informationen
  • Vertrags- oder SLA-Daten
  • Interne Referenznummern
  • Technische Notizen

Felder verwalten

Die Verwaltung erreichen Sie ueber Einstellungen > Benutzerdefinierte Felder.

Feld erstellen

  1. Klicken Sie auf Feld hinzufuegen
  2. Konfigurieren Sie das Feld:
FeldBeschreibung
NameInterner Feldname (keine Leerzeichen, eindeutig)
AnzeigenameLabel in der Oberflaeche
BeschreibungHilfetext fuer das Feld
TypDatentyp des Feldes (siehe unten)
ModuleFuer welche Module das Feld verfuegbar ist
GeltungsbereichHost, Gruppe oder Modul (siehe unten)
PflichtfeldMuss das Feld ausgefuellt werden?
StandardwertVorausgefuellter Wert bei neuen Eintraegen
In UI ausblendenFeld in der Uebersicht ausblenden
In Zusammenfassung ausblendenFeld in der Kurzansicht ausblenden
SortierungReihenfolge der Felder in der Anzeige

Feldtypen

TypBeschreibungBeispiel
textEinzeiliges TextfeldStandort, Raumnummer
numberNumerischer WertVertragsnummer, Port
dropdown_singleEinzelauswahl-DropdownSLA-Level (Gold/Silber/Bronze)
dropdown_multipleMehrfachauswahl-DropdownTags, Kategorien
datetimeDatum und UhrzeitWartungstermin, Vertragsende
checkboxJa/Nein-SchalterProduktivsystem, VPN aktiv

Bei den Typen dropdown_single und dropdown_multiple koennen Sie die Auswahloptionen definieren:

  1. Geben Sie die Optionen als Liste ein
  2. Beispiel: Gold, Silber, Bronze

Geltungsbereich (Scope)

ScopeBeschreibung
hostFeld wird pro Host gespeichert (Standard)
groupFeld wird pro Host-Gruppe gespeichert
moduleFeld wird modulweit gespeichert

Felder befuellen

Im Detail-Modal

  1. Oeffnen Sie einen Host
  2. In der Uebersicht werden die Custom Fields angezeigt
  3. Klicken Sie auf den Wert, um ihn zu bearbeiten (Inline-Edit)
  4. Druecken Sie Enter zum Speichern

Beim Host-Erstellen

Wenn ein Feld als Pflichtfeld markiert ist, muss es beim Erstellen eines neuen Hosts ausgefuellt werden.

Anzeige

In der Host-Tabelle

Felder mit aktivierter Option In Tabelle anzeigen erscheinen als zusaetzliche Spalten in der Host-Tabelle des jeweiligen Moduls.

Im Detail-Modal

Alle Custom Fields eines Hosts werden im Uebersichts-Tab des Detail-Modals angezeigt.

In Berichten

Custom Fields stehen als Variablen in Report-Vorlagen zur Verfuegung und koennen in Berichte eingebunden werden.

Modul-Zuweisung

Felder koennen fuer bestimmte Module oder alle Module gleichzeitig konfiguriert werden:

  • Alle - Feld erscheint in allen Modulen
  • OPNsense - Nur im OPNsense-Modul
  • Proxmox VE - Nur im PVE-Modul
  • Proxmox PBS - Nur im PBS-Modul
  • Linux - Nur im Linux-Modul
  • Windows - Nur im Windows-Modul

Sichtbarkeit

OptionBeschreibung
In UI ausblenden (hide_in_ui)Feld wird in der normalen Uebersicht nicht angezeigt, ist aber ueber die API verfuegbar. Nuetzlich fuer technische Felder, die nur von Scripts/Checks befuellt werden.
In Zusammenfassung ausblenden (hide_in_summary)Feld wird in der Kurzuebersicht (z.B. Tooltip) nicht angezeigt, erscheint aber im Detail-Modal.

Automatische Befuellung

Custom Fields koennen nicht nur manuell, sondern auch automatisch durch Health-Checks befuellt werden. Siehe Health-Checks > Custom Field Mappings.

Praxisbeispiele

IT-Dienstleister

Feld: sla_level (Select: Gold, Silber, Bronze)
Feld: contract_end (Date)
Feld: contact_person (Text)
Feld: location (Text)

Internes IT-Team

Feld: department (Select: Entwicklung, Marketing, Vertrieb, IT)
Feld: cost_center (Text)
Feld: is_production (Boolean)
Feld: notes (Textarea)

DATAZONE Control Documentation