Sincronizzare i feed utilizzando Commerce CLI

Ultimo aggiornamento: 20 agosto 2025

Creato per:

  • Amministratore

Il comando saas:resync nel pacchetto magento/saas-export consente di gestire la sincronizzazione dei dati per i servizi SaaS di Adobe Commerce.

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

NOTA
La sincronizzazione iniziale viene eseguita automaticamente quando sono abilitati Live Search o Product Recommendations. Non sono necessari comandi manuali.

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.

Per la sincronizzazione iniziale, Adobe consiglia di eseguire i comandi nel seguente ordine:

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

Sincronizza con i comandi CLI

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 disponibili:

bin/magento saas:resync --help

Per la descrizione delle opzioni con esempi, consulta le sezioni seguenti.

NOTA
Per le opzioni avanzate per gestire l'elaborazione dell'esportazione, vedere Personalizzare l'elaborazione dell'esportazione.

--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.

IMPORTANTE
Usare solo dopo la pulizia dell'ambiente o con l'opzione --dry-run. Se utilizzata in altri casi, l’operazione di pulizia può causare la perdita di dati e problemi di sincronizzazione dei dati.

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

--feed

Obbligatorio. Specifica l'entità feed da risincronizzare.

Feed disponibili:

  • categories
  • categoryPermissions
  • orders
  • prices
  • products
  • productAttributes
  • productOverrides
  • scopesWebsite
  • scopesCustomerGroup
  • variants
NOTA
I feed disponibili nell’ambiente potrebbero essere diversi a seconda dei moduli installati nell’ambiente Adobe Commerce.

Esempio:

bin/magento saas:resync --feed products