Erweiterte Maskenprogrammierung: Freemarker Templates - Versionsgeschichte

Danielq: /* Sichten und Freemarker */

2026-10-13T19:01:50Z

Sichten und Freemarker

@@ Zeile 286: / Zeile 286: @@
 abgeschickt.
 ===Sichten und Freemarker===
-Bei Sicht-Feldern (Feldart 12) gibt es besondere Möglichkeiten. Mittels Java-Reflection kann FreeMarker auf Methoden der Objekte im Datenmodell zugreifen. Bei Sichtfeldern wie "Institution" oder "Kostenart" sind folgende Methoden interessant.
+Bei Sicht-Feldern (Feldart 12) gibt es besondere Möglichkeiten. Mittels Java-Reflection kann FreeMarker auf Methoden der Objekte im Datenmodell zugreifen. Bei Sichtfeldern wie "Institution" oder "Kostenart" kann man ganz einfach auf die Objekte und Methoden zugreifen. Beispiel Maskenfeld "Institution":
 ====allNeededKeys====

Danielq: /* allNeededKeys für temporäre Datentabellen */

2026-10-13T18:44:50Z

allNeededKeys für temporäre Datentabellen

← Nächstältere Version		Version vom 13. Oktober 2026, 18:44 Uhr
Zeile 287:		Zeile 287:
	===Sichten und Freemarker===		===Sichten und Freemarker===
	Bei Sicht-Feldern (Feldart 12) gibt es besondere Möglichkeiten. Mittels Java-Reflection kann FreeMarker auf Methoden der Objekte im Datenmodell zugreifen. Bei Sichtfeldern wie "Institution" oder "Kostenart" sind folgende Methoden interessant.		Bei Sicht-Feldern (Feldart 12) gibt es besondere Möglichkeiten. Mittels Java-Reflection kann FreeMarker auf Methoden der Objekte im Datenmodell zugreifen. Bei Sichtfeldern wie "Institution" oder "Kostenart" sind folgende Methoden interessant.
	====allNeededKeys ~~für temporäre Datentabellen~~====		====allNeededKeys====

	Diese Methode liefert alle ~~benötigten~~ Schlüssel.		Diese Methode liefert alle Schlüssel der aktuellen Selektion inkl. der "Kindelemente".

	Wenn bei ~~dme~~ Sichtenfeld nichts ausgewählt wurde, werden einfach alle im Baum vorhandenen Schlüssel geliefert.		Wenn bei dem Sichtenfeld nichts ausgewählt wurde, werden einfach alle im Baum vorhandenen Schlüssel geliefert.

	Wenn z.B. Personalkosten ausgewählt wurde, wird nur der Schlüssel von Personalkosten ('1') und dessen Unterknoten (z.B. '11','12') geliefert.		Wenn z.B. Personalkosten ausgewählt wurde, wird nur der Schlüssel von Personalkosten ('1') und dessen Unterknoten (z.B. '11','12') geliefert.
Zeile 330:		Zeile 330:
	${Haushaltsprogramm.allNeededKeys}.		${Haushaltsprogramm.allNeededKeys}.
	</source>		</source>

	====ContainsElements====		====ContainsElements====
	;Neu ab Kern4.5: Für Sichten und auch Feldart 1 kann man ermitteln, ob eine Auswahl möglich ist.		;Neu ab Kern4.5: Für Sichten und auch Feldart 1 kann man ermitteln, ob eine Auswahl möglich ist.

John.imo: /* Freemarker masieren */

2026-10-08T09:03:05Z

Freemarker masieren

← Nächstältere Version		Version vom 8. Oktober 2026, 09:03 Uhr
Zeile 654:		Zeile 654:
	Der resultierende Dateiname könnte damit z.B. sein "Bilanz-2024-1241.xlsx"		Der resultierende Dateiname könnte damit z.B. sein "Bilanz-2024-1241.xlsx"

	===Freemarker ~~masieren~~===		===Freemarker maskieren===
	====Variablen in DB schreiben====		====Variablen in DB schreiben====
	Folgend ein assign, der einen sql enthält. Der sql soll in eine DB geschrieben werden. Die im sql enthaltene Freemarker-Variable soll als Freemarker-Variable in die DB geschrieben, also erst später ausgewertet werden. Daher muss sie maskiert werden. <code>${'${'}</code> sorgt dafür, dass <code>${</code> als String geschrieben wird. Dadurch wird dann <code>${LM_Notenkonto}</code> als String in die DB geschrieben.<source lang="sql">		Folgend ein assign, der einen sql enthält. Der sql soll in eine DB geschrieben werden. Die im sql enthaltene Freemarker-Variable soll als Freemarker-Variable in die DB geschrieben, also erst später ausgewertet werden. Daher muss sie maskiert werden. <code>${'${'}</code> sorgt dafür, dass <code>${</code> als String geschrieben wird. Dadurch wird dann <code>${LM_Notenkonto}</code> als String in die DB geschrieben.<source lang="sql">

John.imo: /* Exportdateinamen */

2026-10-08T09:01:44Z

Exportdateinamen

← Nächstältere Version		Version vom 8. Oktober 2026, 09:01 Uhr
Zeile 653:		Zeile 653:

	Der resultierende Dateiname könnte damit z.B. sein "Bilanz-2024-1241.xlsx"		Der resultierende Dateiname könnte damit z.B. sein "Bilanz-2024-1241.xlsx"

			===Freemarker masieren===
			====Variablen in DB schreiben====
			Folgend ein assign, der einen sql enthält. Der sql soll in eine DB geschrieben werden. Die im sql enthaltene Freemarker-Variable soll als Freemarker-Variable in die DB geschrieben, also erst später ausgewertet werden. Daher muss sie maskiert werden. <code>${'${'}</code> sorgt dafür, dass <code>${</code> als String geschrieben wird. Dadurch wird dann <code>${LM_Notenkonto}</code> als String in die DB geschrieben.<source lang="sql">
			<#assign rpta_columns = [
			{"uniquename":"swf_note_elementnr_30",
			"caption_der_spalte":"SWF Note PK30 (elementnr)",
			"srcfieldname":"",
			"targetfieldname":"swf_note_elementnr_30",
			"column_type":"lookupColumn",
			"col_function":"select max(note) from lm_exam_unit E
			where tmp_rpta_lm_ects_soll_ist.matrikel_nr=E.matrikel_nr
			and tmp_rpta_lm_ects_soll_ist.dim_studiengang_abschluss=E.ch35_ang_abschluss
			and tmp_rpta_lm_ects_soll_ist.dim_studiengang_stg=E.ch30_fach
			and elementnr in (${'${'}LM_Notenkonto})",
			"is_aggregate":0,
			"description_der_spalte":""}
			/>
			</source>

Danielq: /* Interaktion Freemarker mit Maskenfeldern */

2025-10-18T07:20:31Z

Interaktion Freemarker mit Maskenfeldern

@@ Zeile 48: / Zeile 48: @@
 ==Interaktion Freemarker mit Maskenfeldern==
 Das Servlet verarbeitet bei der Maskenausführung zuerst die Maskenfelder, die mit den Steuerungszeichen "&lt;&lt;" und "&gt;&gt;" in das select_stmt eingefügt werden.
 So wird z.B. bei der Anweisung
@@ Zeile 74: / Zeile 75: @@
 </source>
 und Freemarker würde diese if-Bedingung mit "falsch" beantworten und den SQL "select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;" nicht ausführen.
 ==Programmieren mit FreeMarker==

Danielq: /* Variablen: assign */

2025-10-18T06:43:11Z

Variablen: assign

← Nächstältere Version		Version vom 18. Oktober 2025, 06:43 Uhr
Zeile 95:		Zeile 95:
	===Variablen: assign===		===Variablen: assign===
	Mit assign kann man eigene Variabeln definieren. Z. B.		Mit assign kann man eigene Variabeln definieren. Z. B.
			<source lang="sql">
	<#assign sortnr=0>		<#assign sortnr=0>
	<#assign sortnr=sortnr+1>		<#assign sortnr=sortnr+1>
			</source>
	oder		oder
			<source lang="sql">
	<#if "<<Stichtagsbezogen>>"="NEIN">		<#if "<<Stichtagsbezogen>>"="NEIN">
	<#assign quelltabelle = "sos_statistik">		<#assign quelltabelle = "sos_statistik">
	<#else>		<#else>
	<#assign quelltabelle = "sos_statistik">		<#assign quelltabelle = "sos_statistik">
	</#if>		</#if>
			</source>
	<<Stichtagsbezogen>> wird von der SuperX-Transformation ersetzt, sodass Freemarker vergleicht:		<<Stichtagsbezogen>> wird von der SuperX-Transformation ersetzt, sodass Freemarker vergleicht:
	~~<~~#if "JA"="NEIN"~~>~~ oder ~~<~~#if "NEIN"="NEIN"~~>~~		<source lang="sql">
			<#if "JA"="NEIN">
			</source>
			oder
			<source lang="sql">
			<#if "NEIN"="NEIN">
			</source>
	Die Variablen werden wie folgt abgerufen:		Die Variablen werden wie folgt abgerufen:
			<source lang="sql">
	insert into ... values (${sortnr},...)		insert into ... values (${sortnr},...)
			</source>
	oder		oder
			<source lang="sql">
	select .... from ${quelltabelle} where ...		select .... from ${quelltabelle} where ...
			</source>

	Folgender Effekt ist schon mal aufgetreten:		Folgender Effekt ist schon mal aufgetreten:
	Wenn man ein einer Abfrage z.B. schreibt		Wenn man ein einer Abfrage z.B. schreibt
			<source lang="sql">
	<#assign sortnr=sortnr+1>		<#assign sortnr=sortnr+1>
	insert into tmp_rs_base		insert into tmp_rs_base
	(struktur,text, ...		(struktur,text, ...
			</source>
	dann klappt das nicht, man muss unter dem assign eine Leerzeile einfügen.		dann klappt das nicht, man muss unter dem assign eine Leerzeile einfügen.

Danielq: /* Interaktion Freemarker mit Maskenfeldern */

2025-10-18T06:40:27Z

Interaktion Freemarker mit Maskenfeldern

← Nächstältere Version		Version vom 18. Oktober 2025, 06:40 Uhr
Zeile 50:		Zeile 50:
	Das Servlet verarbeitet bei der Maskenausführung zuerst die Maskenfelder, die mit den Steuerungszeichen "<<" und ">>" in das select_stmt eingefügt werden.		Das Servlet verarbeitet bei der Maskenausführung zuerst die Maskenfelder, die mit den Steuerungszeichen "<<" und ">>" in das select_stmt eingefügt werden.
	So wird z.B. bei der Anweisung		So wird z.B. bei der Anweisung
			<source lang="sql">
	<#if (einFach.strukturStr = "Fach (intern)" && <<Aggregierung Fach>>=10 )>		<#if (einFach.strukturStr = "Fach (intern)" && <<Aggregierung Fach>>=10 )>
			</source>
	im Servlet zunächst die Variable "Aggregierung Fach " aufgelöst und dann erst startet der Freemarker-Parser. Für das o.g. Statement würde also zunächst:		im Servlet zunächst die Variable "Aggregierung Fach " aufgelöst und dann erst startet der Freemarker-Parser. Für das o.g. Statement würde also zunächst:
			<source lang="sql">
	<#if (einFach.strukturStr = "Fach (intern)" && 10=10 )>		<#if (einFach.strukturStr = "Fach (intern)" && 10=10 )>
			</source>
	ersetzt und dann die Freemarker-IF-Bedingung ausgewertet.		ersetzt und dann die Freemarker-IF-Bedingung ausgewertet.
	So können Sie z.B. auch Checkboxen auswerten, wenn sie nicht angekreuzt sind: nehmen wir an das Feld heißt "nur aktuelle Stg." und hat den Typ "char" und die art=10, dann wäre der Code:		So können Sie z.B. auch Checkboxen auswerten, wenn sie nicht angekreuzt sind: nehmen wir an das Feld heißt "nur aktuelle Stg." und hat den Typ "char" und die art=10, dann wäre der Code:
			<source lang="sql">
	<#if "<<nur aktuelle Stg.>>" ="">		<#if "<<nur aktuelle Stg.>>" ="">
	select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;		select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;
	</#if>		</#if>
			</source>
	Wenn das Feld nicht angekreuzt ist, macht der SuperX-Parser daraus zunächst		Wenn das Feld nicht angekreuzt ist, macht der SuperX-Parser daraus zunächst
			<source lang="sql">
	<#if "" ="">		<#if "" ="">
			</source>
	und Freemarker würde diese if-Bedingung mit "wahr" beantworten und den SQL "select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;" ausführen.		und Freemarker würde diese if-Bedingung mit "wahr" beantworten und den SQL "select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;" ausführen.
	Wenn das Feld angekreuzt wird, macht der SuperX-Parser daraus zunächst		Wenn das Feld angekreuzt wird, macht der SuperX-Parser daraus zunächst
			<source lang="sql">
	<#if "'true'" ="">		<#if "'true'" ="">
			</source>
	und Freemarker würde diese if-Bedingung mit "falsch" beantworten und den SQL "select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;" nicht ausführen.		und Freemarker würde diese if-Bedingung mit "falsch" beantworten und den SQL "select 'Beispiel: nur aktuelle Stg. nicht angekreuzt' from xdummy;" nicht ausführen.

Winterstein am 23. September 2025 um 15:51 Uhr

2025-09-23T15:51:29Z

← Nächstältere Version		Version vom 23. September 2025, 15:51 Uhr
Zeile 499:		Zeile 499:
	Auf diesen View wird dann zum Schluss die Sicht definiert mit quelle='<<SQL>> select caption as name, id as key , parent, ord, nodeattrib, content from sos_iRSZ order by ord,1;'		Auf diesen View wird dann zum Schluss die Sicht definiert mit quelle='<<SQL>> select caption as name, id as key , parent, ord, nodeattrib, content from sos_iRSZ order by ord,1;'

	Durch diese ~~Eintragung~~ in sx_repository kann man nicht nur elegant diesen View erzeugen, sondern hat auch die Möglichkeit in der Abfrage direkt auf die Bedingung in content zuzugreifen		Durch diese Eintragungen in sx_repository kann man nicht nur elegant diesen View erzeugen, sondern hat auch die Möglichkeit in der Abfrage direkt auf die Bedingung in content zuzugreifen

	Eintrag in felderinfo:		Eintrag in felderinfo:

Winterstein: /* Sichten aus Repo-Variablen */

2025-09-23T15:50:24Z

Sichten aus Repo-Variablen

← Nächstältere Version		Version vom 23. September 2025, 15:50 Uhr
Zeile 499:		Zeile 499:
	Auf diesen View wird dann zum Schluss die Sicht definiert mit quelle='<<SQL>> select caption as name, id as key , parent, ord, nodeattrib, content from sos_iRSZ order by ord,1;'		Auf diesen View wird dann zum Schluss die Sicht definiert mit quelle='<<SQL>> select caption as name, id as key , parent, ord, nodeattrib, content from sos_iRSZ order by ord,1;'

	Durch diese Eintragung in sx_repository kann man nicht nur elegant diesen View erzeugen, sondern hat auch die Möglichkeit in Abfrage direkt auf die ~~Bedingungen~~ in content zuzugreifen		Durch diese Eintragung in sx_repository kann man nicht nur elegant diesen View erzeugen, sondern hat auch die Möglichkeit in der Abfrage direkt auf die Bedingung in content zuzugreifen

	Eintrag in felderinfo:		Eintrag in felderinfo:
Zeile 505:		Zeile 505:
	{{ImagePara \|imgsrc=Eintrag in felderinfo.png\|width=500px\|caption=Eintrag in felderinfo}}		{{ImagePara \|imgsrc=Eintrag in felderinfo.png\|width=500px\|caption=Eintrag in felderinfo}}

	Durch den typ=sql und den Wert z.B. SOS_UDE_RSZ sucht das System in ~~sx_repositorygenau~~ diese id und ersetzt sie im SQL durch den Wert in content.		Durch den typ=sql und den Wert z.B. SOS_UDE_RSZ sucht das System in sx_repository genau diese id und ersetzt sie im SQL durch den Wert in content.

	<blockquote>		<blockquote>

Winterstein: /* Sichten aus Repo-Variablen */

2025-09-23T15:46:56Z

Sichten aus Repo-Variablen

@@ Zeile 494: / Zeile 494: @@
 union
 select  3 as ord, id, caption, 'bRSZ' as parent, 0 as nodeattrib, content from sx_repository where id like 'SOS_UDE_bRSZ%'<br />
+;<br />
 </blockquote>