# HG changeset patch # User Tom Gottfried # Date 1375695599 -7200 # Node ID 012f79123d48c3cd0383dbbd3d6522e344d84140 # Parent 46c6ff16c422bd427d5d919fb9e2fe8328bcda84 Importer Doc: completion and corrections to overview of geo-importer. diff -r 46c6ff16c422 -r 012f79123d48 backend/doc/documentation/de/importer-geodaesie.tex --- a/backend/doc/documentation/de/importer-geodaesie.tex Mon Aug 05 11:21:05 2013 +0200 +++ b/backend/doc/documentation/de/importer-geodaesie.tex Mon Aug 05 11:39:59 2013 +0200 @@ -3,18 +3,20 @@ Der Geodaten Importer ist ein in der Programmiersprache Python geschriebenes Kommandozeilen Werkzeug zum Import von Shapefiles in eine Datenbank. -Zum Lesen der Shapefiles und zum schreiben der Geodaten -in die Datenbank wird die GDAL Bibliothek verwendet. +Zum Lesen der Shapefiles und zum Schreiben der Geodaten +in die Datenbank wird die GDAL-Bibliothek verwendet. Um Daten in eine Oracle Datenbank zu importieren ist es nötig, dass -GDAL und GDAL Python Bindungs mit Oracle Unterstützung installiert +GDAL und GDAL-Python-Bindings mit Oracle-Unterstützung installiert sind. Bei der Verwendung von PostgreSQL entfällt dieser Schritt. Weitere Details hierzu befinden sich im Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. -Für die Reprojektion der Daten verwendet GDAL wiederum die PROJ4-Bibliothek. +Für die Transformation der Daten verwendet GDAL wiederum die PROJ4-Bibliothek. Die Daten werden vor dem Schreiben in die Datenbank alle -in die Gauß-Krüger-Projektion Zone 3 (EPSG-Code 31467) überführt. +in die Gauß-Krüger-Projektion Zone 3 (EPSG-Code 31467) transformiert. Ist für die zu importierenden Daten keine Projektion ersichtlich -(fehlende \textit{*.prf}-Datei), so findet keine Reprojektion statt. +(fehlende \textit{*.prj}-Datei), so findet keine Transformation statt. +Dies führt nur zu Problemen mit dem Fachdienst FLYS, falls die Daten nicht +bereits in der genannten Projektion vorlagen. Der Importer kann mit einem Shellscript von der Kommandozeile gestartet werden (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der @@ -24,47 +26,50 @@ Relation der Datenbank schreibt. Die Parser sind speziell auf das Dateisystem der BfG ausgerichtet. So wird beispielsweise erwartet, dass die Shapefiles der Gewässerachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu -den einzelnen Parsern sind dem nächsten Kapitel \ref{Beschreibung der Parser} zu -entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird je nach -Konfiguration im Logfile vermerkt. Folgende Einträge können dem Logfile +den einzelnen Parsern sind Kapitel \ref{Beschreibung der Parser} zu +entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird +im Logfile vermerkt. Folgende Einträge können dem Logfile entnommen werden: -\textbf{INFO: Inserted 4 features} -\\Gibt die Anzahl der erfolgreich importierten Features an.\\ +\textbf{INFO: Inserted \# features} +\\Gibt die Anzahl der erfolgreich importierten Features an. -\textbf{INFO: Failed to create 2 features} -\\Gibt die Anzahl der Features an, die nicht importiert werden konnten.\\ +\textbf{INFO: Failed to create \# features} +\\Gibt die Anzahl der Features an, die nicht importiert werden konnten. -\textbf{INFO: Found 3 unsupported features of type: wbkMultiLineString} +\textbf{INFO: Found 3 unsupported features of type: '...'} \\Gibt die Anzahl der Features an, die aufgrund ihres Datentyps nicht importiert werden konnten. Wenn etwa Punkte erwartet wurden aber sich im Shapefile -Polygone befanden.\\ +Polygone befanden. -\textbf{INFO: Did not import values from fields: TYP ID GRUENDUNG BHW} -\\Manche Importer versuchen neben der Geographischen Information weitere -Felder in die Datenbank einzulesen. Um festzustellen ob ein Feld aufgrund -von Tippfehlern oder unterschiedlicher Schreibweise nicht importiert wurde, -gibt diese Information Auskunft darüber welche Felder aus der Shape Datei -nicht verwendet wurden.\\ +\textbf{INFO: Did not import values from fields: '...' ...} +\\Der Importer schreibt neben der geographischen Information weitere +Attribut-Daten in die Datenbank. +Attribut-Spalten die nicht importiert wurden (z.B. auf Grund +von Tippfehlern oder unterschiedlicher Schreibweise), +werden wie angegeben im Logfile aufgeführt. \textbf{ERROR: No source SRS given! No transformation possible!} \\Das Shapefile enthält keine Information, in welcher Projektion die Geometrien vorliegen. Es findet keine Transformation in die Zielprojektion statt. Bitte -beachten Sie, dass FLYS diese Geometrien später ggf nicht korrekt darstellen +beachten Sie, dass FLYS diese Geometrien später ggf.\ nicht korrekt darstellen kann. \textbf{ERROR: Unable to insert feature: DETAIL} -\\Beim Lesen der Attribute eines Features ist ein Fehler aufgetreten. -Das Feature konnte nicht in die Datenbank geschrieben werden.\\ +\\Beim Lesen eines Features ist ein Fehler aufgetreten. +Das Feature konnte nicht in die Datenbank geschrieben werden. \textbf{ERROR: Exception while committing transaction} \\Beim Abschluss des Schreib-Vorgangs in die Datenbank ist ein unerwarteter -Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden.\\ +Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden. \textbf{ERROR 1: ORA-01017: invalid username/password; logon denied} \\Es konnte keine Verbindung zur Oracle Datenbank hergestellt werden. Prüfen Sie die Verbindungseinstellungen. +Weitere Fehler, die von der Oracle-Datenbank kommen, können ebenfalls im +Logfile angezeigt werden. + Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem in einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank