Regeln für CSV-Dateien

Um CSV-Dateien effektiv für die Hintergrundsynchronisation zu verwenden, müssen Sie einige Regeln bei der Datei-Struktur und beim Speichervorgang beachten.

Regeln für die Datei-Struktur

CSV-Dateien müssen wie folgt strukturiert sein:

  • Die einzelnen Einträge, die synchronisiert werden sollen, werden jeweils in einer Zeile definiert.

  • Die einzelnen Spalten werden durch ein einheitliches Trennzeichen, z. B. Semikolons, getrennt.

    Hinweis: Für jedes Aeneis-Attribut, das synchronisiert werden soll, muss eine entsprechende Spalte in der CSV-Datei angelegt sein.

    Hinweis: Wenn ein anderen Trennzeichen als ein Semikolon gesetzt wird, muss dieses in der Konfiguration der Web-Service-Synchronisationsinstanz definiert werden.

  • Werden mehrere Werte in einer Zelle festgelegt, werden diese durch das Zeichen | (Pipe-Strich) getrennt.

  • Wenn Anführungszeichen links und rechts von einem definierten Trennzeichen gesetzt sind, wird die Trennung der Zeichenkette, in der das Trennzeichen vorkommt, umgangen.

    Beispiel: In einer CSV-Datei werden Zeichenketten durch Kommata getrennt. Zeichenketten, die zwischen Anführungszeichen stehen, werden dabei nicht getrennt:

    Achtung: Wenn das definierte Trennzeichen ein Semikolon ist, kann die Trennung einer Zeichenkette durch Anführungszeichen nicht umgangen werden.

  • Datumswerte werden im plattformspezifischen Format (z. B. 01.12.2011) angegeben.

Beispiel: Für die Hintergrundsynchronisation von Organisationseinheiten kann z. B. die Syntax ID;Bezeichnung der Organisationseinheit;ID des zugehörigen Mitarbeiters verwendet werden. Die CSV-Datei sieht im Texteditor wie folgt aus:

Regeln für die CSV-Dateibenennung

Bei der Benennung der CSV-Dateien sind folgende Regeln zu beachten:

  • CSV-Dateien müssen die Endung .csv besitzen.

  • Die Dateiendung csv muss kleingeschrieben sein.

  • Liegt die Datei im UTF-8 Zeichensatz vor, muss diese als Orgeinheiten.utf8.csv abgespeichert werden.

Achtung: Wenn die Dateinamen nach der Einrichtung der Synchronisation geändert werden, muss die gesamte Synchronisation neu eingerichtet werden!

Regeln für den Speicherort

Standardmäßig greift Aeneis bei der Synchronisation auf die CSV-Dateien zurück, die im Installationsverzeichnis im Ordner templates hinterlegt sind.

Wenn Aeneis auf einen anderen Speicherort zugreifen soll, müssen Sie dies mit einem entsprechenden Startparameter bestimmen.

Voraussetzung: Der Speicherort muss ein Netzwerk, Laufwerk oder lokaler Ordner sein.

Beispiel: Ein Startparameter für Windows kann so aussehen:

-Daeneis.webserver.ssl.keystore.key-alias=D:\upload

Beispiel: Ein Startparameter für Linux kann so aussehen:

-Daeneis.webserver.ssl.keystore.key-alias=D:\upload