Mercurial > dive4elements > river

comparison artifacts/doc/datacage_ref_de.rst @ 7314:53d1dd441867

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Datacage ref doc: More structure. Explain text interpolation.
author Sascha L. Teichmann <teichmann@intevation.de>
date Mon, 14 Oct 2013 13:08:33 +0200
parents 5783bd29de8a
children 8498fdd71a1e
comparison
equal deleted inserted replaced
7313:bcae19901bf0 7314:53d1dd441867
6 .. contents:: Inhalt 6 .. contents:: Inhalt
7 7
8 Übersicht 8 Übersicht
9 --------- 9 ---------
10 10
11 Daten
12 -----
13 Im Datenkorb stehen zwei Arten von Daten zur Auswertung zur Verfügung.
14
15 ``Datensätze``
16 ~~~~~~~~~~~~~~
17 Datensätze sind Tabellen mit benannten Spalten. Sie werden von Datenquellen
18 erzeugt und in einem Stapel verwaltet. Die konkreten Werte stehen erst durch
19 Auffaltung als Variablen zur Verfügung.
20
21
22 ``Variablen``
23 ~~~~~~~~~~~~~
24 Variablen sind die Werte, die aktuell zur Auswertung zur Verfügung stehen. Sie haben
25 einen Namen und einen Typ (String, Zahl, durch Datenquelle bestimmt).
26
27 Textersatz
28 ----------
29 Um die Wertebelegungen in das Ausgabedokument schreiben zu kann an entsprechenden
30 Stellen eine String-Interpolation durchgeführt werden.
31 Hier finden zwei Arten von Textersatz ihren Einsatz.
32
33 ``${}-Ersetzungen``
34 ~~~~~~~~~~~~~~~~~~~
35 Die ältere Variante. Innerhalb von Strings werden hier nur Variablen aufgelöst.
36 Beispiel: "**Hallo, ${planet}!**" wird bei planet = 'Welt' zu "**Hallo, Welt!**".
37
38 ``{$}-Ersetzungen``
39 ~~~~~~~~~~~~~~~~~~~
40 Die neuere Variante, allerdings noch nicht komplett an allen Stellen einsatzfähig.
41 Innerhalb der geschweiften Klammern können beliebige XPath-Ausdrück stehen, die
42 zu Strings evaluiert werden. Dies orientiert sich an den String-Auswertungen in XSLT.
43 "**{ concat($greet, ', ', $planet, '!') }**" wird bei gesetzten Variablen greet = Hallo
44 und planet = "Welt" zu **Hallo, Welt!** ausgewertet.
45
11 Datenkorb-Elemente 46 Datenkorb-Elemente
12 ------------------ 47 ------------------
13 48
14 ``dc:element`` **TODO** 49 Datensätze erzeugen
15 50 ~~~~~~~~~~~~~~~~~~~
16 ``dc:attribute`` **TODO**
17 51
18 ``dc:context`` **TODO** 52 ``dc:context`` **TODO**
19 53
20 ``dc:statement`` **TODO** 54 ``dc:statement`` **TODO**
21 55
22 ``dc:container-context`` **TODO** 56 ``dc:container-context`` **TODO**
23 57
24 ``dc:properties`` **TODO** 58 ``dc:properties`` **TODO**
25 59
60 ``dc:virtual-column`` **TODO**
61
62 Datensätze einschränken
63 ~~~~~~~~~~~~~~~~~~~~~~~
64
65 ``dc:filter`` **TODO**
66
67 ``dc:group`` **TODO**
68
69 Datensätze auffalten
70 ~~~~~~~~~~~~~~~~~~~~
71
26 ``dc:for-each`` **TODO** 72 ``dc:for-each`` **TODO**
27 73
28 ``dc:iterate`` **TODO** 74 ``dc:iterate`` **TODO**
29 75
30 ``dc:virtual-column`` **TODO** 76 Makros
77 ~~~~~~
31 78
32 ``dc:macro`` **TODO** 79 ``dc:macro`` **TODO**
33 80
34 ``dc:macro-body`` **TODO** 81 ``dc:macro-body`` **TODO**
35 82
36 ``dc:call-macro`` **TODO** 83 ``dc:call-macro`` **TODO**
37 84
85 Sonstige Elemente
86 ~~~~~~~~~~~~~~~~~
87
88 ``dc:element`` Hinzufügen neuer Elemente in der Ausgabe
89 .......................................................
90
91 .. code:: xml
92
93 <dc:element name="Name">
94 ...
95 </dc:element>
96
97 Erzeugt ein Element namens Name. Für den Namen gelten die `${}-Ersetzungen`_.
98
99
100 ``dc:attribute`` Hinzufügen neuer Attribute zum umgebenden Ausgabeelement
101 .........................................................................
102
103 .. code:: xml
104
105 <dc:attribute name="Name" value="Wert"/>
106
107 Fügt dem umgebenden Ausgabeelement ein weiteres Attribut namens Name mit dem
108 Wert von Wert hinzu. Für Namen und Wert gelten die `${}-Ersetzungen`_.
109 Der Einsatz dieses Konstrukts findet häufig im Zusammenhang mit dc:element
110 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen
111 erstellt werden soll.
112
113
114
115
38 ``dc:comment`` **TODO** 116 ``dc:comment`` **TODO**
39
40 ``dc:filter`` **TODO**
41
42 ``dc:group`` **TODO**
43 117
44 ``dc:message`` **TODO** 118 ``dc:message`` **TODO**
45 119
46 ``dc:variable`` **TODO** 120 ``dc:variable`` **TODO**
47 121
83 keiner der ``test``-Ausdrücke zu wahr, wird der innere Teil des 157 keiner der ``test``-Ausdrücke zu wahr, wird der innere Teil des
84 ``<dc:otherwise>``-Elements betreten. 158 ``<dc:otherwise>``-Elements betreten.
85 ``<dc:choose>`` ist in Symmetrie zu ``<xsl:choose>`` von XSLT entworfen worden. 159 ``<dc:choose>`` ist in Symmetrie zu ``<xsl:choose>`` von XSLT entworfen worden.
86 160
87 161
88 Variablen
89 ---------
90
91 Textersatz
92 ----------
93 162
94 Datenkorb-Funktionen 163 Datenkorb-Funktionen
95 -------------------- 164 --------------------
96 165
97 ``dc:contains`` **TODO** 166 ``dc:contains`` **TODO**
http://dive4elements.wald.intevation.org