Sincronizar feeds usando a CLI do Commerce

O comando saas:resync no pacote magento/saas-export permite gerenciar a sincronização de dados para serviços SaaS do Adobe Commerce.

A Adobe não recomenda usar o comando saas:resync regularmente. Os cenários típicos para usar o comando são:

Monitorar operações de sincronização no arquivo var/log/saas-export.log.

Sincronização inicial

Quando você aciona um saas:resync na linha de comando, dependendo do tamanho do catálogo, pode levar de alguns minutos a algumas horas para que os dados sejam atualizados.

Para a sincronização inicial, a Adobe recomenda executar os comandos na seguinte ordem:

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

Sincronizar usando comandos CLI

O comando saas:resync dá suporte a várias operações de sincronização:

Exibir todas as opções disponíveis:

bin/magento saas:resync --help

Consulte as seções a seguir para obter descrições de opções com exemplos.

--by-ids

Ressincronizar parcialmente entidades específicas por suas IDs. Suporta os feeds products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.

Por padrão, ao usar a opção --by-ids, você especifica valores usando valores de SKU do produto. Para usar IDs de produto, adicione a opção --id-type=ProductID.

Exemplos:

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

Limpe a tabela indexadora de feed antes de reindexar e enviar dados para o SaaS. Com suporte somente para products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.

Se usada com a opção --dry-run, a operação executará uma operação de ressincronização de simulação para todos os itens.

Exemplo:

bin/magento saas:resync --feed products --cleanup-feed

--continue-resync

Retoma uma operação de ressincronização interrompida. Suportado apenas para feeds products, productAttributes e productOverrides.

Exemplo:

bin/magento saas:resync --feed productAttributes --continue-resync

--dry-run

Executa o processo de reindexação do feed sem enviá-lo para o SaaS e sem salvá-lo na tabela de feed. Essa opção é útil para identificar quaisquer problemas com seu conjunto de dados.

Adicione a variável de ambiente EXPORTER_EXTENDED_LOG=1 para salvar a carga em var/log/saas-export.log.

Exemplo:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run

Testar itens específicos do feed

Teste itens específicos do feed adicionando a opção --by-ids com a coleção de logs estendidos para ver a carga gerada no arquivo var/log/saas-export.log.

Exemplo:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'

Testar todos os itens do feed

Por padrão, o feed enviado durante uma operação resync --dry-run inclui somente itens novos ou itens que não foram exportados anteriormente. Para incluir todos os itens no feed a serem processados, use a opção --cleanup-feed.

Exemplo

bin/magento saas:resync --feed products --dry-run --cleanup-feed

--feed

Obrigatório. Especifica a entidade de feed a ser ressincronizada.

Feeds disponíveis:

Exemplo:

bin/magento saas:resync --feed products

--no-reindex

Reenvia dados existentes do catálogo para Commerce Services sem reindexação. Não compatível com feeds relacionados ao produto.

O comportamento varia de modo de exportação:

Exemplo:

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

--id-type=ProductId

Por padrão, as entidades especificadas quando você usa o comando saas:resync feed com a opção --by-ids são especificadas pelo SKU do produto. Use a opção --id-type=ProductId para especificar entidades por ID de produto.

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

Exemplo:

Solução de problemas

Se você não vir os dados esperados nos Serviços Commerce conectados, solucione os problemas verificando os logs de erro da exportação de dados e usando o comando saas:resync com as variáveis de ambiente para revisar as cargas e os dados do criador de perfil. Consulte Revisar logs e solucionar problemas.