Mercurial > dive4elements > river
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 < 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**