dive4elements/river: artifacts/doc/datacage_ref

annotate artifacts/doc/datacage_ref_de.rst @ 7400:dd87e0a5f83c

Datacage: Added TODOs for new functions in ref document.

author	Sascha L. Teichmann <teichmann@intevation.de>
date	Mon, 21 Oct 2013 11:43:50 +0200
parents	e07dc8854a8f
children	bbf758e594bb

rev	line source
7255 5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	1 =========
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	2 Datenkorb
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	3 =========
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	4
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	5
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	6 .. contents:: Inhalt
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	7
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	8 Übersicht
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	9 ---------
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	10
7379 e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	11 Der Datenkorb ist im Kern ein Dive4Elements/River eingebetteter Webdienst,
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	12 der dazu dient, ein XML-Dokument zu generieren, das seinerseits benutzt
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	13 werden kann, um Daten so identifizierbar zu machen, dass sie zu
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	14 Projekten innerhalb von Dive4Elements/River hinzugeladen werden können.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	15
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	16 Das vom Datenkorb erzeugte XML-Dokument wird dann vom D4E/River-Client in
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	17 eine Baumansicht innerhalb der graphischen Benutzeroberfläche
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	18 transformiert.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	19
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	20 Die Grundlage für das XML-Doument, das an die Oberfäche gesandt wird,
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	21 ist ein XML-Dokument namens ``meta-data.xml``, das im ``conf``-Verzeichnis
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	22 des Servers als Template für die Ausgabe-XML benutzt wird.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	23
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	24 Dieses Referenzhandbuch beschreibt die Strukturen innerhalb von
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	25 ``metadata.xml``.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	26
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	27 Grundstruktur
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	28 -------------
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	29
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	30 Das Grundgerüst einer validen ``meta-data.xml`` sieht sieh so aus:
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	31
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	32 .. code:: xml
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	33
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	34 <xml version="1.0" encoding="UTF-8">
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	35 <dc:template xmlns:dc="http://www.intevation.org/2011/Datacage">
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	36 <datacage>
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	37 ...
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	38 </datacage>
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	39 </dc:template>
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	40
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	41 Dies erzeugt folgendes Dokument:
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	42
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	43 .. code:: xml
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	44
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	45 <xml version="1.0" encoding="UTF-8">
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	46 <datacage>
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	47 ...
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	48 </datacage>
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	49
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	50 Elemente, die nicht aus dem Namespace ``dc`` stammen, werden durchkopiert.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	51 ``dc``-Elemente dienen der Steuerung des Templating. Generell kann sagen,
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	52 dass das ``meta-data.xml``-Template mittels einer
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	53 rekursiven Tiefensuche (siehe http://de.wikipedia.org/wiki/Tiefensuche)
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	54 über seine Elemente abgearbeitet wird.
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	55
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	56 Daten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	57 -----
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	58 Im Datenkorb stehen zwei Arten von Daten zur Auswertung zur Verfügung.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	59
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	60 ``Datensätze``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	61 ~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	62 Datensätze sind Tabellen mit benannten Spalten. Sie werden von Datenquellen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	63 erzeugt und in einem Stapel verwaltet. Die konkreten Werte stehen erst durch
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	64 Auffaltung als Variablen zur Verfügung.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	65
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	66 ``Variablen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	67 ~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	68 Variablen sind die Werte, die aktuell zur Auswertung zur Verfügung stehen. Sie haben
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	69 einen Namen und einen Typ (String, Zahl, durch Datenquelle bestimmt).
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	70
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	71 Textersatz
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	72 ----------
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	73 Um die Wertebelegungen in das Ausgabedokument schreiben zu kann an entsprechenden
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	74 Stellen eine String-Interpolation durchgeführt werden.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	75 Hier finden zwei Arten von Textersatz ihren Einsatz.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	76
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	77 ``${}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	78 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	79 Die ältere Variante. Innerhalb von Strings werden hier nur Variablen aufgelöst.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	80 Beispiel: "Hallo, ${planet}!" wird bei planet = 'Welt' zu "Hallo, Welt!".
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	81
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	82 ``{$}-Ersetzungen``
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	83 ~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	84 Die neuere Variante, allerdings noch nicht komplett an allen Stellen einsatzfähig.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	85 Innerhalb der geschweiften Klammern können beliebige XPath-Ausdrück stehen, die
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	86 zu Strings evaluiert werden. Dies orientiert sich an den String-Auswertungen in XSLT.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	87 "{ concat($greet, ', ', $planet, '!') }" wird bei gesetzten Variablen greet = Hallo
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	88 und planet = "Welt" zu Hallo, Welt! ausgewertet.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	89
7255 5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	90 Datenkorb-Elemente
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	91 ------------------
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	92
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	93 Datensätze erzeugen
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	94 ~~~~~~~~~~~~~~~~~~~
7255 5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	95
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	96 ``dc:context`` Aufspannen eines Gültigkeitsbereiches eines Datenbankdatensatz
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	97 .............................................................................
7255 5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	98
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	99 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	100
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	101 <dc:context connection="Verbindung">
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	102 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	103 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	104
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	105 Spannt einen Gültigkeitsbereich für einen Datensatz auf, der aus der Datenbank
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	106 kommt. Die adressierte Datenbank wird über das optionale Attribut 'connection'
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	107 bestimmt. Zur Zeit sind drei Datenbanken angebunden:
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	108
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	109 - user: Die Index-Datenbank des Artefakt-Servers. Hierüber stehen Meta-Informationen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	110 zu alten Berechnungen zur Verfügung.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	111
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	112 - system: Die FLYS-Datenbank mit den hydrologischen, morphologische und geodätischen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	113 Daten.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	114
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	115 - seddb: Die Sediment-Datenbank.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	116
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	117 In einem `<dc:context>`-Element wird zwingend ein `<dc:statement>`-Element erwartet,
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	118 um einen Datensatz aus der Datenbank zu holen. Dieser Datensatz steht dann innerhalb des
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	119 `<dc:context>`-Elementes ein oder mehrfach zur Verfügung. Innerhalb eines
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	120 `<dc:context>`-Elementes können weitere `<dc:context>`-Elemente eingeschachtelt werden.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	121 Ist kein 'connection'-Attribut vorhanden, wird die Datenbank-Verbindung des umgebenen
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	122 Kontextes weiterbenutzt. Initial wird je nach Aufrufart der Datenkorbs entweder
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	123 der user oder system-Kontext angenommen. Dies richtet sich danach, ob in
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	124 der Aufrufumgebung eine Artefakt gesetzt wird oder nicht. Im ersten Fall wird
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	125 angenommen, dass es sich um einen Ladevorgang für zusätzliche Daten handelt, die
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	126 auch alte Berechnungen mit einschliesst.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	127
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	128
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	129 ``dc:statement`` Holen eines Datensatzes aus einer Datenbank
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	130 ............................................................
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	131
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	132 .. code:: xml
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	133
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	134 <dc:statement>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	135 SQL-Select-Statement.
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	136 </dc:element>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	137
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	138 Mittels eines SQL-Select-Statements werden in einem `<dc:context>`-Elementes aus
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	139 der dort definierten Datenbank geholt. Die Spaltennamen der Projektion des SQL-Statements
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	140 werden übernommen und später beim Auffalten des Datensatzes benutzt.
7255 5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	141
7379 e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	142 ``dc:container-context`` Tabellarische Daten aus der Programm-Umgebung
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	143 ......................................................................
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	144
e07dc8854a8f More datacage ref doc. Sascha L. Teichmann <teichmann@intevation.de> parents: 7322 diff changeset	145 TODO
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
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	147 ``dc:properties`` 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	148
7318 d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	149 ``dc:virtual-column`` Virtuelle Spalten definieren
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	150 ..................................................
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	151
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	152 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	153
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	154 <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	155 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	156 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	157
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	158 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	159 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	160 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	161
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	162 Dies sei an folgendem Beispiel illustriert:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	163
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	164 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	165 +Zahl+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	166 +====+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	167 + 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	168 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	169 + 2+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	170 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	171 + 3+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	172 +----+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	173
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	174 .. code:: xml
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	175
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	176 <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	177 ...
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	178 </dc:virtual-column>
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	179
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	180 Erzeugt einen neuen Datensatz folgender Struktur:
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	181
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	182 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	183 +Zahl+Quadrat+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	184 +====+=======+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	185 + 1+ 1+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	186 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	187 + 2+ 4+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	188 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	189 + 3+ 9+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	190 +----+-------+
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	191
d8ca7a1d522c Datacage ref doc: Explain dc:virtual-column. Sascha L. Teichmann <teichmann@intevation.de> parents: 7317 diff changeset	192 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	193 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	194 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	195
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	196 Datensätze einschränken
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	197 ~~~~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	198
7321 b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	199 ``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	200 ......................................................................
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	201
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	202 .. code:: xml
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	203
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	204 <dc:filter expr="XPath-Ausdruck">
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	205 ...
7322 7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	206 </dc:filter>
7321 b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	207
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	208 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	209 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	210 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	211 der jeweiligen Zeile zur Verfügung.
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	212
7322 7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	213 Folgends Beispiel soll dies verdeutlichen:
7321 b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	214
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	215 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	216 +Zahl+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	217 +====+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	218 + 1+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	219 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	220 + 2+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	221 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	222 + 3+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	223 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	224 + 4+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	225 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	226
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	227 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	228
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	229 .. code:: xml
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	230
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	231 <dc:filter expr="$Zahl < 3">
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	232 ...
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	233 <dc:filter>
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	234
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	235 Dies erzeugt folgenden neuen Datensatz:
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	236
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	237 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	238 +Zahl+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	239 +====+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	240 + 1+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	241 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	242 + 2+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	243 +----+
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	244
b33a2a437ab8 Datacage ref doc: Explain dc:filter. Sascha L. Teichmann <teichmann@intevation.de> parents: 7320 diff changeset	245 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	246 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	247 Datensatz aktuell.
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	248
7322 7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	249 ``dc:group`` Datensätzen in Gruppen ordnen
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	250 ..........................................
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	251
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	252 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	253
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	254 <dc:group expr="XPath-Ausdruck">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	255 ...
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	256 </dc:group>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	257
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	258 Pro Zeile der Originaldatensatzes wird der XPath-Ausdruck 'expr' ausgewertet.
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	259 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	260 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	261 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	262 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	263 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	264 `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	265 die Funktion `dc:group-key()` zur Auswertung zu Verfügung. Innerhalb der
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	266 jeweiligen Gruppen kann mittel `dc:for-each` der jeweilige Unterdatensatz
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	267 realisiert werden.
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	268
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	269 Zur Verdeutlichung folgendes Beispiel:
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	270
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	271 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	272 +Marke +Bezeichnung+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	273 +=======+===========+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	274 +Ferrari+Testarossa +
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	275 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	276 +Volvo +V40 +
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	277 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	278 +Volvo +780 +
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	279 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	280 +Ferrari+F40 +
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	281 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	282 +VW +Käfer +
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	283 +-------+-----------+
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	284
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	285 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	286
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	287 <marken>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	288 <dc:group expr="$Marke">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	289 <marke name="{dc:group-key()}">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	290 <dc:for-each>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	291 <bezeichnung name="$Bezeichnung"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	292 </dc:for-each>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	293 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	294 </dc:group>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	295 </marken>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	296
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	297 Dies führt zu folgender Ausgabe:
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	298
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	299 .. code:: xml
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	300
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	301 <marken>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	302 <marke name="Ferrari">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	303 <bezeichnung name="F40"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	304 <bezeichnung name="Testarossa"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	305 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	306 <marke name="Volvo">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	307 <bezeichnung name="V40"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	308 <bezeichnung name="780"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	309 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	310 <marke name="VW">
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	311 <bezeichnung name="Käfer"/>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	312 </marke>
7be4425eaca9 Datacage doc ref: Explain dc:group Sascha L. Teichmann <teichmann@intevation.de> parents: 7321 diff changeset	313 </marken>
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	314
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	315 Datensätze auffalten
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	316 ~~~~~~~~~~~~~~~~~~~~
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	317
7319 d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	318 ``dc:for-each`` Realisieren eines Datensatzes
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	319 .............................................
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	320
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	321 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	322
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	323 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	324 ...
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	325 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	326
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	327 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	328 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	329 des Datenstzes benannt sind.
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	330
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	331 Folgendes Beispiel soll den Sachverhalt illustieren:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	332
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	333 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	334 +Zahl+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	335 +====+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	336 + 1+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	337 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	338 + 2+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	339 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	340 + 3+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	341 +----+
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	342
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	343 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	344
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	345 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	346 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	347 <zahl wert="$Zahl"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	348 <dc:for-each>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	349 </zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	350
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	351 Dies erzeugt folgende Ausgabe:
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	352
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	353 .. code:: xml
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	354
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	355 <zahlen>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	356 <zahl wert="1"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	357 <zahl wert="2"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	358 <zahl wert="3"/>
d29a5e703cc4 Datacage ref doc: Explain dc:for-each Sascha L. Teichmann <teichmann@intevation.de> parents: 7318 diff changeset	359 </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	360
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	361 ``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	362
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	363 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	364 ~~~~~~~~~~~~~~~~~~~
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	365
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	366 ``<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	367 ...............................................
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	368
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	369 .. 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	370
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	371 <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	372 ...
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	373 </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	374
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	375 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	376 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	377 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	378 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	379 ``<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	380
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	381 ``<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	382 ...............................................
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	383
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	384 .. 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	385
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	386 <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	387 <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	388 <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	389 ...
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	390 <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	391 </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	392
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	393 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	394 ``<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	395 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	396 ``<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	397 ``<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	398
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	399
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	400
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	401 Makros
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	402 ~~~~~~
7317 00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	403 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	404 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	405
7317 00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	406 ``dc:macro`` Wiederverwendbare Teile definieren
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	407 ...............................................
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	408
7317 00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	409 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	410
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	411 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	412 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	413 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	414
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	415 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	416 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	417 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	418 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	419
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	420 ``dc:call-macro`` Makros aufrufen
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	421
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	422 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	423
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	424 <dc:call-macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	425
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	426 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	427 von Definition und Aufruf ist egal.
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	428
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	429 ``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	430 .................................................
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	431
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	432 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	433
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	434 <dc:macro name="Name">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	435 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	436 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	437 ...
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	438 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	439
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	440 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	441 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	442 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	443
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	444 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	445
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	446 <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	447
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	448 Zur Verdeutlichung ein konkretes Beispiel
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	449
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	450 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	451
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	452 <dc:macro name="Greetings">
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	453 <Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	454 <dc:macro-body/>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	455 </Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	456 </dc:macro>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	457
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	458 <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	459 <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	460
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	461 Dies produziert folgende Ausgabe
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	462
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	463 .. code:: xml
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	464
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	465 <Hallo>Welt</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	466 <Hallo>Mond</Hallo>
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	467
00b17e77c2e8 Datacage ref doc: Explain dc:macro & Co. Sascha L. Teichmann <teichmann@intevation.de> parents: 7316 diff changeset	468 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	469 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	470
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	471 Sonstige Elemente
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	472 ~~~~~~~~~~~~~~~~~
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	473
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	474 ``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	475 .......................................................
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	476
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	477 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	478
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	479 <dc:element name="Name">
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	480 ...
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	481 </dc:element>
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	482
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	483 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	484
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	485
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	486 ``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	487 .........................................................................
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	488
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	489 .. code:: xml
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	490
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	491 <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	492
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	493 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	494 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	495 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	496 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	497 erstellt werden soll.
53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	498
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	499 ``dc:comment`` Kommentare im Beschreibungsdokument
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	500 ..................................................
7316 52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	501
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	502 .. code:: xml
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	503
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	504 <dc:comment>
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	505 ...
8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	506 </dc:comment>
7314 53d1dd441867 Datacage ref doc: More structure. Explain text interpolation. Sascha L. Teichmann <teichmann@intevation.de> parents: 7255 diff changeset	507
7315 8498fdd71a1e Dataage ref doc: Explain dc:context, dc:comment Sascha L. Teichmann <teichmann@intevation.de> parents: 7314 diff changeset	508 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	509 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	510 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	511
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	512
7316 52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	513 ``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	514 ....................................................
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	515
7316 52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	516 .. 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	517
7316 52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	518 <dc:message>
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	519 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	520 </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	521
7316 52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	522 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	523 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	524 die `{$}-Ersetzungen`_.
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	525
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	526 ``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	527 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	528
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	529 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	530
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	531 <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	532
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	533 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	534 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	535 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	536 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	537 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	538 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	539
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	540
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	541 ``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	542 .........................................................
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	543
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	544 .. code:: xml
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	545
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	546 <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	547
52bc38e6bbe1 Datacage ref doc: Explain dc:variable and dc:convert. Sascha L. Teichmann <teichmann@intevation.de> parents: 7315 diff changeset	548 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	549 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	550 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	551
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	552
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	553 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	554 --------------------
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	555
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	556 ``dc:contains`` 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	557
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	558 ``dc:fromValue`` 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	559
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	560 ``dc:toValue`` 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	561
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	562 ``dc:replace`` 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	563
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	564 ``dc:replace-all`` 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	565
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	566 ``dc:has-result`` 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	567
5783bd29de8a First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs. Sascha L. Teichmann <teichmann@intevation.de> parents: diff changeset	568 ``dc:group-key`` 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	569
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	570 ``dc:date-format`` 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	571
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	572 ``dc:dump-variables`` 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	573
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	574 ``dc:get`` 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	575
7400 dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	576 ``dc:max-number`` TODO
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	577
7400 dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	578 ``dc:min-number`` TODO
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	579
7400 dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	580 ``dc:to-date`` TODO
dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	581
dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	582 ``dc:find-all`` TODO
dd87e0a5f83c Datacage: Added TODOs for new functions in ref document. Sascha L. Teichmann <teichmann@intevation.de> parents: 7379 diff changeset	583

Mercurial > dive4elements > river

annotate artifacts/doc/datacage_ref_de.rst @ 7400:dd87e0a5f83c