Mercurial > dive4elements > river
changeset 7316:52bc38e6bbe1
Datacage ref doc: Explain dc:variable and dc:convert.
author | Sascha L. Teichmann <teichmann@intevation.de> |
---|---|
date | Mon, 14 Oct 2013 14:40:51 +0200 |
parents | 8498fdd71a1e |
children | 00b17e77c2e8 |
files | artifacts/doc/datacage_ref_de.rst |
diffstat | 1 files changed, 36 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/artifacts/doc/datacage_ref_de.rst Mon Oct 14 13:44:54 2013 +0200 +++ b/artifacts/doc/datacage_ref_de.rst Mon Oct 14 14:40:51 2013 +0200 @@ -154,6 +154,7 @@ ``dc:comment`` Kommentare im Beschreibungsdokument .................................................. + .. code:: xml <dc:comment> @@ -165,12 +166,44 @@ Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen! -``dc:message`` **TODO** +``dc:message`` Ausgabe auf die Diagnoseausgabe (Log) +.................................................... -``dc:variable`` **TODO** +.. code:: xml -``dc:convert`` **TODO** + <dc:message> + Text für die Diagnose. + </dc:message> +Gibt den Text innerhalb des Elementes aus Ausgabe im Log aus. Dies dient in erster Linie +dem Nachvollziehen von Aufrufen innerhalb des Datenkorbdokumentes. Für den Text gelten +die `{$}-Ersetzungen`_. + +``dc:variable`` Erzeugung einer kontext-lokalen Variablen +......................................................... + +.. code:: xml + + <dc:variable name="Name" type="Typ" expr="XPath-Ausdruck"/> + +Legt im aktuellen Kontext eine lokale Variable namens Name an. Diese hat den +Typ Typ und entsteht durch Auswertung des XPath-Ausdruck expr. Der Typ +ist optional. Wird dieser nicht gesetzt, wird das Ergebnis als String interpretiert. +Alternativ können hier die Werte 'number' für Zahlen, 'bool' für Boolean-Werte +benutzt werden. Für den Namen und den Typ gelten die `${}-Ersetzungen`_. +Wird der aktuellen `dc:context` verlassen, ist diese Variable nicht mehr definiert. + + +``dc:convert`` kontext-lokale Konvertierung von Variablen +......................................................... + +.. code:: xml + + <dc:convert name="Name" type="Typ"/> + +Konvertiert die Variable namens Name für die Gültigkeit des aktuellen Kontextes in +einen anderen Typ. Für Name und Typ gelten die `${}-Ersetzungen`_. Für die +Typen gilt das gleiche wie für die Typen von `dc:variable`. Bedingte Ausführung ~~~~~~~~~~~~~~~~~~~