Dateien können entweder im XML- oder im CSV-Format in einen Pool-Container importiert werden.

Zum Importieren einer CSV-Datei müssen im entsprechenden Pool-Container Spalten erstellt werden, die der Struktur der Daten entsprechen (siehe Datenspalten im Pool-Container anlegen​). Dies muss vor dem Importieren der Daten erledigt werden. Bei XML-Dateien können die Struktur (d.h. die Spalten der Tabelle) und die Daten während des Imports hinzugefügt werden.

Diese Struktur kann mithilfe der Benutzeroberfläche von Mapp Engage erstellt werden (siehe Datenspalten im Pool-Container anlegen​).

XML-Datei​

Das nachstehende Beispiel muss an die im Pool-Container erstellte Struktur angepasst werden.

Beispiel:

<relatedData>
    <row key="123456">
        <column name="Productname">shoe</column>
        <column name="Date">11.01.2011</column>
        <column name="Price">10</column>
    </row>
    <row key="123457">
        <column name="Productname">Skirt</column>
        <column name="Date">15.01.2011</column>
        <column name="Price">20</column>
    </row>
</relatedData>
CODE


  • row key: Dieses Element identifiziert einen Datensatz. Alle zu dem Element gehörenden Werte werden in einer Zeile gespeichert. Die darauf folgenden Tags beschreiben die Spalten, das heißt die einzelnen Daten, die zu diesem Datensatz gehören. Der Zeilenschlüssel (row key) muss nicht als Spalte im zugehörigen Pool-Container angelegt werden. Der Zeilenschlüssel kann mit einem Attribut verknüpft werden, um eine Verbindung zwischen einem Attribut und einem Pool-Container zu definieren. Um einen Datensatz zu überprüfen, können Sie im Zeilenschlüssel nach dem Eintrag suchen. Je nach den Einstellungen beim Anlegen des Datensatzes ist der Eintrag im Zeilenschlüssel entweder eindeutig oder nicht eindeutig (Beispiele finden Sie unter Erweiterter Datenpool: Daten importieren​).

  • column name ="<Name>": Dieses Tag markiert eine einzelne Information, die in einem Datensatz gespeichert ist. Alle Tags müssen als Spalten im Datensatz angelegt werden. Der Eintrag für „column name“ muss identisch mit dem angelegten Spaltennamen sein. Der Name darf nur Buchstaben und Zahlen enthalten. Leerzeichen oder Sonderzeichen erzeugen einen Fehler. Je nach Zeichenkodierung der Daten können im Tag verschiedene Zeichensätze genutzt werden. Diese Kodierung muss auch beim Import der Datei in den Pool-Container angegeben werden.
    Für weitere Informationen, siehe Erweiterter Datenpool: Daten importieren​.

XML-Dateien für den Datenimport und Aufbau der Struktur im Container​

Dieses Beispiel enthält das <metadata>-Element, mit dem die Struktur des Pool-Containers angelegt wird. Die Struktur und die Daten können mit einer einzelnen XML-Datei importiert werden.

<relatedData>
    <metadata>  
        <columnDefinition name="Productname" type="String" default="shoe">
            <enum>shoe</enum>
            <enum>skirt</enum>
        </columnDefinition>
        <columnDefinition name="Date" type="date"></columnDefinition>
        <columnDefinition name="Price" type="String"></columnDefinition>
    </metadata>
    <row key="123456">
        <column name="Productname">shoe</column>
        <column name="Date">11.01.2011</column>
        <column name="Price">10</column>
    </row>
    <row key="123457">
        <column name="Productname">Skirt</column>
        <column name="Date">15.01.2011</column>
        <column name="Price">20</column>
    </row>
</relatedData>
CODE


  • <metadata>: Gibt den Bereich zur Definition der Dateistruktur des Datensatzes an.

  • columnDefinition: : Dieses Tag kennzeichnet den Bereich zur Definition der Datenspalte.

  • name: Dieses Element legt den Namen der Spalte fest. Dieser muss dem im Attribut „key“ zur Datenübertragung verwendeten Eintrag entsprechen. Der Name der Datenspalte darf nur Buchstaben und Zahlen enthalten. Leerzeichen oder Sonderzeichen erzeugen einen Fehler.

  • type: Dieses Attribut legt den Datentyp fest:

    • number: In der Spalte können nur Zahlen gespeichert werden.

    • date: Es können nur Daten im Format eines Datums übertragen werden. Folgende Datumsformate sind möglich:
      TT.MM.JJJJ
      JJJJ-MM-TT
      JJJJ-MM-TT hh:mm:ss
      Sie können auch ein beliebiges ISO-Standardformat verwenden, beispielsweise:
      JJJJ-MM-TT'T'HH:mm:ss (z. B. 2012-06-27T10:45:44)
      JJJJ-MM-TT'T'HH:mm (z. B. 2012-06-27T10:45)

    • string: Es können aus Zahlen bestehende Zeichenketten gespeichert werden.

    • boolean: Einträge können nur die Werte „wahr“ oder „falsch“ enthalten oder leer sein.

  • enum: Mit diesem Tag wird eine Enumerierung erstellt (das bedeutet, dass alle möglichen Werte definiert werden). Alle möglichen Werte der Enumerierung werden in dem Tag aufgelistet.

Nachdem die Metadaten definiert wurden, kann in der zu importierende Datensatz angegeben werden.


Datentyp: Zahl​

  • Default-Wert: Eingabefeld für einen Wert, der immer dann eingetragen wird, wenn kein anderer Wert in der Spalte eingegeben wird. Dieses Eingabefeld muss nicht ausgefüllt werden.

  • Enumerierung erzeugen: Diese Selektion erzeugt eine Enumerierung. Nummerierte Spalten erlauben ausschließlich den Import vorab definierter Werte.

  • Wert für Enumerierung einfügen: Dieses Eingabefeld ermöglicht die Eingabe der Werte, die in die nummerierten Spalten eingegeben werden können. Durch Klicken auf die Schaltfläche + wird ein weiteres Eingabefeld geöffnet und der Wert gespeichert.

CSV-Dateien​

Die CSV-Datei muss in der ersten Zeile die Spaltennamen enthalten, die im Pool-Container angelegt wurden. Die erste Spalte enthält immer den Identifikator für den Datensatz. Dieser Identifikator wird nicht im Pool-Container angelegt, wenn die Struktur angelegt wird.

Für weitere Informationen, siehe Erweiterter Datenpool: Daten importieren​.

Beispiel

      Key, Purchase-ID, Article, Price
"123456","123","jacket","179,95"
"123457","124","shirt","99,95"
"123458","125","trousers","119"

Die in der ersten Zeile angezeigten Namen entsprechen den im Pool-Container angelegten Spalten. Das Zeichen zur Trennung der Felder/Spalten kann frei gewählt werden, muss jedoch beim Import der Datei entsprechend angegeben werden.

Es wird zudem empfohlen, doppelte hochgestellte Anführungszeichen (") als Feldbegrenzer zu verwenden, damit in den Datensätzen Sonderzeichen verwendet werden können. Darüber hinaus muss beim Speichern der Datei die korrekte Zeichenkodierung ausgewählt werden, um eine fehlerfreie Darstellung der importierten Daten zu gewährleisten. Diese Zeichenkodierung muss auch beim Import der Datei in den Pool-Container angegeben werden.

Für weitere Informationen, siehe Erweiterter Datenpool: Daten importieren​.