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
- Klicken Sie auf Feld hinzufuegen
- Konfigurieren Sie das Feld:
| Feld | Beschreibung |
|---|---|
| Name | Interner Feldname (keine Leerzeichen, eindeutig) |
| Anzeigename | Label in der Oberflaeche |
| Beschreibung | Hilfetext fuer das Feld |
| Typ | Datentyp des Feldes (siehe unten) |
| Module | Fuer welche Module das Feld verfuegbar ist |
| Geltungsbereich | Host, Gruppe oder Modul (siehe unten) |
| Pflichtfeld | Muss das Feld ausgefuellt werden? |
| Standardwert | Vorausgefuellter Wert bei neuen Eintraegen |
| In UI ausblenden | Feld in der Uebersicht ausblenden |
| In Zusammenfassung ausblenden | Feld in der Kurzansicht ausblenden |
| Sortierung | Reihenfolge der Felder in der Anzeige |
Feldtypen
| Typ | Beschreibung | Beispiel |
|---|---|---|
| text | Einzeiliges Textfeld | Standort, Raumnummer |
| number | Numerischer Wert | Vertragsnummer, Port |
| dropdown_single | Einzelauswahl-Dropdown | SLA-Level (Gold/Silber/Bronze) |
| dropdown_multiple | Mehrfachauswahl-Dropdown | Tags, Kategorien |
| datetime | Datum und Uhrzeit | Wartungstermin, Vertragsende |
| checkbox | Ja/Nein-Schalter | Produktivsystem, VPN aktiv |
Dropdown-Optionen
Bei den Typen dropdown_single und dropdown_multiple koennen Sie die Auswahloptionen definieren:
- Geben Sie die Optionen als Liste ein
- Beispiel:
Gold, Silber, Bronze
Geltungsbereich (Scope)
| Scope | Beschreibung |
|---|---|
| host | Feld wird pro Host gespeichert (Standard) |
| group | Feld wird pro Host-Gruppe gespeichert |
| module | Feld wird modulweit gespeichert |
Felder befuellen
Im Detail-Panel
- Oeffnen Sie einen Host
- In der Uebersicht werden die Custom Fields angezeigt
- Klicken Sie auf den Wert, um ihn zu bearbeiten (Inline-Edit)
- 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
| Option | Beschreibung |
|---|---|
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:
$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)"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_KEYaus 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_secretmit 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)