LIDS 7 Import/Export Mannheim, 11.02.2013 Autor: Anschrift: Version: Status: Modifiziert von: Ablage: Christine Sickenberger - Asseco BERIT GmbH Asseco BERIT GmbH Mundenheimer Straße 55 68219 Mannheim Tel. +49 (0)621 87805-0 Fax. +49 (0)621 87805-20 F1 Final Andreas Schleich T:\Dokumentationen\Asseco_BERIT\Schulung\BERIT_LIDS7_Basiskurs\Impo rt_export\beritde_lt_do_20120918_lids7.basisschulung_import_export. docx Speicherdatum: 2013-11-06 Druckdatum: 2013-11-06 Anzahl Seiten: 17 LIDS 7 Import/Export Seite 1 / 17
Inhaltsverzeichnis LIDS 7 Import/Export... 1 Inhaltsverzeichnis... 2 1. Import/Export... 3 1.1. Voraussetzungen... 3 1.2. Workflow Datenaustausch... 3 1.3. Created by, updated by... 5 1.4. Export der Daten aus Hauptprojekt über Vorlage Export in XML... 6 1.4.1. Vorlage erstellen... 6 1.4.2. Ergebnis... 7 1.4.2.1. Export.zip-Datei zum Austausch mit dem Dienstleister... 7 1.4.2.2. Eintrag in Datenbank... 8 1.4.2.3. Verwaltung der Exporte... 8 1.5. Import der Daten in DL Projekt Import von XML-Daten... 9 1.5.1. Ergebnis... 11 1.5.1.1. Selektionsmenge in der Datenverwaltung... 11 1.5.1.2. Verwaltung der Import... 12 1.5.1.3. Eintrag in Datenbank... 12 1.6. Export der Daten aus DL Projekt Verwaltung der Importe... 12 1.7. Import der Daten in DL Projekt Import von XML-Daten... 15 1.8. Import der Daten in Hauptprojekt Import von XML-Daten... 16 LIDS 7 Import/Export Seite 2 / 17
1. Import/Export Im folgenden Kapitel wird der Workflow beschrieben, wenn die Daten eines LIDS Projektes von Dienstleistern erfasst werden und regelmäßig ein Austausch der Daten mit dem Hauptprojekt stattfinden soll. 1.1. Voraussetzungen Folgende Voraussetzungen sind für einen erfolgreichen Im- und Export notwendig: Beide Projekte nutzen die gleichen Metadaten (Datenmodell, Ressource, ) Beide Projekte nutzen die gleichen Versionen von LIDS7 Server und Client Der Benutzer, der die Vorlagen exportiert, muss alle Rechte auf alle Featuretypen haben, die in den Vorlagen enthalten sind. Nach einer Änderung der Benutzerrechte muss über die LAS Console ein Synchronize Security durchgeführt werden. Im Hauptprojekt existiert für jeden Dienstleister ein Benutzername. Dieser Login muss für den Import verwendet werden. 1.2. Workflow Datenaustausch Mit dem Datenaustausch wird immer der Master der Projektdaten übergeben, d.h. während der Erfassung eines Beteiligten, dürfen die Daten des anderen nicht bearbeitet werden (alle Änderungen werden beim Import überschrieben). Werden Daten nur vom Dienstleister erfasst und im Hauptprojekt zur Datenaktualisierung importiert, ist folgender Workflow zu berücksichtigen. Wichtig dabei ist, dass nach einem Export beim Dienstleister das exportierte Paket direkt wieder importiert wird. Dies ist notwendig, damit auch alle vom Dienstleister neu erfassten Elemente beim nächsten Datenabgleich berücksichtigt werden können. LIDS 7 Import/Export Seite 3 / 17
Abbildung 1: Workflow Erfassung bei Dienstleistern Findet eine Masterübergabe statt, d.h. sollen nach einer Erfassung vom Dienstleister im Hauptprojekt Daten geändert werden, gilt folgender Workflow: LIDS 7 Import/Export Seite 4 / 17
Abbildung 2: Workflow wechselnder Master Dabei ist es wichtig, dass die Kriterien der Vorlagen (Featuretypen, räumliche Bedingung) bei einem weiteren Export nicht verändert werden. 1.3. Created by, updated by Beim Import der Daten im Hauptprojekt werden die Spalten update date und updated by mit dem LIDS7 Benutzernamen ersetzt, über welchen der Import stattgefunden hat. Aus diesem Grund ist im Hauptprojekt für jeden Dienstleister ein Benutzername zu erzeugen, mit welchem der Import durchgeführt wird. Mit diesem Filter ist es dann auch später möglich vom Dienstleister erfasste Daten von eigen erfassten Daten zu unterscheiden. LIDS 7 Import/Export Seite 5 / 17
1.4. Export der Daten aus Hauptprojekt über Vorlage Export in XML 1.4.1. Vorlage erstellen Die vom Dienstleister zu bearbeiteten Daten müssen zunächst im Hauptprojekt über eine Vorlage definiert werden. Die Vorlage kann eine räumliche Bedingung enthalten. So ist es z.b. möglich, den Export für unterschiedliche Dienstleister in mehrere kleine Pakete zu unterteilen: Abbildung 3: Export Vorlage aufgeteilt nach Kategorie und Bereich Die Funktion Export in XML ermöglicht den Export der Daten im XML- Format um sie z.b. in einem anderen LIDS7 Projekt verwenden zu können oder für externe Systeme zu exportieren. Mit Bestätigen der Funktion öffnet sich das Dialogfenster Export in XML über welches der Zielpfad sowie der Dateiname gewählt werden kann. Wenn die Vorlage keine räumliche Bedingung enthält erscheint eine Warnmeldung, dass alle Daten exportiert werden. Der Benutzer muss hier gezielt nochmal die Aktion bestätigen. Abbildung 4: Ansicht Datenverwaltung Export in XML LIDS 7 Import/Export Seite 6 / 17
Im Feld Name von Export muss der Name für die Export-Datei gefüllt werden. Im Feld Beschreibung kann eine entsprechende Beschreibung vergeben werden. Im Feld Ausgabedatei wird der entsprechende Pfad angegeben. Im unteren Bereich Inhalt von Export kann über einen Haken definiert werden, welche Elemente in den Export mit einbezogen werden. Hier stehen zur Auswahl Verknüpfte Grafik Anhänge Details Verknüpfungen Verknüpfte nicht grafische Elemente Codelisten (wird nur benötigt beim Austausch in andere Systeme, außerhalb LIDS7) Datenmodell (wird nur benötigt beim Austausch in andere Systeme, außerhalb LIDS7) Mit Bestätigen der Funktion Starten wird der Export der Daten gestartet. Je nachdem welche Inhalte gewählt wurden werden in XML-Dateien exportiert und als ZIP-Archiv im definierten Pfad abgelegt. Im rechten Bereich Ergebnis der Verarbeitung wird das Ergebnis und die Anzahl der exportierten Elemente angezeigt. Abbildung 5: Ansicht Datenverwaltung Export in XML Ergebnis der Verarbeitung 1.4.2. Ergebnis 1.4.2.1. Export.zip-Datei zum Austausch mit dem Dienstleister Das Ergebnis des Exportes im Hauptprojekt ist zum einen eine.zip-datei mit folgendem Inhalt: LIDS 7 Import/Export Seite 7 / 17
Abbildung 6: Inhalt Export.zip 1.4.2.2. Eintrag in Datenbank Sowie einen Eintrag in der Datenbank-Tabelle LIDS_PACKAGE für den Export Abbildung 7: DB-Tabelle LIDS_PACKAGE 1.4.2.3. Verwaltung der Exporte Ebenso wird ein Eintrag in der Verwaltung der Exporte erzeugt. über die Verwaltung der Exporte XML kann eine die log-datei aufgerufen sowie eine Selektionsmenge der exportierten Daten aufgerufen werden. Abbildung 8: Tools Datenaustausch in XML Verwaltung der Exporte XML Die Funktion Log-Datei öffnen öffnet eine Textdatei die Auskunft über die durch den Export durchgeführten Änderungen listet. Die Funktion Datenselektion erstellen erstellt aus allen in der markierten Exporzeile enthaltenen Daten eine Selektionsmenge und hängt diese in der Datenverwaltung als Selektionsmenge an. Die Funktion löschen der Importe. löscht einen markierten Eintrag aus der Verwaltung Mit der Funktion Neu laden kann die Liste der Importe aktualisiert werden. LIDS 7 Import/Export Seite 8 / 17
1.5. Import der Daten in DL Projekt Import von XML-Daten Der Dienstleister erhält den Export vom Hauptprojekt als ZIP-Datei. Diese ZIP- Datei kann über die Funktion Tools/Datenaustausch in XML/Import von XML-Dateien beim Dienstleister importiert werden. Abbildung 9: Tools Datenaustausch in XML Import von XML-Dateien Mit Bestätigung der Funktion Import von XML Dateien öffnet sich folgendes Dialogfenster: Abbildung 10: Projekt Datenaustausch - Import LIDS 7 Import/Export Seite 9 / 17
Im Feld Name von Import muss ein Name für den Import vergeben werden. Dieser Name erscheint nach dem Import in der Datenverwaltung und wird als neue(s) Element(e) angezeigt. Über das Feld Eingabedatei wird das.zip-file aus dem Export ausgewählt. Das.zip-File zum Import muss zwingend die xml-dateien für den Import enthalten. Der Haken Inkl. Der Modifikation der Elemente definiert, werden auch bestehende Elemente geändert. Ist die Option abgehakt, werden alle Elemente als neue Elemente importiert. Der Haken Elemente löschen definiert, ob Elemente, die im ausgelagerten Projekt gelöscht wurden beim Import im zentralen Projekt ebenfalls gelöscht werden. Bei ausgeschaltetem Haken werden keine Elemente gelöscht. können weitere Optionen für den Import defi- Im Bereich Parameter niert werden: Der Haken Import beim Auftreten eines Fehlers unterbrechen bewirkt, dass bei einem Fehler im Import alle durch den Import ausgeführten Operationen rückgängig gemacht werden. Ist der Haken nicht gesetzt, läuft der Import weiter, Fehler werden im Protokoll eingetragen. Der Haken Nur Überprüfung der Eingabedatei bewirkt, dass der Import nicht durchgeführt wird sondern lediglich die Eingabedatei auf Richtigkeit geprüft wird. Der Haken Modus der automatisierten Bestätigung der Operationen definiert ein automatisches Commit der Änderungen durch den Import. Der Haken Stiller Modus definiert, dass die durch die internen Listener automatisch generierten Objekte (Räumliche Bedingungen, Abgeleitete Attribute wie Länge, Fläche,, Linienränder, nicht generiert werden. Im Stillen Modus sind die internen Listener beim Import deaktiviert. Somit läuft der Import wesentlich schneller. Ist der Haken Stiller Modus gesetzt, muss nach dem Import über folgende Funktionen die entsprechenden Objekte für alle importierten Objekte generiert werden. Tools Flächen generieren Tools räumliche Verknüpfung generieren Tools Thematisierungsattribute aktualisieren Topologie Liniengraphen generieren Erweiterungen Ränder der Linien generieren Erweiterungen Pufferzonen der Linien generieren Das Protokoll ist über die Funktion Log-Datei öffnen aufzurufen. Mit der Funktion Starten wird der Import der Eingabedatei gestartet. Im rechten Bereich Ergebnis der Verarbeitung wird angezeigt, die Gesamtanzahl der importierten Elemente, wie viele Elemente das System erstellt, aktualisiert oder nicht importiert hat. LIDS 7 Import/Export Seite 10 / 17
Abbildung 11: Ergebnis der Verarbeitung 1.5.1. Ergebnis 1.5.1.1. Selektionsmenge in der Datenverwaltung Nach dem Import wird eine temporäre Selektionsmenge in der Datenverwaltung erzeugt. Aus dieser Selektionsmenge können die importierten Daten in der Grafik, in der Liste oder im Formular angezeigt werden. Abbildung 12: Datenverwaltung nach dem Import Der Import ist mit Operationen bestätigen in der Datenbank zu bestätigen. LIDS 7 Import/Export Seite 11 / 17
1.5.1.2. Verwaltung der Import Durch den Import wird in der Verwaltung der Importe ein Eintrag erzeugt: Abbildung 13: Verwaltung der Importe 1.5.1.3. Eintrag in Datenbank In der Datenbank wird im Hintergrund ein Eintrag in der Tabelle LIDS_PACKAGE erzeugt. Abbildung 14: DB-Tabelle LIDS_PACKAGE In der Tabelle LIDS_PACKAGE_IMP wird für jedes grafische Element welches im importierten Paket enthalten ist ein Eintrag mit Bezug zur entsprechenden ID aus LIDS_PACKAGE erzeugt. LIDS_PACKAGE_IMP wird für das Löschen von Feature verwendet. Folgendes Select erzeugt die Einträge in LIDS_PACKAGE_IMP: select fid from lids_package_imp where imp_id = (select id from lids_package) and where exists select fid from lids_feature_hist where change_flag=d; Abbildung 15: DB-Tabelle LIDS_PACKAGE_IMP 1.6. Export der Daten aus DL Projekt Verwaltung der Importe Nach der Datenerfassung des Dienstleisters muss der aktuelle Projektstand mit dem Hauptprojekt ausgetauscht werden. Dieser enthält alle geänderten Daten, neue Elemente, gelöschte Elemente, Anhänge. LIDS 7 Import/Export Seite 12 / 17
Beim Export der Daten aus dem Dienstleister-Projekt ist es zwingend, den Export auf Grundlage der letzten Importdatei durchzuführen. Nur so kann gewährleistet sein, dass alle Daten, die der Dienstleister exportiert mit den im Hauptprojekt existierenden Daten abgeglichen werden kann. Abbildung 16: Tools Datenaustausch in XML Verwaltung der Importe XML Mit der Funktion Verwaltung der Importe XML können die im LIDS7 Projekt getätigten Importe verwaltet werden. Die Funktion Log-Datei öffnen öffnet eine Textdatei die Auskunft über die durch den Import durchgeführten Änderungen listet. Die Funktion Datenselektion erstellen erstellt aus allen in der markierten Importzeile enthaltenen Daten eine Selektionsmenge und hängt diese in der Datenverwaltung als Selektionsmenge an. LIDS 7 Import/Export Seite 13 / 17
Abbildung 17: Tools Datenverwaltung Neue Datenselektion aus Import Die Funktion Exportieren exportiert wird verwendet, wenn Daten vorab importiert wurden und genau diese wieder exportiert werden sollen. Mit dieser Funktion öffnet sich das Dialogfenster Export in XML. Eine genaue Beschreibung ist im Kapitel Datenverwaltung Export in XML zu finden. Die Funktion löschen der Importe. löscht einen markierten Eintrag aus der Verwaltung Mit der Funktion Neu laden kann die Liste der Importe aktualisiert werden. Der Dienstleister markiert in der Verwaltung der Importe die letzte Import-Datei und führt die Funktion Exportieren aus: Abbildung 18: Export auf Basis der letzten Importdatei LIDS 7 Import/Export Seite 14 / 17
Abbildung 19: Parameter Export beim Dienstleister 1.7. Import der Daten in DL Projekt Import von XML-Daten Werden nun die Daten direkt beim Dienstleister weiter bearbeitet und bleibt somit der Master der Daten beim Dienstleister muss dieser vor einer weiteren Erfassung das Paket, welches als Export an das Hauptprojekt geliefert wurde wieder importieren. Über die Funktion Tools/Datenaustausch in XML/Import von XML-Dateien wird die Datei wieder importiert. Abbildung 20: gleichzeitiger Import des Paketes beim Dienstleister LIDS 7 Import/Export Seite 15 / 17
Abbildung 21: gleichzeitiger Import des Paketes beim Dienstleister Somit erhält der Dienstleister in seiner Verwaltung der Importe einen zweiten Eintrag für den Import nach einer Lieferung. Dieser Import muss als Basis für die nächste Datenlieferung verwendet werden. 1.8. Import der Daten in Hauptprojekt Import von XML-Daten Im Hauptprojekt können die Datenlieferungen der Dienstleister wie folgt eingespielt werden. Zunächst loggt sich die Person mit einem LIDS7 Benutzer für den Dienstleister ein. Dies ist notwendig, da alle Daten, die durch den Import geändert werden (Änderungen, neue Elemente) in den Systemattributen updated by und updated when von dem Benutzer erhalten, der den Import durchgeführt hat. Somit können auch später Daten der Dienstleister von den eigen erfassten Daten unterschieden werden. Abbildung 22: Einloggen mit Dienstleister-Benutzer Über die Funktion Tools/Datenaustausch in XML/Import von XML-Dateien kann die Datei nun importiert werden. LIDS 7 Import/Export Seite 16 / 17
Abbildung 23: Import von XML-Dateien im Hauptprojekt Abbildung 24: Parameter zum Import im Hauptprojekt Der Import ist mit Operationen bestätigen in der Datenbank zu bestätigen. In der Liste der Importe über Verwaltung der Importe wird ein Eintrag erzeugt. LIDS 7 Import/Export Seite 17 / 17