Mercurial > dive4elements > river
changeset 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 |
| files | artifacts/doc/datacage_ref_de.rst |
| diffstat | 1 files changed, 49 insertions(+), 1 deletions(-) [+] |
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**