annotate artifacts/doc/datacage_ref_de.rst @ 9778:b57b236c4f4e 3.2.x

Backed out changeset b1b48fa7bd80 It turns out that, while this works for PostgreSQL/PostGIS, it does not with Oracle. Hibernatespatial tries to map spatial types to PostGIS hibernate types in both cases.
author Tom Gottfried <tom@intevation.de>
date Mon, 06 Feb 2023 16:57:03 +0100
parents 081a57c80540
children
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
8388
5b3a2908a346 Fixed some typos in datacage docs.
Tom Gottfried <tom@intevation.de>
parents: 8306
diff changeset
122 Kontextes weiterbenutzt. Initial wird je nach Aufrufart des Datenkorbs entweder
7315
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
8388
5b3a2908a346 Fixed some typos in datacage docs.
Tom Gottfried <tom@intevation.de>
parents: 8306
diff changeset
124 der Aufrufumgebung ein Artefakt gesetzt wird oder nicht. Im ersten Fall wird
7315
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
8388
5b3a2908a346 Fixed some typos in datacage docs.
Tom Gottfried <tom@intevation.de>
parents: 8306
diff changeset
126 auch alte Berechnungen mit einschließt.
7315
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.
8388
5b3a2908a346 Fixed some typos in datacage docs.
Tom Gottfried <tom@intevation.de>
parents: 8306
diff changeset
136 </dc:statement>
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
137
8388
5b3a2908a346 Fixed some typos in datacage docs.
Tom Gottfried <tom@intevation.de>
parents: 8306
diff changeset
138 Mittels eines SQL-Select-Statements werden in einem `<dc:context>` Elemente aus
7315
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
8077
671b244517ed Some typos in datacage config reference.
Tom Gottfried <tom@intevation.de>
parents: 7960
diff changeset
344 ``dc:group`` Datensätze in Gruppen ordnen
7322
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
8077
671b244517ed Some typos in datacage config reference.
Tom Gottfried <tom@intevation.de>
parents: 7960
diff changeset
353 Pro Zeile des Originaldatensatzes wird der XPath-Ausdruck 'expr' ausgewertet.
7322
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
8077
671b244517ed Some typos in datacage config reference.
Tom Gottfried <tom@intevation.de>
parents: 7960
diff changeset
361 jeweiligen Gruppen kann mittels `dc:for-each` der jeweilige Unterdatensatz
7322
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
7960
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
410 Der Expr-Ausdruck kann mittels der Zeichenfolge '#!#' innerhalb des Ausdrucks
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
411 in mehrere Ausdrücke zerlegt werden. Damit ist es möglich, einen Wert
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
412 in mehrere Kategorien einzusortieren. Wird z.B. ein Film über den Zeitraum
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
413 von zwei Jahren gedreht und man möchte eine Liste von Filmen nach ihren
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
414 Produktionsjahren gruppieren, sollte der Film im Resulat in beiden Jahren auftauchen.
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
415
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
416 .. code:: xml
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
417
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
418 <dc:group expr="$start_jahr #!# $end_jahr">
fbab10c21e0b Datacage: Make it possible to group a value tuple into more than one group.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7907
diff changeset
419
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
420 Datensätze auffalten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
421 ~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
422
7319
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
423 ``dc:for-each`` Realisieren eines Datensatzes
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
424 .............................................
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 .. code:: xml
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 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
429 ...
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
430 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
431
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
432 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
433 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
434 des Datenstzes benannt sind.
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
435
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
436 Folgendes Beispiel soll den Sachverhalt illustieren:
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 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
439 +Zahl+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
440 +====+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
441 + 1+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
442 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
443 + 2+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
444 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
445 + 3+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
446 +----+
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 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
452 <zahl wert="$Zahl"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
453 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
454 </zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
455
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
456 Dies erzeugt folgende Ausgabe:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
457
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
458 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
459
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
460 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
461 <zahl wert="1"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
462 <zahl wert="2"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
463 <zahl wert="3"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7318
diff changeset
464 </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
465
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
466 ``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
467
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
468 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
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
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 ``<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
472 ...............................................
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
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 .. 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
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: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
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 </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
479
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 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
481 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
482 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
483 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
484 ``<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
485
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>`` 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
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
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 .. 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
490
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: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
492 <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
493 <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
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 <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
496 </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
497
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
498 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
499 ``<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
500 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
501 ``<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
502 ``<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
503
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
504
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
505
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
506 Makros
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
507 ~~~~~~
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
508 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
509 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
510
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
511 ``dc:macro`` Wiederverwendbare Teile definieren
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
512 ...............................................
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
513
7317
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
514 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
515
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
516 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
517 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
518 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
519
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
520 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
521 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
522 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
523 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
524
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
525 ``dc:call-macro`` Makros aufrufen
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:call-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 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
532 von Definition und Aufruf ist egal.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
533
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
534 ``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
535 .................................................
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
536
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
537 .. code:: xml
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 <dc:macro name="Name">
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:macro-body/>
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 </dc:macro>
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 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
546 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
547 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
548
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
549 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
550
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
551 <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
552
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
553 Zur Verdeutlichung ein konkretes Beispiel
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
554
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
555 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
556
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
557 <dc:macro name="Greetings">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
558 <Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
559 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
560 </Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
561 </dc:macro>
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 <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
564 <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
565
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
566 Dies produziert folgende Ausgabe
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
567
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
568 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
569
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
570 <Hallo>Welt</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
571 <Hallo>Mond</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
572
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7316
diff changeset
573 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
574 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
575
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
576 Sonstige Elemente
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
577 ~~~~~~~~~~~~~~~~~
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
578
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
579 ``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
580 .......................................................
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
581
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
582 .. code:: xml
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 <dc:element name="Name">
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:element>
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 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
589
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
590
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
591 ``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
592 .........................................................................
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
593
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
594 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
595
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
596 <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
597
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
598 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
599 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
600 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
601 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
602 erstellt werden soll.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
603
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
604 ``dc:comment`` Kommentare im Beschreibungsdokument
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
605 ..................................................
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
606
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
607 .. code:: xml
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
608
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
609 <dc:comment>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
610 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
611 </dc:comment>
7314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7255
diff changeset
612
7315
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7314
diff changeset
613 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
614 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
615 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
616
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
617
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
618 ``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
619 ....................................................
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
620
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
621 .. 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
622
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
623 <dc:message>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
624 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
625 </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
626
7316
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
627 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
628 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
629 die `{$}-Ersetzungen`_.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
630
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
631 ``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
632 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
633
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
634 .. code:: xml
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: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
637
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
638 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
639 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
640 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
641 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
642 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
643 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
644
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
645
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
646 ``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
647 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
648
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
649 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
650
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
651 <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
652
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7315
diff changeset
653 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
654 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
655 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
656
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
657
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
658 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
659 --------------------
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
660
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
661 ``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
662 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
663
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
664 ``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
665 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
666 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
667 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
668 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
669
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
670 ``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
671 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
672
8431
f1bc081210ea Load sounding width via recommendations for bed height differences and cleanup and fix related bed height macros.
Tom Gottfried <tom@intevation.de>
parents: 8388
diff changeset
673 ``dc:contains(Heuhaufen, Nadel)`` prüft ob das Suchobjekt Nadel in
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
674 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
675 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
676 ``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
677 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
678
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
679 ``dc:replace`` Textersatz in Strings
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
680 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
681
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
682 ``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
683 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
684 resultiert folglich in dem String ``Benene``.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
685
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
686 ``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
687 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
688
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
689 ``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
690 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
691 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
692 ``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
693 in ``>Klaus<Gabi>Peter<``.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
694
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
695 ``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
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: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
699 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
700 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
701
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
702 ``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
703 ``'1900'``, ``'1930'``, ``'1941'``, ``'1960'``.
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
704
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
705 ``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
706 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
707
7907
b3534220aac7 Fixed typos in datacage manual.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7416
diff changeset
708 ``dc:date-format(Format, Datum)`` liefert für ein Datum einen String, der
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
709 nach den Formatierungsregeln aus Format formatiert wird. Für die Formatierungen
8460
081a57c80540 Accept number as argument in dc:date-format().
Tom Gottfried <tom@intevation.de>
parents: 8431
diff changeset
710 gelten die in SimpleFormat_ beschriebenen Regeln. ``Datum`` kann dabei ein
081a57c80540 Accept number as argument in dc:date-format().
Tom Gottfried <tom@intevation.de>
parents: 8431
diff changeset
711 Datums-Objekt oder eine Zahl sein. Letztere wird als Millisekunden nach dem
081a57c80540 Accept number as argument in dc:date-format().
Tom Gottfried <tom@intevation.de>
parents: 8431
diff changeset
712 1.1.1970 00:00:00 GMT interpretiert.
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
713
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
714 .. _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
715
8119
a9a6414b3563 Format timestamps in datacage tooltip for porosities.
"Tom Gottfried <tom@intevation.de>"
parents: 8077
diff changeset
716 ``dc:date-format('dd.MM.yyyy', $datum)`` liefert für ein ``$datum``
a9a6414b3563 Format timestamps in datacage tooltip for porosities.
"Tom Gottfried <tom@intevation.de>"
parents: 8077
diff changeset
717 mit dem Wert 1. Dezember 1941 den String ``01.12.1941``.
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
718
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
719
7410
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
720 ``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
721 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
722
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
723 Siehe hierzu `dc:group`_.
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
724
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
725 ``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
726 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
727
0e56d7b4b38c Datacage ref doc: More doc for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7403
diff changeset
728 ``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
729 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
730
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
731 ``dc:get`` Dynamische Variablenauswertung
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
732 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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
733
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
734 ``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
735 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
736 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
737 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
738
7416
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
739 ``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
740 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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
741
7416
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
742 ``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
743
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
744 ``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
745
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
746
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
747 ``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
748 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
749
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
750 ``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
751
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
752 ``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
753
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
754
f26e7d386d8c Datacage ref doc: More docs on functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7415
diff changeset
755
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
756
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
757 ``dc:fromValue`` **TODO**
7400
dd87e0a5f83c Datacage: Added TODOs for new functions in ref document.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7379
diff changeset
758
7415
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
759 ``dc:toValue`` **TODO**
f5948a07f317 Datacage ref doc: More docs for functions.
Sascha L. Teichmann <teichmann@intevation.de>
parents: 7410
diff changeset
760
8306
33d90858b2dc Remove duplications from discharge prototypes and put it all together.
"Tom Gottfried <tom@intevation.de>"
parents: 8119
diff changeset
761 ``dc:coalesce`` **TODO**
33d90858b2dc Remove duplications from discharge prototypes and put it all together.
"Tom Gottfried <tom@intevation.de>"
parents: 8119
diff changeset
762

http://dive4elements.wald.intevation.org