Mercurial > dive4elements > river

annotate flys-artifacts/doc/datacage.txt @ 3035:b388d888330d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Implemented facets and splitted up the event facet.Implemented facets and splitted up the event facet. flys-artifacts/trunk@4604 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Raimund Renkert <raimund.renkert@intevation.de>
date Wed, 06 Jun 2012 11:35:32 +0000
parents aba4104f41c9
children 6a37a0134409
rev   line source
3033
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
1 The datacages behaviour is defined in the file conf/meta-data.xml .
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
2
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
3 The datacage serves two purposes.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
4 It handles automatic 'recommendations', which are instructions
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
5 sent by the client to add newly created artifacts to the collection.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
6 From a user perspective, these artifacts mainly represent curves or data
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
7 points in the resulting diagrams.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
8 The second task is to let the user add already existing artifacts (i.e.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
9 previous calculations) or new artifacts with access to related data.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
10
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
11 Irrelevant of the type of elements (recommendations or user picked data) the
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
12 datacage can iterate over possible artifacts by accessing its own database.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
13 Thus, to create a list of matching entries, database queries are used.
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
14
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
15 In meta-data.xml, database queries are defined as <dc:statement> elements,
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
16 for example
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
17 <dc:statement>
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
18 SELECT id AS prot_id,
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
19 description AS prot_description
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
20 FROM wsts WHERE kind = 1 AND river_id = ${river_id}
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
21 </dc:statement>
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
22
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
23 As can be seen from the example, the datacage configuration file can maintain
aba4104f41c9 Added stub for datacage configuration documentation.
Felix Wolfsteller <felix.wolfsteller@intevation.de>
parents:
diff changeset
24 its own stack of variables (${river_id} in above example).
http://dive4elements.wald.intevation.org