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. Der Download wird in einem Hintergrundprozess vorbereitet, und die Exportdatei kann im Notifications-Bereich deines Systems heruntergeladen werden, sobald der Prozess abgeschlossen ist.

play_circle Live-Download

Lädt die Katalogdaten als Datei herunter. Der Download wird sofort in einem neuen Tab gestartet. Wenn du deinem System erlaubt hast, in deinem Browser Pop-ups anzuzeigen, wird die Exportdatei automatisch heruntergeladen, sobald sie bereit ist.

playlist_play Status

Öffnet das Menü Daten » Katalogexportstatus und filtert nach diesem Katalog. Über diese Ansicht kannst du den Status aller Exporte prüfen, die bisher für den Katalog ausgeführt wurden.

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 Katalog löschen

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. Klicke auf KATALOG ERSTELLEN (save).
    → 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.
Hinweis: Bei den meisten Export-Typen steht nur ein Format zur Auswahl. Bei Export-Typen, für die 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, den du anpassen willst.
    → Der Katalog wird geöffnet.

  3. Klicke in der Navigation links auf den Tab Einstellungen (settings).
    → Die Einstellungen 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
    Beispiel: 20,00 Euro

  • Punkt
    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

Du kannst in diesem Feld wahlweise eine maximale Anzahl an Datenzeilen angeben, die in der Exportdatei enthalten sind.
Tipp: Du kannst die Vorschau bzw. den Live-Download verwenden, um zu prüfen, wie deine Daten in der Exportdatei organisiert sind und welche Datenzeilen durch das angegebene Limit ausgeschlossen 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

Der Export wird alle 20 Minuten ausgeführt.

Einmal pro Stunde

Der Export wird zu jeder vollen Stunde aufgeführt (z.B. 14:00 Uhr, 15:00 Uhr etc.)

Einmal pro Tag

Der Export wird einmal täglich um 2 Uhr morgens ausgeführt.

Zeitplan: Uhrzeiten

Der Import wird zu bestimmten Uhrzeiten ausgeführt. Du kannst diese Uhrzeiten im Feld Zeitplan: Uhrzeiten wählen, das sichtbar ist, während diese Option ausgewählt ist.

Zeitplan: Uhrzeiten
(wird nur angezeigt, während die Option Zeitplan: Uhrzeiten ausgewählt ist)

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.

  • Du kannst über die Option Version verwenden und/oder die Option Token verwenden einschränken, wie über den öffentlichen Link auf deine Daten zugegriffen werden kann.

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 die Domain, die zum Generieren der Download-Links verwendet werden soll. Für jeden Mandanten, der über dein PlentyONE System verwaltet wird, werden jeweils zwei Optionen angezeigt:

  • Die Domain des Mandanten.
    Hinweis: Wenn du dem Mandanten einen Namen zugewiesen hast, wird für diese Option anstelle der Domain der Name des Mandanten angezeigt.

  • Eine Domain, die auf der Plenty ID des Mandanten basiert (z.B. p12345.my.plentysystems.com).
    Hinweis: Wenn diese Option ausgewählt ist, ist die Domain auch in den Feldern Admin-Link und Öffentlicher Link enthalten.

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, wird am Ende des öffentlichen Links ein zufällig generierter Token hinzugefügt. Der Token kann jederzeit neu generiert werden, und nur Links, die den aktuellen Token enthalten, können verwendet werden, um auf die Exportdatei zuzugreifen.

Sicherheits-Token generieren

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

Tipp: Der Token wird als Bestandteil des öffentlichen Links im Feld Öffentlicher Link hinzugefügt.

Öffentlicher Link

Zeigt den öffentlichen Link an. Nachdem ein Export abgeschlossen wurde, 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 kannst du sicherstellen, dass bestimmte Daten für alle Datenzeile exportiert werden, auch wenn die bevorzugte Datenquelle diese Daten nicht bereitstellen kann. So funktionieren Ausweich-Datenquellen:

  • Wenn die primäre Datenquelle für einen Datensatz einen zulässigen Wert zurückgibt, dann wird dieser Wert in den Datensatz eingefügt.

  • Wenn die primäre Datenquelle für einen Datensatz keinen zulässigen Wert zurückgibt, prüft das System, ob die erste Ausweich-Datenquelle einen zulässigen Wert zurückgibt, dann die zweite Ausweich-Datenquelle usw.

    • Wenn ein zulässiger Wert gefunden wird, wird dieser Wert in den Datensatz eingefügt und alle restlichen Ausweich-Datenquellen werden ignoriert.

    • Wenn keine der Datenquellen einen zulässigen Wert zurückgibt, wird kein Wert in den Datensatz eingefügt.

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.

    2. Klicke in der Liste der verfügbaren Datenquellen neben der gewünschten PlentyONE Datenquelle auf das Plus (+).
      → Die PlentyONE Datenquelle wird als Ausweich-Datenquelle in das Feld rechts eingefügt.
      → Der Wert aus der Ausweich-Datenquelle wird exportiert, wenn die Datenquelle über ihr keinen zulässigen Wert zurückgibt.

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, also zuerst der erste in der Liste, dann der zweite usw.

  • Tipp: Du kannst einen eigenen Wert als Ausweich-Datenquelle hinzufügen, um sicherzustellen, dass ein Wert für jeden Datensatz exportiert wird.

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

Mit der Datenquelle Eigener Wert kannst du für jeden Datensatz genau denselben Wert exportieren.

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 automatisch den Export Key own-value, dieser sollte aber angepasst werden, insbesondere wenn du mehrere eigene Werte exportieren willst.
    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 kannst du Zahlenwerte während des Exports automatisch anpassen.

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 Formel erstellen wird geöffnet.

  5. 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.

  6. 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.

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

  8. 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 Formel wird während des Exports zur Berechnung der Werte verwendet, die in die Datensätze eigefügt werden.

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 der Datenquelle, das du entfernen möchtest, auf die weiteren Aktionen (more_vert).

  4. Klicke auf Datenquelle löschen (delete).
    → Die Datenquelle wird entfernt.
    Oder: Klicke rechts in der Zeile auf Datenzeile löschen (delete), um eine komplette Zeile zu entfernen
    → 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 Zeilen 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 anzeigen

  • Vorschau in der Katalog-Übersicht anzeigen

Vorschau im Katalog anzeigen:

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

  2. Öffne den Katalog, für den du eine Vorschau sehen 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 anzeigen lassen.

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 ist der Katalog nun für den Export bereit. Aktiviere den Katalog, um den Zeitplan für den automatischen Export zu aktivieren, den du vorher eingestellt hast.

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: