[PATCH] Datacage ref doc: Explain dc:filter

[Wald Commits]

# HG changeset patch
# User Sascha L. Teichmann <teichmann at intevation.de>
# Date 1381759596 -7200
# Node ID b33a2a437ab8c087bc4dd54ef853264cee98be10
# Parent  22c85b8232cc5b127c76320621654dba6076c1ed
Datacage ref doc: Explain dc:filter.

diff -r 22c85b8232cc -r b33a2a437ab8 artifacts/doc/datacage_ref_de.rst
--- 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 < 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**