Mercurial > dive4elements > river

comparison artifacts/doc/datacage_ref_de.rst @ 7315:8498fdd71a1e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Dataage ref doc: Explain dc:context, dc:comment
author Sascha L. Teichmann <teichmann@intevation.de>
date Mon, 14 Oct 2013 13:44:54 +0200
parents 53d1dd441867
children 52bc38e6bbe1
comparison
equal deleted inserted replaced
7314:53d1dd441867 7315:8498fdd71a1e
47 ------------------ 47 ------------------
48 48
49 Datensätze erzeugen 49 Datensätze erzeugen
50 ~~~~~~~~~~~~~~~~~~~ 50 ~~~~~~~~~~~~~~~~~~~
51 51
52 ``dc:context`` **TODO** 52 ``dc:context`` Aufspannen eines Gültigkeitsbereiches eines Datenbankdatensatz
53 53 .............................................................................
54 ``dc:statement`` **TODO** 54
55 .. code:: xml
56
57 <dc:context connection="Verbindung">
58 ...
59 </dc:element>
60
61 Spannt einen Gültigkeitsbereich für einen Datensatz auf, der aus der Datenbank
62 kommt. Die adressierte Datenbank wird über das optionale Attribut 'connection'
63 bestimmt. Zur Zeit sind drei Datenbanken angebunden:
64
65 - **user**: Die Index-Datenbank des Artefakt-Servers. Hierüber stehen Meta-Informationen
66 zu alten Berechnungen zur Verfügung.
67
68 - **system**: Die FLYS-Datenbank mit den hydrologischen, morphologische und geodätischen
69 Daten.
70
71 - **seddb**: Die Sediment-Datenbank.
72
73 In einem `<dc:context>`-Element wird zwingend ein `<dc:statement>`-Element erwartet,
74 um einen Datensatz aus der Datenbank zu holen. Dieser Datensatz steht dann innerhalb des
75 `<dc:context>`-Elementes ein oder mehrfach zur Verfügung. Innerhalb eines
76 `<dc:context>`-Elementes können weitere `<dc:context>`-Elemente eingeschachtelt werden.
77 Ist kein 'connection'-Attribut vorhanden, wird die Datenbank-Verbindung des umgebenen
78 Kontextes weiterbenutzt. Initial wird je nach Aufrufart der Datenkorbs entweder
79 der **user** oder **system**-Kontext angenommen. Dies richtet sich danach, ob in
80 der Aufrufumgebung eine Artefakt gesetzt wird oder nicht. Im ersten Fall wird
81 angenommen, dass es sich um einen Ladevorgang für zusätzliche Daten handelt, die
82 auch alte Berechnungen mit einschliesst.
83
84
85 ``dc:statement`` Holen eines Datensatzes aus einer Datenbank
86 ............................................................
87
88 .. code:: xml
89
90 <dc:statement>
91 SQL-Select-Statement.
92 </dc:element>
93
94 Mittels eines SQL-Select-Statements werden in einem `<dc:context>`-Elementes aus
95 der dort definierten Datenbank geholt. Die Spaltennamen der Projektion des SQL-Statements
96 werden übernommen und später beim Auffalten des Datensatzes benutzt.
55 97
56 ``dc:container-context`` **TODO** 98 ``dc:container-context`` **TODO**
57 99
58 ``dc:properties`` **TODO** 100 ``dc:properties`` **TODO**
59 101
108 Wert von Wert hinzu. Für Namen und Wert gelten die `${}-Ersetzungen`_. 150 Wert von Wert hinzu. Für Namen und Wert gelten die `${}-Ersetzungen`_.
109 Der Einsatz dieses Konstrukts findet häufig im Zusammenhang mit dc:element 151 Der Einsatz dieses Konstrukts findet häufig im Zusammenhang mit dc:element
110 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen 152 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen
111 erstellt werden soll. 153 erstellt werden soll.
112 154
113 155 ``dc:comment`` Kommentare im Beschreibungsdokument
114 156 ..................................................
115 157 .. code:: xml
116 ``dc:comment`` **TODO** 158
159 <dc:comment>
160 ...
161 </dc:comment>
162
163 Ein Kommentar auf Ebene des Beschreibungsdokumentes, das keinerlei Ausgabe
164 im Ausgabedokument erzeugt. Eingeschachtelte Elemente werden ebenfalls nicht ausgewertet.
165 Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen!
166
117 167
118 ``dc:message`` **TODO** 168 ``dc:message`` **TODO**
119 169
120 ``dc:variable`` **TODO** 170 ``dc:variable`` **TODO**
121 171
http://dive4elements.wald.intevation.org