diff artifacts/doc/datacage_ref_de.rst @ 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
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
 ~~~~~~~~~~~~~~~~~~~~~~~

http://dive4elements.wald.intevation.org