Solução de problemas de cenários para SaaS Data Export
Esta página descreve comportamentos que você pode observar ao trabalhar com o SaaS Data Export, que normalmente são causados por uma configuração incorreta ou interpretação incorreta dos resultados de sincronização. Use as descrições abaixo para identificar a causa raiz e aplicar a resolução apropriada.
Produto configurável ou em pacote ausente nos serviços da Commerce configurable-bundle-missing
Problema: um produto configurável ou em pacote tem o status Habilitado em Adobe Commerce, mas não é retornado na loja ou é exibido com o status Desabilitado nos serviços SaaS da Commerce.
Causa: o status efetivo dos produtos compostos depende do status dos produtos derivados, não apenas do status do produto principal. Os serviços SaaS da Commerce refletem esse status calculado:
- Produtos configuráveis - pelo menos uma variante de produto deve ser habilitada.
- Agrupar produtos - pelo menos um produto deve ser habilitado para cada opção de pacote necessária.
Se essas condições não forem atendidas, o produto principal será tratado como desabilitado mesmo se seu próprio status for definido como Habilitado.
Solução:
- Para produtos configuráveis, verifique se pelo menos uma variante de produto simples associada está habilitada e atribuída ao site e à exibição de loja corretos.
- Para produtos agrupados, verifique se cada opção de pacote necessária tem pelo menos um produto filho habilitado. Uma opção necessária com todos os filhos desativados faz com que todo o pacote seja tratado como desativado.
- Depois de ativar os produtos secundários apropriados, acione uma ressincronização ou aguarde a próxima sincronização agendada e, em seguida, confirme o status atualizado nos serviços SaaS da Commerce.
Preços não atualizados após a ativação da regra de preço de catálogo prices-not-updated
Problema: Após ativar uma regra de preço de catálogo usando o recurso Atualização Agendada, os preços não são atualizados. O commerce-data-export.log mostra synced: 0 para prices feed após a aplicação das atualizações programadas.
Causa: uma condição de corrida pode ocorrer entre grupos cron quando as Atualizações Agendadas são usadas para regras de preço de catálogo. O indexador catalog_data_exporter_product_prices pode ser executado antes que sua dependência, o índice catalogrule_product, tenha terminado a reconstrução. Em consequência, o exportador de preços lê dados obsoletos e não exporta quaisquer alterações.
Solução:
A correção imediata para esse problema é uma solução alternativa: configure ambos os grupos cron para serem executados sequencialmente para eliminar a condição de corrida:
-
Vá para Stores > Configuration > Advanced > System > Cron (Scheduled Tasks).
-
Definir Use Separate Process como No para ambos:
- Opções de configuração do Cron para o grupo: index
- Opções de configuração do Cron para o grupo: staging
-
Limpe o cache de configuração depois de salvar.
Discrepância de dados do catálogo entre Adobe Commerce e serviços conectados catalog-data-discrepancy
Problema: Os dados do produto mostrados nos Serviços Commerce conectados (como Live Search ou Product Recommendations) não correspondem aos dados do catálogo em Adobe Commerce. Por exemplo, um nome de produto, preço ou descrição parece desatualizado ou incorreto na loja.
Causa: depois que uma ressincronização é acionada, pode levar até uma hora para que os dados sejam atualizados e refletidos nos componentes da interface do usuário. Se a discrepância persistir além dessa janela, talvez o item não tenha sido selecionado pela última sincronização ou a sincronização não tenha detectado uma alteração porque os dados do feed já estavam marcados como atualizados.
Solução:
- Na loja do Commerce, abra os resultados da pesquisa. Em seguida, selecione o produto em questão para abrir a visualização detalhada.
- Copie a saída JSON e verifique se ela corresponde ao que você tem no catálogo Commerce.
- Se o conteúdo não corresponder, faça uma pequena edição no produto no catálogo, como adicionar um espaço ou um ponto, para forçar a detecção da alteração.
- Aguarde uma ressincronização ou acione uma ressincronização manual da CLI ou da página Data Feed Sync Status no Administrador.
Para obter soluções de problemas adicionais de dados de catálogo no Product Recommendations, consulte Solução de problemas do módulo de Recomendações de Produto na Base de Dados de Conhecimento Commerce.
A sincronização de dados não está sendo executada de acordo com o agendamento sync-not-on-schedule
Problema: a sincronização de dados não é executada de acordo com o cronograma ou nenhum item está sendo sincronizado apesar das alterações no produto em Adobe Commerce.
Causa: as causas mais comuns são trabalhos cron não executados ou indexadores não configurados no modo Update by Schedule.
Solução:
- Confirme se os trabalhos cron estão em execução.
- Verifique se os indexadores dos seguintes feeds estão definidos como Update by Schedule: Atributos do Catálogo, Produto, Substituições de Produto e Variante de Produto. Verifique a partir de Index Management no Administrador do Commerce ou usando a CLI:
bin/magento indexer:show-mode | grep -i feed.
A sincronização do catálogo tem um status Falha catalog-sync-failed
Problema: a sincronização do catálogo mostra o status Falha na página Data Feed Sync Status.
Causa: Erro irrecuperável durante a coleta de dados ou a fase de envio. Causas comuns incluem problemas de autenticação de API, erros de rede ou falhas de validação de dados.
Solução:
-
Revise os logs de erro da exportação de dados para obter detalhes sobre a falha. Consulte Revisar logs e solucionar problemas para ver o formato do log e as opções de log estendidas:
var/log/commerce-data-export-errors.logpara erros durante a coleta de dados.var/log/saas-export-errors.logpara erros durante o envio de dados.
-
Se o erro não estiver relacionado à configuração ou a uma extensão de terceiros, envie um tíquete de suporte com as entradas de log relevantes.
O registro mostra mensagens de “operação ignorada - processo bloqueado” process-locked
Problema: O arquivo commerce-data-export.log contém entradas semelhantes às seguintes:
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
Causa: Esse é um comportamento esperado, não um erro. A mensagem é exibida quando uma sincronização parcial acionada por cron tenta ser executada enquanto uma reindexação completa ou saas:resync já está em andamento. A extensão SaaS Data Export usa um mecanismo de bloqueio de feed para evitar operações de sincronização simultâneas conflitantes.
Solução:
Nenhuma ação é necessária. Quando o processo em execução for concluído e liberar o bloqueio, a próxima execução do cron selecionará e sincronizará todas as alterações pendentes. Para obter detalhes sobre como o mecanismo de bloqueio funciona, consulte Mecanismo de bloqueio de feed para Exportação de Dados SaaS.