Überblick
Diese Seite führt von einem Symptom zu Ursache und Lösung, für den Produkt-Export ab Version 12.7.0 des Bundles und den Produkt-Import ab Version 3.0.0 des Plugins. Das Verhalten im Detail beschreiben die Seiten "Produkt-Export: FAQ", "Produkt-Import: FAQ" und "Frequently Asked Questions".
Meldungen sind im Originalwortlaut angegeben. Die Meldungen des Imports stehen im Journal (.done) und im Importbericht per Mail (siehe "Was zeigt das Journal?"), <id> steht für die Pimcore-ID des Eintrags.
Export in Pimcore
Die Exportdateien sind sehr groß
| Ursache | Lösung |
|---|
Es werden viele Sprachen exportiert. Ohne supported_languages exportieren die Produkt-Adapter alle in Pimcore aktivierten Sprachen, die nicht in disabled_languages stehen | Sprachen je Zielsystem mit supported_languages begrenzen, angegeben als Pimcore-Sprachen (z.B. de, en). language_mapping legt nur die Shopware-Locale fest und begrenzt keine Sprachen (siehe "Sprachen-Mapping konfigurieren" und "Wie exportiere ich nur bestimmte Sprachen?") |
| Lokalisierte Felder liefern im Export ihre Fallback-Werte. Sprachen ohne eigenen Wert enthalten daher die Texte der Fallback-Sprache, z.B. vollständige Beschreibungen | Nicht benötigte Sprachen über supported_languages ausschließen |
supported_languages wirkt nur auf Produkt-Adapter (ProductAdapterAbstract). Andere Adapter, die z.B. translationHelper()->mapTranslations() verwenden, exportieren alle aktivierten Sprachen | Sprachen für alle Zielsysteme über disabled_languages ausschließen (siehe "Sprachen deaktivieren") |
Es wurde ein vollständiger Export erzeugt (Dateiname <Zielsystem>-full-<Datum>.json), über die Option "Vollständige Daten exportieren (Kein Delta)" bzw. --skip-delta. Für Zielsysteme mit has_delta_management: false führt die Warteschlange jeden Export vollständig aus | Delta-Export verwenden (Dateiname <Zielsystem>-delta-<Datum>.json) und has_delta_management des Zielsystems prüfen (siehe "Zielsysteme konfigurieren") |
Der Delta-Export vergleicht nur mit Exporten im Status "Erfolgreich". Diesen Status setzt Pimcore, wenn es die .done-Datei mit der Resolution success verarbeitet hat. Bis dahin enthält jeder Delta-Export alle Änderungen seit dem letzten erfolgreichen Export | Siehe "Der Importbericht kommt nicht an" |
buildProduct() liefert bei jedem Lauf andere Werte, die Einträge gelten immer als geändert | Siehe "Ein Produkt wird bei jedem Delta-Export übertragen" |
| Varianten sind Teil des Eintrags ihres Hauptprodukts. Ändert sich eine Variante, wird das Hauptprodukt inkl. aller Varianten übertragen | Erwartetes Verhalten (siehe "Wie erkennt der Delta-Export Änderungen?") |
Ein vollst ändiger Export enthält im Package cross-selling das Cross-Selling aller Produkte, ein Delta-Export nur das der exportierten Produkte | Delta-Export verwenden (siehe "Delta-Export") |
Der Export wurde per CLI mit --pretty erzeugt | --pretty nur zur Analyse verwenden, Exporte über die Warteschlange werden nicht formatiert |
Abhängige Adapter werden automatisch mitexportiert, der Produkt-Adapter z.B. mit den Adaptern attributes und attribute-values, sofern diese registriert sind | Erwartetes Verhalten (siehe "Abhängigkeiten zwischen Export-Adaptern") |
Der Export bricht mit "Unknown key" ab
Unknown key "<Schlüssel>" in the product entry of object <ID> (<Adapter>). Return [...parent::getAllowedProductKeys(), '<Schlüssel>'] from getAllowedProductKeys() to allow it or null to disable the check
| Ursache | Lösung |
|---|
Tippfehler oder Schlüssel in camelCase (productNumber) in buildProduct() | Schlüssel korrigieren (siehe "Export-JSON-Vertrag") |
| Eigener Schlüssel, z.B. für ein eigenes Produkt-Modul | getAllowedProductKeys() bzw. getAllowedTranslationKeys() erweitern oder null liefern (siehe "Warum bricht der Export mit "Unknown key" ab?") |
translations.<locale> ist kein Array (The translation "translations.<locale>" of object <ID> (<Adapter>) must be an array) | Übersetzungen über prepareTranslations() aufbauen |
Die ExportException bricht den gesamten Export-Lauf ab und erscheint im Exportbericht. Für ein einzelnes Objekt gibt twocream:shopware-connector:preview-product die Meldung ohne Stacktrace aus (siehe "Produkt prüfen").
Der Export startet nicht oder schlägt fehl
| Ursache | Lösung |
|---|
Die Warteschlange wird nicht abgearbeitet. Exporte aus der Admin-Oberfläche führt twocream:shopware-connector:queue aus | CronJob * * * * * php /var/www/html/bin/console twocream:shopware-connector:queue einrichten (siehe "Queue System") |
| Der Export ist für einen späteren Zeitpunkt eingeplant | Der Export startet beim ersten Lauf der Warteschlange nach dem eingeplanten Zeitpunkt |
Ein anderer Export läuft (The command is already running.) | Der Export bleibt in der Warteschlange und wird bei einem späteren Lauf ausgeführt |
Das Export-Verzeichnis ist kein absoluter Pfad oder existiert nicht (Target directory needs to be an absolute path (Path: "…"), Target directory needs to exist (Path: "…")) | export_directory des Zielsystems korrigieren bzw. das Verzeichnis anlegen |
buildProduct() wirft eine Exception | Betroffenes Objekt mit preview-product prüfen (siehe "Produkt prüfen") |
Eine Sprache fehlt im Export
| Ursache | Lösung |
|---|
Die Pimcore-Sprache steht nicht in supported_languages des Zielsystems, ist nicht aktiviert oder steht in disabled_languages | Konfiguration prüfen (siehe "Warum fehlt eine Sprache im Export?") |
supported_languages enthält Shopware-Locales (z.B. de_DE) oder Tippfehler. Enthält die Liste keine aktivierte Pimcore-Sprache, haben die Einträge keine Übersetzungen und Shopware überspringt einfache Produkte und Hauptprodukte | Pimcore-Sprachen angeben. preview-product warnt mit The supported languages "<Sprachen>" are no enabled Pimcore languages and are not exported bzw. No supported language is enabled in Pimcore, the product has no translations |
Die Callback-Funktion von prepareTranslations() liefert für die Sprache null | Callback-Funktion prüfen, sie erhält die Pimcore-Sprache (z.B. de) |
Ein Delta-Export enthält eine Änderung nicht
| Ursache | Lösung |
|---|
Die Änderung wirkt sich nicht auf das Ergebnis von buildProduct() aus. Der Delta-Export vergleicht eine Prüfsumme des Eintrags, nicht das Änderungsdatum des Objekts | Wert in buildProduct() liefern, Ergebnis mit preview-product prüfen (siehe "Wie erkennt der Delta-Export Änderungen?") |
Nur das Cross-Selling hat sich geändert und buildProduct() liefert kein cross-selling-checksum | 'cross-selling-checksum' => $this->getCrossSellingChecksum($product) liefern |
Das Objekt liegt nicht unterhalb der source_folder_ids des Adapters oder wird in prepareListingConditions() ausgeschlossen | Konfiguration des Adapters prüfen (siehe "Adapter konfigurieren") |
| Shopware soll den Stand von Pimcore vollständig erhalten, z.B. nach übersprungenen Batches | Vollständigen Export ausführen: Option "Vollständige Daten exportieren (Kein Delta)" bzw. --skip-delta (siehe "Befehle") |
Ein Produkt wird bei jedem Delta-Export übertragen
| Ursache | Lösung |
|---|
buildProduct() liefert je Lauf andere Werte, z.B. einen Zeitstempel oder eine wechselnde Reihenfolge von Relationen | Werte bei unveränderten Daten identisch liefern (siehe "Warum wird ein Produkt bei jedem Delta-Export übertragen?") |
| Der Import meldet für den Eintrag eine Warnung oder einen Fehler. Pimcore entfernt die Prüfsumme solcher Einträge, damit die Meldung beim nächsten Export erneut erscheint | Ursache der Meldung im Journal beheben, z.B. einen zu langen Text oder ein unbekanntes Zusatzfeld |
| Der vorherige Export hat nicht den Status "Erfolgreich" | Siehe "Der Importbericht kommt nicht an" |
Das Cross-Selling fehlt im Export
| Ursache | Lösung |
|---|
Der Adapter verwendet den CrossSellingTrait, implementiert aber nicht das CrossSellingProviderInterface | Interface implementieren |
buildProduct() ruft weder getCrossSellingChecksum() noch prepareCrossSelling() auf | 'cross-selling-checksum' => $this->getCrossSellingChecksum($product) liefern |
| Delta-Export: Das Package enthält nur das Cross-Selling der in diesem Lauf exportierten Produkte inkl. ihrer Varianten, für gelöschte Produkte nie | Erwartetes Verhalten, für das Cross-Selling aller Produkte einen vollständigen Export ausführen |
Siehe "Warum fehlt das Cross-Selling im Export?" und "Schritt 8: Cross-Selling".
Varianten werden doppelt exportiert
Varianten-Objekte sind Teil des Listings und erscheinen als eigener Eintrag und zusätzlich in variants ihres Hauptprodukts. Varianten über prepareListingConditions() aus dem Listing ausschließen (siehe "Warum werden Varianten doppelt exportiert?").
Assets fehlen im Asset-Verzeichnis
| Ursache | Lösung |
|---|
transfer > adapter ist pimcore_asset und asset_transfer ist nicht konfiguriert. Die Assets werden dann ebenfalls über den PimcoreAssetTransferAdapter abgelegt, der dafür nicht geeignet ist | asset_transfer mit einem eigenen Adapter konfigurieren, z.B. nfs (siehe "JSON-Dateien und Assets") |
Das Asset wurde für das Zielsystem bereits kopiert. Das Bundle vermerkt kopierte Assets in der Tabelle twocream_asset_export_journal und kopiert ein Asset erst nach einer Änderung (Änderungsdatum) erneut, auch wenn die Datei im Ziel fehlt | Asset in Pimcore erneut speichern oder die Einträge des Assets aus twocream_asset_export_journal entfernen |
Die Datei konnte nicht kopiert werden, der Exportbericht meldet z.B. Asset <Pfad> could not be copied to the asset directory | Quelldatei in Pimcore sowie asset_directory und dessen Schreibrechte prüfen |
Übertragung
Die Exportdatei wird in Shopware nicht importiert
| Ursache | Lösung |
|---|
Der Messenger-Transport json wird nicht konsumiert | CronJob messenger:consume json einrichten (siehe "Messenger-Transport") |
Die Datei liegt nicht im Import-Verzeichnis von Shopware. Shopware sucht *.json nur direkt im Import-Verzeichnis, nicht in Unterverzeichnissen | Import-Verzeichnis (siehe "Konfiguration") mit export_directory und dem Directory-Resolver des Zielsystems abgleichen (siehe "Ablageverzeichnisse über ein Directory-Resolver bestimmen") |
| Die Datei ist jünger als 30 Sekunden | Außer in der Umgebung dev werden Dateien erst nach 30 Sekunden verarbeitet |
Der Worker meldet Import directory is not configured. Did you forget the plugin configuration? bzw. Directory is not writable: "<Pfad>" | Import-Verzeichnis konfigurieren bzw. Schreibrechte setzen |
Zum Testen kann eine einzelne Datei mit php bin/console twocream:json:import <file> importiert werden (siehe "Befehle").
Die Datei bleibt als .work-Datei liegen
Shopware benennt die Datei vor dem Import in .work um und schreibt nach dem Import die .done-Datei. Bleibt eine .work-Datei ohne .done-Datei liegen, nachdem der Import beendet ist, wurde der Worker während des Imports abgebrochen (z.B. durch das Speicherlimit). Die Datei wird nicht erneut verarbeitet, da Shopware nur *.json aufgreift.
Ursache im Log des Workers prüfen und die Datei in .json umbenennen oder den Export erneut ausführen. Da der Export nicht den Status "Erfolgreich" erhält, enthält ein Delta-Export die Änderungen seit dem letzten erfolgreichen Export erneut.
Der Importbericht kommt nicht an
Bis Pimcore die .done-Datei verarbeitet hat, bleibt der Export im Status "Exportiert" und der Delta-Export vergleicht weiterhin mit dem letzten erfolgreichen Export.
| Ursache | Lösung |
|---|
Pimcore verarbeitet .done-Dateien beim Lauf von twocream:shopware-connector:queue | CronJob der Warteschlange einrichten (siehe "Queue System") |
Die .done-Datei ist jünger als 60 Sekunden | Außer in den Umgebungen dev und development werden .done-Dateien erst nach 60 Sekunden verarbeitet |
Die .done-Datei liegt nicht in einem Verzeichnis, das Pimcore durchsucht (resolveDoneDirectories() des Directory-Resolvers, standardmäßig export_directory) | Import-Verzeichnis von Shopware und export_directory auf dasselbe Verzeichnis ausrichten |
Nach der Verarbeitung erhält der Export bei der Resolution success den Status "Erfolgreich", sonst "Fehlgeschlagen".
Import in Shopware
Der Import bricht mit "Detected unknown package" ab
Für ein Package der Datei ist kein Modul registriert, z.B. Detected unknown package "products". Die Datei endet mit der Resolution error, die folgenden Packages werden nicht importiert.
| Ursache | Lösung |
|---|
Das ProductModule wird vom Plugin nicht registriert | Das Modul oder eine Ableitung mit dem Service-Tag twocream_json_importer.module registrieren (siehe "Produkt-Modul registrieren") |
| Für ein eigenes Package fehlt das Modul | Modul registrieren (siehe "Das Modul registrieren") |
Ein eigenes Import-Modul wird ignoriert
| Ursache | Lösung |
|---|
Die Ableitung eines Moduls, das das Plugin registriert (PropertyGroupModule, PropertyGroupOptionModule, CrossSellingModule, CategoryAssignmentModule), ist zusätzlich mit dem Service-Tag registriert. Es wird das erste Modul eines Packages verwendet | Ableitung als Decorator (decorates) ohne eigenen Tag registrieren (siehe "Ein Modul des Plugins ersetzen") |
Für das Package products sind mehrere Module registriert | Nur ein Modul registrieren |
Ein Produkt fehlt in Shopware
| Meldung bzw. Ursache | Lösung |
|---|
Field "<field>" is not valid in record <id> | Pflichtdaten liefern (siehe "Welche Daten sind Pflicht?") |
Product has no translations (ID: "<id>") | Übersetzungen liefern, supported_languages prüfen (siehe "Eine Sprache fehlt im Export") |
Product skipped because a new product needs a name in the system language (ID: "<id>") | Namen in der Systemsprache liefern und die Locale-Schlüssel prüfen (siehe "Welche Locales werden akzeptiert?") |
Tax rate can not be detected (ID: "<id>", Tax: "<tax>") | Steuersatz in Shopware anlegen, der Import legt keine Steuern an |
… is already used in Shopware by product <id> (UUID: "…") bzw. … is already used by record <id> in this import file | Produktnummer in Shopware freigeben oder im Quellsystem korrigieren (siehe "Was passiert, wenn die Produktnummer in Shopware bereits einem anderen Produkt gehört?") |
Product is a represent but has no valid variant (ID: "<id>") | Varianten prüfen oder getVariants() null liefern lassen, damit das Produkt als einfaches Produkt exportiert wird |
Batch was skipped because it could not be written, affected records: … | Siehe "Die Datei endet mit success, aber Daten fehlen" |
Keine Meldung, der Eintrag ist nicht in der Datei: Das Objekt liegt nicht unterhalb der source_folder_ids, ist unveröffentlicht, isExportable() liefert false oder es ist seit dem letzten erfolgreichen Delta-Export unverändert | Objekt mit preview-product prüfen (siehe "Produkt prüfen") |
Die Datei endet mit success, aber Daten fehlen
Übersprungene Einträge und Batches ändern die Resolution nicht, sie stehen nur als Warnung bzw. Fehler im Journal (siehe "Welche Resolution hat eine Datei mit übersprungenen Einträgen?"). Für die Überwachung sind die Meldungen auszuwerten.
| Meldung | Lösung |
|---|
WARNING je Eintrag, z.B. Field "<field>" is not valid in record <id> | Siehe "Ein Produkt fehlt in Shopware" |
Batch was skipped because it could not be written, affected records: … Cause: … | Der Batch (getBatchSize(), standardmäßig 75 Hauptprodukte inkl. Varianten) wurde vollständig zurückgerollt. Die Ursache nennt Eintrag und Feld. Daten im Quellsystem korrigieren und die genannten Einträge erneut exportieren (siehe "Was passiert, wenn ein Batch nicht geschrieben werden kann?") |
Das Journal meldet "Batch was written, but post-processing failed"
Die Daten sind in Shopware geschrieben, danach hat ein Listener des Schreib-Events eine Exception geworfen (z.B. ein Subscriber eines anderen Plugins). Ursache aus der Meldung beheben, ggf. mit dal:refresh:index neu indexieren (siehe "Was bedeutet "Batch was written, but post-processing failed"?").
Ein Wert wird nicht in Shopware geschrieben
| Meldung bzw. Ursache | Lösung |
|---|
| Der Schlüssel fehlt im Eintrag, ein einfacher Schlüssel behält dann seinen bisherigen Wert | Schlüssel liefern, null schreibt einen leeren Wert (siehe "Was ist der Unterschied zwischen einem fehlenden Schlüssel und null?") |
Custom field "<Pfad>/<Name>" is not available for products in Shopware, it is not written … | Der Name muss ein aktives Zusatzfeld eines Sets sein, das Produkten zugeordnet ist (siehe "Was passiert mit einem unbekannten Zusatzfeld oder einem ungültigen Wert?") |
Custom field "<Pfad>/<Name>" was not written because value … is not valid for the type "<Typ>" … | Wert passend zum Typ liefern, bei select nennt die Meldung die Optionen |
| Ungültige Zahl, Wahrheitswert oder Datum, die Warnung nennt das Feld | Wert korrigieren, der bisherige Wert bleibt erhalten (siehe "Angepasste und nicht geschriebene Werte") |
Field "<field>" was truncated to <n> characters (length: <m>) | Der Text ist länger als das Shopware-Feld und wurde gekürzt |
Übersetzungsschlüssel ist nicht in getProductTranslationKeyMap() enthalten | Schlüssel im Produkt-Modul ergänzen (siehe "Warum wird ein Übersetzungsschlüssel nicht in Shopware geschrieben?") |
| Schlüssel der Produkt-Extension ist nicht gemappt | Siehe "Warum wird keine Produkt-Extension geschrieben?" |
Canonical product "<uuid>" is deactivated in this import, field is not written … bzw. … is neither available in Shopware nor written in this import, field is not written … bzw. … is the product itself, field is not written … | Ein Canonical-Produkt muss in Shopware existieren oder im Import geschrieben werden, darf nicht das Produkt selbst sein und nicht von diesem Import deaktiviert werden (siehe "Wie wird das Canonical-Produkt geliefert?") |
CMS page "<uuid>" is not a product page layout (type: "<Typ>"), field is not written … bzw. CMS page … is not available in Shopware, field is not written … | UUID eines bestehenden CMS-Layouts vom Typ product_detail liefern (siehe "Wie werden das CMS-Layout und das Feature-Set geliefert?") |
Feature set … is not available in Shopware, field is not written … | UUID eines bestehenden Feature-Sets liefern |
Purchase price … is not valid (net and gross numeric, not negative), field is not written … | purchase-price als {net, gross} mit numerischen, nicht negativen Werten liefern |
Field "variant-listing-config" is only supported for main products, it is not written … bzw. Main variant … is not a valid variant of this product in this import, it is not set … | variant-listing-config nur bei Hauptprodukten liefern, die Hauptvariante muss eine gültige Variante des Eintrags sein (siehe "Wie wird die Variantenliste konfiguriert?") |
Der Import dauert lange
| Ursache | Lösung |
|---|
| Es werden vollständige Exporte importiert | Delta-Export verwenden (siehe "Die Exportdateien sind sehr groß") |
| Viele Batches schlagen fehl. Nach jedem fehlgeschlagenen Batch werden die zwischengespeicherten IDs neu geladen | Ursachen der Fehler beheben (siehe "Ist der Import für große Kataloge geeignet?") |
Nach jeder Datei führt der Import cache:clear aus, sofern kein Modul der Datei das SkipCacheClearInterface implementiert | Module, nach deren Import der Cache nicht geleert werden muss, mit Twocream\JsonImporter\Core\System\Import\Interface\SkipCacheClearInterface kennzeichnen |
| Die Batch-Größe passt nicht zum Katalog | getBatchSize() (Standard 75) im Produkt-Modul überschreiben |
Ergebnis im Shop
Ein Produkt ist im Shop nicht sichtbar oder hat keine Regel-Preise
Eine Sprache fehlt im Shop
| Ursache | Lösung |
|---|
| Die Sprache fehlt bereits im Export | Siehe "Eine Sprache fehlt im Export" |
Die Pimcore-Sprache hat keinen Eintrag in language_mapping und wird unter ihrem Pimcore-Schlüssel exportiert (z.B. fr). Shopware ordnet standardmäßig nur de => de_DE und en => en_GB zu, andere Schlüssel ohne passende Shopware-Sprache werden ignoriert | language_mapping ergänzen, z.B. fr: 'fr_FR' (siehe "Sprachen-Mapping konfigurieren") oder das Mapping über den LocaleMappingEvent anpassen |
Die Locale passt nicht zur Sprache in Shopware, z.B. wird en als en_GB geliefert, die Shopware-Sprache verwendet aber en-US. Shopware vergleicht mit dem Übersetzungscode der Sprache (Bindestrich als Unterstrich) | Locale in language_mapping an die Shopware-Sprache anpassen, z.B. en: 'en_US' |
Der Locale-Schlüssel enthält einen Bindestrich (z.B. de-DE) und wird ignoriert | Locale mit Unterstrich liefern (siehe "Welche Locales werden akzeptiert?") |
Eigenschaften, Sichtbarkeiten oder Regel-Preise wurden entfernt
Shopware bringt properties, visibilities, prices und bei Varianten options bei jeder Lieferung exakt auf den Stand der Datei, das Quellsystem ist führend.
| Ursache | Lösung |
|---|
Der Schlüssel fehlt oder ist [], alle bestehenden Relationen dieser Art werden entfernt | Relationen bei jeder Lieferung vollständig liefern und ausschließlich in Pimcore pflegen (siehe "Wann werden Relationen in Shopware bereinigt?") |
| Ein Markt oder eine Regel kann nicht aufgelöst werden, bestehende Einträge außerhalb der aufgelösten Menge werden trotzdem entfernt | Hooks getSalesChannelIdByMarket() und getRuleIdByMarket() prüfen |
| Eine Variante ohne diese Schlüssel verliert ihre eigenen Einträge und erbt die Werte des Hauptprodukts | Eigene Relationen der Variante liefern (siehe "Was passiert, wenn visibilities, properties oder prices fehlen?") |
Produkte werden unerwartet deaktiviert oder aktiviert
Eine Variante erbt einen Wert nicht oder ungewollt
| Ursache | Lösung |
|---|
| Der Schlüssel fehlt für die Variante, ein fehlender Schlüssel behält den bisherigen Wert der Variante | Für die Variante null liefern, z.B. 'tax' => $mainProduct ? null : 19 |
Die Variante liefert null und erbt dadurch den Wert des Hauptprodukts | Eigenen Wert der Variante liefern |
Die Variante liefert keine translations und behält ihre bisherigen Namen | translations immer liefern, name: null erbt den Namen des Hauptprodukts |
Siehe "Wie erbt eine Variante einen Wert ihres Hauptprodukts?" und "Was erben Varianten vom Hauptprodukt?".
Ein Produkt fehlt in einer Kategorie
| Meldung bzw. Ursache | Lösung |
|---|
Keine Kategorie in Shopware besitzt in twocream_category_extension den gelieferten identifier, oder sie liegt außerhalb von getRootCategoryId() | Identifier in Pimcore (getCategoryIdentifier()) und Shopware abgleichen (siehe "Kategoriezuordnungen") |
| Der Identifier des Kategorie-Objekts ist leer, das Objekt wird als gelöscht übertragen | Identifier pflegen (siehe "Schritt 9: Kategoriezuordnungen") |
Product is not available in Shopware (ID: "<id>") | Das Produkt existiert nicht in Shopware, z.B. weil es übersprungen wurde (siehe "Ein Produkt fehlt in Shopware") |