Berichtsvorlage erstellen

Erstelle einen eigenen PDF-Bericht aus octoja-Widgets — KPI-Karten, Diagramme, Tabellen und Meldungen — für einen Kunden, Standort oder den gesamten Mandanten.

Geschrieben von Erdinc Akay

Zuletzt aktualisiert Vor 26 Tagen

Im Bereich Berichte kannst du eigene PDF-Berichte erstellen, die deinen Mandanten zusammenfassen — offene Meldungen, Gerätezustand, Patch-Compliance, Zertifikatsablauf, Meldungsverlauf, Festplattennutzung, Hardware-Inventar und mehr. octoja liefert mehrere eingebaute Vorlagen für typische Anwendungsfälle — darunter eine Executive-Übersicht, eine Patch-Compliance-Übersicht, einen Ausführlichen Patch-Bericht und ein Hardware-Inventar — und du kannst sie unverändert nutzen, sie klonen und anpassen oder eine eigene Vorlage von Grund auf bauen. Das Ergebnis ist ein PDF, das du an einen Kundenreview hängen, an einen Vorgesetzten senden oder zur Revision archivieren kannst.

Die Berichte-Übersichtsseite mit der Schaltfläche „Vorlage erstellen" rot hervorgehoben oben rechts, oberhalb des Rasters der eingebauten Vorlagen (Aktivitäts-Übersicht, Backup-Status, Benutzer-Audit, Executive-Übersicht, Festplattenplatz-Bericht, Hardware-Inventar, Incident-Bericht, Lywand Security, Meldungsübersicht, Monitoring-Übersicht, Patch-Compliance-Übersicht, Software-Inventar, SSL-Zertifikatsablauf).

Voraussetzungen

  • Du benötigst die Berechtigung Berichte / Berichtsvorlagen verwalten (reports.manage). Diese wird über Gruppen unter Administration → Gruppen vergeben — bitte den Tenant-Administrator, sie deiner Rolle hinzuzufügen, falls noch nicht vorhanden.
  • Auch ohne die Berechtigung kannst du Berichte aus eingebauten Vorlagen ansehen und erstellen; nur das Anlegen, Bearbeiten und Löschen eigener Vorlagen ist gesperrt.

Schritt 1 — Bereich Berichte öffnen

Navigiere in der linken Seitenleiste zu Berichte. Die Seite zeigt alle Vorlagen deines Mandanten, gruppiert in Eingebaute Vorlagen (von octoja bereitgestellt) und Eigene Vorlagen (von deinem Team angelegt).

Erscheint die Schaltfläche Vorlage erstellen oben rechts nicht, fehlt dir die Berechtigung Berichte / Berichtsvorlagen verwalten — du kannst die eingebauten Vorlagen weiterhin öffnen und Berichte daraus erstellen, aber keine neuen anlegen.

Schritt 2 — Neue Vorlage erstellen

Klicke oben rechts auf Vorlage erstellen. Der Dialog Berichtsvorlage erstellen öffnet sich.

Der Dialog „Berichtsvorlage erstellen" mit dem Vorlagennamen „Quartalsbericht für Kunden", dem Auswahlfeld „Klonen von" auf „Leere Vorlage" belassen und der Schaltfläche „Vorlage erstellen" rot hervorgehoben.

Fülle aus:

FeldWas eintragen
Klonen vonWähle Leere Vorlage für eine leere Leinwand oder eine vorhandene eingebaute Vorlage, um deren Widgets und Layout in eine neue, bearbeitbare Vorlage zu kopieren.
VorlagennameEin Anzeigename für diese Vorlage (z. B. „Quartalsbericht für Kunden").

Klicke auf Vorlage erstellen. octoja speichert die Vorlage und öffnet den Vorlagen-Editor.

Im Vorschaumodus zeigen einige Widgets „Dieses Widget konnte nicht geladen werden", bis du einen Kunden-Geltungsbereich setzt (Schritt 4) oder die Vorlage speicherst und erneut öffnest. Das ist normal — Widgets mit kundenspezifischen Daten rendern erst, wenn der Geltungsbereich diese Daten liefert.

Schritt 3 — Widgets hinzufügen und anordnen

Der Vorlagen-Editor öffnet sich standardmäßig im Vorschau-Modus — du siehst, wie das gerenderte PDF aussehen wird. Oben rechts befindet sich ein Umschalter aus zwei Schaltflächen: ein Augensymbol für Vorschau und ein Stiftsymbol für Vorlage bearbeiten. Klicke auf das Stiftsymbol, um in den Bearbeitungs-Modus zu wechseln und Widgets hinzuzufügen sowie anzuordnen.

Eine Vorlage besteht aus Zeilen; jede Zeile enthält eines oder mehrere Widgets nebeneinander. Widgets sind die Bausteine, die Daten darstellen — KPI-Karten, Diagramme, Tabellen, Überschriften, Hinweisboxen und so weiter. Es gibt außerdem eine Kategorie Checks mit Monitoring-Check-Widgets — zum Beispiel Check-Detail (der aktuelle Status eines Checks) und Check-Verlauf (pro Gerät), der den Verlauf eines Checks zeigt und auf bestimmte Geräte oder Status eingegrenzt werden kann.

So fügst du ein Widget hinzu:

  1. Ziehe im Bearbeitungsmodus ein Widget aus der Widget-Palette links auf die Leinwand.
  2. Lege es in einer vorhandenen Zeile ab (neben die bereits vorhandenen Widgets) oder auf den freien Bereich zwischen Zeilen, um eine neue Zeile zu erstellen.
  3. Klicke das Widget an, um sein Eigenschaften-Panel rechts zu öffnen. Setze den Titel, ändere die Breite (wie viele Spalten das Widget in der Zeile belegt), wähle eine Hintergrundfarbe und konfiguriere widget-spezifische Optionen.

Zum Umsortieren ziehst du Widgets innerhalb einer Zeile oder zwischen Zeilen. Zum Entfernen klickst du das Widget an und wählst Löschen aus dem Aktionsmenü.

Ein besonders erwähnenswertes Widget ist die Tabelle Hardware-Inventar — sie zeigt eine Zeile pro Gerät und lässt dich genau wählen, welche Hardware-Felder als Spalten erscheinen. Wähle das Widget aus und such dir im Eigenschaften-Panel die gewünschten Felder. Sie sind in sechs Kategorien gruppiert, damit du sie schnell findest:

KategorieBeispielfelder
SystemBetriebssystem, Architektur, Zuletzt gesehen, Boot-Zeit, Gerätetyp.
IdentitätHersteller, Modell, Seriennummer, BIOS-Version, Angemeldeter Benutzer.
CPUCPU, CPU-Kerne, Logische Prozessoren, Max. CPU-Takt.
ArbeitsspeicherGesamter RAM, Belegte RAM-Steckplätze, RAM-Module, RAM-Modulgrößen.
SpeicherGesamte Festplatte, Freie Festplatte, Festplatte frei %, Festplattenmodelle, BitLocker.
NetzwerkPrimäre IPv4, Primäre MAC, Standard-Gateway, Netzwerkadapter, DNS-Server.

Mit den Schaltflächen Alle und Keine wählst oder leerst du alle Felder auf einmal. Wählst du keines, fällt das Widget auf einen sinnvollen Standardsatz an Spalten zurück. Da jede Spalte Breite kostet, liest sich eine große Auswahl am besten im Querformat (siehe unten) — octoja zeigt einen Hinweis, sobald du dich der Spaltenzahl näherst, die noch bequem auf eine A4-Seite passt.

Der Bericht hat außerdem eine Seitenausrichtung. In der Symbolleiste über der Leinwand schalten zwei Schaltflächen zwischen Hochformat und Querformat (breiter — mehr Tabellenspalten) um. Querformat gibt breiten Tabellen wie dem Hardware-Inventar mehr Platz. Die Ausrichtung gehört zur Vorlage und wird daher gemeinsam mit dem Layout gespeichert — schalte sie um und klicke dann auf Speichern. Neue Vorlagen starten im Hochformat.

Klicke oben rechts auf Speichern, um deine Änderungen zu sichern. Die Schaltfläche erscheint nur, wenn ungespeicherte Änderungen vorliegen — bei sauberem Stand ist sie ausgeblendet.

Tipp: Eingebaute Vorlagen sind ein guter Startpunkt, selbst wenn du sie nicht behalten willst. Öffne eine eingebaute Vorlage, um zu sehen, wie octoja KPI-Karten, Diagramme und Tabellen anordnet. Du kannst dann entweder in einer Kopie weiterarbeiten (Aktion Klonen im Menü) oder mit dem Layout, das du im Kopf hast, neu beginnen.

Schritt 4 — Bericht eingrenzen

Über der Leinwand grenzt eine Filterleiste den Bericht ein, bevor du ihn erstellst:

AuswahlfeldWas es filtert
KundeBeschränkt den Bericht auf die Geräte, Meldungen und Zertifikate eines Kunden. Beim Laden der Seite kann bereits ein Kunde vorausgewählt sein — leere die Auswahl, wenn du einen mandantenweiten Bericht möchtest.
StandortInnerhalb des gewählten Kunden weiter auf einen Standort einschränken. Nur verfügbar, wenn ein Kunde ausgewählt ist.
ZeitraumDer Zeitraum, den zeitbezogene Widgets abdecken (zum Beispiel installierte Patches im Ausführlichen Patch-Bericht). Wähle eine Voreinstellung — Gesamter Zeitraum, Aktueller Monat, Letzter Monat — oder wähle Benutzerdefiniert und setze ein Datum für Von und Bis.

Die Vorschau aktualisiert sich beim Ändern des Geltungsbereichs, sodass du genau siehst, was das erzeugte PDF enthält. Geltungsbereich und Zeitraum werden nicht in der Vorlage gespeichert — sie werden bei jeder Erstellung neu gewählt.

Schritt 5 — PDF herunterladen

Sieht die Vorschau so aus, wie du es möchtest, klicke auf Herunterladen (das Download-Symbol) in der Filterleiste unterhalb der Kopfzeile, neben den Auswahlfeldern Kunde, Standort und Zeitraum. octoja:

  1. Rendert die Vorlage mit den Daten deines gewählten Geltungsbereichs und Zeitraums.
  2. Erzeugt ein PDF in der aktuell in deiner octoja-Oberfläche gewählten Sprache (Englisch oder Deutsch).
  3. Lädt es in deinen Browser als <slug>-<jjjj-mm-tt>.pdf herunter — bei eingebauten Vorlagen ist der Slug die stabile Built-in-Kennung, bei eigenen Vorlagen der slugifizierte Vorlagenname.

Speichere oder teile das PDF wie jede andere Datei, die dein Browser herunterlädt.

Berichte automatisch versenden. Neben dem Download auf Abruf kann octoja Bericht-PDFs auch wiederkehrend per E-Mail versenden. Klicke oben rechts auf der Berichte-Seite auf Zeitplanung, um einen Zeitplan zu erstellen: Wähle die einzubeziehenden Vorlagen, setze einen Kunden- (und optional Standort-)Geltungsbereich, füge Empfänger-E-Mail-Adressen hinzu und lege fest, wie oft er ausgeführt wird. Bei jeder Ausführung werden die gewählten Vorlagen gerendert und die PDFs an diese Empfänger gesendet.

Bestehende Vorlagen verwalten

Im Vorlagen-Editor bietet das Aktionsmenü (die Schaltfläche in der Kopfzeile der Seite):

AktionFunktion
KlonenErzeugt eine Kopie der aktuellen Vorlage mit „ (Kopie)" am Namensende. Nützlich, um eine eingebaute Vorlage in eine angepasste Version abzuzweigen.
LöschenEntfernt die Vorlage endgültig. Nur bei eigenen Vorlagen verfügbar — eingebaute Vorlagen können nicht gelöscht werden.

Eingebaute Vorlagen sind vollständig schreibgeschützt — du kannst weder ihre Widgets bearbeiten noch sie umbenennen oder löschen. Um eine eingebaute Vorlage anzupassen, nutze Klonen im Aktionsmenü und bearbeite die Kopie. Um eine eigene Vorlage umzubenennen, wechsle zuerst in den Bearbeitungsmodus und klicke dann oben im Vorlagen-Editor auf den Titel — im Bearbeitungsmodus ist der Titel ein direkt bearbeitbares Feld.

Fehlerbehebung

Die Schaltfläche „Vorlage erstellen" erscheint nicht. Dir fehlt die Berechtigung Berichte / Berichtsvorlagen verwalten. Eingebaute Vorlagen bleiben sichtbar und erstellbar; nur das Anlegen, Bearbeiten und Löschen sind gesperrt.

Die Schaltfläche „Herunterladen" liefert ein PDF in der falschen Sprache. Die PDF-Sprache folgt der UI-Sprache zum Zeitpunkt des Klicks auf Herunterladen. Wechsle die Sprache in deinem Profil (erreichbar über die Benutzer-Schaltfläche unten links) und klicke erneut auf Herunterladen — octoja erzeugt das PDF in der neuen Sprache.

Manche Widget-Daten sehen leer aus. Ein Widget rendert leer, wenn der gewählte Geltungsbereich keine passenden Daten enthält — zum Beispiel zeigt das Widget Neueste Meldungen nichts an, wenn der gewählte Kunde keine offenen Meldungen im Zeitraum hat. Erweitere den Geltungsbereich (entferne den Standort-Filter oder den Kunden-Filter für eine mandantenweite Ansicht) und lade den Bericht erneut herunter.

Der Name einer eingebauten Vorlage sieht wie ein Übersetzungsschlüssel aus (z. B. pages.reports.builtIns.executiveSnapshot.name). Das deutet auf eine fehlende Übersetzung im octoja-Sprachpaket hin — Seite neu laden oder den Support informieren. Die Vorlage funktioniert weiterhin; betroffen ist nur die Anzeigebezeichnung.

Verwandte Artikel

  • Kern-RMM-Funktionen — Überblick über das octoja-Berechtigungsmodell, inklusive reports.manage.
  • Berichte-Referenz — vollständiges Datenmodell, REST-Endpunkte, Widget-Katalog und Layout-Raster für den Bereich Berichte.