Mercurial > dive4elements > river
annotate artifacts/doc/datacage_ref_de.rst @ 9790:75dc4ea60938 3.2.x
Drop using explicit container names
Compose will generate names for the containers and containers can connect
each other on the network via the service names. This avoids the
unnecessary extra "name space" and prepares the application for usage
with different project names.
author | Tom Gottfried <tom@intevation.de> |
---|---|
date | Thu, 20 Jul 2023 10:25:59 +0200 |
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 < 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 |