4.13. Auswertung von Daten aus dem LDAP-Verzeichnis mit Univention Directory Reports#
Univention Directory Reports bietet die Möglichkeit vordefinierte Reports zu beliebigen im Verzeichnisdienst verwalteten Objekten zu erstellen.
Die Struktur der Reports wird dabei durch Vorlagen definiert. Die dafür entwickelte Beschreibungssprache ermöglicht die Verwendung von Platzhaltern, die durch die Werte aus dem LDAP-Verzeichnis ersetzt werden. Es können dabei beliebig viele Reportvorlagen vorgegeben werden. So können beispielsweise für Benutzer wahlweise sehr detaillierte Reports oder nur einfache Adresslisten erstellt werden.
Die Erstellung von Reports ist direkt in die UMC-Module Benutzer, Gruppen und Rechner integriert. Alternativ kann das Kommandozeilenprogramm univention-directory-reports verwendet werden.
Im Auslieferungszustand werden sechs Reportvorlagen von Univention Directory Reports bereitgestellt, die für Benutzer, Gruppen und Rechner verwendet werden können. Drei Vorlagen erzeugen PDF-Dokumente und drei Vorlagen CSV-Dateien, die als Import-Quelle für andere Programme verwendet werden können. Weitere Vorlagen können erstellt und registriert werden.
4.13.1. Erstellen von Reports in Univention Management Console-Modulen#
Um einen Report zu erstellen, muss das UMC-Modul Benutzer, Gruppen oder Rechner geöffnet werden. Anschließend müssen alle vom Report erfassten Objekte ausgewählt werden (durch einen Klick auf die Checkbox links von Name können alle Objekte ausgewählt werden). Ein Klick auf ermöglicht die Auswahl zwischen dem Standard-Report im PDF-Format und dem CSV-Report im CSV-Format.
Abb. 4.10 Erstellen eines Reports#
Die über die UMC-Module erzeugten Reports werden für 12 Stunden aufbewahrt und danach durch einen Cron-Job entfernt. Die Einstellungen, wann dieser Cron-Job laufen soll und wie lange diese Reports aufbewahrt werden sollen, kann über zwei Univention Configuration Registry-Variablen definiert werden:
- directory/reports/cleanup/cron#
Definiert den Zeitpunkt zu dem der Cron-Job ausgeführt werden soll.
- directory/reports/cleanup/age#
Bestimmt das maximale Alter eines Report-Dokumentes in Sekunden bevor es gelöscht wird.
4.13.2. Erstellen von Reports auf der Kommandozeile#
Reports können auch über die Kommandozeile mit dem Programm univention-directory-reports erstellt werden. Informationen zur Verwendung des Programm können über die Option --help abgefragt werden.
Mit dem folgenden Befehl können beispielsweise die verfügbaren Reportvorlagen für Benutzer aufgelistet werden:
$ univention-directory-reports -m users/user -l
4.13.3. Anpassung/Erweiterung von Univention Directory Reports#
Schon vorhandene Reports können direkt mit den Voreinstellungen erstellt werden. Einige Voreinstellungen können mittels Univention Configuration Registry angepasst werden. Beispielsweise ist es möglich, das Logo, dass in der Kopfzeile jeder Seite eines PDF-Reports angezeigt wird, zu ersetzen. Dafür kann der Wert der Univention Configuration Registry Variable directory/reports/logo den Namen einer Bilddatei enthalten. Dabei können gängigen Bildformate wie JPEG, PNG oder GIF verwendet werden. Das Bild wird automatisch auf eine feste Breite von 5.0 cm angepasst.
Neben dem Logo kann auch der Inhalt der Reports angepasst werden, indem neue Reportvorlagen definiert werden.