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-Modal
- 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-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
| 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-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)