Entwicklerschulung

Allgemeine Themen

Berichtstabellen

Berichte werden in der Datenbank abgelegt

Dynamische Generierung von SQL

1. Klassische Verarbeitung ohne Freemarker

Die einzelnen Abfragen (auch synonym Masken genannt) enthalten Platzhalter, wie beispielsweise:

select monat,sum(betrag) from cob_busa
where   monat=<<Monat>>; 

Auf der Maske gibt es ein Feld Monat. Vorm Abschicken des SQL wird <<Monat>> durch den gewählten Wert ersetzt. Falls eine Maske Felder enthält, welche optional gefüllt werden können, so wird der Ausdruck zwischen /* und */ gesetzt. Das hat zur Folge, dass dieser entfernt wird, falls kein Wert ausgewählt wurde. Aus beispielsweise

select monat,sum(betrag) from cob_busa
where   monat=<<Monat>>
/* and gege=<<Geldgeber>> */;

wird, falls kein Geldgeber ausgewählt wurde z. B.

select monat,sum(betrag) from cob_busa
where   monat=1;

, aber falls ein Geldgeber ausgewählt wurde z. B.

select monat,sum(betrag) from cob_busa
where   monat=1
and gege=3; 

Detail:
Der Ausdruck in <<XXX>> darf nur einmal in dem optionalen Block vorkommen. Falls er zweimal benötigt wird, müssen diese auf zwei Blöcke aufgeteilt werden. Z. B.:
/* and (dr in (<<Deckungsring>>) */
/* or dr2 in (<<Deckungsring>>) )*/

2. FreeMarker-Transformation

Nach der klassischen Transformation mit generateSql folgt ggfs. die FreeMarker Transformation. FreeMarker transformiert eine Vorlage (template) mit Hilfe eines Datenmodells (mit Java Objekten) zu einem Ausgabetext.

Sehr oft wird es zur Erzeugung von HTML benutzt, wir produzieren stattdessen SQL. Die Java-Objekte im Datenmodell sind die Felder, die auf der Maske zur Auswahl stehen.

Als einfachsten Anwendungsfall könnten wir also für eine Maske mit einem Monatsfeld statt des klassischen SuperX-Tags

select monat,sum(betrag) from tmp_busa where monat=<<Monat>> 

auch die FreeMarker Notation nehmen.

select monat,sum(betrag) from tmp_busa where monat=${Monat} 

Innerhalb von Freemarker kann ${} entfallen:

<#if Monat=1> ... </#if>

Ein komplexes Beispiel:

SQLVars

--freemarker template
<sqlvars>
<sqlvar name="countstudis">
select count(*) from sos_stg_aggr where stichtag=6 and sem_rueck_beur_ein=<<Semester>>
</sqlvar>
</sqlvars>
<#if countstudis&gt;0>
BLOCK 1
<#else>
BLOCK 2
</#if>

1. (klassische) Transformation macht aus SQL in der SQLVar z.B.

a) select count(*) from sos_stg_aggr where stichtag=6 and sem_rueck_beur_ein=20201 oder
b) select count(*) from sos_stg_aggr where stichtag=6 and sem_rueck_beur_ein=20501

2. SQL wird ausgeführt und Ergebnis in Freemarker-Variable countstudis gespeichert
3. reguläre Freemarker Transformation wird durchgeführt, bei 1a) wird BLOCK1 ausgeführt, bei 1b) BLOCK2.
4. Entsprechender Teil wird ausgeführt.

Hinweise:

• Statt <<Semester>> hätte man auch ${Semester} nehmen können
• Wenn nach der klassischen Transformation < oder > Zeichen vorhanden sind, wird um den Text ein CDATA-Block benötigt, z.B.
  <sqlvar name="counter"><![CDATA[select count(*) from .. where anzahl>0; ]]></sqlvar>
• Weitere Möglichkeiten unter https://super-ics.de/superx/doku/entwicklerhandbuch/f_Variablen.htm

Freemarker Spickzettel

1. Innerhalb von SQL Zugrif auf Variabeln mit ${Varname} z.B. ${Semester}, in Befehlen ohne z.B. <#if Geschlecht=1>
   • Sind in Variabelnnamen Leer- oder Sonderzeichen enthalten Zugriff mit
   • ${.vars["Köpfe oder Fälle?"]} oder in Befehlen
   • <#if .vars["Köpfe oder Fälle?"]="xy">
2. Variablen zuweisen mit assign, z.B. <#assign sortnr=0/> <#assign sortnr=sortnr+1/>
3. IF-Befehle
   • <#if "<<Aggregierung>>"="stark">
   • insert into .. select ...
   • <#elseif "<<Aggregierung>>="mittel">
   • insert into .. select ...
   • <#else>
   • insert into .. select ...
   • </#if>
4. Innerhalb von IF Größer- und Kleinerzeichen darstellen mit &gt; und &lt; z.B. <#if anzahl &gt; 0 >
5. switch - statt vieler IF/ELSE-Bedinungen switch
6. in SQLVars : wenn nach der klassischen Transformation < oder > Zeichen vorhanden sind, wird um den Text ein CDATA-Block benötigt, z.B. <sqlvar name="counter"><![CDATA[select count(*) from .. where anzahl>0; ]]></sqlvar>
7. Schleifen
   1. einfach 10x durchführen <#list 1..10 as i> select ${i} .. </#list>
   2. über Ausgewählte Objekte <#foreach stg in Studiengang> </#foreach>
8. Für Feldart 1 (Einfache Auswahlboxen) Zugriff auf das JavaObjekt und damit Methoden
   • <#if AggregierungObject.containsElements> oder ${AggregierungObject.allNeededKeys}

Captions - Felderläuterungen

Captions

Makros

Makros

Studierende/Prüfungen

Komplexe Gewichtungen

https://wiki.his.de/mediawiki/index.php/Studierendengewichtungsregeln_-_HISinOne-BI
Anpassung von Berichten:
wenn Sie im Quelltext der Vorlage etwas sehen wie

<#assign lehr_stg_ab="lehr_stg_ab"/>
<#assign quelltabelle='sos_stg_aggr'/>
<#if "<<Köpfe oder Fälle ?>>"?index_of("S.gewichtung_id=")!=-1>
<#assign lehr_stg_ab="lehr_stg_ab_gew"/>
<#assign quelltabelle='sos_stud_gewichtung'/>
</#if>

Schauen Sie sich die Anleitung an unter https://wiki.his.de/mediawiki/index.php/Aenderung_von_Abfragen_zur_erweiterten_Gewichtung_-_HISinOne-BI

Weiterführende Informationen

Datenbankmodelle / Dokumentation

http://www.superx-projekt.de/
Unter Module, dann jeweils LInk "Installations-, Upgradehinweise, Dokumentation und Versionshistorie" , Handbücher und Ressourcen, Datenbankbeschreibung

Entwicklerhandbuch

http://entwicklerhandbuch.superx-projekt.de/ bzw. ältere, aber umfangreichere Dokumentation http://www.superx-projekt.de/doku/entwicklerhandbuch/main.htm

JasperReports

http://ireport.superx-projekt.de/