Ziel​

Daten in einen ​Pool-Container​ importieren.

Voraussetzung​

Die Daten, die importiert werden sollen, liegen als CSV- oder XML-Datei vor.

Wenn die Daten in einer CSV-Datei vorliegen, müssen der ​Pool-Container​ und seine Struktur bereits im System existieren.

Hinweis:

Die Spalten (d.h. die Struktur) eines ​Pool-Containers​ müssen bereits vor dem Import von CSV-Dateien erstellt sein. Bei XML-Dateien können die Struktur (d.h. die Spalten der Tabelle) und die Daten während des Imports hinzugefügt werden.

Für weitere Informationen, siehe ​Aufbau von XML- und CSV-Dateien (erweiterter Datenpool)​.

Hintergrundinformation​

Es gibt unterschiedliche Möglichkeiten, Daten in einen ​Pool-Container​ zu importieren. Diese Anleitung beschreibt den manuellen Import von Daten in einen Pool-Container.

Wenn die Quelldaten regelmäßig aktualisiert werden sollen, können Sie eine ​zeitbasierte Automatisierung​ erstellen, die die Daten immer wieder automatisch importiert. Für weitere Informationen, siehe ⇘ ​Erweiterter Datenpool: Daten importieren​.

Eine Anleitung, wie Pool-Container angelegt und aktualisiert werden können, kann via SOAP oder REST mithilfe der ​Customer Engagement Platform API​ versendet werden. Für weitere Informationen siehe https://developers.mapp.com/.

Structure of XML and CSV Files for Related Data​

Files can be imported into a related data set in either XML or CSV format.

To import a CSV file, first create columns in the related data set out of the structure that is used in the data (see ⇘ ​Import Data: Create Columns of Related Data Sets During Import​). These columns must be created before the data is imported. With an XML file, both the structure (such as the columns of the table) and the data can be added during import.

This structure can be created in the user interface of Mapp Engage (see Import Data: Create Columns of Related Data Sets During Import​).

The structure can also be created during data import.

XML File​

This example must be adapted to the structure created in the related data set.

Example:

<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
    This element represents a data record. All values included in the element are saved in a common row. The following tags describe the columns, which contain the individual data that belongs to this data record. The row key does not need be set up as a column in the related data set. The row key can be linked to an attribute to create a connection between an attribute and a related data set. To check a data record, you can search for the entry in the row key. Depending on the settings when the data record was created, the entry is either row key unique or non-unique (for examples, see ).

  • column name ="<Name>"
    This tag marks a single piece of information that is stored in a data record. All tags must be created as a column in the data record. The column name must be identical to the created column name. The name can only contain letters, numbers, and hyphens. Spaces or special characters generate an error. Depending on the character encoding of the data, different character encodings can be used in the tag. This encoding must also be indicated when importing the file into the related data set.
    For more information, see ​Related Data: Import Data​.

XML files for data import and building the structure of the container​

This example includes the <metadata> element which creates the structure of the related data set. The structure and data can be imported in a single XML file.

<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>: shows the area for defining the file structure of the data record.

  • column Definition
    This tag marks the area for defining the data column.

  • name:
    This tag determines the name of the column. The name must correspond to the entry used for the file transfer in the attribute key. The name of the data column can only contain letters, numbers, and hyphens. Spaces or special characters generate an error.

  • type
    This attribute determines the type of data:

    • number
      Only numbers can be saved in the column.

    • date
      Only data in the form of dates can be transferred. The following date formats are possible:
      DD.MM.YYYY
      YYYY-MM-DD
      YYYY-MM-DD HH:mm:ss
      You can also use any ISO standard format, for example:
      YYYY-MM-DD'T'HH:mm:ss (for example 2012-06-27T10:45:44)
      YYYY-MM-DD'T'HH:mm (for example 2012-06-27T10:45)

    • string
      Strings of numbers can be saved.

    • Boolean
      Entries can only have the value true, false, or empty.

  • enum
    This tag creates an enumeration (that is, all possible values are defined). All possible values of the enumeration are listed in the tag.

After the metadata are defined, the data set to be imported can be specified (see Structure of XML and CSV Files (Related Data)​).

Data Type: Number​

  • Default-Value
    Input field for a value that is always entered when no other value is entered in the column. You do not have to fill in this input.

  • Generate enumeration
    This selection creates a numeration. Numbered columns only allow the import of values defined in advance.

  • Add value for enumeration
    This input field allows entry of the values that can be entered in the numbered columns. Click + to open an input field and save the value.

CSV files​

The CSV file must contain the column names that were created in the related data set in the first row. The first column is always the identifier for the data record. This identifier is not created in the related data set when the structure is being built.

For more information, see Related Data: Import Data​.

Example

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


The names that are displayed in the first row correspond to the columns created in the related data set. You can select any character to separate the fields or columns, but this character must be configured appropriately when the file is imported.

Use the field delimiter " to enable the use of special characters in the data records. In addition, the correct character encoding must be selected when saving the file so that the imported file can be displayed correctly. This character encoding must be indicated when importing the file into the related data set.

For more information, see Related Data: Import Data​.

Vorgehen​

  1. Klicken Sie in der ​Hauptnavigation​ auf ​Administration​ > ​Attribut​.
    ⇒ Der Dialog ​Übersicht der Attribute​ wird geöffnet.
  2. Klicken Sie auf das Register ​Erweiterter Datenpool​.
  3. Klicken Sie in der Spalte Aktion neben dem Pool-Container auf  ​Neue Pool-Daten einfügen.
    ⇒ Der Dialog ​Neue Pool-Daten einfügen​ wird geöffnet.
  4. Klicken Sie auf die Schaltfläche ​Durchsuchen​, um eine Datei von Ihrem lokalen Server zu importieren.
  5. Wählen Sie im Feld ​Dateityp​, ob die zu importierende Datei eine XML- oder CSV-Datei ist.
  6. Ist die Datei eine CSV-Datei, definieren Sie im Feld ​Trennzeichen ist​ das Trennzeichen.

  7. Wählen Sie im Listenfeld ​Import-Modus​, wie die Daten in den existierenden Datenpool importiert werden. Folgende Optionen stehen zur Verfügung:

      • Hinzufügen:Der Modus speichert neue Einträge aus der Importdatei in den Pool-Container, ohne dabei existierende Einträge zu verändern.

      • Ersetzen: Der Modus überschreibt alle existierende Einträge im Datensatz mit den Einträgen aus der Importdatei.
      • Aktualisieren: Der Modus Aktualisieren ersetzt existierende Einträge im Datensatz mit den entsprechenden Einträgen der Import-Datei. Es werden nur existierende Einträge, die mit einem Eintrag aus der Import-Datei übereinstimmen, ersetzt. Existierende Einträge, die mit keinem Eintrag aus der Import-Datei übereinstimmen, bleiben unverändert. Diese Option fügt dem Datensatz keine neuen Einträge hinzu.

      • Aktualisieren und Hinzufügen: Der Modus Aktualisieren und Hinzufügen ersetzt existierende Einträge im Datensatz mit den entsprechenden Einträgen der Importdatei und fügt dem Datensatz neue Einträge hinzu. Einträge, die bereits im Datensatz gespeichert sind und mit keinem Eintrag aus der Import-Datei übereinstimmen, bleiben unverändert. Einträge mit neuen Schlüsseln werden dem Datensatz hinzugefügt.
        Ist einer der Modi zum Aktualisieren ausgewählt, wird zusätzlich die Option ​Synchronisationsmodus​ angezeigt.

    Hinweis:

    Die Import-Modi ​Hinzufügen​ und ​Aktualisieren und Hinzufügen​ ersetzen alle existierenden Einträge im Pool-Container mit Einträgen der Importdatei, die übereinstimmende Werte in den Schlüsselspalten haben. Für nicht eindeutige Datensätze bedeutet das, dass der Datensatz nach dem Import von Einträgen für einen bestimmten Wert weniger Zeilen enthalten kann. Sie können bis zu 800 ähnliche Schlüssel haben.

    Beispiel: Ein Datensatz mit dem Namen ​Einkauf​ besitzt fünf Zeilen für einen Wert ​Identifikator​. Die Importdatei beinhaltet nur drei Zeilen für diesen Wert. Die Modi ​Aktualisieren​ und ​Aktualisieren und Hinzufügen​ löschen die fünf existierenden Einträge und speichern nur die drei in der Import-Datei enthaltenen neuen Einträge im Datensatz.

  8. Wenn für den ​Import-Modus​ eine Aktualisierungsoption eingestellt ist, klicken Sie auf die Option ​Synchronisationsmodus​, um eine Feineinstellung des Aktualisierungsmodus vorzunehmen. Folgende Optionen stehen zur Verfügung:

    • Vorhandene Zeilen komplett überschreiben:Diese Option überschreibt alle Werte (Spalten) in einem Datensatz (Zeile) mit dem entsprechenden neuen Eintrag aus der Import-Datei. Dadurch werden Spaltenwerte im Datensatz, die nicht in der Import-Datei enthalten sind, gelöscht.

    • Nur Spalten aus der Datei überschreiben: Diese Option ist nur für eindeutige Datensätze verfügbar. In diesem Fall wird nur der Wert (Spalte) des Datensatzes (d.h. der Zeile) mit dem neuen Eintrag aus der Import-Datei ersetzt. Andere Werte des Datensatzes bleiben unverändert.
  9. Wählen Sie im Listenfeld ​Fehler-Modus​, wie Fehler in der Import-Datei behandelt werden.

    • Wert überspringen: Wird ein Fehler im Datensatz gefunden, so wird nur der Wert, der den Fehler enthält (z.B. die Spalte), nicht importiert. Gibt es andere Werte (Spalten), die importiert werden können, so werden diese importiert.

      Zeile überspringen: Wird ein Fehler im Datensatz gefunden, so wird die gesamte Zeile, die den Fehler enthält (z.B. ein Datensatz), nicht importiert.
  10. Wählen Sie im Listenfeld ​Kodierung​ die Zeichenkodierung der importierten Daten. Die Auswahl stellt sicher, dass Zeichen in den importierten Datensätzen korrekt dargestellt werden.
  11. Klicken Sie auf die Schaltfläche ​Importieren​.
    ⇒ Der Daten-Import beginnt und der Dialog ​Übersicht Erweiterter Datenpool (Dialog)​ wird geöffnet. Eine Statusmeldung mit Informationen über den Import wird angezeigt. Ist der Import abgeschlossen, wird eine Bestätigungsmail gesendet.