Mercurial > dive4elements > river

annotate artifacts/doc/datacage_ref_de.rst @ 7320:22c85b8232cc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
author Sascha L. Teichmann <teichmann@intevation.de>
date Mon, 14 Oct 2013 15:55:36 +0200
parents d29a5e703cc4
children b33a2a437ab8
rev   line source
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
1 =========
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
2 Datenkorb
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
3 =========
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
4
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
5
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
6 .. contents:: Inhalt
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
7
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
8 Übersicht
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
9 ---------
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
10
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
11 Daten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
12 -----
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
13 Im Datenkorb stehen zwei Arten von Daten zur Auswertung zur Verfügung.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
14
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
15 ``Datensätze``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
16 ~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
17 Datensätze sind Tabellen mit benannten Spalten. Sie werden von Datenquellen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
18 erzeugt und in einem Stapel verwaltet. Die konkreten Werte stehen erst durch
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
19 Auffaltung als Variablen zur Verfügung.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
20
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
21
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
22 ``Variablen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
23 ~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
24 Variablen sind die Werte, die aktuell zur Auswertung zur Verfügung stehen. Sie haben
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
25 einen Namen und einen Typ (String, Zahl, durch Datenquelle bestimmt).
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
26
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
27 Textersatz
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
28 ----------
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
29 Um die Wertebelegungen in das Ausgabedokument schreiben zu kann an entsprechenden
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
30 Stellen eine String-Interpolation durchgeführt werden.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
31 Hier finden zwei Arten von Textersatz ihren Einsatz.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
32
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
33 ``${}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
34 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
35 Die ältere Variante. Innerhalb von Strings werden hier nur Variablen aufgelöst.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
36 Beispiel: "**Hallo, ${planet}!**" wird bei planet = 'Welt' zu "**Hallo, Welt!**".
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
37
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
38 ``{$}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
39 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
40 Die neuere Variante, allerdings noch nicht komplett an allen Stellen einsatzfähig.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
41 Innerhalb der geschweiften Klammern können beliebige XPath-Ausdrück stehen, die
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
42 zu Strings evaluiert werden. Dies orientiert sich an den String-Auswertungen in XSLT.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
43 "**{ concat($greet, ', ', $planet, '!') }**" wird bei gesetzten Variablen greet = Hallo
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
44 und planet = "Welt" zu **Hallo, Welt!** ausgewertet.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
45
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
46 Datenkorb-Elemente
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
47 ------------------
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
48
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
49 Datensätze erzeugen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
50 ~~~~~~~~~~~~~~~~~~~
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
51
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
52 ``dc:context`` Aufspannen eines Gültigkeitsbereiches eines Datenbankdatensatz
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
53 .............................................................................
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
54
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
55 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
56
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
57 <dc:context connection="Verbindung">
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
58 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
59 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
60
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
61 Spannt einen Gültigkeitsbereich für einen Datensatz auf, der aus der Datenbank
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
62 kommt. Die adressierte Datenbank wird über das optionale Attribut 'connection'
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
63 bestimmt. Zur Zeit sind drei Datenbanken angebunden:
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
64
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
65 - **user**: Die Index-Datenbank des Artefakt-Servers. Hierüber stehen Meta-Informationen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
66 zu alten Berechnungen zur Verfügung.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
67
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
68 - **system**: Die FLYS-Datenbank mit den hydrologischen, morphologische und geodätischen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
69 Daten.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
70
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
71 - **seddb**: Die Sediment-Datenbank.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
72
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
73 In einem `<dc:context>`-Element wird zwingend ein `<dc:statement>`-Element erwartet,
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
74 um einen Datensatz aus der Datenbank zu holen. Dieser Datensatz steht dann innerhalb des
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
75 `<dc:context>`-Elementes ein oder mehrfach zur Verfügung. Innerhalb eines
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
76 `<dc:context>`-Elementes können weitere `<dc:context>`-Elemente eingeschachtelt werden.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
77 Ist kein 'connection'-Attribut vorhanden, wird die Datenbank-Verbindung des umgebenen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
78 Kontextes weiterbenutzt. Initial wird je nach Aufrufart der Datenkorbs entweder
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
79 der **user** oder **system**-Kontext angenommen. Dies richtet sich danach, ob in
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
80 der Aufrufumgebung eine Artefakt gesetzt wird oder nicht. Im ersten Fall wird
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
81 angenommen, dass es sich um einen Ladevorgang für zusätzliche Daten handelt, die
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
82 auch alte Berechnungen mit einschliesst.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
83
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
84
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
85 ``dc:statement`` Holen eines Datensatzes aus einer Datenbank
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
86 ............................................................
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
87
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
88 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
89
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
90 <dc:statement>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
91 SQL-Select-Statement.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
92 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
93
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
94 Mittels eines SQL-Select-Statements werden in einem `<dc:context>`-Elementes aus
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
95 der dort definierten Datenbank geholt. Die Spaltennamen der Projektion des SQL-Statements
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
96 werden übernommen und später beim Auffalten des Datensatzes benutzt.
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
97
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
98 ``dc:container-context`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
99
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
100 ``dc:properties`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
101
7318
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
102 ``dc:virtual-column`` Virtuelle Spalten definieren
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
103 ..................................................
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
104
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
105 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
106
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
107 <dc:virtual-column name="Name" type="Type" expr="XPath-Ausdruck">
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
108 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
109 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
110
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
111 Definiert eine neue, virtuelle Spalte namens Name für den aktuellen Datensatz.
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
112 Der Typ wird optional durch Typ festgelegt; ohne Angabe wird der Typ String angenommen.
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
113 Die Wertebelegung ergibt sich aus der zeilenweisen Auswertung des XPath-Ausdrucks.
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
114
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
115 Dies sei an folgendem Beispiel illustriert:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
116
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
117 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
118 +Zahl+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
119 +====+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
120 + 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
121 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
122 + 2+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
123 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
124 + 3+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
125 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
126
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
127 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
128
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
129 <dc:virtual-column name="Quadrat" type="number" expr="$Zahl * $Zahl">
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
130 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
131 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
132
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
133 Erzeugt einen neuen Datensatz folgender Struktur:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
134
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
135 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
136 +Zahl+Quadrat+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
137 +====+=======+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
138 + 1+ 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
139 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
140 + 2+ 4+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
141 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
142 + 3+ 9+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
143 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
144
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
145 Innerhalb eines `virtual-column`-Elementes kann der Datensatz mittel `dc:for-each` wie
7319
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
146 gewohnt realisiert werden. Wird das `dc:virtual-column`-Element verlassen, gilt wieder
7318
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
147 der vormalige Datensatz ohne die zusätzlich Spalte.
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
148
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
149 Datensätze einschränken
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
150 ~~~~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
151
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
152 ``dc:filter`` **TODO**
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
153
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
154 ``dc:group`` **TODO**
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
155
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
156 Datensätze auffalten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
157 ~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
158
7319
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
159 ``dc:for-each`` Realisieren eines Datensatzes
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
160 .............................................
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
161
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
162 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
163
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
164 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
165 ...
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
166 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
167
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
168 Erzeugt nacheinander alle zeilenweisen Realisationen des aktuellen Datensatzes. Die
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
169 einzelnen Spaltenwerte sind dann über Variablen erreichbar, die nach den Spaltenbezeichnern
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
170 des Datenstzes benannt sind.
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
171
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
172 Folgendes Beispiel soll den Sachverhalt illustieren:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
173
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
174 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
175 +Zahl+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
176 +====+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
177 + 1+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
178 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
179 + 2+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
180 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
181 + 3+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
182 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
183
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
184 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
185
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
186 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
187 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
188 <zahl wert="$Zahl"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
189 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
190 </zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
191
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
192 Dies erzeugt folgende Ausgabe:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
193
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
194 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
195
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
196 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
197 <zahl wert="1"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
198 <zahl wert="2"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
199 <zahl wert="3"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
200 </zahlen>
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
201
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
202 ``dc:iterate`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
203
7320
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
204 Bedingte Ausführung
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
205 ~~~~~~~~~~~~~~~~~~~
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
206
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
207 ``<dc:if>`` Einfaches Wenn-Dann ohne Sonst-Fall
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
208 ...............................................
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
209
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
210 .. code:: xml
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
211
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
212 <dc:if test="XPath-Ausdruck">
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
213 ...
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
214 </dc:if>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
215
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
216 Der innere Teil wird nur dann betreten, wenn der XPath-Ausdruck zu
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
217 logisch wahr evaluiert wird. Dieses Konstrukt kennt keinen alternativen
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
218 Pfad, der betreten wird, falls der Ausdruck zu logisch falsch ausgewertet
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
219 wird. Wird dies benötigt, muss man ``<dc:choose>`` benutzen.
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
220 ``<dc:if>`` ist in Symmetrie zu ``<xsl:if>`` von XSLT entworfen worden.
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
221
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
222 ``<dc:choose>`` Ketten von Wenn-Dann-Ausdrücken
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
223 ...............................................
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
224
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
225 .. code:: xml
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
226
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
227 <dc:choose>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
228 <dc:when test="XPath-Ausdruck 1"> ... </dc:when>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
229 <dc:when test="XPath-Ausdruck 2"> ... </dc:when>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
230 ...
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
231 <dc:otherwise> ... </dc:otherwise>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
232 </dc:choose>
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
233
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
234 Es werden der Reihe nach von oben nach unter die ``test``-XPath-Ausdrücke der ``dc:when``-Elemente ausgewertet. Evaluiert ein Ausdruck zu logisch wahr, wird der innere Teil des entsprechenden ``<dc:when>``-Elements betreten. Die verbliebenen
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
235 ``<dc:when>``- und ``<dc:otherwise>``-Elemente werden dann ignoriert. Evaluiert
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
236 keiner der ``test``-Ausdrücke zu wahr, wird der innere Teil des
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
237 ``<dc:otherwise>``-Elements betreten.
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
238 ``<dc:choose>`` ist in Symmetrie zu ``<xsl:choose>`` von XSLT entworfen worden.
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
239
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
240
22c85b8232cc Datacage ref doc: Move dc:if & dc:choose up because they are more important than other elements.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7319
diff changeset
241
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
242 Makros
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
243 ~~~~~~
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
244 Um innerhalb des Definitionsdokumentes Wiederholungen zu vermeiden, können sogenannte
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
245 Makros definiert werden, die dann von anderer Stellen aus eingefügt werden können.
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
246
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
247 ``dc:macro`` Wiederverwendbare Teile definieren
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
248 ...............................................
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
249
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
250 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
251
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
252 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
253 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
254 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
255
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
256 Definiert ein Makro namens Name. Nach der Definition ist dieses dann unter diesem
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
257 Namen global innerhalb des Definitionsdokumentes bekannt. Makros können geschachtelt
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
258 werden. Auch eingeschachtelte Makros sind global sichtbar. Die Makrodefinition und
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
259 ihre eingeschalteten Elemente werden nicht in das Ausgabedokument übernommen.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
260
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
261 ``dc:call-macro`` Makros aufrufen
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
262
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
263 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
264
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
265 <dc:call-macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
266
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
267 Ruft ein Makro names Name auf. Dieses muss mit `dc:macro` definiert sein. Die Reihenfolge
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
268 von Definition und Aufruf ist egal.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
269
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
270 ``dc:macro-body`` Elemente an ein Makro übergeben
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
271 .................................................
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
272
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
273 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
274
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
275 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
276 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
277 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
278 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
279 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
280
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
281 Um an Makros weitere Bausteine als Argument übergeben zu können, ist es optional
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
282 möglich innerhalb einer Makrodefinition ein Element `dc:macro-body` einzufügen.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
283 Dieses Element expandiert sich zum Inhalt des `dc:call-macro`-Aufrufs.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
284
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
285 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
286
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
287 <dc:call-macro name="Name">Inhalt von dc:macro-body</dc:call-macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
288
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
289 Zur Verdeutlichung ein konkretes Beispiel
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
290
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
291 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
292
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
293 <dc:macro name="Greetings">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
294 <Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
295 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
296 </Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
297 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
298
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
299 <dc:call-macro name="Greetings">Welt</dc:call-macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
300 <dc:call-macro name="Greetings">Mond</dc:call-macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
301
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
302 Dies produziert folgende Ausgabe
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
303
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
304 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
305
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
306 <Hallo>Welt</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
307 <Hallo>Mond</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
308
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
309 Das Haupteinsatzgebiet dieses Konstruktes ist die transparente Bereitstellung
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
310 von Kontexten, die dann verschiedentlich ausgewertet werden sollen.
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
311
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
312 Sonstige Elemente
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
313 ~~~~~~~~~~~~~~~~~
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
314
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
315 ``dc:element`` Hinzufügen neuer Elemente in der Ausgabe
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
316 .......................................................
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
317
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
318 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
319
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
320 <dc:element name="Name">
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
321 ...
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
322 </dc:element>
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
323
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
324 Erzeugt ein Element namens Name. Für den Namen gelten die `${}-Ersetzungen`_.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
325
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
326
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
327 ``dc:attribute`` Hinzufügen neuer Attribute zum umgebenden Ausgabeelement
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
328 .........................................................................
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
329
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
330 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
331
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
332 <dc:attribute name="Name" value="Wert"/>
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
333
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
334 Fügt dem umgebenden Ausgabeelement ein weiteres Attribut namens Name mit dem
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
335 Wert von Wert hinzu. Für Namen und Wert gelten die `${}-Ersetzungen`_.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
336 Der Einsatz dieses Konstrukts findet häufig im Zusammenhang mit dc:element
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
337 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
338 erstellt werden soll.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
339
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
340 ``dc:comment`` Kommentare im Beschreibungsdokument
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
341 ..................................................
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
342
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
343 .. code:: xml
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
344
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
345 <dc:comment>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
346 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
347 </dc:comment>
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
348
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
349 Ein Kommentar auf Ebene des Beschreibungsdokumentes, das keinerlei Ausgabe
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
350 im Ausgabedokument erzeugt. Eingeschachtelte Elemente werden ebenfalls nicht ausgewertet.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
351 Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen!
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
352
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
353
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
354 ``dc:message`` Ausgabe auf die Diagnoseausgabe (Log)
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
355 ....................................................
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
356
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
357 .. code:: xml
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
358
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
359 <dc:message>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
360 Text für die Diagnose.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
361 </dc:message>
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
362
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
363 Gibt den Text innerhalb des Elementes aus Ausgabe im Log aus. Dies dient in erster Linie
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
364 dem Nachvollziehen von Aufrufen innerhalb des Datenkorbdokumentes. Für den Text gelten
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
365 die `{$}-Ersetzungen`_.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
366
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
367 ``dc:variable`` Erzeugung einer kontext-lokalen Variablen
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
368 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
369
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
370 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
371
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
372 <dc:variable name="Name" type="Typ" expr="XPath-Ausdruck"/>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
373
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
374 Legt im aktuellen Kontext eine lokale Variable namens Name an. Diese hat den
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
375 Typ Typ und entsteht durch Auswertung des XPath-Ausdruck expr. Der Typ
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
376 ist optional. Wird dieser nicht gesetzt, wird das Ergebnis als String interpretiert.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
377 Alternativ können hier die Werte 'number' für Zahlen, 'bool' für Boolean-Werte
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
378 benutzt werden. Für den Namen und den Typ gelten die `${}-Ersetzungen`_.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
379 Wird der aktuellen `dc:context` verlassen, ist diese Variable nicht mehr definiert.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
380
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
381
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
382 ``dc:convert`` kontext-lokale Konvertierung von Variablen
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
383 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
384
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
385 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
386
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
387 <dc:convert name="Name" type="Typ"/>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
388
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
389 Konvertiert die Variable namens Name für die Gültigkeit des aktuellen Kontextes in
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
390 einen anderen Typ. Für Name und Typ gelten die `${}-Ersetzungen`_. Für die
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
391 Typen gilt das gleiche wie für die Typen von `dc:variable`.
7255
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
392
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
393
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
394 Datenkorb-Funktionen
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
395 --------------------
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
396
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
397 ``dc:contains`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
398
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
399 ``dc:fromValue`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
400
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
401 ``dc:toValue`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
402
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
403 ``dc:replace`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
404
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
405 ``dc:replace-all`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
406
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
407 ``dc:has-result`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
408
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
409 ``dc:group-key`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
410
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
411 ``dc:date-format`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
412
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
413 ``dc:dump-variables`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
414
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
415 ``dc:get`` **TODO**
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
416
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
417
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
418
http://dive4elements.wald.intevation.org