tar -xzvf Dateiname
Fügen Sie dann den Pfad Ihrer SQL_ENV hinzu:
cat $SUPERX_DIR/db/bin/SQL_ENV_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV
Danach laden Sie die SQL_ENV neu und führen aus:
cd $RPTA_PFAD module_install rpta .
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit. Eine Hauptladeroutine gibt es in diesem Modul nicht.
tar -xzvf Dateiname
Danach können Sie das Modul über die Komponentenverwaltung installieren:
Danach starten Sie Tomcat neu, bzw. leeren den Cache im Webanwendung Manager. Eine Hauptladeroutine gibt es derzeit nicht, wohl aber eine Upgrade Funktion. Nach einer Neuanmeldung sollten Sie im Menü "Standardberichte konfigurieren" ganz oben den Menüpunkt "Berichtsassistent" finden.
Laden Sie zunächst das Environment von SuperX, so dass die Umgebungsvariables $SUPERX_DIR und $WEBAPP gesetzt sind. Führen Sie dann folgende Shell-Befehle aus:
git clone https://git.campussource.de/git/SuperX/rpta.git cd rpta cat superx/WEB-INF/conf/edustore/db/bin/SQL_ENV_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV . $SUPERX_DIR/db/bin/SQL_ENV ant -DMODULE_PATH=$RPTA_PFAD -DBASE_DIR=. -DWEBAPP=$WEBAPP -DMODULE=rpta all cd $RPTA_PFAD module_install rpta .
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.
Wenn Sie die Komponente bereits installiert haben, müssen Sie wie folgt vorgehen:
rpta_upgrade.x
aus.
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.
Im Berichtswesen gibt es oft die Notwendigkeit, häufig wiederkehrende Abfragen in speziellen Spaltenlayouts zu speichern. Früher bot SuperX nur die Möglichkeit
In dem Modul können Sie auf der Basis des SuperX-Datenmodells
Siehe auch:
In der Auslieferung gibt es eine Beispielanwendung, die Studierendenauswertungen flexibel für Landes- oder interne Zwecke ausgeben kann. Das Ziel ist z.B. die beigefügte Tabelle fürs Ministerium in NRW:
Die Datengrundlage ist eine Tabelle mit Studierendendaten. Diese wird im folgenden beschrieben.
Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der virtuellen Tabellen.
Die virtuelle Tabelle "Studierende amtlich und intern" beinhaltet
Das Detailformular zeigt die Quelltabellen und Felder:
Dieses Beispiel sollten Sie nicht ändern, es dient nur als Beispiel in der Auslieferung.
Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten:
Im Ergebnis finden Sie die definierten Spalten:
Sie können die Definition der Spalten abrufen, hier das Beispiel des Standortes (amtlich):
Es gibt folgende Spaltentypen:
Ausgehend vom obigen Beispiel-Muster benötigen wir eine Tabelle mit Studierendensummen mit einem Filter auf
Die Tabelle enthält folgende Spalten:
Die Benennung der Spalten sollte exakt mit dem Muster übereinstimmen.
Zunächst die Tabellendefinition: Filter wie Stichtag, Hörerstatus und Status können wir wie gewohnt in der Maske als Felder anbieten, und die Filter
definieren wir direkt im Spaltenlayout. Wir gehen dazu in das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der Spaltenlayouts:
Das Feld "Bedingung (optional)" definiert die Filter auf der virtuellen Tabelle. Da manche Hochschulen Studiengänge ohne Regelstudienzeit mit einem sehr hohen Wert versehen (z.B. 99), wird ein Filter auf eine "übliche" Regelstudienzeit zwischen 1 und 20 Semestern gesetzt.
Im Beschreibungsfeld darunter wird eine textuelle Beschreibung im Sinne einer Legende angeboten. Diese wird in der späteren Berichtsausgabe dann unter der Legende erscheinen.
Die eigentlichen Spalten werden in dem Unterformular angezeigt, mit Klick auf die jew. Details können Sie die Bezeichnung der Spalte und Layoutmerkmale angeben, sowie einen Erläuterungstext:
Den fertigen Bericht können Sie hier abrufen: In der Maske definieren Sie die Ergebnismenge
und die Tabelle gibt die Studierendensummen exakt im Layout des Musters aus:
Die Sortierung erfolgt in der Reihenfolge der Spalten jeweils aufsteigend.
Der Berichtsassistent bindet defaultmäßig eine Datei "simple_table.jrtx" ein, die im gleichen Ordner wie die normalen JRXML-Dateien liegt (.../webapps/superx/WEB-INF/reports ).
Sie können die Layouts anpassen und so alle exportierten Berichte in einem "Corporate Design" gestalten. Details zu Styles und ausgelagerten Styles siehe unser JasperReports-Handbuch.
Wenn Sie im Berichtsassistenten ein Exportformat eingerichtet haben, können Sie dies in die Oberfläche als "Direktlink" einrichten, also als Link direkt auf das jew. Exportformat (z.B. Excel) ohne den Assistenten. Damit können Sie den regulären Excel-Export ersetzen, d.h. bei Ergebnisberichten mit Aufklappstruktur erhalten sie auch den gewohnten Dialog bzgl. der Zeilen.
In der Auslieferung ist dies das Excel-Format, hier ein Screenshot, wie das aussieht:
Nach dem Bestätigen erhalten Sie direkt die fertige Excel-Datei:
Das Beispiel läßt sich für alle von JasperReports unterstützte Formate umsetzen, z.B. auch PDF. Dazu müssen Sie nur das vorhandene Stylesheet "tabelle_jrxml_a4_quer.xsl" kopieren und den Contenttype ändern, für PDF z.B. "application/pdf". Auch das Icon können Sie ändern.
Viele Hochschulen erzeugen die Berichtslayouts auch per Kommandozeile, dies ist auch hier möglich. Wir haben für diesen Zweck mehrere ANT-Targets erstellt. Das Vorgehen:
git clone https://git.campussource.de/git/SuperX/rpta.git
ant -DXML=test.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test xml2jrxml_tabelle_a4_quer
Es wird im Unterordner test/tabelle_a4_quer eine Datei test.jrxml erzeugt
Sie können auch aus den Berichtslayouts PDF-Berichte erzeugen, indem Sie danach eingeben:
ant -DXML=test.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test jrxml2pdf_tabelle_a4_quer
Damit wird die jrxml-Datei mit der XML-Datenquelle verbunden und ein formatierter Export erzeugt.
Neben dem A4-quer Layout haben wir auch ein Template, das aus einem Makrobericht ein Booklet erzeugen kann. Auch hier beginnt die Verarbeitung mit einem XML-Export eines Makroberichts, z.B. in der Datei testmakro.xml
ant -DXML=testmakro.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test xml2jrxml_booklet_ohne_cover
Damit werden einige Dateien erzeugt:
Den Hauptbericht und die Unterberichte können Sie in JasperSoft Studio weiterverarbeiten, oder daraus ein PDF-Buch erzeugen:
ant -DXML=testmakro.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test jrxml2pdf_booklet_ohne_cover
Dies erzeugt eine Datei ./test/booklet_ohne_cover/testmakro.pdf
Die beiden Beispiele können in eigenen ANT-Targets angepaßt und genutzt werden, z.B. um statt PDF das Format XLSX zu erzeugen.