Für selektierte Ordner (oder auch die komplette Kategorie) steht die Aktion 'In Gemeindeverzeichnisse einordnen' zur Verfügung. Alle in dem Ordner enthaltenen Dokumente (rekursiv), an denen in der Basisklasse eine Geometrie angegeben wurde, werden dann darauf geprüft, ob sie in einer Gemeinde der Gemeindeebene liegen.

Ist dies der Fall, wird das Dokument in einen nach der Gemeindenamen benannten Ordner direkt unter dem Rootelement verschoben. Ist der entsprechende Gemeindeordner noch nicht vorhanden, dann wird dieser angelegt.

Das Kommandozeilentool IDU.PuzzleImportTool.exe kann mit folgenden Parametern aufgerufen werden: 

• cardoUrl: Basisadresse des cardos, in welches importiert werden soll
  Beispiel: http://cardo.meineDomain.de
   
• startFolder: Basisverzeichnis, in welchem die zu importierenden Bilder liegen. Aus diesem Verzeichnis werden alle Bilder aller Unterverzeichnisse unter Erhaltung ihres Unterpfades importiert.
  Beispiel: d:\temp\schraegluftbilder
  Hinweis: Es wird immer eine Unterordnerstruktur erwartet, Bilder im Basisverzeichnis werden nicht importiert!
• baseFolder: Verzeichnis für die temp. erzeugten Dateien (Standard: d:\temp)
• username: cardo-User unter welchem der Import ausgeführt werden soll
• password: zugehöriges Passwort
  
  Hinweis: falls aktueller Windows-Account verwendet werden soll, können die Parameter username,passwort weggelassen werden.
• category: ID der Kategorie in welche importiert werden soll
  Beispiel: LRAGR_SCHRAEGBILD
   
• op: auszuführende Operation, Möglichkeiten sind
  create - Erstellen der XML-Dateien, welche die zu importierdenden Objekte beschreiben
  import - Import der Daten über die erstellten XML-Dateien
   
• ikxStoreId: die ID des IKX-Stores in welchem die Puzzle-Kategorie registriert wurde
   
• project: Name des aktuellen cardo-Projektes
   
• docsPerChunk: Anzahl der Objekte, welche in einem Import-XML-File zusammengefasst werden. Wenn die Bilder in das XML-File eingebettet werden (siehe embedImageInXml), kann über diesen Parameter die Dateigröße begrenzt werden
   
• embedImageInXml: true/false(Standard) - gibt an, ob die Bilder in das XML-File eingebettet werden sollen (einfacher falls XML-File auf einem anderen Server ausgeführt werden soll) oder per Pfad referenziert werden (resourcenschonender)
   
• deleteImportedBinFiles: true/false(Standard) - erfolgreich importierte Bilder nach dem Import löschen
   
• checkDocExists: true(Standard)/false - importiert das Bild nur, wenn Dokument noch nicht existiert (Achtung: bei vielen Bildern ist diese Prüfung sehr zeitaufwendig!)
   
• baseFolderNodeId: optional PuzzleNodeId eines Basisordners im Puzzle, dies muss ein Ordner direkt unter dem Kategorieknoten sein (falls kein Basisordner angegeben, wird direkt unter den Kategorieknoten importiert)

Beispiel:

Generieung der Importdateien:

IDU.PuzzleImportTool.exe cardoUrl:http://localhost:90 startFolder:D:\temp\LRAGR_SCHRAEGBILD  username:user password:pw category:LRAGR_SCHRAEGBILD op:create ikxStoreId:0 project:DEVELOPERS docsPerChunk:10 embedImageInXml:false DeleteImportedBinFiles:true checkDocExists:true  baseFolderNodeId:1135

Import:

Einfach obiges Statement erneut ausführen mit op:import statt op:create.

Für jedes Bild wird die Puzzle-eigene interne GUID aus einem Hash gebildet, welcher wiederum aus dem Unterpfad und Dateinamen des Bildes im Originalverzeichnis erzeugt wird. Dadurch kann bei einem späteren Importvorgang eine bereits importierte Datei eindeutig erkannt werden, auch wenn das Dokument im Puzzle bereits umbenannt oder in einen anderen Ordner verschoben wurde. Voraussetzung für jeden Folgeimport ist aber, dass die originale Verzeichnisstruktur im Dateisystem beibehalten wird, sonst funktioniert die oben beschriebene Identifizierung nicht mehr.

Der Name der Gemeindeebene (Lxxx) und der Name der Spalte, in welcher der für den Ordner zu verwendende Gemeindename steht, werden über das Management Center an der Kategorie eingetragen.