Mercurial > dive4elements > river

comparison artifacts/doc/datacage_ref_de.rst @ 7379:e07dc8854a8f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
More datacage ref doc.
author Sascha L. Teichmann <teichmann@intevation.de>
date Thu, 17 Oct 2013 18:56:44 +0200
parents 7be4425eaca9
children dd87e0a5f83c
comparison
equal deleted inserted replaced
7378:aff189df381b 7379:e07dc8854a8f
5 5
6 .. contents:: Inhalt 6 .. contents:: Inhalt
7 7
8 Übersicht 8 Übersicht
9 --------- 9 ---------
10
11 Der Datenkorb ist im Kern ein Dive4Elements/River eingebetteter Webdienst,
12 der dazu dient, ein XML-Dokument zu generieren, das seinerseits benutzt
13 werden kann, um Daten so identifizierbar zu machen, dass sie zu
14 Projekten innerhalb von Dive4Elements/River hinzugeladen werden können.
15
16 Das vom Datenkorb erzeugte XML-Dokument wird dann vom D4E/River-Client in
17 eine Baumansicht innerhalb der graphischen Benutzeroberfläche
18 transformiert.
19
20 Die Grundlage für das XML-Doument, das an die Oberfäche gesandt wird,
21 ist ein XML-Dokument namens ``meta-data.xml``, das im ``conf``-Verzeichnis
22 des Servers als Template für die Ausgabe-XML benutzt wird.
23
24 Dieses Referenzhandbuch beschreibt die Strukturen innerhalb von
25 ``metadata.xml``.
26
27 Grundstruktur
28 -------------
29
30 Das Grundgerüst einer validen ``meta-data.xml`` sieht sieh so aus:
31
32 .. code:: xml
33
34 <xml version="1.0" encoding="UTF-8">
35 <dc:template xmlns:dc="http://www.intevation.org/2011/Datacage">
36 <datacage>
37 ...
38 </datacage>
39 </dc:template>
40
41 Dies erzeugt folgendes Dokument:
42
43 .. code:: xml
44
45 <xml version="1.0" encoding="UTF-8">
46 <datacage>
47 ...
48 </datacage>
49
50 Elemente, die nicht aus dem Namespace ``dc`` stammen, werden durchkopiert.
51 ``dc``-Elemente dienen der Steuerung des Templating. Generell kann sagen,
52 dass das ``meta-data.xml``-Template mittels einer
53 rekursiven Tiefensuche (siehe http://de.wikipedia.org/wiki/Tiefensuche)
54 über seine Elemente abgearbeitet wird.
10 55
11 Daten 56 Daten
12 ----- 57 -----
13 Im Datenkorb stehen zwei Arten von Daten zur Auswertung zur Verfügung. 58 Im Datenkorb stehen zwei Arten von Daten zur Auswertung zur Verfügung.
14 59
15 ``Datensätze`` 60 ``Datensätze``
16 ~~~~~~~~~~~~~~ 61 ~~~~~~~~~~~~~~
17 Datensätze sind Tabellen mit benannten Spalten. Sie werden von Datenquellen 62 Datensätze sind Tabellen mit benannten Spalten. Sie werden von Datenquellen
18 erzeugt und in einem Stapel verwaltet. Die konkreten Werte stehen erst durch 63 erzeugt und in einem Stapel verwaltet. Die konkreten Werte stehen erst durch
19 Auffaltung als Variablen zur Verfügung. 64 Auffaltung als Variablen zur Verfügung.
20
21 65
22 ``Variablen`` 66 ``Variablen``
23 ~~~~~~~~~~~~~ 67 ~~~~~~~~~~~~~
24 Variablen sind die Werte, die aktuell zur Auswertung zur Verfügung stehen. Sie haben 68 Variablen sind die Werte, die aktuell zur Auswertung zur Verfügung stehen. Sie haben
25 einen Namen und einen Typ (String, Zahl, durch Datenquelle bestimmt). 69 einen Namen und einen Typ (String, Zahl, durch Datenquelle bestimmt).
93 137
94 Mittels eines SQL-Select-Statements werden in einem `<dc:context>`-Elementes aus 138 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 139 der dort definierten Datenbank geholt. Die Spaltennamen der Projektion des SQL-Statements
96 werden übernommen und später beim Auffalten des Datensatzes benutzt. 140 werden übernommen und später beim Auffalten des Datensatzes benutzt.
97 141
98 ``dc:container-context`` **TODO** 142 ``dc:container-context`` Tabellarische Daten aus der Programm-Umgebung
143 ......................................................................
144
145 **TODO**
99 146
100 ``dc:properties`` **TODO** 147 ``dc:properties`` **TODO**
101 148
102 ``dc:virtual-column`` Virtuelle Spalten definieren 149 ``dc:virtual-column`` Virtuelle Spalten definieren
103 .................................................. 150 ..................................................
http://dive4elements.wald.intevation.org