comparison backend/doc/documentation/de/importer-hydr-morph.tex @ 6699:f1aefaa0e0fa double-precision

Importer Doc: small corrections to configuration and typo
author Tom Gottfried <tom.gottfried@intevation.de>
date Mon, 29 Jul 2013 12:26:13 +0200
parents cc22e3cfd0f5
children 95322836a6a3
comparison
equal deleted inserted replaced
6698:cc22e3cfd0f5 6699:f1aefaa0e0fa
151 kann der Import von Hochwasserschutzanlagen 151 kann der Import von Hochwasserschutzanlagen
152 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis 152 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis
153 \textit{../HW-Schutzanlagen} relativ zur \textit{gewaesser.wst}-Datei betrachtet. 153 \textit{../HW-Schutzanlagen} relativ zur \textit{gewaesser.wst}-Datei betrachtet.
154 154
155 \subsubsection{Messstellen-Stammdaten} 155 \subsubsection{Messstellen-Stammdaten}
156 Mit \textbff{-Dflys.backend.importer.skip.measurement.stations=true} 156 Mit \textbf{-Dflys.backend.importer.skip.measurement.stations=true}
157 kann der Import von Messstellen-Stammdaten aus 157 kann der Import von Messstellen-Stammdaten aus
158 \textit{Morphologie/Basisdaten/Messstellen-Stammdaten.csv} 158 \textit{Morphologie/Basisdaten/Messstellen-Stammdaten.csv}
159 unterdrückt werden. 159 unterdrückt werden.
160 160
161 \subsubsection{Sohlhöhen (Peilungen)} 161 \subsubsection{Sohlhöhen (Peilungen)}
275 Die zweite Regel-Variante \textit{line} wird auf jeden Eintrag innerhalb einer KM-Datei 275 Die zweite Regel-Variante \textit{line} wird auf jeden Eintrag innerhalb einer KM-Datei
276 auf den Bezeichner der Streckenfavoriten angewandt. Als Muster dient auch hier 276 auf den Bezeichner der Streckenfavoriten angewandt. Als Muster dient auch hier
277 ein regulärer Ausdruck, der über das Attribut \textit{pattern} definiert wird. 277 ein regulärer Ausdruck, der über das Attribut \textit{pattern} definiert wird.
278 Die Kategorie wird im Trefferfall über das Attribut \textit{type} bestimmt. 278 Die Kategorie wird im Trefferfall über das Attribut \textit{type} bestimmt.
279 Treffen mehrere Regeln zu, wird die Kategorie gewählt, die zum ersten Treffer 279 Treffen mehrere Regeln zu, wird die Kategorie gewählt, die zum ersten Treffer
280 gehört. Trifft keine Regel zu wird der Eintrag der Kategorie zugeteilt, die für 280 gehört. Trifft keine Regel zu, wird der Eintrag der Kategorie zugeteilt, die für
281 die beinhaltende Datei als Vorgabe gilt. 281 die beinhaltende Datei als Vorgabe gilt.
282 282
283 283
284 \subsection{Konfiguration} 284 \subsection{Konfiguration}
285 \label{configuration} 285 \label{configuration}
294 Desktop-FLYS). Wichtig für den Importer sind in dieser Datei die Zeilen, die mit 294 Desktop-FLYS). Wichtig für den Importer sind in dieser Datei die Zeilen, die mit
295 \textit{WSTDatei:} beginnen. In ihnen wird der Pfad zu der zentralen WST-Datei 295 \textit{WSTDatei:} beginnen. In ihnen wird der Pfad zu der zentralen WST-Datei
296 des jeweiligen Gewässers angegeben. Alle anderen importierten Dateien werden in 296 des jeweiligen Gewässers angegeben. Alle anderen importierten Dateien werden in
297 ihrer Lage im Dateisystem relativ zur Lage dieser Datei betrachtet. 297 ihrer Lage im Dateisystem relativ zur Lage dieser Datei betrachtet.
298 298
299 In der Zeile beginnend mit \textit{Gewässer:} wird der Name des Gewässers
300 festgelegt.
301
299 \textbf{BACKEND\_USER} 302 \textbf{BACKEND\_USER}
300 \\Der Nutzername, der zum Verbinden zur Datenbank verwendet werden soll. 303 \\Der Nutzername, der zum Verbinden zur Datenbank verwendet werden soll.
301 304
302 \textbf{BACKEND\_PASS} 305 \textbf{BACKEND\_PASS}
303 \\Das Passwort, welches in Kombination mit \textbf{BACKEND\_USER} zum Verbinden 306 \\Das Passwort, welches in Kombination mit \textbf{BACKEND\_USER} zum Verbinden
327 \\Der Hibernate-Dialekt, den die Datenbank versteht. Im Falle einer Oracle-XE 330 \\Der Hibernate-Dialekt, den die Datenbank versteht. Im Falle einer Oracle-XE
328 wäre dies z.B.: \textit{org.hibernate.dialect.OracleDialect}. 331 wäre dies z.B.: \textit{org.hibernate.dialect.OracleDialect}.
329 332
330 333
331 Weitere Details zum Verbinden zu einer Oracle Datenbank finden Sie unter\\ 334 Weitere Details zum Verbinden zu einer Oracle Datenbank finden Sie unter\\
332 \href{http://www.orafaq.com/wiki/JDBC}{http://www.orafaq.com/wiki/JDBC}. Alle weiteren Einstellungen sind 335 \href{http://www.orafaq.com/wiki/JDBC}{http://www.orafaq.com/wiki/JDBC}.
333 optional anpassbar: 336
337 Alle weiteren Einstellungen sind optional anpassbar:
334 338
335 \textbf{LOG4J\_CONFIG} 339 \textbf{LOG4J\_CONFIG}
336 \\Der Fachdatenimport verwendet die externe Bibliothek \textit{Apache Log4J} zum Loggen 340 \\Der Fachdatenimport verwendet die externe Bibliothek \textit{Apache Log4J} zum Loggen
337 von Informationen. Dazu ist es notwendig eine entsprechende Konfiguration beim 341 von Informationen. Dazu ist es notwendig eine entsprechende Konfiguration beim
338 Start anzugeben. \textit{LOG4J\_CONFIG} verweist in diesem Fall auf eine externe 342 Start anzugeben. \textit{LOG4J\_CONFIG} verweist in diesem Fall auf eine externe
347 \href{http://logging.apache.org/log4j/1.2/}{http://logging.apache.org/log4j/1.2/} 351 \href{http://logging.apache.org/log4j/1.2/}{http://logging.apache.org/log4j/1.2/}
348 352
349 353
350 \textbf{IMPORTER\_MAINVALUE\_TYPES} 354 \textbf{IMPORTER\_MAINVALUE\_TYPES}
351 \\Diese Einstellung erlaubt die Angabe eines Textes, der aus den gültigen Typen 355 \\Diese Einstellung erlaubt die Angabe eines Textes, der aus den gültigen Typen
352 für Hauptwerte zusammengesetzt ist. \textit{QWTD} ist standardmäßig gesetzt. 356 für Hauptwerte zusammengesetzt ist. \textit{QWTD-} ist standardmäßig gesetzt.
353 357
354 \textbf{IMPORTER\_ANNOTATION\_TYPES} 358 \textbf{IMPORTER\_ANNOTATION\_TYPES}
355 \\Diese Einstellung verweist auf eine Datei (relativ zum Ort der \textit{run.sh} 359 \\Diese Einstellung verweist auf eine Datei (relativ zum Ort der \textit{run_hydr_morph.sh}
356 im Dateisystem), die die möglichen Typen von Streckenfavoriten und deren Regeln 360 im Dateisystem), die die möglichen Typen von Streckenfavoriten und deren Regeln
357 definiert. Siehe hierzu auch Kapitel \ref{annotation-types}. 361 definiert. Siehe hierzu auch Kapitel \ref{annotation-types}.
358 362
359 363
360 Die im folgenden beschriebenen Einstellungen können jeweils die Werte 364 Die im folgenden beschriebenen Einstellungen können jeweils die Werte
361 \textit{true} oder \textit{false} annehmen und sind optional anzupassen. 365 \textit{true} oder \textit{false} annehmen und sind optional anzupassen.
362 366
363 \textbf{IMPORTER\_DRY\_RUN} 367 \textbf{IMPORTER\_DRY\_RUN}
364 \\Falls \textit{true} gesetzt wird, wird der Import nur simuliert. Es werden 368 \\Falls \textit{true} gesetzt wird, wird der Import nur simuliert. Es werden
365 keine Daten in die Datenbank geschrieben. Dies kann z.B.: zum Ermitteln 369 keine Daten in die Datenbank geschrieben. Die Log-Dateien können dann verwendet werden, um Fehler in den Daten vor dem Schreiben in die
366 potentieller Dateninkonsistenzen sinnvoll sein. 370 Datenbank zu ermitteln.
367 371
368 \textbf{IMPORTER\_SKIP\_GAUGES} 372 \textbf{IMPORTER\_SKIP\_GAUGES}
369 \\Wenn \textit{true} gesetzt ist werden keine Pegel- und Stammdaten bearbeitet. 373 \\Wenn \textit{true} gesetzt ist werden keine Pegel- und Stammdaten bearbeitet.
370 374
371 \textbf{IMPORTER\_SKIP\_ANNOTATIONS} 375 \textbf{IMPORTER\_SKIP\_ANNOTATIONS}
789 gestartet. Dazu führen folgenden Befehl aus:\\ 793 gestartet. Dazu führen folgenden Befehl aus:\\
790 794
791 \begin{lstlisting} 795 \begin{lstlisting}
792 ./run_hydr_morph.sh 796 ./run_hydr_morph.sh
793 \end{lstlisting} 797 \end{lstlisting}
794
795 Nachdem der Prompt der Konsole zurückkehrt, ist der Import abgeschlossen oder es 798 Nachdem der Prompt der Konsole zurückkehrt, ist der Import abgeschlossen oder es
796 ist ein Fehler aufgetreten. Weitere Informationen entnehmen Sie der Log-Datei. 799 ist ein Fehler aufgetreten. Weitere Informationen entnehmen Sie der Log-Datei.
797 800
798 Um einen Gewässerdatensatz in einem Durchlauf (inkl.\ Geodaten) 801 Um einen Gewässerdatensatz in einem Durchlauf (inkl.\ Geodaten)
799 zu importieren, kann auch das Skript \textit{import\_river.sh} verwendet werden. 802 zu importieren, kann auch das Skript \textit{import\_river.sh} verwendet werden.

http://dive4elements.wald.intevation.org