Zum Hauptinhalt springen

Import nach Datentyp

CSV, XML, XSLT, JSON

CSV

Am weitesten verbreitet ist das CSV (Comma-separated values) Format. Die meisten Shop-Systeme exportieren ihre Daten im CSV-Format. Auch mit Excel lassen sich Dateien im CSV-Format erstellen.

Eine CSV_Datei besteht aus Zeilen, von denen jede einen Datensatz darstellt. Die Werte innerhalb einer Zeile sind durch Kommata (oder andere Trennzeichen) getrennt.

Die Zeilen und Spalten werden von Channel Pilot Pro in Datenfelder umgewandelt. Jede Zeile füllt ein Artikel mit Werten zu jedem Datenfeld. Die Kopfzeile (auch "Header" genannt) gibt dabei die Überschriften an.

Beispiel:

Name,Alter,Stadt
Max,25,Berlin
Lisa,30,Hamburg
Tom,22,München

In diesem Beispiel enthält die erste Zeile die sogenannten "Header", die den Inhalt der Spalten angeben: "Name", "Alter" und "Stadt".

Trennzeichen

Die Werte in der Kopfzeile und Werte der Artikel werden mit dem sogenannten Trennzeichen getrennt. Im Beispiel ist als Trennzeichen ein Komma (,) verwendet worden. Channel Pilot Pro kann mit folgenden Trennzeichen arbeiten:

  • Komma (,)

  • Semikolon (;)

  • Pipe (|)

  • Leerzeichen (/t)

  • Hashtag (#)

  • Doppelpunkt (:)

BEACHTE: Nutze innerhalb einer Datei nur 1 Art Trennzeichen! Andernfalls kann es beim Import zu Fehlern kommen und Du erhältst eine Fehlermeldung = (unclosed_CSV_Escaping).

Beispiel: 

Name,Alter;Stadt
Max,25;Berlin
Lisa,30;Hamburg
Tom,22;München

In diesem Beispiel wurden zwei unterschiedliche Trennzeichen verwendet. Zum einen ein Komma (,) aber auch ein Semikolon (;). Dies führt zu einem Fehler und die Datei kann nicht importiert werden!

Wir empfehlen dringend "Doppelpunkt (:)" NICHT als Trennzeichen zu verwenden. Dieses Trennzeichen kann dazu führen, dass Deine Datei nicht oder nicht korrekt gelesen werden kann.

Beispiel anhand einer URL: https://www. ...

Hier würde Folgendes passieren:

Durch den Doppelpunkt als Trennzeichen würde die URL in zwei Teile aufgespalten werden:
​

Zeile 1: https
Zeile 2: //www....

Feldbegrenzer

Falls Du Trennzeichen, Zeilenumbrüche oder bestimmte Sonderzeichen innerhalb von Datenfeldern verwendest, musst Du Deine Daten mit einem "Feldbegrenzer" umschließen.

  • Anführungszeichen (")

  • Apostroph (')

BEACHTE: Nutzt Du Feldbegrenzer, müssen diese immer "geschlossen" sein. Sprich, sie müssen einen bestimmten Abschnitt innerhalb einer Zeile umschließen. Ist dies nicht der Fall, kann der Feed nicht importiert werden und Du erhältst eine Fehlermeldung = (unclosed_CSV_Quote).

Beispiel: 

Name,Alter,Stadt
Max,25,Berlin"Spandau"
Lisa,30,Hamburg"Harburg"
Tom,22,München"Bogenhausen

In diesem Beispiel wurden die Stadtteile mit einem "Feldbegrenzer" umschlossen. Jedoch wurde vergessen, "Bogenhausen" ebenfalls mit Anführungszeichen (") zu schließen. Dies führt zu einem Fehler und die Datei kann nicht importiert werden!

Max. Anzahl fehlerhafter Zeilen

Dieser Wert bezieht sich auf die maximale Anzahl von fehlerhaften Zeilen, die in einer Datei toleriert werden, bevor ein bestimmter Prozess oder eine Anwendung, die die Datei verarbeitet, einen Fehler auslöst oder die Verarbeitung der Datei abbricht. Eine "fehlerhafte Zeile" ist dabei eine Zeile, die nicht den erwarteten Formatvorgaben entspricht.

Einige häufige Gründe sind:

  1. Ungültige Anzahl von Feldern: Die Zeile hat mehr oder weniger Felder (Spalten) als erwartet.

  2. Ungültiges Dateiformat: Eines oder mehrere der Felder enthalten Daten, die nicht dem erwarteten Format entsprechen (z.B. Text in einem numerischen Feld).

  3. Zeilenumbrüche innerhalb von Feldern: Manchmal können Felder unerwartete Zeilenumbrüche enthalten, die die Struktur der CSV-Datei zerstören.

  4. Unvollständige Daten: Die Zeile ist unvollständig, oder endet abrupt.

Doppelte Artikelnummern

Hast Du doppelte Artikel in Deinem Feed kannst Du hier einstellen, dass diese von Channel Pilot Pro automatisch ausgeschlossen werden. Behalten wird immer der zuerst erkannte doppelte Artikel.

Den Wert kannst Du in Prozent oder als absolute Zahl angeben.

Mindestanzahl an Artikeln

Bestimme, ob eine Mindestanzahl an Artikeln importiert werden muss. Den Wert kannst Du in Prozent oder als absolute Zahl angeben.

Maximale Anzahl fehlender SKUs

Gib die maximale Anzahl für fehlende SKU in Deinem Feed ein. Den Wert kannst Du in Prozent oder als absolute Zahl angeben.

Neue oder fehlende Datenfelder

Wähle die Konfiguration für den Umgang mit neuen oder fehlenden Datenfeldern.

  • Nur neue Datenfelder sind erlaubt.

  • Es sind keine Änderungen erlaubt.

  • Jede Änderung in den Datenfeldern ist erlaubt.

Beachte, dass Du hier die korrekte Einstellung auswählst. Falls es zu Fehlern während eines Imports kommt, findest Du in diesem Artikel mögliche Ursachen und die Fehlerbehebung.

Feed-Typ

  • Produkt-Feed

    • Dieser Feed-Typ enthält Daten für neue oder bestehende Produkte.

  • Daten-Feed

    • Dieser Feed-Typ enthält nur Daten für bereits bestehende Produkte.

  • Lookup-Feed

    • Dieser Feed-Typ enthält Daten, die durch einen passenden Schlüssel vorhandenen Produkten zugeordnet werden können.

Klicke auf "Änderungen speichern".

Kopfzeile vorhanden?

Existiert innerhalb des Dokuments eine Kopfzeile? Und soll diese verwendet werden? Oder soll die Datei ohne Kopfzeile importiert werden? In dem Fall erstellt Channel Pilot Pro eine sogenannte "Dummy-Kopfzeile", in der Du die Spalten benennen kannst.

XML

XML (extensible Mark-up Language) ist ein Format, zur Darstellung hierarchisch strukturierter Daten, in einer Textdatei. XML besteht aus Elementen, Attributen, ihren Wertzuweisungen, und dem Inhalt der Elemente, der aus Text oder aus untergeordneten Elementen bestehen kann.

Zum Import wird ein XML-Knoten (Element) festgelegt, welcher ein Produkt im Import darstellen sollte. Alle Daten ab diesem Knoten werden berücksichtigt, hierarchisch höher gelegene werden ignoriert.

Du kannst Deinen Produktkatalog auch als XML importieren. Channel Pilot Pro liest alle XML-Tags und XML-Attribute aus und erstellt für diese Datenfelder.

Die TAG-Namen müssen für ein Produkt eindeutig sein, um eine reibungslose Zuordnung zu gewährleisten.

So könnte eine ".xml" Datei aussehen:

<?xml version="1.0" encoding="utf-8"?>
<Feed>
<Product>
<Id>45325</Id>
<Name title="Blueberry Shampoo"><![CDATA[Kid's Shampoo]]></Name>
<Description>
<Description1 title="Blueberry flavor"><![CDATA[Kid's Shampoo]]>         </Description1>
<Description2 title="Color"><![CDATA[blue]]>  
</Description2>
</Description>
<BrandId>5354325</BrandId>
<CategoryId>5354325.45325</CategoryId>
<ProductPageUrl><![CDATA[insert_image_url_here.com]]></ProductPageUrl>
<ImageUrl><![CDATA[insert_product_url_here.com]]></ImageUrl>
</Product>
</Feed>

Achte bei der Erstellung einer .xml Datei unbedingt auf die folgenden Punkte:

  • Der Inhalt muss immer von einem <tag></tag> umschlossen werden.

  • Beachte Groß- und Kleinschreibung innerhalb der Tags

  • Verwende nur Buchstaben und Zahlen. Leerzeichen und Sonderzeichen können zu Fehlern führen, da diese möglicherweise als .xml Attribut erkannt werden.

    Möchtest Du Sonderzeichen verwenden, z. B. innerhalb einer Produktbeschreibung, achte auf folgende Formatierung:

    <![CDATA[hier kannst du jetzt einen Text mit Sonderzeichen oder Leerzeichen einfügen]]>

XSLT

XSLT (Extensible Stylesheet Language Transformation) ist eine erweiterbare Formatsprache, die zur Formatierung und Transformation von XML Formaten verwendet wird. XSLT hat die Aufgabe, Elemente einer XML-basierten Sprache in eine andere XML-gerechte Sprache zu transformieren.

Damit können im Import gelieferte XML-Dateien nach Belieben angepasst, gefiltert und neu strukturiert werden, was vor allem für sehr komplexe hierarchische Strukturen sinnvoll ist, um unnötige Datenfelder im Import zu vermeiden und die bereitgestellten Daten so lesbar wie möglich zu halten.

Ein XSLT-Stylesheet enthält Regeln und Vorlagen (Templates), die festlegen, wie bestimmte Elemente eines XML-Dokuments verarbeitet oder dargestellt werden. Dadurch kann man XML-Daten gezielt in ein anderes Format umwandeln oder optisch aufbereiten.

Achte darauf, immer den korrekten "Artikelpfad" auszuwählen.

  1. Wähle den Artikelpfad, sowie die Zeichenkodierung aus.

  2. Aktiviere den Toggle für "XSLT-Transformation".

  3. Füge Dein "XSLT-Stylesheet" ein.

  4. Klicke anschließend auf "XML generieren".

    Jetzt laden wir die ersten 10 Artikel aus der Originaldatei und transformieren diese. So stellen wir sicher, dass Dein Stylesheet funktioniert.

    Dir wird eine Vorschau angezeigt, in der Du das Ergebnis der Transformation für die ersten 10 Artikel Deines Katalogs sehen kannst.

    Das Stylesheet und auch das Beispiel kannst Du beliebig verändern. Das Beispiel dient lediglich zur Prüfung, ob Deine XSLT funktioniert. Beispielsweise wenn Du komplexere Elemente testen möchtest.

    • Klickst Du danach auf "XML generieren" wird Dir eine neue Vorschau, generiert aus dem Beispiel, angezeigt.

  5. Klickst Du anschließend auf "Änderungen anwenden", laden wir die ersten 10 Elemente aus der Originaldatei in die Tabelle. Sie zeigt das Ergebnis der Anwendung Deines XSLT-Stylesheets auf die Originaldatei.

  6. Überprüfe die Daten und wenn alles korrekt ist, klicke auf "Weiter". Fahre fort und wähle im nächsten Fenster den selben Artikelpfad aus.

JSON


In den "Format Einstellungen" kannst Du an dieser Stelle nur die "Zeichenkodierung" ändern.

JSON (JavaScript Object Notation) ist ein kompaktes Datenformat in Textform, indem Informationen wie Objekte, Arrays und sonstige Variablen in lesbarer Form gespeichert werden können. JSON ist Programmiersprachen unabhängig und kann ebenso wie XML hierarchisch strukturierte Daten abbilden.

Eine gelieferte JSON-Datei wird 1 zu 1 importiert, sodass jeder Datenknoten ein Datenfeld anlegt.

Folgende Punkte musst Du beachten, um eine gültige JSON Datei zu erstellen:

  1. Syntax: JSON (JavaScript Object Notation) verwendet eine einfache Syntax. Achte darauf, dass Du geschweifte Klammern {} für Objekte und eckige Klammern [] für Arrays verwendest.

  2. Schlüssel-Wert-Paare: JSON besteht aus Schlüssel-Wert-Paaren. Der Schlüssel muss immer ein String (in Anführungszeichen) sein, gefolgt von einem Doppelpunkt und dem entsprechenden Wert (String, Zahl, Objekt, Array, Boolean oder null).
    ​
    ​Beispiel:

    [
    {
    "name": "Max",
    "alter": 30,
    "verheiratet": false
    }
    ]

  3. Strings: Strings müssen in doppelten Anführungszeichen stehen. Einfache Anführungszeichen sind nicht zulässig.

  4. Kommas: Achte darauf, dass zwischen den Schlüssel-Wert-Paaren ein Komma steht, aber kein Komma nach dem letzten Paar.
    ​

  5. Leerzeichen: JSON ist nicht empfindlich gegenüber Leerzeichen, Du kannst also Zeilenumbrüche und Leerzeichen verwenden, um die Lesbarkeit zu verbessern.
    ​

  6. Validierung: Verwende einen JSON-Validator, um sicherzustellen, dass Deine JSON-Datei korrekt formatiert ist. Es gibt viele Online-Tools, wie https://jsonlint.com/ dafür.
    ​

  7. Dateiendung: Speichere die Datei mit der Endung `.json`, um sie als JSON-Datei zu kennzeichnen.

JSON-Token

Ein JSON Token (JSON Web Token, JWT) ist ein kompakter, URL-sicherer Weg, um Ansprüche (claims) zwischen zwei Parteien zu übertragen. JWTs werden verwendet, um User zu authentifizieren und zu autorisieren. Sie bestehen aus drei Teilen, die durch Punkte getrennt sind.

Verwandte Artikel
Hat dies deine Frage beantwortet?