Mercurial > lada > lada-server
annotate README.markdown @ 1086:259a6b638968
Prepare for easier schema update testing.
author | Tom Gottfried <tom@intevation.de> |
---|---|
date | Thu, 13 Oct 2016 17:10:02 +0200 |
parents | ff07474b65e0 |
children | effef57f3f7e |
rev | line source |
---|---|
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
1 Lada-Server |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
2 =========== |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
3 Die Software bietet Funktionalität zur Erfassung und Bearbeitung |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
4 von Messdaten. Sowie der Planung der Messungen. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
5 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
6 Weitere Informationen finden sich auf der Projektwebseite unter |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
7 der Adresse: https://wald.intevation.org/projects/lada/ |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
8 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
9 Die Software entstand im Rahmen einer Software Entwicklung durch die |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
10 Intevation GmbH im Auftrag des Bundesamt für Strahlenschutz in den Jahren 2013 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
11 bis 2015. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
12 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
13 Kontakt |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
14 ------- |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
15 Bundesamt für Strahlenschutz |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
16 SW2 Notfallschutz, Zentralstelle des Bundes (ZdB) |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
17 Willy-Brandt-Strasse 5 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
18 38226 Salzgitter |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
19 info@bfs.de |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
20 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
21 Lizenz |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
22 ------ |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
23 Die Software ist unter der GNU GPL v>=3 Lizenz verfügbar. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
24 Details siehe die Datei `COPYING`. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
25 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
26 Quelltext |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
27 --------- |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
28 Die Quelldateien lassen sich wie folgt auschecken: |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
29 ``` |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
30 hg clone https://scm.wald.intevation.org/hg/lada/lada-server |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
31 ``` |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
32 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
33 Entwicklung |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
34 ----------- |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
35 Für die Entwicklung wird ein JDK7 und maven3 oder höher benötigt. Sämtliche |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
36 Abhängigkeiten werden von dem maven build System aufgelöst. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
37 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
38 Installation |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
39 ------------ |
750 | 40 Die Installation des Lada-Servers erfolgt in einem Wildfly-Application-Server |
41 (http://wildfly.org). Dazu müssen folgende Schritte unternommen werden: | |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
42 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
43 $ mvn clean compile package |
750 | 44 $ mv target/lada-server-$VERSION.war $JBOSS_HOME/standalone/deployments |
45 $ touch $JBOSS_HOME/standalone/deployments/lada-server-$VERSION.war.dodeploy | |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
46 |
750 | 47 $JBOSS_HOME ist hierbei durch den Pfad zur Wildfly-Installation zu ersetzen, |
48 $VERSION durch die aktuelle Versionsbezeichnung (entsprechend der Angabe in | |
49 pom.xml). | |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
50 |
750 | 51 Zum Aktualisieren der Anwendung genügt es, das WAR-Archiv zu aktualisieren. |
52 | |
53 Die Anwendung ist dann unter dem Pfad "/lada-server-$VERSION" erreichbar. | |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
54 |
782
322ce4d7cc3a
Mention timezone setting in install docs.
Tom Gottfried <tom@intevation.de>
parents:
750
diff
changeset
|
55 Um zu garantieren, dass die von den REST-Schnittstellen ausgelieferten |
322ce4d7cc3a
Mention timezone setting in install docs.
Tom Gottfried <tom@intevation.de>
parents:
750
diff
changeset
|
56 Zeitstempel sich korrekt auf UTC beziehen, muss die entsprechende System- |
322ce4d7cc3a
Mention timezone setting in install docs.
Tom Gottfried <tom@intevation.de>
parents:
750
diff
changeset
|
57 Property `user.timezone=UTC` vor dem Start des Application-Servers gesetzt |
322ce4d7cc3a
Mention timezone setting in install docs.
Tom Gottfried <tom@intevation.de>
parents:
750
diff
changeset
|
58 werden (siehe `wildfly/standalone.conf`). |
322ce4d7cc3a
Mention timezone setting in install docs.
Tom Gottfried <tom@intevation.de>
parents:
750
diff
changeset
|
59 |
784
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
60 Das PostgreSQL-Datenbank-Backend des Lada-Servers kann als Nutzer `postgres` |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
61 (bzw. als PostgreSQL-Superuser) mit dem Skript `db_schema/setup-db.sh` |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
62 eingerichtet werden. |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
63 |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
64 Details zur Installation können den Dateien `Dockerfile` und |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
65 `db_schema/Dockerfile` entnommen werden. |
353269b89c4c
Mention setup script and Dockerfiles in README.
Tom Gottfried <tom@intevation.de>
parents:
782
diff
changeset
|
66 |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
67 Tests |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
68 ----- |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
69 Die auf Arquillian basierenden Tests erfordern einen vollständig konfigurierten |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
70 und gestarteten Wildfly Application-Server, da für die Schnittstellentest eine |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
71 Clientanwendung simuliert wird und HTTP-Requests ausgeführt werden. |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
72 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
73 Das Ausführen der Tests erfolgt durch das Kommando |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
74 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
75 $ mvn -Premote-test clean test |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
76 |
977
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
77 und benötigt eine leere Datenbank, die z.B. mit |
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
78 |
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
79 $ ./setup-db.sh -cn |
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
80 |
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
81 angelegt werden kann. |
aba3a5384c69
Use a minimal set of master data based on empty database for tests.
Tom Gottfried <tom@intevation.de>
parents:
784
diff
changeset
|
82 |
716
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
83 Dokumenation |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
84 ------------ |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
85 Die Entwicklerdokumentation (Javadoc) kann mit dem folgenden Befehl im |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
86 Verzeichnis der Serveranwendung erzeugt werden: |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
87 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
88 $ mvn javadoc:javadoc |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
89 |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
90 Der Ordner 'target' enthält dann die Dokumentation im HTML-Format in dem |
60cc9b5126d1
Added README file.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
diff
changeset
|
91 Verzeichnis 'site/apidocs'. |
985
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
92 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
93 Erstellen von Filtern |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
94 --------------------- |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
95 Um neue Filter für die Suche von Proben, Messungen und Messprogrammen zu |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
96 erstellen sind die folgenden Schritte erforderlich: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
97 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
98 1. In der Tabelle 'stammdaten.query' einen neuen Eintrag erzeugen. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
99 * id: Primary-Key (wird generiert) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
100 * name: Der Name des Filters |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
101 * type: Der Datentyp der gefiltert werden soll. |
990
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
102 (mögliche Werte: 'probe', 'messung', 'messprogramm', 'ort', 'probenehmer', |
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
103 'datensatzerzeuger', 'messprogrammkategorie') |
985
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
104 * sql: Das auszuführende SQL-Statement (siehe #Regeln für die Syntax) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
105 * description: Ein beschreibender Text |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
106 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
107 2. In der Tabelle 'stammdaten.result' für die anzuzeigenden Felder je einen |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
108 Eintrag erzeugen: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
109 * id: Primary-Key (wird generiert) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
110 * query_id: ID der zugehörigen und in Schritt 1. erzeugten Query |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
111 * data_index: Name des Feldes zur Übertragung an den Client (in CamelCase) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
112 * header: Der Titel der Spalte für diesen Eintrag |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
113 * width: Die Spaltenbreite (in Pixel) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
114 * flex: Dynamische Spaltenbreite (true/false) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
115 * index: Der Datenindex |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
116 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
117 3. In der Tabelle 'stammdaten.filter' für jedes 'WHERE'-Statement in der Query |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
118 einen Eintrag erzeugen: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
119 * id: Primary-Key (wird generiert) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
120 * query_id: ID der zugehörigen und in Schritt 1. erzeugten Query |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
121 * data_index: Der Name der Variablen, die in dem 'WHERE'-Statement ersetzt |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
122 werden soll |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
123 * type: Datenbasis, die im Client als Eingabe genutzt werden soll |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
124 * label: Der angezeigte Name des Filters |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
125 * multiselect: Mehrfachangabe von Werten für diesen Filter (true/false) |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
126 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
127 ### Regeln |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
128 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
129 * Bei Queries vom Typ `probe` muss das erste selektierte Feld `probe.id` sein. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
130 Dieses wird in der Oberfläche nicht angezeigt. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
131 * Bei Queries vom Typ `messung` muss das erste selektierte Feld `messung.id` und |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
132 das Zweite `probe.id AS probeId` sein. Diese werden in der Oberfläche nicht |
986
1f7e40f27103
Added instructions for messung queries. Fixed typo.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
985
diff
changeset
|
133 angezeigt. Um im Client die Funktionalität zu erhalten, sollten Messungsfilter |
1f7e40f27103
Added instructions for messung queries. Fixed typo.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
985
diff
changeset
|
134 die beiden Felder `probe.hauptproben_nr AS hauptprobenNr` und |
1f7e40f27103
Added instructions for messung queries. Fixed typo.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
985
diff
changeset
|
135 `messung.nebenproben_nr AS nebenprobenNr` enthalten. |
985
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
136 * Bei Queries vom Typ `messprogramm` muss das erste selektierte Feld |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
137 `messprogramm.id` sein. Dieses wird in der Oberfläche nicht angezeigt. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
138 * Im `WHERE`-Statement genutzte Variablen müssen in der Form `:variablenName` |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
139 angegeben werden und dem Feld `data_index` im zugehörigen Filter entsprechen. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
140 * Um auch leere Filterangaben zu erlauben, sollte im `WHERE`-Statement ein |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
141 Element wie folgt aussehen: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
142 ... WHERE (tabelle.feld = :variablenName OR '' = :variablenName) ... |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
143 * Wenn ein Filter mit `multiselect = true` angegeben wird, so wird in dem |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
144 `WHERE`-Statement ein `SIMILAR TO` erwartet. |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
145 * Das Feld `index` in der Tabelle `stammdaten.result` dient zur Zuordnung des |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
146 selektierten Datenfeldes zu dem Entsprechenden Eintrag in der Tabelle |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
147 `stammdaten.result`. Beispiel: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
148 ``` |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
149 'SELECT probe.id, probe.mst_id AS mstId, probe.hauptproben_nr AS hpNr, ...' |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
150 |----- index 1 -----| |--------- index 2 --------| |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
151 Wird in der Tabelle 'stammdaten.result' zu: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
152 Result 1: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
153 ... |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
154 data_index: mstId |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
155 header: Messstelle |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
156 width: 100 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
157 flex: false |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
158 index: 1 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
159 ... |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
160 Result 2: |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
161 ... |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
162 data_index: hpNr |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
163 header: Hauptproben Nr |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
164 width: 150 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
165 flex: false |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
166 index: 2 |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
167 .... |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
168 ``` |
990
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
169 * Queries für Stammdaten werden gesondert behandelt und beinhalten keine |
985
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
170 SQL-Statements. Dementsprechend können auch keine Einträge für Ergebnisse in |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
171 der Tabelle `stammdaten.result` gemacht werden. Filter können allerdings, |
990
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
172 unter der Bedingung, dass `data_index` auf einen in dem Datentyp vorhandenes |
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
173 und in CamelCase geschriebenes Datenfeld zeigt, angelegt werden. |
ff07474b65e0
Updated description how to create filters.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
986
diff
changeset
|
174 Momentan sind Queries für die folgenden Stammdaten möglich: |
985
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
175 * Orte |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
176 * Probennehmer |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
177 * Datensatzerzeuger |
3019d7797037
Beschreibung zur Erstellung von Filtern zu README hinzugefügt.
Raimund Renkert <raimund.renkert@intevation.de>
parents:
977
diff
changeset
|
178 * Messprogrammkategorien |