Synchronisieren von Feeds mit der Commerce-CLI
Mit dem saas:resync-Befehl im magento/saas-export können Sie die Datensynchronisation für Adobe Commerce SaaS-Services verwalten.
saas:resync gilt auch für Adobe Commerce Optimizer Connector-Feeds wie products, categories und priceBooks. Unter Unterstützte Feeds finden Sie eine vollständige Liste der Connector-Feeds und Indexernamen.Es wird von Adobe nicht empfohlen, den Befehl saas:resync regelmäßig zu verwenden. Typische Szenarien für die Verwendung des Befehls sind:
- Erstsynchronisierung
- Synchronisieren von Daten mit einem neuen Datenraum nach Änderung der SaaS-Datenraum-ID
- Fehlerbehebung
Überwachen von Synchronisierungsvorgängen in der var/log/saas-export.log.
Erstsynchronisierung
aco:config:init die anfängliche vollständige Synchronisierung, indem alle Connector-Feed-Indexer ungültig gemacht werden. Siehe Aktivieren der Commerce Optimizer -Integration und Verwalten der Synchronisierung mit Commerce Optimizer.Beim Trigger eines saas:resync über die Befehlszeile kann es je nach Kataloggröße einige Minuten bis einige Stunden dauern, bis die Daten aktualisiert werden.
Die Feed-Synchronisierung kann in beliebiger Reihenfolge ausgeführt werden. Es gibt keine festen Abhängigkeiten zwischen ihnen. Die folgende Sequenz beginnt mit den Bereichsdaten , was ein logischer Ausgangspunkt ist, da Bereiche die Speicheransichten definieren, auf die andere Feeds verweisen.
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed productAttributes
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed products
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed productoverrides
Befehlsoptionen
Der saas:resync-Befehl unterstützt verschiedene Synchronisierungsvorgänge:
- Teilweise Synchronisierung nach SKU
- Unterbrochene Synchronisationen fortsetzen
- Daten ohne Synchronisierung validieren
Alle Befehlsoptionen und Flags anzeigen:
bin/magento saas:resync --help
In den folgenden Abschnitten finden Sie Optionsbeschreibungen mit Beispielen.
--feed
Erforderlich. Gibt die Feed-Entität an, die neu synchronisiert werden soll.
bin/magento saas:resync --help von Dokumenten - Befehlsoptionen und Flags. Es werden nicht alle in Ihrer Umgebung verfügbaren Feeds aufgelistet. Die vollständige Feed-Liste mit CLI-Feed-Namen, Indexer-IDs und Feed-Tabellen finden Sie unter Unterstützte Feeds.
productOverrides erfordert beispielsweise Adobe Commerce in der Cloud, On-Premise oder Commerce as a Cloud Service und orders das Modul „Kundenaufträge“.saas:resync übermittelt nur neue Elemente, aktualisierte Elemente und Elemente, die zuvor nicht exportiert werden konnten. Elemente, deren Inhaltshash seit dem letzten Export nicht geändert wurde, werden übersprungen.Beispiel:
bin/magento saas:resync --feed products
--by-ids
Bestimmte Entitäten anhand ihrer IDs teilweise neu synchronisieren. Unterstützt products-, productAttributes-, productOverrides-, inventoryStockStatus-, prices-, variants- und categoryPermissions.
Wenn Sie die Option “--by-ids” verwenden, geben Sie Werte standardmäßig mithilfe von Produkt-SKU-Werten an. Um stattdessen Produkt-IDs zu verwenden, fügen Sie die Option --id-type=productId hinzu.
--by-ids die Hash-Überprüfung und erzwingt, dass die angegebenen Entitäten an verbundene Commerce-Services gesendet werden, unabhängig davon, ob sich ihr Inhalt seit dem letzten Export geändert hat.Beispiele:
bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'
bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'
--cleanup-feed
Bereinigen Sie die Feed-Indexertabelle, bevor Sie Daten neu indizieren und an SaaS senden. Wird nur für products, productAttributes, productOverrides, inventoryStockStatus, prices, variants und categoryPermissions unterstützt.
Bei Verwendung mit der Option --dry-run führt der Vorgang einen Probelauf-Resynchronisierungsvorgang für alle Elemente durch.
cleanup-feed verwenden, wird der Status des lokalen Feed-Exports gelöscht und die Synchronisierung kann unvollständig sein. Zum Beispiel werden Entitätslöschungen in Adobe Commerce möglicherweise nicht in den verbundenen Commerce Services angezeigt oder veraltete Entitäten verbleiben möglicherweise in den Remote-Commerce Services-Indizes, auch wenn sie in Adobe Commerce gelöscht oder aktualisiert wurden. Verwenden Sie diese Option nur für vollständige Neuaufbauten der Umgebung, z. B. nach einer SaaS-Datenspeicherbereinigung.Beispiel:
bin/magento saas:resync --feed products --cleanup-feed
--continue-resync
Setzt einen unterbrochenen Resynchronisierungsvorgang fort. Wird nur für products-, productAttributes- und productOverrides-Feeds unterstützt.
Beispiel:
bin/magento saas:resync --feed productAttributes --continue-resync
--dry-run
Führt den Feed-Neuindizierungsprozess aus, ohne den Feed an SaaS zu senden und ohne in der Feed-Tabelle zu speichern. Diese Option ist nützlich, um Probleme mit Ihrem Datensatz zu identifizieren.
Fügen Sie die Umgebungsvariable EXPORTER_EXTENDED_LOG=1 hinzu, um die Payload in var/log/saas-export.log zu speichern.
Beispiel:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run
Testen spezifischer Feed-Elemente
Testen Sie bestimmte Feed-Elemente, indem Sie die Option --by-ids mit der erweiterten Protokollsammlung hinzufügen, um die generierte Payload in der var/log/saas-export.log-Datei anzuzeigen.
Beispiel:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'
Alle Feed-Elemente testen
Standardmäßig enthält der während eines resync --dry-run gesendete Feed nur neue Elemente oder Elemente, die zuvor nicht exportiert werden konnten. Um alle Elemente in den zu verarbeitenden Feed einzubeziehen, verwenden Sie die Option --cleanup-feed .
Beispiel:
bin/magento saas:resync --feed products --dry-run --cleanup-feed
--no-reindex
Sendet vorhandene Katalogdaten ohne Neuindizierung erneut an Commerce Services. Wird für produktbezogene Feeds nicht unterstützt.
Das Verhalten variiert je Exportmodus:
- Legacy-Modus: Setzt alle Daten erneut ab, ohne sie zu kürzen.
- Sofortiger Modus: Option wird ignoriert, nur Aktualisierungen/Fehler werden synchronisiert.
Beispiel:
bin/magento saas:resync --feed productAttributes --no-reindex