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-Panel ​

  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-Panel ​

Alle Custom Fields eines Hosts werden im Uebersichts-Tab des Detail-Panels 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-Panel.

Automatische Befuellung ​

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

Werte aus Scripts (ab v3.68.0) ​

Jedes Script (auch ein Check oder ein Job-Script) kann Felder des Rechners setzen, auf dem es laeuft. Dazu gibt es eine Zeile in der Ausgabe aus:

powershell
$key = (Get-BitLockerVolume -MountPoint C:).KeyProtector | Where-Object KeyProtectorType -eq 'RecoveryPassword' | Select-Object -First 1
Write-Output "DZ-FIELD: bitlocker_key=$($key.RecoveryPassword)"
Write-Output "DZ-FIELD: lizenz=$((Get-CimInstance SoftwareLicensingProduct | Where-Object PartialProductKey | Select-Object -First 1).Description)"
bash
echo "DZ-FIELD: ram_slots=$(dmidecode -t memory | grep -c 'Size: [0-9]')"

Regeln:

  • Das Feld muss unter Einstellungen > Custom Fields die Option Scripts duerfen schreiben haben und den Bereich Host. Felder ohne diese Option aendert ein Script nie (ein Agent kann so z. B. kein Vertragsfeld ueberschreiben).
  • Der Name ist der interne Feldname. Das Feld muss fuer das Modul des Rechners gelten (oder fuer alle Module).
  • Der Wert wird zum Feldtyp geprueft: Zahl, Ja/Nein (ja, nein, true, false, 1, 0), Auswahl nur aus den Optionen (bei Mehrfachauswahl mit Komma getrennt), Datum als ISO 8601. Text hoechstens 4000 Zeichen, Steuerzeichen werden entfernt. Hoechstens 50 Felder je Lauf, bei mehreren Zeilen fuer dasselbe Feld gilt die letzte.
  • Im Ergebnis des Laufs steht unter dz_fields, welche Felder gesetzt wurden und welche nicht (unbekannt, nicht freigegeben, ungueltiger Wert).
  • Im Detail-Panel zeigt der Tooltip eines Feldes, wann ein Script es zuletzt gesetzt hat.

Feldtyp Geheim (ab v3.68.0) ​

Fuer Werte wie BitLocker-Wiederherstellungsschluessel gibt es den Typ Geheim (verschluesselt):

  • Der Wert wird verschluesselt gespeichert (Schluessel SCRIPT_VAULT_KEY aus der .env, wie bei geheimen Script-Variablen).
  • Im Detail-Panel steht nur •••••••• mit dem Knopf Anzeigen. Anzeigen duerfen Administratoren und Rollen mit dem Recht Geheime Felder anzeigen (customfields.secrets, Operator hat es). Jedes Anzeigen steht im Audit-Log (reveal_custom_field_secret mit Feld und Rechner). Ueber MCP-Tokens ist der Wert nie abrufbar.
  • In Script-Ausgaben, im Log und in der Live-Ausgabe erscheint der Wert als ********.
  • Geheime Felder stehen in Scripts nicht als Platzhalter zur Verfuegung.
  • Ein Feld mit gespeicherten Werten kann den Typ nicht von oder zu Geheim wechseln. Dafuer ein neues Feld anlegen.

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