Product Information Manager : Export von Produkten und Preisen

Zugriff

Es gibt vier Wege, um die Funktionalität Export von Produkten in PIM zuzugreifen:

  • Klicken Sie auf Im-Export -> Export von Produkten und Preisen) in der Sektion Export im Hauptmenü.
  • Auf der Produkt suchen Seite:
    • Führen Sie die Suche nach Ihren Suchparametern aus und wählen Sie die gewünschte Option aus der Drop-Down-Liste aus, um alle Produkte aus den Suchergebnissen zu exportieren.
    • Wählen Sie die Produkte mithilfe der Checkboxen aus und klicken Sie auf die gewünschte Option aus der Drop-Down-Liste aus, um die ausgewählten Produkte zu exportieren.
  • Wählen Sie die relevanten Optionen aus der Drop-Down-Liste neben dem Button im Produkteditor, um das einzelne Produkt zu importieren.

Inhaltsverzeichnis

Übersicht

Der Produktexport hilft Ihnen die Produktkataloge mit den Preisen für einen bestimmten Kunden zu exportieren. Die Produkte können in die Datei exportiert werden (z. B. CSV, XLS, XML usw.).

PIM unterstützt den Import der 'schmutzigen' Daten, werden sie die Bereinigung in PIM vor dem Export erwartet. Keine 'schmutzigen'  (inkorrekt) Produktdaten, außer der 'Roh'-Produkten' (JSON/Produkten und Excel Exportformate) werden exportiert.

Die Berechtigungen, die für den Benutzer in PROV definiert werden können, werden nicht während des Produktexport verwendet. Nämlich, ist es möglich die Attributwerte zu exportieren, die zur Klassifikationsgruppe gehören, für die der Benutzer nicht verantwortlich ist.

Export des Rohprodukts

Die  primäre Absicht des Rohprodukt-Konzepts ist die Produkten zur PIM- kompatibele Instanz noch eimal nach dem Export und Bearbeitung, wenn notig.

 

Rohformate des Exports sind die folgenden:

  • JSON/Produkte (Rohformat)
  • EXCEL/Produkte (Rohformat)

Die grundlegenden Prinzipien des Export der Rohprodukten:

  • Die Daten sind "Istzustand" exportiert (ungültige Produktdaten können exportiert werden)
  • Keine Verarbeitung der Varianten (Varianten werden nicht als einzelne Produkte exportiert)
  • Keine Berechnung zur Externenprodukt (Attributwerten sind ungelöst)
  • Keine Kontentfilterung (Keine Exportparameter, die den zu exportierenden Inhalt für die Produkte begrenzen sind verwendet)

Export des externen Produkts

Die primäre Absicht des Externen-Produkt-Konzepts ist die Verfügung der überschaubaren  Menge der Produktinformationen, die gebrauchsfertig für Publikation, Produktvorschau und andere Berührungspunkte ist. Das Konzept ermöglicht die Behandlung der Produktvarianten, wenn verfügbar, als einzelne Produkte und der Export der Attribute und Dokumenten, die nach die entsprechende Sprachen und Tags gelöst sind.

Falls das exportierte Produkt eine Produktvariante enthält, wird auch das Masterprodukt durch den externen Produkt-Export exportiert (das ist eine Standardeigenschaft, die konfiguriert werden kann).

Der Export diesen Produkten gibt die Möglichkeit für die Channels und andere Parametern, die den zu exportierende Inhalt für die Produkte begrenzen, zu verwenden.

Die Exportformate der Externe-Produkte sind die Folgende:

  • CSV/Produkte

  • JSON/Produkte

Der Standardexport des Formats CSV-Produkte enthält die folgenden Felder:

  • Produkt ID
  • Katalog ID
  • Kurzbeschreibung des Produkts (Name) in der Export-Sprache (Falls keine Sprache ausgewählt wurde, werden die Kurzbeschreibungen in alle Sprachen exportiert.)
  • Änderungsinformation (Angelegt am/von, Geändert am/von)

Die Produkt-Kompatibilitäten werden durch JSON/Produkte (Rohformat) und JSON/Produkte exportiert. Im JSON/Produkte Export:

  • werden die Kompatibilitäten des Masterprodukts für alle Varianten auch exportiert, wenn verfügbar.
  • werden die Kompatibilitätseinschränkungen (die durch die Werte der Kompatibilitätattribute definiert werden) gelöscht wie es in der Sektion "Die Lösung der Attributwerte im externen Produkt" beschrieben ist.

  • werden die Dokumentverknüpfungen für die definierte Sprachen exportiert (falls keine Sprachen definiert werden, die Dokumentverknüpfung für alle Sprachen exportiert wird)

Die Lösung der Attributwerte im externen Produkt

Die Attributwerte mit Ausdrücken, Terms und Referenzen zum Produkt (Markdown- und Texttabelle-Attribute) werden für externe Produkte wie folgt exportiert:

  • Nicht mehrsprachige Attribute:
    • Terms werden nicht gelöst (Term ID wird exportiert)
    • Referenzen zum Produkt mit Modifikatoren :IMG und :DESC werden nicht gelöst. Die einfache Produktreferenz wird als <Produkt ID> (<Katalog ID>) gelöst
    • Ausdrücke werden gelöst, wenn sie eine Referenz mit Sprache, für die einen Wert gelöst werden soll, enthalten. Zum Beispiel: term('$Action','en-GB'); boilerplate('Vorwort','en-GB')

Terms und Produktreferenzen werden derzeit in nicht mehrsprachigen Markdown und Texttabellen-Attributen als gelöst an folgenden Plätzen gezeigt:

  • Im modalen Vorschau-Fenster für Varinaten-Attributwerte in der Registerkarte Varianten im Produkteditor (in der Content-Sprache)
  • In der Sektion Ergebnis im Editor von Texttabellen-Attributwerten (in der UI-Sprache)
  • Im Vorschaumodus des Editors von Markdown-Attributwerte (in der Content-Sprache)
  • In der Produktvorschau (in der Content-Sprache)
  • Im Export PDF/Produkte export und PDF aus der Produktvorschau (in der ausgewählten Sprache / Content-Sprache)
  • In der Sektion Verbundene Produkte in DAM Dokumentdetails (in der UI-Sprache)

Mehrsprachige Attribute:

  • Terms werden für die entsprechende Sprache gelöst (falls es keine Übersetzung für die Sprache gibt, wird die Term ID gezeigt)
  • Produktreferenzen werden für die entsprechende Sprache gelöst (falls kein referenzierest Produkt existiert, wird der Wert als <Produkt ID> (<Katalog ID>) gelöst; falls Modifikatoren :IMG oder :DESC für nicht-existierende Produkte verwendet werdem, bleibt der Wert ungelöst)
  • Ausdrücke werden für die Sprache und Tags berechnet (Weitere Informationen finden Sie auf der Seite Attribute)

Zusätzlich zum Export von Externen Produkten werden die externen Produktwerte für mehrsprachigen Attribute in folgenden Plätzen gezeigt:

  • Produktbeschreibungen (Namen) in Produktsuche und Produkteditor
  • Facettenproduktsuche nach Attributwerten
  • Auf der Seite Produkte und Produktversionen vergleichen
  • In der Vorschau des Produkts
  • In der PDF (PDF/Produkt Export und PDF aus Produktvorschau)
  • Auf der Registerkarte Varianten im Produkteditor (Attributwerte der Varianten)
  • DAM Dokumentdetails (der Sektion Verbundene Produkte)

Der Export von einigen Typen der Daten können konfiguriert werden. Zum Beispiel:

  • Wertelistenelemente in den Attributwerten
  • Attributwerte der Typen Markdown und Text-Tabelle
  • Daten
  • Dezimale Werte

Mehrere Informationen über die Konfigurierung des Exports finden Sie in der technischen Dokumentation des Import-Export-Plugins.

Umgang mit "unsauberen" Attributwerten im externen Produkt

In diesem Kontext, beziehen sich die "unsauberen" Attributwerte auf Attributwerte, die nicht Teil eines externen (sauberen) Produkts mit aufgelösten und berechneten Werten sind. Dieses Konzept umfasst Folgendes:

  • Ungültige Produktattributwerte aufgrund eines falschen Formats/falscher Attributtypen (Datum, Ganzzahl, Langformat). Ungültige Produktattributwerte können importiert werden (siehe die Seite Import von Produkten und Preisen für Details) oder können fälschlicherweise auf der Registerkarte Attribute des Produkt-Editors gespeichert werden. Auf der Registerkarte Attribute sind sie rot markiert und haben eine Fehlermeldung, wenn die Attributwertzelle ausgewählt wurde.

Schon ein ungültiger Wert in einem mehrwertigen Attribut führt zum Ausschluss der Werte dieses Attributs aus dem externen Produkt.
  • Attributwerte, die nicht aufgelöst werden können. Zum Beispiel Attributwerte, die durch Ausdrücke gesetzt werden, die nicht berechnet werden können (führen zu einem Fehler) oder deren Berechnung einen "Null"-Wert ergibt.

Der "unsaubere" Attributwert einer Variante wird von der Variante ausgeschlossen, ohne dass auf den Wert des Masterprodukts zurückgegriffen wird.

Solche "unsauberen" Werte werden:

  • im Bereich der externen Daten nicht gesucht und in den Facetten nicht ersheinen
  • beim Export von externen Produktdaten nicht ausgegeben
  • in Widgets, die Attributwerte in Produkten im Bereich Externe Daten zählen, nicht berücksichtigt

Die folgenden "unsauberen" Werte sind nicht vom externen Produkt ausgeschlossen:

  •     Text-Tabellen Attributwerte, die nicht dem Text-Tabellenformat entsprechen
  •     Attributwerte, die nicht den Beschränkungen des Attributtyps Erweiterung entsprechen (min/max Länge usw.)

Nicht aufgelöste Terms und Produktreferenzen in Texttabellen- sowie Markdown-Attributwerten, werden als reine ID/Produktreferenzwert in das externe Produkt übernommen

Andere Exports

Andere Exportformate sind:

  • XML/BMECat2005 (Produkutexport nach der Klassifikation BMECat2005)
  • XML/SolrML (OPC-kompatibel Format)
  • PDF/Produkte (Export von Produkt-Datasheet)

Exportparametern

Die Seite Produktexport erhält die Parameter, die als Filter im Produktexport verwendet werden.

Es gibt zwei Type der Filter, die für den Export von Produkten und Preisen verwendet werden können:

Die Exportparameter, die die Anzahl der exportierten Produkten begrenzen

Die Anzahl den exportierten Produkten kann eingeschränkt werden, indem Sie die folgenden Parameter festlegen:

Produktkatalog

Die Seite Export von Produkten und Preisen hat Produktkatalog als das erste Feld, um den Katalog auszuwählen, wenn:  

  • Sie auf diese Seite aus dem PIM Hauptmenü zugreifen.

Geben Sie die Katalog ID ins Feld aus oder verwenden Sie , um den Katalog für Export auszuwählen.

Wenn keinen Katalog ausgewählt oder keine Suche ausgeführt wurde, werden alle Produkte, die den anderen Exportparametern entsprechen, aus dem System exportiert.
Produkte

Die Seite Produktexport hat Produkte als das Feld, die die anfängliche Reihe von Exportprodukten definiert.

Das Feld erscheint in den folgenden Fällen:

  • Wenn Sie auf die Seite Produktexport aus dem Produkteditor des Produkts zugreifen. In diesem Fall, wird nur einzelnes Produkt im Feld Produkte angezeigt.

  • Wenn Sie ein oder mehrere Produkte und die Exportoption aus der Drop-Down-Liste auf der Seite Produkt suchen auswählen.

  • In diesem Fall steht der Suchparameter-Link zur Verfügung, um zur Suchergebnisseite mit ausgewählten Produkten zurückzukehren.

Die vorausgewählten Produkte können nicht entfernt oder geändert werden.

Suchparameter

Die Seite Produktexport kann Suchparameter als das erste Feld haben.

Das Feld ist verfügbar, wenn Sie auf diese Seite aus der Seite Produkt suchen zugreifen und nach der Produktsuche gemäß einigen Suchparametern die Exportoption aus der Drop-Down-Liste auswählen.

In diesem Fall ist die anfängliche Reihe der Exportprodukten bei der gefundenen Produkten aus den Suchergebnissen begrenzt.

Die Seite kann beide Felder Suchparameter und Produkte haben, wenn eine Suchanfrage ausgeführt wurde und irgendwelchen Produkten ausgewählt wurden. In diesem Fall werden nur die ausgewählte Produkten exportiert.

Sie können auf den Link Suchparameter klicken, um zu den entsprechenden Suchergebnissen zurückzukehren.

Geänderte Produkte

Es ist möglich die Anzahl der Exportprodukte mit Produkten, die nur einige Änderungen während des bestimmten Zeitraums hatten, zu begrenzen.  

Die Sektion Geänderte Produkte wird über den entsprechenden Radio-Button aktiviert.

Wählen Sie das Datum aus dem Kalender aus, um der Export von Produkten, die nach dem Datum geändert wurden, oder geben Sie das Zeitraum (in Tagen, Stunden oder Minuten) an, um den Export von Produkten, die während der ausgewählten Periode geändert wurden, zu starten.

Die Auswahl der Option Änderungsdatum nicht zu berücksichtigen exportiert alle Produkte. 

Die Exportparametern, die den zu exportierenden Inhalt für die Produkte begrenzen

Diese Parameter sind zur Rohrformat des Exports (JSON/Produkte (Rohformat) und EXCEL/Produkte (Rohformat)) nicht anwendbar.

Der Benutzer kann eine Datei exportieren und solche Filtern wie Kanal, Kontrakt und/oder Exportsprache festlegen. Die Filterung bedeutet, dass die Produkte exportiert werden, aber ihre Attribute, Produkt-Kontraktzuordnung und Übersetzungen gefiltert werden. Jeder vorgenannte Parameter beeinflusst NUR den Kollektion-Export. Die Produkten, die keine Attribute (Channel), keine Produkt-Kontraktzuordnung (Kontrakt) oder keine Attribute in der Zielsprache (Sprache) haben, sind im Export inbegriffen. So wenn Sie die Exportsprache auswählen, bedeutet das, dass Sie die Absicht haben, nach dieser Sprache zu filtern und alle andere Sprachen auszunehmen. Wenn Sie keine Sprache auswählen, bedeutet das, dass Sie keinen Filter einstellen möchten. Und alle Sprachen werden exportiert.

  • Channel - Wählen Sie ein Channel aus, und nur die im Channel definierten Attribute werden exportiert. Wenn ein Produkt keine Attribute hat, die für den Channel gültig sind, wird das Produkt jedenfalls exportiert, aber ohne Attributwerte. Finden Sie die Details auf der Seite Channels.
  • Kontrakt - Geben Sie die Kontrakt ID direkt ein oder wählen Sie den Kontrakt aus, indem Sie auf das Symbol klicken. Nur die zum Kontrakt zugeordneten Produkte (die Zuordnung zum Kontrakt wird in der Registerkarte Sortimente im Produkteditor angelegt) und Prise für ausgewählten Kontrakt werden exportiert. Wenn ein Produkt keine Produkt-Kontraktzuordnung mit dem entsprechendem Kontrakt hat, wird es aber ohne Positionen mit der  Kontraktzuordnung und ohne entsprechende Preisen exportiert.

  • Exportsprache - Wählen Sie ein Paar <Sprache ID>-<Landescode> aus der Drop-down-Liste aus, um eine Sprache für die exportierten Daten festzulegen.

    • Alle Attribute, die nicht mehrsprachig sind, werden exportiert

Nicht mehrsprachiges Attribut soll kein Sprache für seinen Wert eingegeben werden.
  • Alle mehrsprachige Attribute, die in der ausgewählten Sprache festgelegt sind, werden exportiert
  • Mehrsprachige Attributwerte ohne definierte Sprache (falls es keinen Wert der für die Exportsprache spezifisch ist gibt) werden exportiert
  • Falls das Markdown- oder Text-Table Attribut einen Wert mit dem Term hat, wird die Übersetzung des Terms in der ausgewählten Sprache exportiert
  • Falls ein nicht mehrsprachiges Attribut einen Wert mit dem Ausdruck hat, der keine eingegebene Sprache im Ausdruck enthält, wird der Term ID exportiert
  • Falls ein nicht mehrsprachiges Attribut einen Wert mit dem Term hat, wird der Term ID exportiert ( außer dem PDF-Export)
  • Die Dokumente, die in der ausgewählten Sprache festgelegt sind oder Dokumente mit keiner eingegebenen Sprache (falls gibt es kein Dokument dieses Typs in der Exportsprache)  werden exportiert

  •  

Die Details der Exportlogik für die Dokumente der Produktvarianten finden Sie in der Sektion Dokumente für Varianten.

Gemeinsame Parameter

Um Produkte und Preise zu exportieren, müssen Sie folgenden Daten eingeben:

  • Format der Ausgabedatei - wählen Sie die gewünschte Option aus der Drop-Down-Liste:
    • XML/BMECat2005
    • XML/SolrML
    • PDF/Produkte
    • CSV/Produkte
    • JSON/Produkte (Rohformat)
    • JSON/Produkte
    • EXCEL/Produkte (Rohformat)
Für die Formate XML, CSV, PDF und  JSON/Produkte werden die Varianten des Produkts als separate Produkte exportiert. Die Formate JSON /Produkte (Rohformat) und Excel werden als ein Produkt exportiert
  • Format der Ausgabedatei - Wählen Sie das gewünschte Format aus der Drop-down-Liste aus.

Die Kodierung ist für die korrekte Anzeige der Daten auf den internationalen Systemen notwendig:

  • UTF-8 ist eine internationale Zeichenkodierung, die für jede vorhandene Sprache verwendet werden kann. Die ersten 127 Zeichen von UTF-8 stimmen mit dem ASCII-Code überein und sind somit für fast alle Systeme geeignet. Empfohlene Kodierung.
  • UTF-16 ist eine Variation von UTF-8, die dieselben Zeichen verwendet, aber mit ASCII nicht kompatibel ist. Es sollte dann verwendet werden, wenn das Zielsystem von UTF-16 abhängig ist.
  • Die ISO-8859-1-Kodierung wurde von der Internationalen Organisation für Normung (ISO) entwickelt und beschreibt einen westeuropäischen Zeichensatz. Es wird für die Datenübertragung innerhalb Westeuropas verwendet.
  • Die Windows-1252-Kodierung wurde von Microsoft entwickelt und wird nur für die Datenübertragung zwischen Windows-Systemen empfohlen. Systeme, die nicht unter Windows laufen, haben häufig Probleme, diesen Zeichensatz zu importieren.

Nur UTF Kodierung kann für JSON Formaten verwendet werden.
  • Job ID - Geben Sie eine eindeutige Job ID für den Export-Job an oder lassen Sie das Feld leer. Eine eindeutige ID wird automatisch generiert.
  • Ausführungszeit - Um die Ausführungszeit für den Export festzulegen, klicken Sie auf das Symbol, um das Datum und die Uhrzeit festzulegen. Wird die  Ausführungszeit nicht angegeben, wird der Export sofort ausgeführt. Verwenden Sie den Button , um den Zeitplan zu löschen.

Nachdem der Export-Zeitplan festgelegt worden ist, klicken Sie auf  , um den Export für spätere Ausführung zu speichern.

Klicken Sie auf , um die anfänglichen Exportparameter wiederherzustellen.

Klicken Sie auf den Button , um den Export sofort zu starten.

Klicken Sie auf den Link Ergebnis, um die exportierten Dateien herunterzuladen.

Die Logdatei der Ausführung ist durch den Link execution.log oder durch das Arbeitsverzeichnis (abgerufen durch den Klick auf ) zugänglich. Klicken Sie auf die Link , um auf die Seite Jobs verwalten weitergeleitet zu werden.

Varianten-Export Fallback-Logik

Diese Varianten-Export Fallback-Logik ist zum Rohrformat des Exports (JSON/Produkte (Rohformat) und EXCEL/Produkte (Rohformat)) nicht anwendbar.

Es gibt einige Konfigurationen für den Export der Produktvarianten, die Sie in der Sektion Konfigurationsattribute erstellen können (  - >  System - >  Konfigurationsattribute (im Bereich  Konfiguration).

Dokumente für Varianten

Si e können die Fallback-Logik, die beim Dokumentenexport der Produktvarianten verwendet wird, über das  Konfigurationsattribut jcatalog.product.document.variantFallbackLogic konfigurieren.

Das Beispiel des Wertes des Konfigurationsattributs:

{"preview":"variant","product_image":"variantOrMaster"}

Die folgenden Logik-Type sind verfügbar:

  • all – alle Dokumente, die zur Variante und dem Master-Produkt gehören, werden zum Kontraktpunkt exportiert. Zum Beispiel: es gibt ein Dokument Preview für den Master und ein für die Variante, beide Dokumente werden exportiert. 
  • variant – nur die Dokumente, die zur Variante gehören, werden exportiert. Zum Beispiel: es gibt ein Dokument Preview für die Variante, dieses Dokument  wird für die Variante exportiert, unabhängig davon, ob es Dokument  Preview für den Master gibt oder nicht gibt.
  • master – die Dokumente des definierten Typs, die zum Master-Produkt gehören, werden für die Variante exportiert. Wenn es kein Dokument für den Master gibt, wird das Dokument für die Variante exportiert. Zum Beispiel: es gibt Preview für den Master und die Variante, aber wir möchten das Variante-Dokument für den Produktexport ignorieren, dann nur wenn es keinen Master gibt, wird dieses Variante-Dokument exportiert.
  • variantOrMaster  – die Dokumente des definierten Typs, die zur Produktvariante gehören, werden exportiert. Wenn es keine Dokumenten für die Variante gibt, werden Master-Dokumente für Produktvariante exportiert.

Wenn keine Logik  ausgewählt wird, werden aller Dokumente, die nur zur Variante gehören, exportiert.

Die Fallback-Logik für Variantendokumente berücksichtigt nicht, ob eine Sprache für das Dokument definiert ist oder nicht. Wenn es ein variantenspezifisches Dokument der angegebenen Art in einer beliebigen Sprache gibt, wird davon ausgegangen, dass die Variante ein variantenspezifisches Dokument hat, auch wenn die Sprache des Dokuments von der Exportsprache abweicht.

Zum Beispiel ist der Wert des Konfigurationsattributs:

{"preview":"variantOrMaster"}

Die Variante hat ein Vorschau-Dokument in'en-GB' und es gibt ein Master-Vorschau-Dokument ohne definierte Sprache. Beim Export für die "de-DE"-Sprache sieht die Fallback-Logik, dass die Variante das Vorschaudokument hat (wenn auch in einer anderen Sprache) und kein Masterdokument zugewiesen hat. Das Variantenvorschaubild in "en-GB" wird jedoch nicht exportiert, da es nicht dem Export-Sprachparameter "de-DE" entspricht.

Varianten-Preise

Sie können die Fallback-Logik für den Export der Varianten-Preisen mithilfe des Attributes jcatalog.product.price.useFallbackForVariant (boolean) konfigurieren. Wenn der Attributwert auf 'true' eingesetzt ist, wird die Produktvariante die Master-Produkt-Preise verwenden  (falls es keine Varianten-spezifisch Preise mit dem denselben Parametern: Kontrakt ID, Preistyp, Währung ID, Gültig von/bis gibt).