Mercurial > dive4elements > river
changeset 7318:d8ca7a1d522c
Datacage ref doc: Explain dc:virtual-column.
author | Sascha L. Teichmann <teichmann@intevation.de> |
---|---|
date | Mon, 14 Oct 2013 15:43:34 +0200 |
parents | 00b17e77c2e8 |
children | d29a5e703cc4 |
files | artifacts/doc/datacage_ref_de.rst |
diffstat | 1 files changed, 46 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/artifacts/doc/datacage_ref_de.rst Mon Oct 14 15:27:49 2013 +0200 +++ b/artifacts/doc/datacage_ref_de.rst Mon Oct 14 15:43:34 2013 +0200 @@ -99,7 +99,52 @@ ``dc:properties`` **TODO** -``dc:virtual-column`` **TODO** +``dc:virtual-column`` Virtuelle Spalten definieren +.................................................. + +.. code:: xml + + <dc:virtual-column name="Name" type="Type" expr="XPath-Ausdruck"> + ... + </dc:virtual-column> + +Definiert eine neue, virtuelle Spalte namens Name für den aktuellen Datensatz. +Der Typ wird optional durch Typ festgelegt; ohne Angabe wird der Typ String angenommen. +Die Wertebelegung ergibt sich aus der zeilenweisen Auswertung des XPath-Ausdrucks. + +Dies sei an folgendem Beispiel illustriert: + + +----+ + +Zahl+ + +====+ + + 1+ + +----+ + + 2+ + +----+ + + 3+ + +----+ + +.. code:: xml + + <dc:virtual-column name="Quadrat" type="number" expr="$Zahl * $Zahl"> + ... + </dc:virtual-column> + +Erzeugt einen neuen Datensatz folgender Struktur: + + +----+-------+ + +Zahl+Quadrat+ + +====+=======+ + + 1+ 1+ + +----+-------+ + + 2+ 4+ + +----+-------+ + + 3+ 9+ + +----+-------+ + +Innerhalb eines `virtual-column`-Elementes kann der Datensatz mittel `dc:for-each` wie +gewohnt realisiert werden. Wird das `dc:virtual-column`-Element verlassen, gilt wieder +der vormalige Datensatz ohne die zusätzlich Spalte. Datensätze einschränken ~~~~~~~~~~~~~~~~~~~~~~~