diff artifacts/doc/datacage_ref_de.rst @ 7319:d29a5e703cc4

Datacage ref doc: Explain dc:for-each
author Sascha L. Teichmann <teichmann@intevation.de>
date Mon, 14 Oct 2013 15:53:06 +0200
parents d8ca7a1d522c
children 22c85b8232cc
line wrap: on
line diff
--- a/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 15:43:34 2013 +0200
+++ b/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 15:53:06 2013 +0200
@@ -143,7 +143,7 @@
  +----+-------+
 
 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 
+gewohnt realisiert werden. Wird das `dc:virtual-column`-Element verlassen, gilt wieder
 der vormalige Datensatz ohne die zusätzlich Spalte.
 
 Datensätze einschränken
@@ -156,7 +156,48 @@
 Datensätze auffalten
 ~~~~~~~~~~~~~~~~~~~~
 
-``dc:for-each`` **TODO**
+``dc:for-each`` Realisieren eines Datensatzes
+.............................................
+
+.. code:: xml
+
+    <dc:for-each>
+      ...
+    <dc:for-each>
+
+Erzeugt nacheinander alle zeilenweisen Realisationen des aktuellen Datensatzes. Die
+einzelnen Spaltenwerte sind dann über Variablen erreichbar, die nach den Spaltenbezeichnern
+des Datenstzes benannt sind.
+
+Folgendes Beispiel soll den Sachverhalt illustieren:
+
+ +----+
+ +Zahl+
+ +====+
+ +   1+
+ +----+
+ +   2+
+ +----+
+ +   3+
+ +----+
+
+.. code:: xml
+
+    <zahlen>
+      <dc:for-each>
+        <zahl wert="$Zahl"/>
+      <dc:for-each>
+    </zahlen>
+
+Dies erzeugt folgende Ausgabe:
+
+.. code:: xml
+
+    <zahlen>
+        <zahl wert="1"/>
+        <zahl wert="2"/>
+        <zahl wert="3"/>
+    </zahlen>
 
 ``dc:iterate`` **TODO**
 

http://dive4elements.wald.intevation.org