Standardformate nutzen

Mit den Standardformaten des Katalogs exportierst du Daten aus deinem PlentyONE System. Du kannst Daten als CSV-, JSON, TXT- oder XML-Datei exportieren. Für den Export von Daten stehen dir verschiedene Standardformate zur Verfügung. Bisher kannst du noch nicht alle Arten von Daten über Kataloge exportieren. Bis Standardformate für alle Arten von Daten verfügbar sind, kannst du weiterhin den Formatdesigner nutzen.

Folgende Standardformate sind momentan verfügbar:

1. Katalogmenü für Standardformate kennenlernen

Wenn du das Menü Daten » Kataloge öffnest, siehst du als erstes die Katalogübersicht. Diese Katalogübersicht kannst du hier kennenlernen.

Das Katalogmenü für Standardformate siehst du, wenn du einen Katalog mit Standardformat öffnest.

Das Katalogmenü sieht für alle Standardformate gleich aus:

menüaufbau standardformat

Tipp: Dein Katalog sieht trotzdem anders aus? Dann hast du wahrscheinlich ein Marktplatz-Format geöffnet. Damit exportierst du Artikeldaten zu Marktplätzen und Preisportalen. Wie du mit Marktplatz-Formaten arbeitest, erfährst du stattdessen hier.

Wenn du einen Katalog öffnest, wird standardmäßig die Ansicht Datenquellen angezeigt. Über die Navigation wechselst du zu anderen Ansichten des Katalogs.

catalogue default navigation

Katalog-Übersicht

Wechsele zurück zur Katalog-Übersicht, also zu der Liste der Kataloge, die in deinem System gespeichert sind.

Liste geöffneter Kataloge

In der Navigation werden alle Kataloge gelistet, die du in deiner aktuellen Sitzung geöffnet hast. So kannst du schnell zwischen den Katalogen wechseln, die du aktuell bearbeitest.

Tipp: Du kannst einen Katalog aus der Navigation entfernen, indem du mit dem Mauszeiger über seinen Namen fährst und auf das X klickst, das erscheint.

Einstellungen

In diesem Menü findest du alle Einstellungen zu dem jeweiligen Katalog. Die Einstellungen setzen sich aus vier Bereichen zusammen:

  • Grundeinstellungen = Name und Formattyp des Katalogs. Diese Daten gibst du beim Erstellen des Katalogs an.

  • Formateinstellungen = Einstellungen zum Aufbau der Exportdatei.

  • Exporteinstellungen = Einstellungen für den automatischen Export.

  • Download-Einstellungen = Einstellungen für die URL, über die die Exportdatei aufgerufen werden kann.

Diese Bereiche werden in dieser Ansicht ebenfalls in der Navigationsleiste eingeblendet, müssen aber nicht einzeln aufgerufen werden.

Datenquellen

In diesem Menü wählst du die Datenquellen, die du exportieren möchtest. Es wird beim Öffnen des Katalogs zuerst angezeigt.

filter_alt Filter

Setze Filter, um nur bestimmte Datensätze zu exportieren.
Hinweis: Filter sind noch nicht für alle Kataloge verfügbar.

Tipp: In der Navigation kannst du jederzeit sehen, wie viele Filter du für den Katalog aktiviert hast. Template-Filter, also Filter, die automatisch aktiviert sind, werden nicht mitgezählt.

filters number of filters

Eigene Datenquellen

Eigene Datenquellen sind für die meisten Exporte noch nicht verfügbar.

In der Symbolleiste kannst du für den Katalog relevante Aktionen ausführen.

catalogue default toolbar

save Speichern

Speichert die Einstellungen des Katalogs.

preview Vorschau

Erstellt eine Vorschau der Exportdaten. Die Vorschau enthält die ersten 5 Datenzeilen der Exportdatei.

Wichtig: Die Vorschaufunktion ist noch nicht für alle Formate verfügbar.

Asynchroner Download

Startet einen manuellen Download der Katalogdaten.

play_circle Live-Download

Lädt die Katalogdaten als Datei herunter. Der Download wird sofort gestartet. Die Datei wird automatisch auf deinem Rechner gespeichert, wenn der Export abgeschlossen ist.

playlist_play Status

Öffnet das Menü Daten » Katalogexportstatus und filtert nach diesem Katalog. Informationen zum Status des Katalogs werden angezeigt.

more_vert Mehr

Blendet weitere Aktionen ein.

history

Stellt eine ältere Version des Katalogs wieder her. Die letzten 100 Versionen des Katalogs sind verfügbar.

Wie stellt man eine andere Katalogversion wieder her?

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Navigiere in die Zeile des Katalogs.

  3. Möglichkeit 1: In der Katalogübersicht

    1. Öffne die weiteren Aktionen (more_vert).

    2. Klicke auf Katalog-Version wiederherstellen (history).

  4. Möglichkeit 2: Im Katalogmenü

    1. Öffne den Katalog.

    2. Klicke in der Symbolleiste auf die weiteren Aktionen ().

    3. Klicke auf Katalog-Version wiederherstellen (history).

  5. Wähle im angezeigten Fenster die Version, die du wiederherstellen möchtest.
    Tipp: Die letzten 100 Versionen des Katalogs sind verfügbar.

  6. Klicke auf Wiederherstellen.
    → Die Version des Katalogs wird wiederhergestellt und in der Übersicht angezeigt.

delete

Löscht den Katalog.

Wie löscht man einen Katalog?

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Navigiere in die Zeile des Katalogs, den du löschen möchtest.

  3. Klicke auf die weiteren Aktionen (more_vert).

  4. Klicke auf Löschen (delete).
    → Eine Sicherheitsabfrage wird eingeblendet.

  5. Bestätige den Löschvorgang.
    → Der Katalog wird gelöscht.
    Oder: Öffne einen Katalog.

  6. Klicke oben auf die weiteren Aktionen (more_vert).

  7. Klicke auf Katalog löschen (delete).
    → Eine Sicherheitsabfrage wird eingeblendet.

  8. Bestätige den Löschvorgang.
    → Der Katalog wird gelöscht.

Rechts neben der Navigation sind alle PlentyONE Datenquellen in Gruppen sortiert aufgelistet, die du exportieren kannst. Klicke auf das Plus rechts neben einer Datenquelle, um sie zum Export hinzuzufügen.

catalogue default data fields

Tipps:

  • Über das Feld Datenquelle suchen kannst du schnell Datenquellen finden und hinzufügen.

  • Zusätzlich zu den Datenquellen kannst du auch eigene Werte zum Export hinzufügen. Für jeden Datensatz wird dann derselbe Wert exportiert.

  • Nutze die Option Formel, um numerische Daten während des Exports zu aktualisieren. So kannst du zum Beispiel alle exportierten Artikelpreise schon beim Export bearbeiten.

Rechts werden die Datenquellen angezeigt, die du zum Export hinzugefügt hast. Diese Datenquellen werden also in deiner Exportdatei enthalten sein. Solange du noch keine Felder gewählt hast, steht hier "Es wurden keine Datenquellen ausgewählt". Im Screenshot wurden schon ein paar Felder gewählt.

catalogue default added fields

Tipps:

  • Du kannst die Datenquellen per Drag-and-drop verschieben, um die Reihenfolge der Daten im Export anzupassen.

  • Du kannst den Export key anpassen. Die "Export Keys" sind die Namen der Spaltenüberschriften, die in deiner Exportdatei erscheinen werden. Jeder "Export Key" muss eindeutig sein.

  • Du kannst Ausweich-Datenquellen hinzufügen. Wenn die Datenquelle leer oder ungültig ist, wird die erste Ausweich-Datenquelle geprüft und stattdessen dieser Wert exportiert.

2. Katalog erstellen

Ein Katalog mit einem Standardformat ist relativ leicht erstellt. Gehe wie folgt vor:

Katalog erstellen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Klicke auf Katalog erstellen (add).
    → Das Katalog erstellen-Menü wird geöffnet.

  3. Nimm die Einstellungen vor. Beachte dazu die Erläuterungen in Tabelle 1.

  4. Speichere (save) die Einstellungen.
    → Der Katalog wird erstellt.
    → Der Tab Einstellungen (settings) wird geöffnet.

Tabelle 1. Katalog erstellen
Einstellung Erläuterung

Name
(Pflichtfeld)

Gib einen Namen für den Katalog ein.

Marktplatz
(Pflichtfeld)

Wähle die Option Standardformat.

Export-Typ
(Pflichtfeld)

Wähle einen Format-Typ aus der Dropdown-Liste. Mit dem Format-Typ legst du fest, welche Arten von Daten exportiert werden.

Kategorie
(Pflichtfeld)

Wähle ein Format aus der Dropdown-Liste. Falls für einen Export-Typ mehrere Formate zur Auswahl stehen, werden diese im einzelnen auf der entsprechenden Handbuchseite für den Export-Typ erklärt.

3. Katalogeinstellungen vornehmen

Nachdem du einen Katalog erstellt hast, kannst du ihn an deine Anforderungen anpassen, bevor du ihn für den Datenexport verwendest. In den folgenden Kapiteln wird dies Schritt für Schritt erklärt:

Bei bestimmten Standardformaten sind im Einstellungen-Menü zusätzliche Anpassungsoptionen verfügbar. Diese Optionen werden auf den jeweiligen Handbuchseiten der verschiedenen Standardformate erklärt.

3.1. Formateinstellungen vornehmen

Mit den Formateinstellungen legst du fest, in welches Dateiformat die Daten exportiert werden und wie die Exportdatei aufgebaut sein soll.

Einstellungen vornehmen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Klicke auf den Katalog.
    → Der Katalog wird geöffnet.

  3. Klicke in der Navigation links auf den Tab Einstellungen (settings).
    → Die Einstellungsmöglichkeiten werden angezeigt.

  4. Navigiere zum Bereich Formateinstellungen.

  5. Nimm die Einstellungen vor. Beachte dazu die Erläuterungen in Tabelle 2.

  6. Speichere (save) die Einstellungen.

Tabelle 2. Formateinstellungen vornehmen
Einstellung Erläuterung

Dateiname

Gib einen Dateinamen ein. Mit diesem Namen wird die exportierte Datei gespeichert.
Tipp: Die Dateiendung wird beim Export automatisch ergänzt. Gib deshalb den Dateinamen ohne eine Dateiendung ein. Dateiendungen sind zum Beispiel .csv oder .txt.

Tipp: Du kannst auch Platzhalter im Dateinamen verwenden. Beim Export werden anstelle der Platzhalter die entsprechenden Daten aus deinem System in den Dateinamen eingefügt.

Liste der verfügbaren Platzhalter

Die folgenden Platzhalter sind verfügbar:

$$name

Der Katalogname.

$type

Der Export-Typ.

$format

Der Format-Typ.

$timestamp

Der Zeitstempel des Exports.

$datetime

Das Datum und die Uhrzeit, zu denen der Export ausgeführt wurde.

$year

Das Jahr, in dem der Export ausgeführt wurde.

$month

Der Monat, in dem der Export ausgeführt wurde.

$day

Der Tag, an dem der Export ausgeführt wurde.

$hour

Die Stunde, in der der Export ausgeführt wurde.

$minute

Die Minute, in der der Export ausgeführt wurde.

$second

Die Sekunde, in der der Export ausgeführt wurde.

$lastChangeTimestamp

Der Zeitstempel der letzten Änderung am Katalog.

$lastChangeDatetime

Das Datum und die Uhrzeit der letzten Änderung des Katalogs.

$lastChangeYear

Das Jahr der letzten Änderung des Katalogs.

$lastChangeMonth

Der Monat der letzten Änderung des Katalogs.

$lastChangeDay

Der Tag der letzten Änderung des Katalogs.

$lastChangeHour

Die Stunde der letzten Änderung des Katalogs.

$lastChangeMinute

Die Minute der letzten Änderung des Katalogs.

$lastChangeSecond

Die Sekunde der letzten Änderung des Katalogs.

Beispiele für die Verwendung von Platzhaltern:

Eingabe Ergebnis

artikel-export_$year_$month_$day

  • artikel-export_2022_01_02.csv

$type_$format_$year_$month_$day

  • bestellung_bestellung_2022_01_02.csv

  • check24_offer_2020_10_25.csv

Format

In welchem Dateiformat sollen die Daten exportiert werden?

Mögliche Werte:

  • CSV

  • CSV - Array zu JSON

  • JSON

  • TXT

  • XML

Feldtrennzeichen

Welches Feldtrennzeichen soll verwendet werden, um die einzelnen Datensätze voneinander zu trennen?

Mögliche Werte:

  • Komma = ,

  • Semikolon = ;

  • Pipe = |

  • Tabulator = ␉

Textbegrenzer

Welcher Textbegrenzer soll verwendet werden, um die einzelnen Datensätze voneinander zu trennen?

Mögliche Werte:

  • "

  • '

Sonderzeichen verschlüsseln ()

Wenn du diese Option aktiviert hast, werden Unicode-Zeichen (z.B. Umlaute: ä, ö, ü) verschlüsselt exportiert.
Hinweis: Diese Option ist nur für die Formate JSON und CSV - Array zu JSON verfügbar.

Zeilenumbruch

Wie sollen Zeilenumbrüche in den Dateien abgebildet werden?

Mögliche Werte:

  • Wagenrücklauf

  • Zeilenvorschub

  • Wagenrücklauf und Zeilenvorschub

Kopfzeile enthalten

Aktiviere die Option, wenn die Exportdatei eine Kopfzeile enthalten soll. Als Überschrift werden die Export Keys verwendet.

Dezimaltrennzeichen

Welches Zeichen soll verwendet werden, um Dezimalwerte darzustellen?

Mögliche Werte:

  • Komma = Standard im deutschsprachigen Raum
    Beispiel: 20,00 Euro

  • Punkt = Standard im englischsprachigen Raum
    Beispiel: 20.00 Euro

3.2. Exporteinstellungen vornehmen

Mit den Exporteinstellungen legst du fest, wo deine Exportdatei gespeichert wird.

Exporteinstellungen vornehmen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Klicke auf den Katalog, für den du die Exporteinstellungen vornehmen möchtest.
    → Der Katalog wird geöffnet.

  3. Klicke in der Navigation links auf den Tab Einstellungen (settings).
    → Die Einstellungsmöglichkeiten werden angezeigt.

  4. Navigiere zum Bereich Exporteinstellungen.

  5. Nimm die Einstellungen vor. Beachte dazu die Erläuterungen in Tabelle 3.

  6. Speichere (save) die Einstellungen.

Tabelle 3. Exporteinstellungen vornehmen
Einstellung Erläuterung

Limit

Wie viele Datensätze sollen pro Datei maximal exportiert werden?

Überspringe leere Dateien

Wenn diese Schaltfläche aktiviert ist, werden leere Dateien nicht zum FTP-Server exportiert.

Bereitstellung

Wähle aus, über welche Methode die Export-Datei bereitgestellt werden soll.
Wichtig: Mit dieser Einstellung werden keine Daten an Marktplätze exportiert.

Keine

Der Export wird nicht gespeichert.

FTP

Der Export wird auf einem FTP-Server gespeichert.

FTPS

Der Export wird auf einem FTPS-Server gespeichert.

SFTP

Der Export wird auf einem SFTP-Server gespeichert.

SFTP erweitert

Der Export wird auf einem SFTP-Server gespeichert.
Diese Option verwendet eine alternative Implementierung des SFTP-Protokolls. Verwende sie nur, wenn die reguläre SFTP-Option mit deinem SFTP-Server nicht einwandfrei funktioniert.

Server
(bei FTP, FTPS, SFTP, SFTP erweitert)

Gib den Server ein, auf dem der Export gespeichert werden soll.
Hinweis: Gib kein Protokoll-Präfix an. Protokoll-Präfixe sind zum Beispiel ftp:// und ftps://.

Port
(bei FTP, FTPS, SFTP, SFTP erweitert)

Gib einen Port ein oder verwende die Standardeinstellung.

Empfohlene Port-Einstellungen:

  • Für FTP und FTPS = Port 21

  • Für SFTP = Port 22

Benutzername
(bei FTP, FTPS, SFTP, SFTP erweitert)

Gib den Benutzernamen für den Server ein.

Passwort
(bei FTP, FTPS, SFTP, SFTP erweitert)

Gib das Passwort für den Server ein.

Pfad
(bei FTP, FTPS, SFTP, SFTP erweitert)

Gib den Pfad zu dem Speicherort ein, an dem der Export gespeichert werden soll.
Hinweis: Wenn du SFTP verwendest, gib den vollständigen Pfad an.

Verbindung testen
(bei FTP, FTPS, SFTP, SFTP erweitert)

Testet die Servereinstellungen, die du eingegeben hast:

  • Kann eine Verbindung zu dem Server hergestellt werden?

  • Kann eine Exportdatei an dem Speicherort gespeichert werden?

Tipp: Am Speicherort wird eine Testdatei gespeichert. Diese Testdatei heißt plentymarkets_ConnectionTestFile.txt.

Übertragung

Wähle, in welchem Intervall der Export automatisch ausgeführt werden soll. Folgende Optionen stehen dir hier zur Verfügung:

Nie

Der Export wird nie automatisch ausgeführt.

Alle 20 Minuten;
Einmal pro Stunde;
Einmal pro Tag

Der Export wird im gewählten Intervall automatisch ausgeführt.

Zeitplan: Uhrzeiten

Die Option Zeitplan: Uhrzeiten wird eingeblendet.

Zeitplan: Uhrzeiten
(bei Option Zeitplan)

Klicke in das Feld. Wähle in der eingeblendeten Dropdown-Liste einen oder mehrere Uhrzeiten. Exporte werden zu diesen Zeiten automatisch ausgeführt.

Wochentage
(bei Übertragung ≠ Nie)

Standardmäßig sind alle Wochentage aktiviert. Um an bestimmten Wochentagen keinen Export auszuführen:

  1. Klicke in das Feld Wochentage.
    → Eine Dropdown-Liste mit den Wochentagen wird angezeigt.

  2. Deaktiviere die Wochentage, an denen kein Export ausgeführt werden soll.

Tipp: Die Einstellung Wochentage wird erst angezeigt, wenn du für die Einstellung Übertragung ein Intervall bzw. einen Zeitplan wählst.

3.3. Download-Einstellungen vornehmen

In den Download-Einstellungen des Katalogs kannst du eine URL generieren. Über diese URL kannst du direkt auf die Exportdatei zugreifen.

  • Über den Admin-Link kannst du nur auf die exportierte Datei zugegriffen, wenn du gerade als Admin im PlentyONE System eingeloggt bist.

  • Bei öffentlichen Links kannst du die Datei durch eine Version und/oder einen Token vor unbefugtem Zugriff schützen.

Der Katalog muss aktiv sein, damit eine Exportdatei erstellt wird. Die Exportdatei ist erst nach dem ersten Export unter der URL erreichbar.

Download-Einstellungen vornehmen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Wähle den Katalog.
    → Der Katalog wird geöffnet.

  3. Klicke in der Navigation links auf Einstellungen (settings).

  4. Navigiere zum Bereich Download-Einstellungen.

  5. Nimm die Einstellungen vor. Beachte die Erläuterungen in Tabelle 4.

  6. Speichere die Einstellungen.
    → Die URL für den Download der Datei wird angezeigt. Über diese URL ist die Exportdatei nach dem ersten Export verfügbar.
    → Im Menü wird immer die URL der zuletzt exportierten Datei angezeigt.

  7. Klicke auf die URL oder kopiere die URL (content_copy), um sie zu verwenden.

Tabelle 4. URL generieren
Einstellung Erläuterung

Shop-URL

Wähle einen Mandanten. Der Domain-Name dieses Mandanten wird für die URL verwendet.

Benachrichtigungen erhalten

Aktiviere diese Option, um rechts oben im System eine Benachrichtigung anzuzeigen, wenn der Export abgeschlossen ist.

Optionen für Admin-Link

Admin-Link

Für jede Datei wird automatisch ein Admin-Link erstellt. Über diesen Admin-Link ist die exportierte Datei nur erreichbar, wenn du gerade als Admin im PlentyONE System eingeloggt bist.

Tipp: Klicke auf das Symbol rechts (content_copy), um die URL in deine Zwischenablage zu kopieren.

Version verwenden

Wenn diese Option aktiviert ist, wird bei jeder Änderung der Einstellungen bzw. Zuordnungen dieses Katalogs eine neuer Admin-Link generiert. Wenn die vorherige Katalog-Konfiguration bereits für einen Export verwendet wurde, ist die entsprechende Export-Datei bis zu 15 Tage nach der Änderung weiterhin unter dem vorherigen Link verfügbar.
Hinweis: Aktiviere diese Option nicht, wenn die aktuellsten Exportdaten immer über denselben Admin-Link abrufbar sein sollen.

Optionen für öffentlichen Link

Optionen aktivieren

Wenn diese Option aktiviert ist, wird ein öffentlicher Link zur Export-Datei generiert. Nach dem ersten Export ist die Datei über diesen Link für alle verfügbar, die den Link kennen.
Die weiteren Optionen in diesem Abschnitt haben keinen Effekt, wenn diese Option deaktiviert ist.

Tipp: Klicke in der Zeile Öffentlicher Link auf das Symbol ganz rechts (content_copy), um die URL in deine Zwischenablage zu kopieren.

Version verwenden

Wenn diese Option aktiviert ist, wird bei jeder Änderung der Einstellungen bzw. Zuordnungen dieses Katalogs ein neuer öffentlicher Link generiert. Wenn die vorherige Katalog-Konfiguration bereits für einen Export verwendet wurde, ist die entsprechende Export-Datei bis zu 15 Tage nach der Änderung weiterhin unter dem vorherigen Link verfügbar.
Hinweis: Aktiviere diese Option nicht, wenn die aktuellsten Exportdaten immer über denselben öffentlichen Link abrufbar sein sollen.

Token verwenden

Wenn diese Option aktiviert ist, ist die Datei nur abrufbar, wenn die verwendete URL auch den Token enthält, der im Feld Sicherheits-Token generieren einsehbar ist.

Sicherheits-Token generieren

Klicke auf Neues Token generieren (), um einen neuen Token zu generieren.

Tipp: Der Token wird als Bestandteil der URL zum öffentlichen Link hinzugefügt. Wenn du die URL kopierst, kopierst du also gleichzeitig den Token. Wenn du einen neuen Token generierst, ändert sich auch die URL.

Öffentlicher Link

Zeigt den öffentlichen Link an. Ab dem ersten Export ist die Datei über diesen Link für alle verfügbar, die den Link kennen.

Tipp: Klicke in der Zeile Öffentlicher Link auf das Kopieren-Symbol (content_copy), um die URL in deine Zwischenablage zu kopieren.

4. Daten für Export zusammenstellen

Lege nun fest, welche PlentyONE Daten mit diesem Katalog exportiert werden sollen.

Die Informationen in diesem Kapitel sind so aufgebaut:

4.1. Datenquellen zu Export hinzufügen

Nun entscheidest du, welche PlentyONE Datenquellen mit dem Katalog exportiert werden sollen. Dazu fügst du die Datenquellen wie unten beschrieben zum Katalog hinzu.

Datenquelle zum Katalog hinzufügen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Klicke auf den Katalog.
    → Die Ansicht Datenquellen () des Katalogs wird geöffnet.
    → Die verfügbaren PlentyONE Datenquellen werden in Gruppen angezeigt. Außerdem werden die Optionen edit Eigener Wert und calculate Formel angezeigt.

  3. Klappe eine Datenquellen-Gruppe auf, um die Datenquellen dieser Gruppe anzuzeigen.

  4. Klicke neben der Datenquelle, die du exportieren möchtest, auf das Plus (+).
    Tipp: Gib alternativ den Namen der Datenquelle in das Suchfeld ein. Wähle die Datenquelle aus den Suchergebnissen.
    → Die Datenquelle wird zum Export hinzugefügt.

  5. Prüfe, ob der Export Key deine Anforderungen erfüllt.
    Was ist ein Export Key und wie muss er aufgebaut sein?
    Der Export Key ist der Name der Spaltenüberschrift, der in deiner Exportdatei erscheinen wird.

    • Jeder Export Key darf in diesem Katalog nur einmal vorkommen.
      Wichtig: Wenn mehrere Datenquellen denselben Export Key haben, wird nur eine der Datenquellen exportiert.

    • Export Keys dürfen keine Leerzeichen enthalten.

    • Wenn der Export Key einen Punkt enthält, werden die Daten als Baumstruktur exportiert. In den meisten Anwendungsfällen werden die Daten dann nicht wie erwartet exportiert. Wir empfehlen dir deshalb, in Export Keys keine Punkte zu verwenden.

  6. Füge alle Datenquellen hinzu, die du exportieren möchtest.

  7. Speichere (save) die Einstellungen.
    → Die Datenquellen werden mit diesem Katalog exportiert.

Es stehen auch einige komplexere Exportmethoden zur Verfügung, die in den folgenden ausklappbaren Boxen erklärt werden:

Eine andere Datenquelle exportieren, wenn die erste Datenquelle leer ist (Ausweich-Datenquellen hinzufügen)

Mit Ausweich-Datenquellen legst du fest:

  • Ich möchte, dass die erste PlentyONE Datenquelle exportiert wird.

  • Wenn diese Datenquelle für einen Datensatz leer oder ungültig ist, wird die erste Ausweich-Datenquelle geprüft und stattdessen dieser Wert exportiert.

  • Wenn auch die erste Ausweich-Datenquelle leer oder ungültig ist, werden etwaige weitere Datenquellen in Folge geprüft und der erste Wert eingefügt, der gefunden wird.

Ausweich-Datenquelle hinzufügen:

  • Ausgangssituation:
    Du hast eine Datenquelle zum Export hinzugefügt. Für diese Datenquelle möchtest du eine Alternative angeben für den Fall, dass die Datenquelle für einen Datensatz leer oder ungültig ist.

    1. Klicke unterhalb der Datenquelle auf + Ausweich-Datenquelle hinzufügen.
      → Der Bearbeitungsmodus wird geöffnet.

    2. Klicke rechts auf die gewünschte Gruppe, um die PlentyONE Datenquellen auszuklappen.
      → Die PlentyONE Datenquellen werden angezeigt.

    3. Klicke neben der gewünschten PlentyONE Datenquelle auf das Plus (+).
      → Die PlentyONE Datenquelle wird als Ausweich-Datenquelle in das Feld rechts eingefügt.
      → Die Ausweich-Datenquelle wird exportiert, wenn die erste Datenquelle nicht vorhanden oder leer ist.

Beachte die folgende Logik für Ausweich-Datenquellen:

  • Es wird für jeden Datensatz nur ein Wert exportiert, auch wenn du mehrere Ausweich-Datenquellen angibst.

  • Für jeden Datensatz werden die Datenquellen in der Reihenfolge geprüft, in der sie zugeordnet wurden. Wenn also die erste Datenquelle keinen Wert liefert, wird zuerst die erste Ausweich-Datenquelle geprüft, dann die zweite etc.

  • Tipp: Du kannst auch einen eigenen Wert als Ausweich-Datenquelle hinzufügen.

Für jeden Datensatz denselben Wert exportieren (Eigener Wert)

Mit der Datenquelle Eigener Wert legst du fest:

  • Für eine Spalte deiner Exportdatei wird für alle Datensätze des Katalogs derselbe Wert exportiert.

Eigenen Wert exportieren:

  1. Klicke in der Liste der Datenquellen auf Eigener Wert.
    → Die Datenquelle Eigener Wert wird zum Export hinzugefügt.

  2. Prüfe den Export Key. Eigene Werte erhalten immer den Export Key own-value. Gerade wenn du mehrere eigene Werte exportieren willst, solltest du deshalb den Export Key anpassen.
    Wichtig: Wenn mehrere Datenquellen denselben Export Key haben, wird nur eine Datenquelle exportiert.

  3. Gib einen Wert in das Eingabefeld Wert ein.
    → Dieser Wert wird für alle Datensätze exportiert.

Mehrere Datenquellen miteinander kombinieren

Wenn du Datenquellen kombinierst, legst du fest:

  • Die Datenquellen sollen beim Export kombiniert werden.

  • Die Werte der Datenquellen werden in dieselbe Spalte der Exportdatei eingefügt.

  • Welches Zeichen zwischen den Werten eingefügt wird, legst du mit der Option Trennzeichen fest.

Mehrere Datenquellen kombinieren:

  • Ausgangssituation:
    Du hast schon eine Datenquelle zum Export hinzugefügt. Diese Datenquelle möchtest du mit einer weiteren Datenquelle kombinieren.

    1. Klicke rechts neben der Datenquelle auf + Datenquelle hinzufügen ().

    2. Klicke in der Liste der Datenquellen neben der gewünschten Datenquelle auf das Plus.
      → Die Datenquelle wird rechts neben der ersten Datenquelle hinzugefügt.

    3. Klicke auf Bestätigen.

    4. Klicke ganz rechts in der Zeile auf Einstellungen ().

    5. Wähle aus der Dropdown-Liste Trennzeichen ein Trennzeichen oder lege ein eigenes Trennzeichen fest.

    6. Klicke auf Speichern ().
      → Die Einstellungen werden gespeichert.
      → Der Inhalt der Datenquellen wird beim Export kombiniert und in dieselbe Spalte exportiert.

Zahlenwerte neu berechnen (Formel)

Mit mathematischen Berechnungen passt du Zahlenwerte während des Exports automatisch an.

Diese Funktion ist neu und noch nicht für alle Formate verfügbar. Sie funktioniert zudem nur bei Datenquellen, die Zahlenwerte enthalten.

Zahlenwerte neu berechnen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne den Katalog, den du bearbeiten willst.
    → Der Tab Datenquellen wird geöffnet.

  3. Klicke in der Liste der Datenquellen rechts neben Formel (calculate) auf das Plus (+).
    → Das Feld Formel wird zur Ansicht rechts hinzugefügt.

  4. Klicke auf das Feld Formel.
    → Das Fenster Wert ändern wird geöffnet.

  5. Wähle ein Dezimaltrennzeichen aus der Dropdown-Liste.

  6. Wähle unten rechts eine Datenquelle, um sie zur Berechnung hinzuzufügen (add).
    Tipp: Du kannst die Suche verwenden, um bestimmte Datenquellen schneller zu finden.
    → Die Datenquelle wird zur Formel hinzugefügt.

  7. Optional: Wenn in der Datenquelle das Symbol more_vert angezeigt wird, wähle die korrekte Zuweisung für die Datenquelle.
    Tipp: Eine Zahl zeigt an, wie viele Zuweisungen für die Datenquelle vorgenommen werden müssen.

    1. Klicke auf das Symbol more_vert.

    2. Wähle im angezeigten Fenster die gewünschten Zuweisungen aus den Dropdown-Listen.

    3. Speichere die Einstellungen.

  8. Gib Zahlen und mathematische Operatoren entweder mit dem angezeigten Taschenrechner oder über die Tastatur ein.

  9. Speichere die Einstellungen.
    → Die eingefügte Formel wird in der Ansicht angezeigt.
    Tipp: Wenn für das Format eine Vorschau verfügbar ist, prüfe das Ergebnis über die Vorschaufunktion (preview).
    → Die Berechnung wird beim nächsten Export durchgeführt.

Die Reihenfolge der Datenquellen ändern

In der Exportdatei werden die Datenquellen in derselben Reihenfolge angezeigt wie in der Katalogliste. Die erste Spalte einer CSV-Datei enthält also die Daten der Datenquelle, die ganz oben im Katalog steht und so weiter.

Um die Reihenfolge der Daten in der Exportdatei anpassen, kannst du entweder einzelne Datenquellen oder ganze Zeilen verschieben:

  • Um eine einzelne Datenquelle zu verschieben:

    • Zeige mit der Maus auf die Datenquelle und ziehe sie mit gedrückter Maustaste an die gewünschte Position.

  • Um eine ganze Zeile zu verschieben:

    • Klicke auf das Symbol (drag_indicator) am linken Rand und ziehe die Zeile mit gedrückter Maustaste an die neue Position.

4.2. Datenquellen aus Export entfernen

Im Tab Datenquellen eines Katalogs mit Standardformat kannst du einzelne oder auch mehrere Datenquellen gleichzeitig entfernen.

Datenquellen aus Export entfernen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne einen Katalog mit Standardformat.
    → Der Tab Datenquellen () mit allen verfügbaren Datenquellen wird geöffnet.

  3. Klicke rechts neben dem Datenquelle, das du entfernen möchtest, auf die weiteren Aktionen (more_vert).

  4. Klicke auf Datenquelle löschen (delete).
    → Die Datenquelle wird entfernt.
    Oder: Möchtest du eine komplette Zeile entfernen, klicke rechts in der Zeile auf Datenzeile löschen (delete).
    → Die komplette Zeile wird entfernt.
    Oder: Setze links einen Haken für alle mit Datenquellen gefüllten Zeilen, die du entfernen möchtest. Klicke dann rechts oben auf Gewählte Datenquellen löschen (delete).
    → Alle gewählten Datenquellen werden entfernt.

4.3. Exportdaten filtern

Mit Filtern kannst du die Daten eingrenzen, die exportiert werden sollen.

Filter hinzufügen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne den Katalog, den du bearbeiten willst.

  3. Klicke in der Navigation links auf Filter (filter_alt).
    → Die Filter-Übersicht wird geöffnet.

  4. Wähle einen Filter aus der Dropdown-Liste.
    Tipp: Je nach Standardformat sind unterschiedliche Filter verfügbar. Beschreibungen der einzelnen Filter findest du hier:

  5. Klicke rechts auf Filter hinzufügen (add).
    → Der Filter wird hinzugefügt.

  6. Wenn für den Filter ein Operator verfügbar ist:

    • Wähle einen Operator aus der Dropdown-Liste.

    • Gibt einen Wert in das Feld daneben ein.

  7. Speichere (save) die Einstellungen.
    → Der Filter wird gespeichert.

  8. Füge bei Bedarf weitere Filter hinzu.
    → Nur die Daten werden exportiert, auf die die Filter zutreffen.

5. Katalogdaten exportieren

Du hast mehrere Möglichkeiten, die Katalogdaten zu exportieren:

5.1. Exportvorschau erstellen

Nachdem du Datenquellen für den Export gewählt hast, kannst du den Katalogexport über die Vorschaufunktion testen. Mit dieser Vorschaufunktion lädst du die ersten 5 Datenzeilen der Datei herunter.

Die Vorschaufunktion ist nicht für alle Katalog-Formate verfügbar.

  • Vorschau im Katalog erstellen

  • Vorschau in der Katalog-Übersicht erstellen

Vorschau im Katalog erstellen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne den Katalog, den du bearbeiten willst.

  3. Klicke oben in der Symbolleiste auf Vorschau (preview).
    → Im Fenster Vorschau wird eine Vorschau der ersten 5 Datenzeilen des Exports angezeigt.

  4. Prüfe, ob die Daten wie erwartet ausgelesen wurden.

  5. Optional: Klicke auf Daten herunterladen (file_download), um eine Datei mit den ersten 5 Datenzeilen auf deinem Rechner zu speichern.

Du kannst die Vorschau auch über die Liste der Kataloge erstellen.

Vorschau in Katalogübersicht erstellen:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Navigiere zur Zeile des Katalogs.

  3. Klicke auf Mehr (more_vert) und wähle die Option Vorschau (preview).
    → Im Fenster Vorschau wird eine Vorschau der ersten 5 Datenzeilen des Exports angezeigt.

  4. Prüfe, ob die Daten wie erwartet ausgelesen wurden.

  5. Optional: Klicke auf Daten herunterladen (file_download), um eine Datei mit den ersten 5 Datenzeilen auf deinem Rechner zu speichern.

5.2. Automatischen Katalogexport aktivieren

Du hast alle Datenquellen hinzugefügt, die deine Exportdatei enthalten soll? Dann aktiviere jetzt den Export.

Stelle sicher, dass du alle nötigen Exporteinstellungen vorgenommen hast, da sonst keine Daten exportiert werden.

Automatischen Katalogexport aktivieren:

  1. Öffne das Menü Daten » Kataloge.
    → Eine Liste der Kataloge wird angezeigt.

  2. Navigiere zum Katalog, den du exportieren willst.

  3. Aktiviere () die Umschaltfläche in der Spalte Aktiv/Inaktiv.
    → Der Katalog wird aktiviert.
    → Die Daten werden zu dem Speicherort und in dem Intervall exportiert, die du in den Katalogeinstellungen festgelegt hast.

5.3. Manuellen Export starten

Du hast mindestens ein Datenfeld für den Export hinzugefügt? Dann kannst du die Katalogdaten manuell exportieren. In welchem Format die Daten exportiert werden, legst du in den Formateinstellungen des Katalogs fest. Zurzeit kannst du Daten in den Formaten CSV, TXT, JSON und XML herunterladen.

Du hast zwei Möglichkeiten, die Katalogdaten manuell zu exportieren:

Asynchroner Download

Der Export läuft im Hintergrund. Wenn der Download abgeschlossen ist, lädst du die Exportdatei über die Notifications (notifications) herunter.

Live-Download

Die Datei wird automatisch auf deinen Rechner heruntergeladen. Du kannst den Fortschritt des Exports in Echtzeit verfolgen.

  • Asynchronen Download starten

  • Live-Download starten

Beim asynchronen Download läuft der Export im Hintergrund. Es wird also kein Fenster angezeigt, über das du die Datei sofort herunterladen kannst. Auch der Export kleiner Datenmengen dauert ca. 30 Minuten. Wenn der Download abgeschlossen ist, kannst du die Exportdatei über die Notifications (notifications) herunterladen.

Asynchronen Download starten:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne den Katalog, den du exportieren willst.

  3. Klicke in der Symbolleiste oben auf Asynchroner Download (file_download).
    Oder: Noch schneller geht es, wenn du den Download über die Weiteren Aktionen (more_vert) in der Katalog-Übersicht startest.
    → Der Export wird gestartet.
    Wichtig: Der Export läuft im Hintergrund. Es wird kein Fenster angezeigt, über das du die Datei sofort herunterladen kannst. Auch der Export kleiner Datenmengen dauert ca. 30 Minuten.
    → Wenn der Export abgeschlossen ist, wirst in den Notifications (notifications_none) angezeigt, dass die Exportdatei heruntergeladen werden kann.

  4. Klicke im Notification Center auf link Herunterladen.
    Tipp: Die Notification wird nicht mehr angezeigt? Rufe die Datei über die URL in den Download-Einstellungen ab.

  5. Speichere die Datei auf deinem Rechner.

Beim Live-Download wird die Datei erstellt und direkt automatisch auf deinen Rechner heruntergeladen. Du kannst den Fortschritt des Downloads in Echtzeit im Tab Datenexport verfolgen.

Wenn du den Live-Download startest, wird ein neuer Browser-Tab geöffnet. In diesem Browser-Tab wird das PlentyONE Tab Datenexport angezeigt. Schließe den Browser-Tab und den PlentyONE Tab Datenexport nicht und lade ihn nicht neu, während der Export läuft, da der Export sonst abgebrochen wird.
Bei großen Datenmengen kann es zu einer Zeitüberschreitung kommen. Der Download wird dann abgebrochen. Verwende bei großen Datenmengen oder einer Zeitüberschreitung stattdessen den asynchronen Download.

Du kannst bei mehreren Katalogen gleichzeitig einen Live-Download durchführen. Einen neuen Live-Download für denselben Katalog kannst du aber erst starten, wenn der laufende Export abgeschlossen ist.

Live-Download starten:

  1. Öffne das Menü Daten » Kataloge.
    → Die Katalog-Übersicht wird geöffnet.

  2. Öffne den Katalog.

  3. Klicke in der Symbolleiste oben auf Live-Download (play_circle_outline).
    Oder: Noch schneller geht es, wenn du den Live-Download über die weiteren Aktionen (more_vert) in der Katalogübersicht startest.
    → Ein neuer Browser-Tab wird geöffnet. PlentyONE und der Tab Datenexport werden angezeigt.
    Der Tab wurde nicht geöffnet? Dann verwendest du wahrscheinlich einen Pop-up-Blocker. Erlaube Pop-ups für dein System und es kann losgehen.
    → Der Export wird gestartet.
    Wichtig: Das Browser-Tab und der PlentyONE Tab Datenexport dürfen nicht geschlossen oder neu geladen werden, während der Export läuft, da er sonst abgebrochen wird.
    → Der Fortschritt wird in Echtzeit angezeigt.
    → Wenn der Export abgeschlossen ist, wird die Datei automatisch auf deinem Rechner gespeichert.

Live-Download abbrechen

Willst den Live-Download abbrechen? Dann gehe wie folgt vor:

  • Klicke im Tab Datenexport ganz rechts oben auf Export abbrechen (highlight_off).
    → Der Download wird abgebrochen.
    Wichtig: Der Download kann nicht fortgesetzt werden. Starte bei Bedarf einen neuen Download.

6. FAQ: Fragen und Antworten

Wofür brauche ich noch mal welches Katalogformat?
Was bedeutet "Export Key"?

Die "Export Keys" sind die Namen der Spaltenüberschriften, die in deiner Exportdatei erscheinen werden. Jeder "Export Key" muss eindeutig sein.

  • Negatives Beispiel: Du verwendest die Datenquellen Artikel-ID und Varianten-ID. Du gibst beiden "Export Keys" den Namen "id". Dies führt dazu, dass die Exportdatei nur eine der beiden IDs enthält. In der Exportdatei fehlt eine Spalte.

  • Positives Beispiel: Du verwendest die Datenquellen Artikel-ID und Varianten-ID. Du gibst einem "Export Key" den Namen "VariationID" und einem den Namen "ItemID".

katalog export keys
Wie muss der Export Key aufgebaut sein?

Der Export Key ist der Name der Spaltenüberschrift, der in deiner Exportdatei erscheinen wird.

  • Jeder Export Key darf pro Katalog nur einmal vorkommen.
    Wichtig: Wenn mehrere Datenfelder denselben Export Key haben, wird nur eines der Datenfelder exportiert.

  • Export Keys dürfen keine Leerzeichen enthalten.

  • Wenn der Export Key einen Punkt enthält, werden die Daten als Baumstruktur exportiert. In den meisten Anwendungsfällen werden die Daten dann nicht wie erwartet exportiert. Wir empfehlen dir deshalb, in Export Keys keine Punkte zu verwenden.

In meiner Exportdatei fehlt eine Spalte. Warum?

Möglicherweise hast du mehrere Datenquellen mit demselben "Export Key". Jeder "Export Key" muss eindeutig sein.

  • Negatives Beispiel: Du verwendest die Datenquellen Artikel-ID und Varianten-ID. Du gibst beiden "Export Keys" den Namen "id". Dies führt dazu, dass die Exportdatei nur eine der beiden IDs enthält. In der Exportdatei fehlt eine Spalte.

  • Positives Beispiel: Du verwendest die Datenquellen Artikel-ID und Varianten-ID. Du gibst einem "Export Key" den Namen "VariationID" und einem den Namen "ItemID".

katalog export keys
Es wird nur das Wort "Array" exportiert. Warum?

Wenn du eine Datei im CSV- oder TXT-Format exportierst, kann es passieren, dass du nur das Wort "Array" siehst, anstelle der tatsächlichen Exportwerte. Dies geschieht z.B. beim Export mehrerer Bilder oder beim Export von Eigenschaften des Typs Mehrfachauswahl. Dies ist ein bekanntes Problem, das in Zukunft noch behoben wird.

Möglicher Workaround 1: Würde es für dich in Frage kommen, stattdessen eine JSON- oder XML-Datei herunterzuladen? Bei diesen Dateitypen siehst du die eigentlichen Exportwerte.

  1. Klicke auf Einstellungen.

  2. Scrolle runter zum Abschnitt Formateinstellungen.

  3. Wähle JSON oder XML aus der Dropdown-Liste Format.

  4. Speichere () die Einstellungen und lade die Datei herunter (file_download).

    • Vorsicht: Falls du die Datei überarbeiten und dann wieder importieren willst. Beachte, dass das Import-Tool nur die Dateitypen CSV und TXT akzeptiert.

Möglicher Workaround 2: Exportiere die Daten stattdessen mit den Tools FormatDesigner und Elastischer Export.

Kann ich die Datei überarbeiten und dann wieder importieren?

Ja. Exportiere die Datei im CSV- oder TXT-Format. Dann bearbeite die Datei und importiere sie erneut. Beachte, dass das Import-Tool nur die Dateitypen CSV und TXT akzeptiert.

Unter der Download-URL des Katalogs gibt es keine Datei. Warum?

  1. Ist der Katalog aktiv?

  2. Wurde schon ein Export durchgeführt? Prüfe die Exporteinstellungen.

  3. Hast du die richtige URL verwendet?

Unter der Download-URL des Katalogs wird statt einer Datei "Unauthenticated." angezeigt. Warum?

Du hast die Admin-URL verwendet. Du bist aber nicht als Admin im PlentyONE System angemeldet.

  • Möglichkeit 1: Melde dich als Admin an.

  • Möglichkeit 2: Generiere eine öffentliche URL. Über diese URL ist die Datei immer erreichbar.

Warum sehe ich die Kataloge nicht?

Personen mit Backend-Zugriffsrechten sehen Kataloge nur, wenn ein Admin ihnen Zugriffsrechte gegeben hat.

  1. Wende dich an eine Person mit Administratorrechten für das PlentyONE System.

  2. Diese Person öffnet das Menü Einrichtung » Einstellungen » Benutzer » Rechte » Benutzer.

  3. Sie öffnet dein Benutzerkonto und schaltet die Rechte frei:

    • Daten > Datenaustausch > Export > Katalog > Anzeigen

  4. Speichere () die Einstellungen.

Ich will Kataloge importieren, exportieren, löschen, kopieren, Versionen wiederherstellen usw. Wie geht das?

Erklärungen zur Verwaltung von Katalogen findest du hier: