Risoluzione dei problemi relativi a SaaS Data Export
In questa pagina sono descritti i comportamenti che è possibile osservare durante l’utilizzo di SaaS Data Export che sono in genere causati da una configurazione errata o da un’interpretazione errata dei risultati di sincronizzazione. Utilizza le descrizioni di seguito per identificare la causa principale e applicare la risoluzione appropriata.
Prodotto configurabile o in bundle mancante nei servizi Commerce configurable-bundle-missing
Problema: un prodotto configurabile o bundle ha lo stato Enabled in Adobe Commerce ma non è restituito nella vetrina o viene visualizzato con lo stato Disabled nei servizi SaaS di Commerce.
Causa: lo stato effettivo dei prodotti compositi dipende dallo stato dei prodotti secondari e non solo dallo stato del prodotto principale. I servizi SaaS di Commerce riflettono questo stato calcolato:
- Prodotti configurabili - almeno una variante di prodotto deve essere abilitata.
- Prodotti bundle - almeno un prodotto deve essere abilitato per ogni opzione di bundle richiesta.
Se queste condizioni non vengono soddisfatte, il prodotto padre viene considerato disabilitato anche se il suo stato è impostato su Abilitato.
Soluzione:
- Per i prodotti configurabili, verifica che almeno una variante di prodotto semplice associata sia abilitata e assegnata alla visualizzazione corretta del sito web e dello store.
- Per i prodotti bundle, verifica che per ogni opzione di bundle richiesta sia abilitato almeno un prodotto secondario. Un’opzione obbligatoria con tutti gli elementi secondari disabilitati fa sì che l’intero bundle venga trattato come disabilitato.
- Dopo aver abilitato i prodotti secondari appropriati, attiva una risincronizzazione o attendi la successiva sincronizzazione pianificata, quindi conferma lo stato aggiornato nei servizi SaaS di Commerce.
Prezzi non aggiornati dopo l’attivazione della regola prezzo catalogo prices-not-updated
Problema: dopo l’attivazione di una regola dei prezzi di catalogo tramite la funzione Aggiornamento pianificato, i prezzi non vengono aggiornati. commerce-data-export.log mostra synced: 0 per il feed prices dopo l’applicazione degli aggiornamenti pianificati.
Causa: una situazione di tipo “race condition” può verificarsi tra gruppi cron quando si utilizzano gli aggiornamenti pianificati per le regole dei prezzi di catalogo. È possibile che l’indicizzatore catalog_data_exporter_product_prices venga eseguito prima che la relativa dipendenza, l’indice catalogrule_product, abbia completato la ricostruzione. Di conseguenza, l’esportatore di prezzi legge i dati non aggiornati e non esporta modifiche.
Soluzione:
La correzione immediata per questo problema è una soluzione alternativa: configurare entrambi i gruppi cron in modo che vengano eseguiti in sequenza per eliminare la race condition:
-
Vai a Stores > Configuration > Advanced > System > Cron (Scheduled Tasks).
-
Imposta Use Separate Process su No per entrambi:
- Opzioni di configurazione per il gruppo: index
- Opzioni di configurazione per il gruppo: staging
-
Svuota la cache di configurazione dopo il salvataggio.
Discrepanza dei dati del catalogo tra Adobe Commerce e i servizi connessi catalog-data-discrepancy
Problema: i dati di prodotto visualizzati nei servizi Commerce connessi (ad esempio Live Search o Product Recommendations) non corrispondono ai dati del catalogo in Adobe Commerce. Ad esempio, il nome, il prezzo o la descrizione di un prodotto appaiono obsoleti o errati nella vetrina.
Causa: dopo l’attivazione di una risincronizzazione, l’aggiornamento dei dati può richiedere fino a un’ora e può essere riflesso nei componenti dell’interfaccia utente. Se la discrepanza persiste oltre tale finestra, è possibile che l’elemento non sia stato acquisito dall’ultima sincronizzazione o che la sincronizzazione non abbia rilevato una modifica perché i dati del feed sono già contrassegnati come aggiornati.
Soluzione:
- Dalla vetrina Commerce, apri i risultati della ricerca. Quindi, seleziona il prodotto in questione per aprirne la vista dettagliata.
- Copiare l’output JSON e verificare che corrisponda a quello presente nel catalogo Commerce.
- Se il contenuto non corrisponde, apporta una modifica minore al prodotto nel catalogo, ad esempio aggiungendo uno spazio o un punto, per forzare il rilevamento della modifica.
- Attendere la risincronizzazione o attivare una risincronizzazione manuale dalla CLI o dalla pagina Data Feed Sync Status nell’amministratore.
Per ulteriori informazioni sulla risoluzione dei problemi relativi ai dati del catalogo in Product Recommendations, vedere Risoluzione dei problemi relativi al modulo Consigli di prodotto nella Knowledge Base di Commerce.
Sincronizzazione dati non in esecuzione secondo pianificazione sync-not-on-schedule
Problema: la sincronizzazione dei dati non viene eseguita secondo la pianificazione oppure non viene sincronizzato alcun elemento nonostante le modifiche apportate al prodotto in Adobe Commerce.
Causa: Le cause più comuni sono processi cron non in esecuzione o indicizzatori non configurati in modalità Update by Schedule.
Soluzione:
- Verificare che i processi cron siano in esecuzione.
- Verificare che gli indicizzatori per i feed seguenti siano impostati su Update by Schedule: Attributi catalogo, Prodotto, Sostituzioni prodotto e Variante prodotto. Controllare da Index Management nell’amministratore di Commerce o utilizzare CLI:
bin/magento indexer:show-mode | grep -i feed.
Stato della sincronizzazione del catalogo non riuscito catalog-sync-failed
Problema: la sincronizzazione del catalogo mostra uno stato Non riuscito nella pagina Data Feed Sync Status.
Causa: Si è verificato un errore irreversibile durante la fase di raccolta o invio dei dati. Le cause più comuni includono problemi di autenticazione API, errori di rete o errori di convalida dei dati.
Soluzione:
-
Per informazioni dettagliate sull’errore, consulta i registri degli errori di esportazione dei dati. Consulta Esaminare i registri e risolvere i problemi per il formato del registro e le opzioni di registrazione estese:
var/log/commerce-data-export-errors.logper errori durante la raccolta dati.var/log/saas-export-errors.logper gli errori durante l’invio dei dati.
-
Se l’errore non è correlato alla configurazione o a un’estensione di terze parti, invia un ticket di supporto con le voci di registro pertinenti.
Il registro mostra i messaggi “operazione ignorata - elaborazione bloccata” process-locked
Problema: Il file commerce-data-export.log contiene voci simili alle seguenti:
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
Causa: Questo è un comportamento previsto, non un errore. Il messaggio viene visualizzato quando si tenta di eseguire una sincronizzazione parziale attivata da cron mentre è già in corso una reindicizzazione completa o saas:resync. L’estensione SaaS Data Export utilizza un meccanismo di blocco del feed per impedire operazioni di sincronizzazione simultanee in conflitto.
Soluzione:
Non è richiesta alcuna azione. Una volta che il processo in esecuzione completa e rilascia il blocco, l’esecuzione successiva del cron rileva e sincronizza eventuali modifiche in sospeso. Per informazioni dettagliate sul funzionamento del meccanismo di blocco, vedere Meccanismo di blocco del feed per l’esportazione dei dati SaaS.