Sincronizzare i feed utilizzando Commerce CLI
Il comando saas:resync nel pacchetto magento/saas-export consente di gestire la sincronizzazione dei dati per i servizi SaaS Adobe Commerce.
saas:resync si applica anche a Adobe Commerce Optimizer Connector feed come products, categories e priceBooks. Per l'elenco completo dei feed dei connettori e dei nomi degli indicizzatori, vedere Feed supportati.Adobe sconsiglia di utilizzare il comando saas:resync regolarmente. Gli scenari tipici per l’utilizzo del comando sono:
- Sincronizzazione iniziale
- Sincronizza i dati con un nuovo spazio dati dopo aver modificato l’ID spazio dati SaaS
- Risoluzione dei problemi
Monitorare le operazioni di sincronizzazione nel file var/log/saas-export.log.
Sincronizzazione iniziale
aco:config:init pianifica la sincronizzazione completa iniziale invalidando tutti gli indicizzatori del feed del connettore. Vedi Abilitare l'integrazione Commerce Optimizer e Gestire la sincronizzazione in Commerce Optimizer.Quando si attiva saas:resync dalla riga di comando, a seconda delle dimensioni del catalogo, l’aggiornamento dei dati può richiedere da alcuni minuti ad alcune ore.
Le sincronizzazioni dei feed possono essere eseguite in qualsiasi ordine, non esistono dipendenze rigide tra di esse. La sequenza seguente inizia con i dati di ambito, che è un punto di partenza logico poiché gli ambiti definiscono le viste archivio a cui fanno riferimento gli altri feed.
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
Opzioni di comando
Il comando saas:resync supporta diverse operazioni di sincronizzazione:
- Sincronizzazione parziale con SKU
- Riprendi sincronizzazioni interrotte
- Convalida dei dati senza sincronizzazione
Visualizza tutte le opzioni di comando e i flag:
bin/magento saas:resync --help
Per la descrizione delle opzioni con esempi, consulta le sezioni seguenti.
--feed
Obbligatorio. Specifica l’entità feed da risincronizzare.
bin/magento saas:resync --help documenta le opzioni e i flag del comando. Non elenca tutti i feed disponibili nell’ambiente. Per l’elenco completo dei feed con nomi di feed CLI, ID di indicizzatore e tabelle di feed, vedere Feed supportati.
productOverrides richiede ad esempio Adobe Commerce nel cloud, nei locali o Commerce as a Cloud Service e orders richiede il modulo Ordini di vendita.Esempio:
bin/magento saas:resync --feed products
--by-ids
Risincronizza parzialmente entità specifiche in base ai loro ID. Supporta products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions feed.
Per impostazione predefinita, quando si utilizza l’opzione --by-ids si specificano valori utilizzando i valori SKU del prodotto. Per utilizzare gli ID prodotto, aggiungere l’opzione --id-type=productId.
Esempi:
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
Pulisci la tabella dell’indicizzatore del feed prima della reindicizzazione e dell’invio dei dati a SaaS. Supportato solo per products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.
Se utilizzata con l’opzione --dry-run, l’operazione esegue un’operazione di risincronizzazione a secco per tutti gli elementi.
cleanup-feed cancella lo stato di esportazione del feed locale e può causare una sincronizzazione incompleta. È possibile, ad esempio, che le eliminazioni di entità in Adobe Commerce non vengano applicate ai servizi Commerce connessi o che entità non aggiornate rimangano negli indici remoti di Commerce Services anche se sono state eliminate o aggiornate in Adobe Commerce. Utilizza questa opzione solo per le ricompilazioni complete dell’ambiente, ad esempio dopo una pulizia dello spazio dati SaaS.Esempio:
bin/magento saas:resync --feed products --cleanup-feed
--continue-resync
Riprende un’operazione di risincronizzazione interrotta. Supportato solo per products, productAttributes e productOverrides feed.
Esempio:
bin/magento saas:resync --feed productAttributes --continue-resync
--dry-run
Esegue il processo di reindicizzazione del feed senza inviare il feed a SaaS e senza salvarlo nella tabella del feed. Questa opzione è utile per identificare eventuali problemi con il set di dati.
Aggiungi la variabile di ambiente EXPORTER_EXTENDED_LOG=1 per salvare il payload in var/log/saas-export.log.
Esempio:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run
Verifica elementi di feed specifici
Verificare elementi di feed specifici aggiungendo l’opzione --by-ids con la raccolta di registri estesi per visualizzare il payload generato nel file var/log/saas-export.log.
Esempio:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'
Test di tutti gli elementi feed
Per impostazione predefinita, il feed inviato durante un’operazione resync --dry-run include solo i nuovi elementi o gli elementi che non è stato possibile esportare in precedenza. Per includere tutti gli elementi nel feed da elaborare, utilizzare l’opzione --cleanup-feed.
Esempio:
bin/magento saas:resync --feed products --dry-run --cleanup-feed
--no-reindex
Invia nuovamente i dati del catalogo esistenti a Commerce Services senza reindicizzazione. Non supportato per feed relativi a prodotti.
Il comportamento varia in base alla modalità di esportazione:
- Modalità legacy: invia nuovamente tutti i dati senza troncarli.
- Modalità immediata: l’opzione viene ignorata, sincronizza solo gli aggiornamenti/errori.
Esempio:
bin/magento saas:resync --feed productAttributes --no-reindex