Strukturvorlage im CSV-Format

Es handelt sich hier um "externe" CSV-Vorlagen und nicht die "internen", die bereits vorhanden sind. Siehe dazu Abschnitt Arbeiten mit Vorlagen. Sowohl die Quell- als auch die Zielstruktur eines Mappings können in Form einer UTF8-kodierten CSV-Datei als Strukturvorlage exportiert werden (siehe Option Struktur als CSV exportieren im Quellstruktur-Menü und Zielstruktur-Menü).


Soll eine komplexe Struktur erstellt werden, kann es aber einfacher sein manuell eine solche CSV-Strukturvorlage zu erstellen, anstatt die Struktur direkt in der GUI anzulegen. Die Strukturvorlage muss dabei wie folgt aufgebaut sein.


  • Kommentarzeilen müssen mit einem # beginnen.

  • Das Trennzeichen ist ein Semikolon (;).

  • Leerzeilen leiten einen neuen Knoten ein. Handelt es sich bei der auf die Leerzeile folgenden Zeile ebenfalls um eine Leerzeile oder eine Kommentarzeile, dann wird die Leerzeile ignoriert. Ansonsten sind Leerzeilen zu vermeiden.


Jede Zeile der CSV-Datei enthält maximal neun Spalten.


  • Übergeordneter Knotenname. Wird hier kein Wert oder der Wert root eingetragen, dann wird auf die oberste Ebene verwiesen.

  • Name des aktuellen Feldes bzw. Knotens.

  • Minimum-Vorkommen (Für Feste-Länge-Strukturen nicht von Belang. Da hier jedes Feld vorkommen muss, werden die Werte mit 1 überschrieben).

  • Maximum-Vorkommen (Für Feste-Länge-Strukturen nicht von Belang. Da hier jedes Feld vorkommen muss, werden die Werte mit 1 überschrieben).

  • Beschreibung (in Quotes, siehe Beispiel).

  • Satzartkennungen (in Quotes). In dieser Spalte können Satzartkennungen eingetragen werden. Mehrere Satzartkennungen können durch § getrennt eingetragen werden (siehe Beispiel unten). Für Felder muss keine Satzartkennungen angegeben werden, kann aber z. B. für XML-Strukturen. Die Bedingungen werden folgendermaßen angegeben. Wird keine Bedingung angegeben, wird Beginnt mit verwendet.

    Bedingung

    Kodiert mit

    Beginnt mit

    @@type:startsWith:

    Ist gleich

    @@type:equals:

    Endet mit

    @@type:endsWith:

    Enthält

    @@type:contains

    Regulärer Ausdruck

    @@type:regEx:

    Ist nicht

    @@type:not:

    Beginnt nicht mit

    @@type:startsNotWith:

  • Datentyp. In dieser Spalte sind die Werte Integer, String, Float, Double, Date, Timestamp, BigInteger, BigDecimal und Boolean möglich. Es müssen nur so viele Zeichen verwendet werden, bis der Typ eindeutig zugeordnet werden kann. So steht z. B. int für den Typ Integer.

  • Länge. Dieser Wert ist nur für Feste-Länge-Strukturen Pflicht. Wird hier kein Wert angegeben, wird der Wert 0 für die Länge eines Feldes übernommen.

  • Formatvorlage. Hier kann für Felder vom Typ BigDecimal, Date oder Timestamp eine Formatvorlage angegeben werden. Wird keine angegeben, werden Standardwerte verwendet.


Beschreibt eine Zeile einen Knoten, müssen nur die ersten sechs Spalten definiert sein.

Aus der eingelesenen Datei wird eine Quellstruktur erstellt. Eine bereits vorhandene Quellstruktur wird überschrieben.

Beispiel


Die folgende Abbildung zeigt ein Beispiel für eine Quellstruktur.


images/download/attachments/189459305/487-version-1-modificationdate-1737092814164-api-v2.png


Die CSV-Strukturvorlage sieht folgendermaßen aus.


#
# format description (UTF-8 encoded)
# node name of parent;fieldname;min;max;description;matchcodes;type;length;format
#
 
root;Kopf;0;99999;;@@type:startsWith:K
Kopf;SatzartK;0;99999;;;String;0;
Kopf;Datum;0;99999;;;String;0;
Kopf;BelegNr;0;99999;;;String;0;
Kopf;KundenNr;0;99999;;;String;0;
 
root;PositionsKnoten;0;99999;;@@type:startsWith:P@@type:startsWith:T
 
PositionsKnoten;Position;0;99999;;@@type:startsWith:P
Position;SatzartP;0;99999;;;String;0;
Position;Nummer;0;99999;;;String;0;
Position;ArtikelNr;0;99999;;;String;0;
Position;Menge;0;99999;;;String;0;
 
PositionsKnoten;Positionstext;0;99999;;@@type:endsWith:T
Positionstext;SatzartT;0;99999;;;String;0;
Positionstext;Text;0;99999;;;String;0;


Will man manuell eine CSV-Strukturvorlage erzeugen, empfiehlt es sich zuvor eine vorhandene Struktur zu exportieren und Details in dieser Datei zu studieren.

Anmerkung zur Kodierung der CSV-Strukturvorlage: Auch wenn eine UTF8-Kodierungen verwendet werden kann, machen z. B. Umlaute in Knoten- und Feldnamen keinen Sinn, da diese dort nicht erlaubt sind. Beim Import würde z. B. ein ö automatisch in ein oe umgewandelt werden. Für Satzartkennungen und die Beschreibung sind Umlaute erlaubt.

Import


Eine Vorlage, wie sie oben beschrieben ist, können Sie im Bereich Struktur-Import importieren.