Berichte
Das Berichts-System erstellt professionelle Reports basierend auf HTML-Vorlagen. Berichte koennen manuell oder zeitgesteuert generiert und per E-Mail versendet werden.
Konzept
Das Berichtswesen besteht aus drei Ebenen:
- Basis-Vorlagen - Wiederverwendbare HTML/CSS-Grundlayouts
- Report-Vorlagen - Spezifische Berichte mit SQL-Queries und Variablen
- Generierte Berichte - Fertige PDF/HTML-Dokumente
Vorlagen verwalten
Die Vorlagenverwaltung erreichen Sie ueber den Navigationspunkt Reports.
Basis-Vorlagen
Basis-Vorlagen definieren das grundlegende Layout eines Berichts:
- HTML-Struktur (Kopfzeile, Fusszeile, Seitenaufteilung)
- CSS-Styling (Farben, Schriften, Abstände)
- Platzhalter fuer dynamische Inhalte
DATAZONE Control liefert Standard-Basis-Vorlagen mit, die Sie anpassen oder als Ausgangspunkt verwenden koennen.
Report-Vorlagen erstellen
- Klicken Sie auf Vorlage erstellen
- Konfigurieren Sie die Vorlage:
| Feld | Beschreibung |
|---|---|
| Name | Bezeichnung der Vorlage |
| Beschreibung | Zweck des Berichts |
| Basis-Vorlage | Zugrunde liegendes Layout |
| HTML-Template | Report-spezifisches HTML |
| CSS | Zusaetzliche Styles |
| SQL-Queries | Datenabfragen fuer den Bericht |
Template-Editor
Der integrierte Editor bietet:
- Syntax-Highlighting fuer HTML, CSS und SQL
- Zeilennummern
- Live-Vorschau
Variablen
In Templates stehen folgende Variablen zur Verfuegung:
Host-Listen
| Variable | Beschreibung |
|---|---|
| Liste aller OPNsense-Firewalls mit allen Feldern |
| Liste aller PVE-Hosts mit VM/Container-Counts |
| Liste aller PBS-Hosts mit Datastore-Infos |
| Liste aller Linux-Server |
| Liste aller Windows-Server |
Kontext-Variablen
| Variable | Beschreibung |
|---|---|
| Ausgewaehlter Kunde (bei kundenspezifischem Report) |
| Generierungsdatum (ISO-Format) |
| Firmenname (aus Branding-Einstellungen) |
| Firmenlogo als Base64-Bild (aus Branding) |
| Berichtszeitraum (falls konfiguriert) |
Benutzerdefinierte Variablen
Report-Vorlagen koennen eigene Default-Variablen definieren, die bei der Generierung oder im Zeitplan ueberschrieben werden koennen:
| Variable | Beispiel | Beschreibung |
|---|---|---|
| "Firma GmbH" | Filterung auf einen bestimmten Kunden |
| "web*" | Filterung auf bestimmte Hostnamen |
| "warning" | Nur Hosts mit diesem Schweregrad oder hoeher |
Berichte generieren
Manuell
- Waehlen Sie eine Vorlage aus
- Klicken Sie auf Bericht generieren
- Waehlen Sie optional einen Kunden zur Filterung
- Der Bericht wird generiert und kann heruntergeladen werden
Batch-Generierung
Fuer die Erstellung von Berichten fuer alle Kunden gleichzeitig:
- Waehlen Sie eine Vorlage
- Klicken Sie auf Batch generieren
- Fuer jeden Kunden wird ein separater Bericht erstellt
Zeitgesteuert
Report-Zeitplaene automatisieren die regelmaeessige Erstellung:
- Waehlen Sie eine Vorlage
- Klicken Sie auf Zeitplan erstellen
- Konfigurieren Sie:
| Feld | Beschreibung |
|---|---|
| Name | Bezeichnung des Zeitplans |
| Zeitplan-Typ | Taeglich, woechentlich, monatlich oder Cron |
| Uhrzeit | Ausfuehrungszeitpunkt (HH:MM) |
| Tag | Wochentag oder Tag des Monats (je nach Typ) |
| Cron-Expression | Freier Cron-Ausdruck (bei Typ "Cron") |
| Variablen | Ueberschreibbare Template-Variablen |
Zeitplan-Typen
| Typ | Beschreibung |
|---|---|
| Taeglich | Jeden Tag zur angegebenen Uhrzeit |
| Woechentlich | Am gewaehlten Wochentag |
| Monatlich | Am gewaehlten Tag des Monats |
| Cron | Freie Cron-Expression fuer komplexe Zeitplaene |
E-Mail-Versand
Generierte Berichte koennen per E-Mail versendet werden:
- Oeffnen Sie einen generierten Bericht
- Klicken Sie auf Per E-Mail senden
- Geben Sie den Empfaenger ein
- Optional: Betreff und Nachricht anpassen
Voraussetzung
Fuer den E-Mail-Versand muessen die SMTP-Einstellungen unter Einstellungen konfiguriert sein.
Export-Formate
Generierte Berichte koennen in folgenden Formaten exportiert werden:
| Format | Beschreibung |
|---|---|
| HTML | Web-Ansicht direkt im Browser |
| Ueber die Browser-Druckfunktion (Strg+P → Als PDF speichern) |
PDF-Erstellung
Da die Berichte als HTML gerendert werden, nutzen Sie die Browser-Druckfunktion fuer professionelle PDF-Exporte. Die CSS-Styles der Basis-Vorlage enthalten @media print-Regeln fuer optimales Drucklayout.
Vorschau
Vor der Generierung koennen Sie eine Vorschau des Berichts anzeigen lassen:
- Waehlen Sie eine Vorlage
- Klicken Sie auf das Augen-Symbol (Vorschau)
- Der Bericht wird mit aktuellen Daten gerendert
Beispiel-Report
Ein typischer Infrastruktur-Bericht koennte enthalten:
- Firmenkopf mit Logo und Datum
- Zusammenfassung: Anzahl Hosts pro Modul, Online/Offline-Status
- Firewall-Uebersicht: Versionen, Gateway-Status, letzte Updates
- Server-Uebersicht: CPU/RAM-Auslastung, ausstehende Updates
- Backup-Status: Letzte Backups, Datastore-Belegung
- Empfehlungen: Hosts mit kritischen Checks oder veralteten Versionen