Mercurial > dive4elements > river

annotate artifacts/doc/datacage_ref_de.rst @ 7458:b2e167f193d7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
run_geo.sh: allow logging as documented.
author Tom Gottfried <tom.gottfried@intevation.de>
date Tue, 29 Oct 2013 18:57:40 +0100
parents f26e7d386d8c
children b3534220aac7
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
7379
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
11 Der Datenkorb ist im Kern ein Dive4Elements/River eingebetteter Webdienst,
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
12 der dazu dient, ein XML-Dokument zu generieren, das seinerseits benutzt
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
13 werden kann, um Daten so identifizierbar zu machen, dass sie zu
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
14 Projekten innerhalb von Dive4Elements/River hinzugeladen werden können.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
15
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
16 Das vom Datenkorb erzeugte XML-Dokument wird dann vom D4E/River-Client in
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
17 eine Baumansicht innerhalb der graphischen Benutzeroberfläche
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
18 transformiert.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
19
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
20 Die Grundlage für das XML-Doument, das an die Oberfäche gesandt wird,
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
21 ist ein XML-Dokument namens ``meta-data.xml``, das im ``conf``-Verzeichnis
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
22 des Servers als Template für die Ausgabe-XML benutzt wird.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
23
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
24 Dieses Referenzhandbuch beschreibt die Strukturen innerhalb von
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
25 ``metadata.xml``.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
26
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
27 Grundstruktur
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
28 -------------
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
29
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
30 Das Grundgerüst einer validen ``meta-data.xml`` sieht sieh so aus:
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
31
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
32 .. code:: xml
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
33
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
34 <xml version="1.0" encoding="UTF-8">
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
35 <dc:template xmlns:dc="http://www.intevation.org/2011/Datacage">
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
36 <datacage>
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
37 ...
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
38 </datacage>
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
39 </dc:template>
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
40
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
41 Dies erzeugt folgendes Dokument:
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
42
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
43 .. code:: xml
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
44
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
45 <xml version="1.0" encoding="UTF-8">
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
46 <datacage>
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
47 ...
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
48 </datacage>
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
49
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
50 Elemente, die nicht aus dem Namespace ``dc`` stammen, werden durchkopiert.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
51 ``dc``-Elemente dienen der Steuerung des Templating. Generell kann sagen,
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
52 dass das ``meta-data.xml``-Template mittels einer
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
53 rekursiven Tiefensuche (siehe http://de.wikipedia.org/wiki/Tiefensuche)
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
54 über seine Elemente abgearbeitet wird.
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
55
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
56 Daten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
57 -----
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
58 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
59
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
60 ``Datensätze``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
61 ~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
62 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
63 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
64 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
65
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
66 ``Variablen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
67 ~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
68 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
69 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
70
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
71 Textersatz
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
72 ----------
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
73 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
74 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
75 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
76
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
77 ``${}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
78 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
79 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
80 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
81
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
82 ``{$}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
83 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
84 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
85 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
86 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
87 "**{ 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
88 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
89
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
90 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
91 ------------------
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
92
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
93 Datensätze erzeugen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
94 ~~~~~~~~~~~~~~~~~~~
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
95
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
96 ``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
97 .............................................................................
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
98
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
99 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
100
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
101 <dc:context connection="Verbindung">
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
102 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
103 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
104
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
105 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
106 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
107 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
108
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
109 - **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
110 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
111
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
112 - **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
113 Daten.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
114
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
115 - **seddb**: Die Sediment-Datenbank.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
116
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
117 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
118 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
119 `<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
120 `<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
121 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
122 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
123 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
124 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
125 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
126 auch alte Berechnungen mit einschliesst.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
127
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
128
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
129 ``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
130 ............................................................
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
131
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
132 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
133
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
134 <dc:statement>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
135 SQL-Select-Statement.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
136 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
137
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
138 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
139 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
140 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
141
7379
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
142 ``dc:container-context`` Tabellarische Daten aus der Programm-Umgebung
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
143 ......................................................................
e07dc8854a8f More datacage ref doc.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7322
diff changeset
144
7401
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
145 .. 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
146
7401
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
147 <dc:container-context container="Container">
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
148 ...
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
149 </dc:container-context>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
150
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
151 Dies spannt einen Kontext auf einem Container namens Container auf,
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
152 einer listen-ähnlichen Struktur, die als externe Datenquellen in
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
153 Form eines Java-Objekts an den Datenkorb übergeben werden kann.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
154 Dies müssen Klassen sein, die das Interface ``java.util.Collection``
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
155 implementieren. Mit diesem Konstrukt ist es möglich, tabellarische
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
156 Ergebnisse von außen in die Auswertung des Datenkorbs zu integrieren.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
157 Der Container muss hierfür über die Variable ``Container`` zur Verfügung
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
158 gestellt werden. Die Spalten des Tabelle werden über ``dc:properties``
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
159 definiert. Der Datensatz selbst kann wie gewohnt mittels ``dc:for-each``
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
160 realisiert werden.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
161
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
162 ``dc:properties`` Spaltendefinitionen für externe Daten aus der Programm-Umgebung
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
163 .................................................................................
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
164
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
165 .. code:: xml
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
166
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
167 <dc:container-context container="Container">
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
168 <dc:properties>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
169 <dc:property name="name" alias="alias"/>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
170 </dc:properties>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
171 </dc:container-context>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
172
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
173 Muss innerhalb eines ``dc:container-context`` angegeben werden und enthält eine
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
174 Liste von Attributen der Java-Objekte, die in den Datenkorb eingeblendet werden sollen.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
175 Die Auflösung der Namen auf der Java-Seite funktioniert nach Konvention von Java-Beans,
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
176 sprich aus ``name`` wird ``getName``. ``alias`` ist optional und weisst explizit einen
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
177 Spaltennamen aus. Dies entspricht im Wesentlichen einen 'AS' bei einem SQL-Statement.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
178
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
179 Ein vollständigeres Beispiel könnte in etwa so aussehen.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
180 Die Java-Seite:
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
181
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
182 .. code:: java
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
183
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
184 public class Car {
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
185
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
186 private String marke;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
187 private String name;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
188
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
189 public Car(String marke, String name) {
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
190 this.marke = marke;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
191 this.name = name;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
192 }
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
193
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
194 public String getMarke() {
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
195 return marke;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
196 }
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
197
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
198 public String getName() {
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
199 return name;
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
200 }
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
201 }
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
202
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
203 // Liste befuellen.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
204
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
205 java.util.Container<Car> container = new java.util.ArrayList<Car>();
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
206
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
207 container.add(new Car("Volvo", "V80"));
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
208 container.add(new Car("Ferrari", "Testarossa"));
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
209
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
210 // Dem Datenkorb uebergeben.
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
211
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
212 parameters.put("CARS", cars);
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
213
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
214 Das Datenkorb-Schnipsel
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
215
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
216 .. code:: xml
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
217
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
218 <dc:container-context container="cars">
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
219 <dc:properties>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
220 <dc:property name="marke" alias="brand" />
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
221 <dc:property name="name" alias="type" />
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
222 </dc:properties>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
223
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
224 <cars>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
225 <dc:for-each>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
226 <car type="$type" brand="$brand" />
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
227 </dc:for-each>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
228 </cars>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
229 </dc:container-context>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
230
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
231 liefert dann folgende Ausgabe:
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
232
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
233 .. code:: xml
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
234
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
235 <cars>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
236 <car type="V80" brand="Volvo" />
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
237 <car type="Testarossa" brand="Ferrari" />
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
238 </cars>
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
239
bbf758e594bb Datacage reference doc: Explain dc:container-context and dc:properties.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7400
diff changeset
240
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
241
7318
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
242 ``dc:virtual-column`` Virtuelle Spalten definieren
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
243 ..................................................
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
244
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
245 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
246
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
247 <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
248 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
249 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
250
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
251 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
252 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
253 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
254
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
255 Dies sei an folgendem Beispiel illustriert:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
256
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
257 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
258 +Zahl+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
259 +====+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
260 + 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
261 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
262 + 2+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
263 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
264 + 3+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
265 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
266
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
267 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
268
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
269 <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
270 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
271 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
272
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
273 Erzeugt einen neuen Datensatz folgender Struktur:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
274
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
275 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
276 +Zahl+Quadrat+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
277 +====+=======+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
278 + 1+ 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
279 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
280 + 2+ 4+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
281 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
282 + 3+ 9+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
283 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
284
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7317
diff changeset
285 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
286 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
287 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
288
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
289 Datensätze einschränken
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
290 ~~~~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
291
7321
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
292 ``dc:filter`` Selektieren einzelner Zeilen aus dem aktuellen Datensatz
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
293 ......................................................................
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
294
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
295 .. code:: xml
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
296
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
297 <dc:filter expr="XPath-Ausdruck">
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
298 ...
7322
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
299 </dc:filter>
7321
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
300
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
301 Evaluiert pro Zeile des aktuellen Datensatzes den XPath-Ausdruck 'expr' und erzeugt
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
302 einen neuen Datensatz, der nur die Zeilen des Originaldatensatzes enthält für den
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
303 die Auswertung logisch wahr ergab. Im XPath-Ausdruck stehen die aufgefalteten Werte
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
304 der jeweiligen Zeile zur Verfügung.
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
305
7322
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
306 Folgends Beispiel soll dies verdeutlichen:
7321
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
307
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
308 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
309 +Zahl+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
310 +====+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
311 + 1+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
312 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
313 + 2+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
314 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
315 + 3+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
316 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
317 + 4+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
318 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
319
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
320 Zahlen erhalten, die einen Wert kleiner drei haben.
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
321
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
322 .. code:: xml
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
323
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
324 <dc:filter expr="$Zahl &lt; 3">
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
325 ...
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
326 <dc:filter>
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
327
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
328 Dies erzeugt folgenden neuen Datensatz:
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
329
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
330 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
331 +Zahl+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
332 +====+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
333 + 1+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
334 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
335 + 2+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
336 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
337
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
338 Innerhalb des `dc:filter`-Elementes kann der neue Datensatz wie gewohnt mit `dc:for-each`
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
339 realisiert werden. Nach Verlassen des `dc:filter`-Elementes ist wieder der vormalige
b33a2a437ab8 Datacage ref doc: Explain dc:filter.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7320
diff changeset
340 Datensatz aktuell.
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
341
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
342 .. _dc:group:
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
343
7322
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
344 ``dc:group`` Datensätzen in Gruppen ordnen
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
345 ..........................................
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
346
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
347 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
348
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
349 <dc:group expr="XPath-Ausdruck">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
350 ...
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
351 </dc:group>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
352
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
353 Pro Zeile der Originaldatensatzes wird der XPath-Ausdruck 'expr' ausgewertet.
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
354 Wie bei `dc:filter` stehen hier die aufgefalteten Werte der einzelnen Spalten zur
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
355 Verfügung. Das Resultat der XPath-Auswertung wird als Schlüssel für zu erzeugende
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
356 Gruppen benutzt, denen dann die Zeilen zugeordnet werden.
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
357 Nachdem alle Zeilen ihren entsprechenden Gruppen zugeordnet wurden, wir der
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
358 Inhalt des `dc:group`-Elements für jede Gruppe durchlaufen. Innerhalb des
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
359 `dc:group`-Elementes steht der jeweilige Schlüssel der aktuellen Gruppe über
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
360 die Funktion `dc:group-key()` zur Auswertung zu Verfügung. Innerhalb der
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
361 jeweiligen Gruppen kann mittel `dc:for-each` der jeweilige Unterdatensatz
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
362 realisiert werden.
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
363
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
364 Zur Verdeutlichung folgendes Beispiel:
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
365
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
366 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
367 +Marke +Bezeichnung+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
368 +=======+===========+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
369 +Ferrari+Testarossa +
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
370 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
371 +Volvo +V40 +
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
372 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
373 +Volvo +780 +
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
374 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
375 +Ferrari+F40 +
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
376 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
377 +VW +Käfer +
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
378 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
379
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
380 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
381
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
382 <marken>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
383 <dc:group expr="$Marke">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
384 <marke name="{dc:group-key()}">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
385 <dc:for-each>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
386 <bezeichnung name="$Bezeichnung"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
387 </dc:for-each>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
388 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
389 </dc:group>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
390 </marken>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
391
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
392 Dies führt zu folgender Ausgabe:
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
393
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
394 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
395
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
396 <marken>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
397 <marke name="Ferrari">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
398 <bezeichnung name="F40"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
399 <bezeichnung name="Testarossa"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
400 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
401 <marke name="Volvo">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
402 <bezeichnung name="V40"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
403 <bezeichnung name="780"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
404 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
405 <marke name="VW">
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
406 <bezeichnung name="Käfer"/>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
407 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7321
diff changeset
408 </marken>
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
409
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
410 Datensätze auffalten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
411 ~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
412
7319
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
413 ``dc:for-each`` Realisieren eines Datensatzes
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
414 .............................................
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
415
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
416 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
417
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
418 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
419 ...
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
420 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
421
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
422 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
423 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
424 des Datenstzes benannt sind.
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
425
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
426 Folgendes Beispiel soll den Sachverhalt illustieren:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
427
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
428 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
429 +Zahl+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
430 +====+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
431 + 1+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
432 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
433 + 2+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
434 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
435 + 3+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
436 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
437
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
438 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
439
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
440 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
441 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
442 <zahl wert="$Zahl"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
443 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
444 </zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
445
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
446 Dies erzeugt folgende Ausgabe:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
447
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
448 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
449
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
450 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
451 <zahl wert="1"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
452 <zahl wert="2"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
453 <zahl wert="3"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
454 </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
455
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
456 ``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
457
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
458 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
459 ~~~~~~~~~~~~~~~~~~~
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
460
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
461 ``<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
462 ...............................................
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
463
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
464 .. 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
465
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
466 <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
467 ...
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
468 </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
469
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
470 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
471 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
472 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
473 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
474 ``<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
475
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
476 ``<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
477 ...............................................
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
478
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
479 .. 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
480
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
481 <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
482 <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
483 <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
484 ...
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
485 <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
486 </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
487
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
488 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
489 ``<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
490 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
491 ``<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
492 ``<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
493
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
494
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
495
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
496 Makros
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
497 ~~~~~~
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
498 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
499 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
500
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
501 ``dc:macro`` Wiederverwendbare Teile definieren
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
502 ...............................................
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
503
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
504 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
505
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
506 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
507 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
508 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
509
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
510 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
511 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
512 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
513 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
514
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
515 ``dc:call-macro`` Makros aufrufen
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
516
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
517 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
518
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
519 <dc:call-macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
520
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
521 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
522 von Definition und Aufruf ist egal.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
523
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
524 ``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
525 .................................................
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
526
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
527 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
528
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
529 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
530 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
531 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
532 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
533 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
534
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
535 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
536 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
537 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
538
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
539 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
540
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
541 <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
542
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
543 Zur Verdeutlichung ein konkretes Beispiel
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
544
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
545 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
546
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
547 <dc:macro name="Greetings">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
548 <Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
549 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
550 </Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
551 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
552
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
553 <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
554 <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
555
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
556 Dies produziert folgende Ausgabe
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
557
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
558 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
559
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
560 <Hallo>Welt</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
561 <Hallo>Mond</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
562
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
563 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
564 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
565
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
566 Sonstige Elemente
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
567 ~~~~~~~~~~~~~~~~~
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
568
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
569 ``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
570 .......................................................
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
571
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
572 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
573
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
574 <dc:element name="Name">
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
575 ...
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
576 </dc:element>
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
577
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
578 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
579
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
580
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
581 ``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
582 .........................................................................
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
583
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
584 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
585
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
586 <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
587
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
588 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
589 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
590 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
591 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
592 erstellt werden soll.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
593
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
594 ``dc:comment`` Kommentare im Beschreibungsdokument
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
595 ..................................................
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
596
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
597 .. code:: xml
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
598
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
599 <dc:comment>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
600 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
601 </dc:comment>
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
602
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
603 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
604 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
605 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
606
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
607
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
608 ``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
609 ....................................................
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
610
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
611 .. 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
612
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
613 <dc:message>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
614 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
615 </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
616
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
617 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
618 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
619 die `{$}-Ersetzungen`_.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
620
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
621 ``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
622 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
623
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
624 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
625
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
626 <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
627
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
628 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
629 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
630 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
631 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
632 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
633 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
634
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
635
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
636 ``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
637 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
638
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
639 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
640
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
641 <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
642
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
643 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
644 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
645 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
646
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
647
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
648 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
649 --------------------
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
650
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
651 ``dc:has-result`` Prüfen, ob der aktuelle Datensatz nicht leer ist
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
652 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
653
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
654 ``dc:has-result()`` liefert logisch wahr zurück, falls der aktuelle
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
655 Datensatz nicht leer ist, sprich Datenzeilen enthält. Ansonsten wird
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
656 logisch falsch zurück gegeben. Mittels dieser Funktion können leere
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
657 Knoten im Resultatdokument verhindert werden. Die typische Nutzung
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
658 ist daher innerhalb des ``test``-Attributs eines ``<dc:if>``-Elements.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
659
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
660 ``dc:contains`` Prüfen, ob Suchbegriff in einer Liste vorhanden ist
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
661 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
662
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
663 ``dc:contains(Nadel, Heuhaufen)`` prüft ob das Suchobjekt Nadel in
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
664 der Liste Heufhaufen zu finden ist. Liefert logisch wahr falls die
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
665 Nadel gefunden wurde, ansonsten logisch falsch. Typischer Anwendungsfall:
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
666 ``dc:contains($outs, 'longitudinal-section')`` prüft, ob in der Liste
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
667 der aktuellen Outs der Eintrag 'longitudinal-section' zu finden ist.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
668
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
669 ``dc:replace`` Textersatz in Strings
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
670 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
671
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
672 ``dc:replace(Heuhaufen, Nadel, Ersatz)`` ersetzt in im String Heuhaufen alle
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
673 Vorkommen des Strings Nadel durch den String Ersatz. ``dc:replace('Banane', 'a', 'e')``
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
674 resultiert folglich in dem String ``Benene``.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
675
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
676 ``dc:replace-all`` Textersatz in Strings mit regulären Ausdrücken
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
677 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
678
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
679 ``dc:replace-all(Heuhaufen, Nadel, Ersatz)`` ersetzt in im String Heuhaufen alle
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
680 Vorkommen des regulären Ausdrucks durch den String Ersatz. Auf im regulären Ausdruck
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
681 gebildete Gruppen ``()`` kann mit ``$1``, ``$2``, ``$3`` usw. im Ersatztext zurückgegriffen werden.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
682 ``dc:replace-all('KlausGabiPeter', '(Klaus|Peter)', '>$1<')`` resultiert demnach
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
683 in ``>Klaus<Gabi>Peter<``.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
684
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
685 ``dc:find-all`` Extraktion von Strings aus einem String anhand eines regulären Ausdrucks
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
686 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
687
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
688 ``dc:find-all(Nadel, Heuhaufen)`` extrahiert aus einem String Heuhaufen all jene Substrings,
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
689 die auf den regulären Ausdruck Nadel passen. Das Resultat dieser Funktion ist eine Liste
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
690 von Strings. Sie ist leer, wenn das Muster nicht gefunden wurde.
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
691
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
692 ``dc:find-all('\d{4}', '1900 1930 1941 1960')`` liefert dem entsprechend die Liste
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
693 ``'1900'``, ``'1930'``, ``'1941'``, ``'1960'``.
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
694
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
695 ``dc:date-format`` Formatierte Ausgabe eines Datums
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
696 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
697
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
698 ``dc:date-format(Format, Datum)`` leifert für ein Datum Datum einen String, der
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
699 nach den Formatierungsregeln aus Format formatiert wird. Für die Formatierungen
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
700 gelten die in SimpleFormat_ beschriebenen Regeln.
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
701
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
702 .. _SimpleFormat: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
703
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
704 ``dc::date-format(''dd.MM.yyyy', $datum,)`` liefert für ein ``$datum`` mit dem Wert 1. Dezember 1941
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
705 den String ``01.12.1941``.
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
706
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
707
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
708 ``dc:group-key`` Wert des aktuellen Gruppierungsschlüssels
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
709 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
710
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
711 Siehe hierzu `dc:group`_.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
712
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
713 ``dc:dump-variables`` Aktuelle Variablenbelegung als String
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
714 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
715
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
716 ``dc:dump-variables()`` liefert einen String mit der aktuellen Belegung aller Variablen.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
717 Dies ist zusammen mit ``dc:message`` nützlich, um eine Ablaufverfolgung zu implementieren.
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
718
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
719 ``dc:get`` Dynamische Variablenauswertung
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
720 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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
721
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
722 ``dc:get(Variablenname)`` ermöglicht es, eine Variable über ihren Namen als String
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
723 auszuwerten. Gegenüber der normalen XPath-Variablenauswertung kann die Variable auch
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
724 null liefern. Bis auf diese Ausnahme ist der Aufruf ``dc:get('a')`` identisch zu ``$a``
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
725 in XPath-Kontexten.
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
726
7416
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
727 ``dc:max-number`` Bestimmung des Maximums einer Liste von Zahlen
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
728 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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
729
7416
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
730 ``dc:max-number($liste)`` Ermittelt aus einer Liste von Zahlen das Maximum. Strings werden dabei in Zahlen umgewandelt.
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
731
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
732 ``dc:max-number(dc:find-all('\d{4}', '1900 1930 1941 1960'))`` liefert also ``1960``.
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
733
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
734
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
735 ``dc:min-number`` Bestimmung des Minimums einer Liste von Zahlen
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
736 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
737
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
738 ``dc:min-number($liste)`` Ermittelt aus einer Liste von Zahlen das Minimum. Strings werden dabei in Zahlen umgewandelt.
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
739
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
740 ``dc:min-number(dc:find-all('\d{4}', '1900 1930 1941 1960'))`` liefert also ``1960``.
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
741
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
742
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
743
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
744
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
745 ``dc:fromValue`` **TODO**
7400
dd87e0a5f83c Datacage: Added TODOs for new functions in ref document.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7379
diff changeset
746
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
747 ``dc:toValue`` **TODO**
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
748
http://dive4elements.wald.intevation.org