DocumentazioneCommerceGuida di Data Export per i servizi SaaS

Sincronizzare i feed utilizzando Commerce CLI

Ultimo aggiornamento: 6 maggio 2025
  • Argomenti:

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

NOTE
La sincronizzazione iniziale viene eseguita automaticamente quando sono abilitati Live Search o Product Recommendations. I comandi manuali non sono necessari.

Quando si attiva un 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 Systems consiglia di eseguire i comandi nell'ordine seguente:

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

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

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

IMPORTANT
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 feed senza inviare il feed a SaaS e senza salvare nella tabella feed. Questa opzione è utile per identificare eventuali problemi con il set di dati.

Aggiungi la variabile di ambiente in cui salvare il EXPORTER_EXTENDED_LOG=1 payload 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
  • inventoryStockStatus
  • orders
  • prices
  • products
  • productAttributes
  • productOverrides
  • scopesWebsite
  • scopesCustomerGroup
  • variants

Esempio:

bin/magento saas:resync --feed products

--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 di nuovo tutti i dati senza troncare.
  • Modalità immediata: l'opzione viene ignorata, sincronizza solo gli aggiornamenti/errori.

Esempio:

bin/magento saas:resync --feed productAttributes --no-reindex

--id-type=ProductId

Per impostazione predefinita, le entità specificate quando si utilizza il saas:resync feed comando con l'opzione --by-ids sono specificate dal referenza di magazzino di prodotto. Utilizzare l'opzione --id-type=ProductId per specificare le entità in base all'ID prodotto.

bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'

Esempio:

Risoluzione dei problemi

Se non vengono visualizzati i dati previsti nei servizi Commerce connessi, risolvere i problemi verificando i registri degli errori di esportazione dei dati e utilizzando il comando saas:resync con variabili di ambiente per rivedere i payload e i dati del profiler. Consulta Esaminare i registri e risolvere i problemi.

recommendation-more-help
84c95778-e795-4ef1-8b7e-54d73e45e22d