Eigene Funktionen - Versionsgeschichte

Veltrup am 5. Mai 2015 um 08:17 Uhr

2015-05-05T08:17:46Z

Veltrup: /* Fehlerbehandlung */

2015-05-05T07:33:48Z

Fehlerbehandlung

Veltrup am 5. Mai 2015 um 07:33 Uhr

2015-05-05T07:33:15Z

Veltrup: Die Seite wurde neu angelegt: „Eigene Funktionen können in SPML nicht innerhalb eines Templates/SPML-Datei definiert werden. Jede Funktion in SPML ist ein eigenes Templates/SPML-Datei. Mit Hi…“

2015-05-05T07:13:53Z

Die Seite wurde neu angelegt: „Eigene Funktionen können in SPML nicht innerhalb eines Templates/SPML-Datei definiert werden. Jede Funktion in SPML ist ein eigenes Templates/SPML-Datei. Mit Hi…“

Neue Seite

Eigene Funktionen können in SPML nicht innerhalb eines Templates/SPML-Datei definiert werden. Jede Funktion in SPML ist ein eigenes Templates/SPML-Datei.

Mit Hilfe von [[sp:include]] kann das Funktions-Template aufgerufen werden.

===Funktions-Argumente===
Dem Funktionsaufruf können Argumente übergeben werden. Dafür wird im Body von sp:include der [[sp:argument]]-Tag verwenden

Aufrufender Include:
<source lang="xml">
<sp:include template="!{myfunctions.addition}">
<sp:argument name="myvar1" value="x"/>
<sp:argument name="myobj1" object="system.information.myfield"/>
</sp:include>
</source>

Die Abfrage der Übergabe-Argumente in dem Funktions-Template erfolgt über <code>system.arguments</code> und enthält eine [[Map]] mit den Argumenten.

Funktions-Template:
<source lang="xml">
<sp:print name="system.arguments"/>
</source>

===Rückgabe-Wert===
Um Werte einer Funktion zurück zu geben wird der [[sp:return]]-Tag verwendet. Dieser beendet sofort die Ausführung der Funktion und liefert den angegebene Wert an den aufrufenden sp:include-Tag zurück. Der Include-Tag kann ein Attribut <code>return</code> definieren in dem der Name der Variable angegeben wird in dem der Rückgabe-Wert gespeichert werden soll.

Aufrufender Include:
<source lang="xml">
<sp:include template="!{myfunction}" return="c">
<sp:argument name="mode" value="x"/>
<sp:argument name="value" object="myvalue"/>
</sp:include>
result: <sp:print name="c"/>
</source>

Funktions-Template
<source lang="xml">
<sp:condition>
<sp:if name="system.arguments.mode" eq="x">
<sp:return expression="${system.arguments.value} + 10"/>
</sp:if>
<sp:else>
<sp:return expression="${system.arguments.value} * 2"/>
</sp:else>
</sp:condition>
</source>

===Fehlerbehandlung===
Zur Fehlerbehandlung gibt es keine zusätzliche Funktionalität. Hierfür wird ebenfalls sp:return verwendet. Das im Fehler-Fall entsprechende selbst definierte Fehler-Objekte zurück liefert.

Aufrufender Include:
<source lang="xml">
<sp:include template="!{myfunction}" return="_result">
<sp:argument name="mode" value="x"/>
<sp:argument name="value" object="myvalue"/>
</sp:include>
<sp:condition>
<sp:if name="_result.success">
result: <sp:print name="_result.value"/>
</sp:if>
<sp:else>
error: <sp:print name="_result.message"/>
</sp:else>
</sp:condition>

</source>

Funktions-Template
<source lang="xml">
<sp:map name="_result" action="new"/>
<sp:map name="_result" key="success" action="add" value="true"/>
<sp:condition>
<sp:if name="system.arguments.mode" eq="x">
<sp:set name="_result.value" expression="${system.arguments.value} + 10"/>
</sp:if>
<sp:if name="system.arguments.mode" eq="y">
<sp:set name="_result.value" expression="${system.arguments.value} * 2"/>
</sp:if>
<sp:else>
<sp:map name="_result" key="success" action="add" value="false"/>
<sp:map name="_result" key="message" action="add" value="invalid mode '${system.arguments.mode}'"/>
</sp:else>
</sp:condition>
</source>
<noinclude>
[[Category:Funktionen]]
</noinclude>

← Nächstältere Version		Version vom 5. Mai 2015, 08:17 Uhr
Zeile 1:		Zeile 1:
		+	''Ab Version 2.13''
		+
	Eigene Funktionen können in SPML nicht innerhalb eines Templates/SPML-Datei definiert werden. Jede Funktion in SPML ist ein eigenes Templates/SPML-Datei.		Eigene Funktionen können in SPML nicht innerhalb eines Templates/SPML-Datei definiert werden. Jede Funktion in SPML ist ein eigenes Templates/SPML-Datei.

← Nächstältere Version		Version vom 5. Mai 2015, 07:33 Uhr
Zeile 47:		Zeile 47:

	===Fehlerbehandlung===		===Fehlerbehandlung===
−	Zur Fehlerbehandlung gibt es keine zusätzliche Funktionalität. Hierfür wird ebenfalls sp:return verwendet. Das im ~~Fehler~~-Fall entsprechende selbst definierte ~~Fehler~~-Objekte zurück liefert.	+	Zur Fehlerbehandlung gibt es keine zusätzliche Funktionalität. Hierfür wird ebenfalls sp:return verwendet. Das im diesem-Fall entsprechende selbst definierte Result-Objekte zurück liefert.

@@ Zeile 52: / Zeile 52: @@
 Aufrufender Include:
 <source lang="xml">
-<sp:include template="!{myfunction}" return="_result">
+<sp:set name="myvalue" value="5"/>
     <sp:argument name="mode" value="x"/>
     <sp:argument name="value" object="myvalue"/>
@@ Zeile 64: / Zeile 65: @@
     </sp:else>
 </sp:condition>
 </source>
@@ Zeile 70: / Zeile 70: @@
 <source lang="xml">
 <sp:map name="_result" action="new"/>
-<sp:map name="_result" key="success" action="add" value="true"/>
+<sp:map name="_result" key="success" action="put" value="true"/>
 <sp:condition>
     <sp:if name="system.arguments.mode" eq="x">
-       <sp:set name="_result.value" expression="${system.arguments.value} + 10"/>
+       <sp:map name="_result" key="value" action="put" expression="${system.arguments.value} + 10"/>
     </sp:if>
     <sp:else>
-       <sp:map name="_result" key="success" action="add" value="false"/>
+       <sp:map name="_result" key="success" action="put" value="false"/>
-       <sp:map name="_result" key="message" action="add" value="invalid mode '${system.arguments.mode}'"/>
+       <sp:map name="_result" key="message" action="put" value="invalid mode '${system.arguments.mode}'"/>
     </sp:else>
 </sp:condition>
 </source>
 <noinclude>
 [[Category:Funktionen]]
 </noinclude>