Transformatoren

Allgemeine Funktionsweise

Transformatoren ermöglichen die Transformation von oder zu dem normierten XML-Format. Es ist bspw. möglich in eine CSV-Datei zu exportieren, oder aus einer CSV-Datei zu importieren.

Um ein fremdes Datenformat verarbeiten zu können, konfigurieren Sie das jeweilige Im- oder Exportprofil und verknüpfen einen oder mehrere Transformatoren. Dazu bearbeiten Sie das jeweilige Profil und wählen anschließend in der Liste der Kindverknüpfungen Transformatoren.

Welche Transformatoren für den Import stehen zur Verfügung?

Import aus XML (xpath2xml)

Beschreibung des Transformators: File-Type: XML to XML using configured database columns

Dieser Transformator kann genutzt werden, um Daten aus einer XML-Datei in mehrdimensionale Datenstrukturen zu importieren. Zu diesem Zweck ist es notwendig die Quell-Datenstruktur über einen sogenannten XPath zu den Tabellen/Feldern in brandbox zuzuordnen. Dazu bearbeiten Sie das jeweilige Importprofil und wählen anschließend in der Liste der Kindverknüpfungen Datenbankfelder.

Beispieldatei

<?xml version="1.0" encoding="ISO-8859-1"?>
<ZMATMAS05>
    <IDOC BEGIN="1">
        <EDI_DC40 SEGMENT="1">
            <MANDT>100</MANDT>
            <MSGFN>005</MSGFN>
            <MATNR>000000000000100000</MATNR>
         </EDI_DC40>
    </IDOC>
</ZMATMAS05>

Beispiel-Konfiguration

Die nachfolgende Beispiel-Konfiguration erzeugt für jeden Knoten in der XML-Datei einen Artikel, der die SKU aus dem XML-Knoten MATNR enthält.

Feld	Konfiguration
XPath	ZMATMAS05/IDOC/E1MARAM/MATNR
Datenbankfeld	Artikel ~ SKU
Primärschlüssel	ja
Kollation identifizieren	nein

Primärschlüssel

Wird das Datenbankfeld als Primärschlüssel verwendet, werden Datensätze anhand dieser Spalte identifiziert und (falls vorhanden) aktualisiert.

Kollation identifizieren

Wird das Datenbankfeld mit Kollation identifizieren ausgezeichnet, wird eine erweiterte Konfiguration im Import-Profil notwendig. Diese Konfiguration ermöglicht es Daten mehrsprachig zu importieren. Öffnen Sie das Importprofil und pflegen in der Konfiguration bspw. nachfolgende Map. Dabei enthält der Schlüssel der collationMap den Wert aus der XML-Datei, während der Wert das locale (sprache_LAND) enthält.

{
    "collationMap": {
        "D": "de_DE",
        "F": "fr_FR",
        "E": "en_GB"
    }
}

Import aus XML (xslt-php)

Beschreibung des Transformators: PHP XSLT

TBD

Import aus CSV (csv2xml)

Die erste Zeile enthält die Namen der Entity-Felder, alle folgenden Zeilen enthalten die entsprechenden Daten.

"id";"createTime";"changeTime";"presetFlyerNestedHeadline";"presetFlyerNestedText1";"presetFlyerNestedText2";"createTime";"changeTime"
"1";"1575921954";"1575921954";"Headline";"Text 1";"Text 2";"1575921954";"1575921955"