Fehlerbehebungsszenarien für SaaS Data Export
Auf dieser Seite werden Verhaltensweisen beschrieben, die Sie beim Arbeiten mit den SaaS Data Export beobachten können und die normalerweise durch eine falsche Konfiguration oder Interpretation von Synchronisierungsergebnissen verursacht werden. Verwenden Sie die folgenden Beschreibungen, um die Grundursache zu identifizieren und die entsprechende Lösung anzuwenden.
Konfigurierbares Produkt oder Bundle fehlt in Commerce-Services configurable-bundle-missing
Problem: Ein konfigurierbares oder gebündeltes Produkt hat den Status Aktiviert in Adobe Commerce, wird jedoch entweder nicht in der Storefront zurückgegeben oder in den SaaS-Services von Commerce mit dem Status Deaktiviert angezeigt.
Ursache: Der effektive Status von zusammengesetzten Produkten hängt vom Status ihrer untergeordneten Produkte ab, nicht nur vom Status des übergeordneten Produkts. Commerce SaaS-Services spiegeln diesen berechneten Status wider:
- Konfigurierbare Produkte - Es muss mindestens eine Produktvariante aktiviert sein.
- Bundle-: Für jede erforderliche Bundle-Option muss mindestens ein Produkt aktiviert sein.
Wenn diese Bedingungen nicht erfüllt sind, wird das übergeordnete Produkt als deaktiviert behandelt, selbst wenn sein eigener Status auf Aktiviert“.
Lösung:
- Stellen Sie bei konfigurierbaren Produkten sicher, dass mindestens eine zugehörige einfache Produktvariante aktiviert und der richtigen Website- und Store-Ansicht zugewiesen ist.
- Stellen Sie bei Bundle-Produkten sicher, dass jede erforderliche Bundle-Option über mindestens ein aktiviertes untergeordnetes Produkt verfügt. Eine erforderliche Option mit allen deaktivierten untergeordneten Elementen bewirkt, dass das gesamte Bundle als deaktiviert behandelt wird.
- Nachdem Sie die entsprechenden untergeordneten Produkte aktiviert haben, synchronisieren Sie den Trigger erneut oder warten Sie auf die nächste geplante Synchronisierung. Bestätigen Sie dann den aktualisierten Status in den Commerce SaaS-Services.
Preise werden nach Aktivierung der Katalogpreisregel nicht aktualisiert prices-not-updated
Problem: Nach der Aktivierung einer Katalogpreisregel mit der Funktion „Geplantes Update“ werden die Preise nicht aktualisiert. Die commerce-data-export.log zeigt synced: 0 für prices Feed an, nachdem geplante Aktualisierungen angewendet wurden.
Ursache: Es kann zu einer Wettlaufsituation zwischen Cron-Gruppen kommen, wenn geplante Updates für Katalogpreisregeln verwendet werden. Der catalog_data_exporter_product_prices Indexer kann ausgeführt werden, bevor seine Abhängigkeit, der catalogrule_product, den Neuaufbau abgeschlossen hat. Infolgedessen liest der Preisexporteur veraltete Daten und exportiert keine Änderungen.
Lösung:
Die sofortige Lösung für dieses Problem ist eine Problemumgehung: Konfigurieren Sie beide Cron-Gruppen so, dass sie sequenziell ausgeführt werden, um die Wettlaufbedingung zu beseitigen:
-
Navigieren Sie zu Stores > Configuration > Advanced > System > Cron (Scheduled Tasks).
-
Legen Sie Use Separate Process für beide auf No fest:
- Cron-Konfigurationsoptionen für Gruppe: index
- Cron-Konfigurationsoptionen für Gruppe: staging
-
Leeren Sie den Konfigurations-Cache nach dem Speichern.
Diskrepanz bei Katalogdaten zwischen Adobe Commerce und verbundenen Services catalog-data-discrepancy
Problem: Produktdaten, die in verbundenen Commerce-Services angezeigt werden (z. B. Live Search oder Product Recommendations), stimmen nicht mit den Katalogdaten in Adobe Commerce überein. Beispielsweise erscheint ein Produktname, ein Preis oder eine Beschreibung in der Storefront veraltet oder falsch.
Ursache: Nachdem eine Neusynchronisierung ausgelöst wurde, kann es bis zu einer Stunde dauern, bis die Daten aktualisiert und in Benutzeroberflächenkomponenten angezeigt werden. Wenn die Diskrepanz über dieses Fenster hinaus weiterhin besteht, wurde das Element möglicherweise bei der letzten Synchronisierung nicht aufgenommen oder die Synchronisierung hat keine Änderung erkannt, da die Feed-Daten bereits als „auf dem neuesten Stand“ markiert waren.
Lösung:
- Öffnen Sie in der Commerce-Storefront die Suchergebnisse. Wählen Sie dann das betreffende Produkt aus, um seine Detailansicht zu öffnen.
- Kopieren Sie die JSON-Ausgabe und überprüfen Sie, ob sie mit dem übereinstimmt, was Sie im Commerce Katalog haben.
- Wenn der Inhalt nicht übereinstimmt, nehmen Sie eine geringfügige Änderung am Produkt in Ihrem Katalog vor, z. B. das Hinzufügen eines Leerzeichens oder eines Punkts, um die Erkennung der Änderung zu erzwingen.
- Warten Sie auf eine Neusynchronisierung oder einen Trigger oder eine manuelle Neusynchronisierung der CLI oder Data Feed Sync Status Seite im Admin Console.
Weitere Informationen zur Fehlerbehebung bei Katalogdaten in Product Recommendations finden Sie unter Fehlerbehebung beim Modul „Produktempfehlungen in der Commerce Knowledge Base.
Datensynchronisation läuft nicht planmäßig sync-not-on-schedule
Problem: Die Datensynchronisation wird nicht planmäßig ausgeführt oder es werden trotz Produktänderungen in Adobe Commerce keine Elemente synchronisiert.
Ursache: Die häufigsten Ursachen sind Cron-Aufträge, die nicht ausgeführt werden, oder Indexer, die nicht im Update by Schedule konfiguriert sind.
Lösung:
- Bestätigen Sie, dass Cron-Aufträge ausgeführt werden.
- Stellen Sie sicher, dass die Indexer für die folgenden Feeds auf Update by Schedule eingestellt sind: Katalogattribute, Produkt, Produktüberschreibungen und Produktvariante. Führen Sie eine Überprüfung von Index Management in Commerce Admin durch oder verwenden Sie die CLI:
bin/magento indexer:show-mode | grep -i feed.
Katalogsynchronisierung hat den Status Fehlgeschlagen . catalog-sync-failed
Problem: Katalogsynchronisierung zeigt auf der Data Feed Sync Status den Status Fehlgeschlagen an.
Ursache: Während der Datenerfassungs- oder -übermittlungsphase ist ein nicht behebbarer Fehler aufgetreten. Häufige Ursachen sind Probleme bei der API-Authentifizierung, Netzwerkfehler oder Fehler bei der Datenvalidierung.
Lösung:
-
Überprüfen Sie die Fehlerprotokolle zu Datenexporten, um Details zum Fehler zu erhalten. Siehe Überprüfen von Protokollen und Fehlerbehebung für Protokollformat und erweiterte Protokollierungsoptionen:
var/log/commerce-data-export-errors.logauf Fehler bei der Datenerfassung.var/log/saas-export-errors.logauf Fehler bei der Datenübermittlung.
-
Wenn der Fehler nicht mit der Konfiguration oder einer Erweiterung eines Drittanbieters zusammenhängt, Sie ein Support-Ticket den entsprechenden Protokolleinträgen.
Protokoll zeigt Meldungen vom Typ „Vorgang übersprungen - Prozess gesperrt“ process-locked
Problem: Die commerce-data-export.log enthält Einträge, die den folgenden ähneln:
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
Ursache: Dies ist ein erwartetes Verhalten, kein Fehler. Die Meldung wird angezeigt, wenn eine durch Cron ausgelöste partielle Synchronisierung versucht, ausgeführt zu werden, während bereits eine vollständige Neuindizierung oder saas:resync ausgeführt wird. Die SaaS Data Export-Erweiterung verwendet einen Feed-Sperrmechanismus, um widersprüchliche gleichzeitige Synchronisierungsvorgänge zu verhindern.
Lösung:
Es ist keine Aktion erforderlich. Sobald der laufende Prozess abgeschlossen ist und die Sperre aufhebt, erfasst und synchronisiert die nächste Cron-Ausführung alle ausstehenden Änderungen. Einzelheiten zur Funktionsweise des Sperrmechanismus finden Sie unter Feed-Sperrmechanismus für SaaS-Datenexport.