[PATCH] Datacage ref doc: Explain dc:virtual-column

[Wald Commits]

# HG changeset patch
# User Sascha L. Teichmann <teichmann at intevation.de>
# Date 1381758214 -7200
# Node ID d8ca7a1d522c3b4ed8b31dbb1655247ba7e7d445
# Parent  00b17e77c2e82675c96cee1eea9975624c02d9c9
Datacage ref doc: Explain dc:virtual-column.

diff -r 00b17e77c2e8 -r d8ca7a1d522c artifacts/doc/datacage_ref_de.rst
--- 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
 ~~~~~~~~~~~~~~~~~~~~~~~