Kapitel 11. Benutzerdefinierte Berichte

Inhaltsverzeichnis

11.1. Das Kontext-Objekt
11.2. Eine neue Berichtsvorlage erstellen
11.2.1. Unterstützte Parametertypen
11.2.2. Umgang mit Parametern
11.3. Einen Bericht erzeugen
11.4. Beispielbericht
11.4.1. Erzeugen des Skripts
11.4.2. Eine PDF-Layout-Vorlage erzeugen
11.5. Ein Diagramm erstellen
11.5.1. Script für ein Tortendiagramm
11.5.2. Pie Chart Report Template
11.5.3. Bilder einbinden
11.5.4. Eine Layout-Vorlage für Excel erzeugen

Obwohl Klaros-Test­management bereits eine Vielzahl von vordefinierten Berichten bietet, reichen diese oft nicht aus, wenn spezielle Anforderungen an den Inhalt oder das Layout vorliegen. Deshalb können mit der Klaros-Test­management Enterprise Edition auch beliebige eigene Berichte erstellt werden. Abbildung 11.1, „Ablauf der Berichtserstellung“ gibt einen Überblick, wie Berichte erstellt werden.

Ablauf der Berichtserstellung

Abbildung 11.1. Ablauf der Berichtserstellung


Am Erstellen eines Berichtes sind zwei Benutzergruppen beteiligt: Berichtdesigner und Benutzer.

[Anmerkung] Programmierkenntnisse

Für das Erstellen von eigenen Berichte sind grundlegende Kenntnisse der Programmiersprachen Java oder Groovy sowie der XML-basierten Template-Erstellung mit SeamPDF oder SeamExcel notwendig.

Dieses Kapitel richtet sich hauptsächlich an Berichtsdesigner und zeigt, wie die benutzerdefinierten Berichtsvorlagen erstellt werden. Benutzer sehen in Abschnitt 9.2, „Berichte“ wie daraus Berichte erstellt werden können.

11.1. Das Kontext-Objekt

Im Berichts-Skript werden die Daten für die Darstellung in der Layout-Vorlage bereitgestellt. Es bezieht die Daten entweder direkt aus dem Objektmodell de.verit.klaros.core.model oder aus der Datenbank über die Abfragesprache HQL.

Die resultierenden Daten für die Layout-Vorlage müssen dann im Objekt Abschnitt E.2, „KlarosScript Interface“ gespeichert werden, das an die Methode execute übergeben wurde.

Sind Parameter definiert, sind sie über das Kontextobjekt sowohl für das Berichts-Skript als auch für die Layout-Vorlage verfügbar.

[Tipp] Vordefinierte Objekte im Kontext

Das Objekt Abschnitt E.2, „KlarosScript Interface“ enthält bereits vordefinierte Objekte. Eine vollständige Liste ist unter Abschnitt E.1, „Der Klaros Report-Kontext“ zu finden.