In/Out & Schema

Der Import/Export von Daten und Datenmodell ist zum Beispiel in folgenden Fällen nötig:

  • Umzug einer auf Ikx basierten Anwendung auf einen anderen cardo-Server 
  • Austausch eines Datenmodells einer Ikx-Anwendung mit einem anderen cardo-Betreiber, der die selbe Anwendung einsetzen will (dann werden typischerweise nur das Datenmodell und gegebenenfalls die Nachschlageklassen-Einträge übertragen)
  • Manipulation des Datenmodells oder der Daten, welche sich leichter über eine XML-Datei als über den Klasseneditor durchführen lässt (Export, Bearbeitung der Xml-Dateien und Import)
  • Aktualisierung des Metadaten-Standardmodells durch IDU (über den Datenmodellimport können inzwischen nötige Anpassungen beim Kunden nachträglich eingespielt werden)

Vorgehensweise:

neu ab Version 3.8.5.
  • Im Reiter 'Klassenstruktur' des Moduls 'InOutAndSchema' gibt es jetzt einen
    Button, um das XML-Dokument direkt in die Zwischenablage zu kopieren.
Einführende Erläuterungen zum Ex- und Import der Metadatenstruktur und der Metadatensätze

Export von Struktur und Daten

Im Modul IN/OUT & Schema können Sie die Metadatenstruktur oder die Datensätze exportieren. Für beide Fälle erhalten Sie eine XML Datei sowie eine XSD mit einer vorhandenen Schemadefinition.

export_metadaten.png

Metadatenimport von Struktur und Datensätzen

Wurde die Metadatenstruktur verändert oder Datensätze ergänzt, können diese mit dem gleichen Modul wieder importiert werden. Die geänderten XML Dateien müssen gespeichert und in cardo aktualisiert werden.

Folgende Grafik veranschaulicht den Vorgang. 

strukturimport.png

Schema und Struktur anzeigen

Schema anzeigen

Nach einem Klick auf den Eintrag links Metadaten für Ebenen und Ordner wird im Reiter XSD-Schema die XSD-Datei des Startknotens (CARDO_DEF_MDDATASET) angezeigt. Das XSD definiert das Schema der Metadatenstruktur.

xsd_schema.png

Struktur anzeigen

Im Reiter Klassenstruktur wird die XML des Startknotens (CARDO_DEF_MDDATASET) angezeigt. Diese kann über einen Button auch direkt in die Zwischenablage kopiert werden.

 

Problem: Für Schema und Klassenstruktur wird statt XML nur ein unformatierter Text angezeigt.

Lösung für Firefox: Das wird meist durch eines der im Firefox aktivierten Plugins verursacht. Um das auszuschließen sollten alle AddOns der Reihe nach ausgeschaltet werden.

Daten und Struktur importieren
Beachten Sie, das nachfolgend der Im- und Export ausschließlich zwischen cardo-Systemen beschrieben wird. Aufgrund des IDU-Standardmodells für Metadaten ist in sonstigen Fällen eine Anpassung der Daten notwendig.

Daten importieren

Im Reiter Daten importieren wählen Sie unter Upload ihre Zieldatei aus. Diese muss eine ZIP-Datei sein mit einer xml und einer XSD-Datei, die den gleichen Namen haben müssen, bspw. class.xml und class.xsd.

upload.png

Namespace ignorieren - Normalerweise wird das zu importierende XML-File darauf hin untersucht, dass es den gleichen Namespace besitzt wie das Zielcardo. Dies stellt erst einmal grundsätzlich sicher, dass die zu importierenden Daten aus dem selben cardo exportiert wurden oder der Namespace explizit für das Zielcardo angepasst wurde.

Sollen Daten importiert werden, die aus einem anderen cardo stammen und daher einen anderen Namespace besitzen, muss die Checkbox 'Namespace ignorieren' explizit gesetzt werden.

Trockenlauf - Sie sollten den Import immer mit aktivierter Checkbox Trockenlauf testen. Dann wird der Import nur simuliert aber noch nicht durchgeführt. Eventuell auftretende Fehler können so erkannt und korrigiert werden. Für den eigentlichen Import müssen Sie dann den Haken aus der Checkbox nehmen und den Import wiederholen

Struktur importieren

Wechseln Sie zum Reiter Struktur importieren. Im Feld Eingabe fügen Sie nun über Einfügen ihre XML-Datei hinzu. (Die XSD ist fest im System definiert und soll nicht angepasst werden). Klicken Sie auf importieren und ihre Datenstruktur wird importiert.

Trockenlauf - Sie sollten den Import immer mit aktivierter Checkbox Trockenlauf testen. Dann wird der Import nur simuliert aber noch nicht durchgeführt. Eventuell auftretende Fehler können so erkannt und korrigiert werden. Für den eigentlichen Import müssen Sie dann den Haken aus der Checkbox nehmen und den Import wiederholen.

Nach erfolgtem Import wird in das Feld Ausgabe gewechselt.

Hinweis: Denken Sie ggf. daran, dass die Rechte nach dem Datenimport für Nachschlageklassen neu gesetzt werden müssen!
Daten und Struktur exportieren

Struktur exportieren

Die Struktur exportieren Sie über den Reiter Klassenstruktur. Kopieren Sie sich die Struktur und editieren Sie diese in einem dafür vorgesehenen Programm. Nach Beendigung kopieren Sie die Struktur erneut und fügen Sie sie wie im Link Struktur importieren beschrieben, in das Feld Eingabe ein.

Hinweis: Kopieren Sie die Struktur über Kontextmenü/Quelltext anzeigen. Übernehmen Sie die Struktur aus diesem Fenster. Ab Version 3.8.4. steht ein Button zum Kopieren in die Zwischenablage zur Verfügung,

Daten exportieren

Wechseln Sie in den Reiter Datensätze für CARDO_DEF_MDDATASET und wählen im nun aktiven mittleren Arbeitsbereich unter Datensätze ihre zu exportierenden Datensätze aus (Doppelklick auf die Datensätze). Anschließend klicken Sie auf den Button Export. Die exportierten Datensätze werden als zip abgespeichert. Darin enthalten ist eine XML- und eine XSD-Datei. Diese können Sie bspw. mit dem Visual Studio Express 2010 (kostenfrei) bearbeiten.

Sie können beim Export der Nachschlagewerte zwischen folgenden Varianten wählen:

  1. Nur in den Datensätzen referenzierte
    Es werden nur die Nachschlagewerte exportiert, welche auch tatsächlich in den ausgewählten Daten verwendet werden.
     
  2. alle der referenzierten Nachschlageklassen
    Es werden alle Werte der verwendeten Nachschlageklassen exportiert.
     
  3. Für den Export von Nachschlagewerten gibt es die Checkbox ALLE Werte ALLER Nachschlageklassen. Ist diese beim Export aktiviert, werden nicht nur die am zu exportierenden Datensatz verwendeten Nachschlagewerte exportiert, sondern die kompletten Werte aller Nachschlageklassen.

ikx_export_nachschlagewerte.png

Über eine weitere Auswahlliste können Sie zudem wählen, welche Nachschlagetabellen vollständig exportiert werden sollen. Nachfolgend sehen Sie als Beispiel die Nachschlagetabellen des Brachflächenkatasters.

ikx_export_nachschlagetabelle.png

Exkurs: Programm zur Bearbeitung der XMLs

Zur Bearbeitung der XML empfehlen wir das Visual Studio 2010 Express (kostenfrei). Mit Hilfe von IntelliSense können einfach Datenfelder und Datensätze hinzugefügt werden (Bitte öffnen Sie die XSD ebenso!). Alle gültigen Tags werden automatisch durch IntelliSence angezeigt. Erkannte Felder werden marktiert und wenn vorhanden, werden die Fehler angezeigt.

visualstudio.png

Hinweis: Ein weiteres Programm zur Bearbeitung von XML ist das XML Notepad (kostenfrei). Das Handling dieses Programmes unterscheidet sich ein wenig vom Visual Studio, zur Ergänzung von Datenfeldern wird aber ebenso IntelliSense genutzt! Beachten Sie, einige Felder benötigen eine UUID. Freie GUID Generatoren stehen im Internet zur Verfügung.