diff artifacts/doc/datacage_ref_de.rst @ 7321:b33a2a437ab8

Datacage ref doc: Explain dc:filter.
author Sascha L. Teichmann <teichmann@intevation.de>
date Mon, 14 Oct 2013 16:06:36 +0200
parents 22c85b8232cc
children 7be4425eaca9
line wrap: on
line diff
--- a/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 15:55:36 2013 +0200
+++ b/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 16:06:36 2013 +0200
@@ -149,7 +149,55 @@
 Datensätze einschränken
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-``dc:filter`` **TODO**
+``dc:filter`` Selektieren einzelner Zeilen aus dem aktuellen Datensatz
+......................................................................
+
+.. code:: xml
+
+    <dc:filter expr="XPath-Ausdruck">
+      ...
+    <dc:filter>
+
+Evaluiert pro Zeile des aktuellen Datensatzes den XPath-Ausdruck 'expr' und erzeugt
+einen neuen Datensatz, der nur die Zeilen des Originaldatensatzes enthält für den
+die Auswertung logisch wahr ergab. Im XPath-Ausdruck stehen die aufgefalteten Werte
+der jeweiligen Zeile zur Verfügung.
+
+Folgends Beipiel soll dies verdeutlichen:
+
+ +----+
+ +Zahl+
+ +====+
+ +   1+
+ +----+
+ +   2+
+ +----+
+ +   3+
+ +----+
+ +   4+
+ +----+
+
+Zahlen erhalten, die einen Wert kleiner drei haben.
+
+.. code:: xml
+
+    <dc:filter expr="$Zahl &lt; 3">
+      ...
+    <dc:filter>
+
+Dies erzeugt folgenden neuen Datensatz:
+
+ +----+
+ +Zahl+
+ +====+
+ +   1+
+ +----+
+ +   2+
+ +----+
+
+Innerhalb des `dc:filter`-Elementes kann der neue Datensatz wie gewohnt mit `dc:for-each`
+realisiert werden. Nach Verlassen des `dc:filter`-Elementes ist wieder der vormalige
+Datensatz aktuell.
 
 ``dc:group`` **TODO**
 

http://dive4elements.wald.intevation.org