IDU.GeoTools.Net

PuzzleImport / ToPuzzle

• Die Datensätze werden per XML-Austauschformat in ein cardo.Puzzle-Dokument umgewandelt und zum cardo-Server (PuzzleBaseService2-Webdienst) geschickt
• Dazu werden die Quell- und Ziel-Schemata abgerufen und anhand von Namen und Datentyp verglichen

  Damit die automatische Zuordnung funktioniert, müssen die Daten-Strukturen übereinstimmen!

• Ggf. muss vorher eine Aufbereitung der Quell-Daten per Abfrage (Parameter 'query') erfolgen, sodass die Spaltennamen übereinstimmen oder die passenden Spaltennamen per Parameter an das Programm übergeben
• Wenn Dokumente bereits vorhanden sind (Vergleich der UUID), werden die Daten dort eingefügt, bzw. überschrieben
  • Ist das Dokument nicht vorhanden, wird dieses angelegt
• Listen und komplexe, nicht-geschachtelte Entities (Datentyp 'Unterklasse') können jetzt als JSON-formatierte Spalte übergeben werden ( siehe Details)

Achtung: Aktuell werden Nachschlagelisten noch nicht unterstützt!

Programmablauf

1. Auslesen von Namen und Datentypen der Spalten
   1. Datenquelle
      • Spalten-Namen werden aus dem SQL-Statement übernommen, können also per AS beliebig umbenannt werden
      • die Daten-Typen werden aus den Spalten-Definitionen der abgefragten Tabelle ausgelesen
   2. aus Puzzle
      • hier wird die entsprechende DescribeClass-Funktion aufgerufen
2. Vergleich und Auswertung der Spalten (matching)

• siehe Log-Ausgaben (pro Spalte, Umfang der Infos je nach Loglevel)
• der optionale Parameter matchingBehaviorIsStrict entscheidet über Abbruch mit Fehlermeldung oder 'nur' Warnungs-Text
  • ebenfalls ist der Parameter mit dem Wert false bei Beziehungsklassen obligatorisch, da die einzelnen Eigenschaften per JSON übertragen werden und desshalb keine 1:1-Zuordnung der einzelnen Eigenschaften/Felder möglich ist

  Bei komplexen Typen wie den Nachschlageklassen und den Beziehungsklassen erfolgt immer eine Warnung, weil deren Struktur nicht validiert werden kann

3. Ausgabe der Exchange-XML-Dateien in den Ausgabeordner

• die Anzahl der generierten XML-Dateien richtet sich natürlich nach Anzahl und Umfang der Quell-Daten
  • damit auch umfangreiche Datensätze per XML über die Web-Schnittstelle übertragen werden können, lassen sich die Datensätze pro Datei mit dem Parameter xmlRecordsPerFile limieren
• änderbar über den Parameter puzzleOutputFolder

4. Upload der XML-Dateien

• jedes Dokument wird der Webdienst-Funktion ImportExchangeDocument übergeben
• dessen "Feedback" wird ebenfalls im Ausgabeordner abgelegt (für detaillierte Fehler-Analysen)

Hinweise für das Einsortieren der Dokumente in Ordner

1. Verhalten des Tools, wenn..

• beides angegeben wurde, werden diese ohne Überprüfung an Puzzle übergeben (siehe 2.)
• beides nicht angegeben wurde, werden die Dokumente im Root/Stammverzeichnis angelegt
• nur [UUID] angegeben wurde, wird versucht das zugehörige [LABEL] aus Puzzle abzufragen, sonst Fehler
• nur [LABEL] angegeben wurde, wird versucht die zugehörige [UUID] aus Puzzle abzufragen. Alternativ wird eine neue [UUID] generiert

2. Verhalten von Puzzle, wenn..

• [UUID] noch nicht vorhanden, wird der Ordner mit dem Namen in [LABEL] angelegt
• [UUID] bereits vorhanden, wird [LABEL] ignoriert
• [LABEL] nicht vorhanden, kommt ein (XML-Schema-)Fehler zurück

Hinweise für die JSON-Notation um Listen / Unterklassen-Datentypen übergeben zu können

SELECT 
    *,
    NOW()                                   AS DATUM,
    'PuzzleImport'                          AS NUTZER,
    json_build_object('complex_object', 
        json_build_array(
            json_build_object('NAME', column_name, 'TELEFON', json_build_array(column_telefon)),
            json_build_object('NAME', column_name_2, 'TELEFON',  json_build_array(column_telefon_2)),
            json_build_object('NAME', column_name_3, 'TELEFON',  json_build_array(column_telefon_3))
        ))                                  AS LISTE_KOMPLEXER_OBJEKTE

FROM demodaten.test
GROUP BY pk_id;

ToPuzzle from:%SOURCE_ALIAS% cardoSrv:"http://localhost:90" ikxStoreID:0 puzzleCategoryID:"CAT_ID_TEST" puzzleUuidColumn:"uuid" puzzleNameColumn:"name" puzzleGeomColumn:"geom" matchingBehaviorIsStrict:false

<KOMPLEXER_TYP_List>
    <KOMPLEXER_TYP sortHint="0" uuid="_uuid_0">
        <NAME>Frau Mustermann</AP_NAME>
        <TELEFON_List>
            <TELEFON sortHint="0">0815</AP_TELEFON>
            <TELEFON sortHint="0">0816</AP_TELEFON>
        </TELEFON_List>
    </KOMPLEXER_TYP>
    <KOMPLEXER_TYP sortHint="1" uuid="_uuid_1">
        <NAME>Herr Mustermann</AP_NAME>
        <TELEFON_List>
            <TELEFON sortHint="0">0817</AP_TELEFON>
        </TELEFON_List>
    </KOMPLEXER_TYP>
</KOMPLEXER_TYP_List>