Pipeline de sincronização do conector
Criado em SaaS Data Export, o Adobe Commerce Optimizer Connector mapeia os dados coletados pelos indexadores SaaS Data Export para o formato exigido pelo Adobe Commerce Optimizer Catalog Data Ingestion API e manipula a autenticação, o envio em lote e o controle de sincronização baseado em escopo. As seções abaixo descrevem como essa sincronização funciona.
Contexto relacionado:
-
Saiba mais sobre o valor comercial, os principais recursos e a arquitetura da integração no tópico Commerce Optimizer Connector visão geral.
-
Para obter os nomes dos pacotes de módulo, pontos de extremidade da API de feed e caminhos de chave de configuração, consulte a Referência do conector
Como a sincronização funciona
O diagrama a seguir mostra a sincronização de dados de Adobe Commerce a Commerce Optimizer através de Adobe I/O Gateway.
Quando os dados do catálogo são alterados no Adobe Commerce, a sincronização percorre esses estágios.
- Detecção de Alteração de Entidade — (a cada 1 min) Um trabalho cron (
indexer_reindex_all_invalid) detecta Adobe Commerce alterações de entidade e aciona SaaS Data Export, que monta itens de feed e rastreia seus status. - Transformação — A Commerce Optimizer Connector seleciona os feeds agrupados, mapeia entidades e escopos de Adobe Commerce para os formatos exigidos pela API Commerce Optimizer e prepara a carga para transmissão.
- Transmissão — Os dados transformados são enviados via HTTP POST (
/v1/catalog/<feed name>) por meio de Adobe I/O Gateway para Commerce Optimizer, que valida e mantém os feeds de entrada. - Nova tentativa com falha (a cada 5 min) — um trabalho cron separado (
*_resend_failed_items) detecta itens de feed com falha e os reenvia pelo mesmo pipeline.
Trabalhos cron agendados
Dois grupos cron automatizam o pipeline em uma programação fixa.
indexer_reindex_all_invalid*_resend_failed_itemsA extensão SaaS Data Export lida com a coleta de feeds e o rastreamento de status. A camada do conector mapeia entidades e escopos para o formato exigido pela API Commerce Optimizer e os envia por meio de POST /v1/catalog/<feed name>.
Requisitos
- cron do Commerce deve estar em execução.
- Os indexadores de feed devem usar o modo Update by Schedule. Consulte Verificar a configuração do aplicativo Commerce.
Controle de sincronização baseado em escopo
O módulo CommerceOptimizerScopeMapper lê as configurações de exportação por site e por armazenamento e as impõe durante a coleta e o envio do feed.
- Escopos habilitados para exportar dados no agendamento delta normal.
- Escopos desabilitados foram excluídos do pipeline.
As entidades sincronizadas anteriormente serão removidas de Commerce Optimizer na próxima execução do cron.
Se os problemas de sincronização afetarem apenas uma origem de catálogo ou catálogo de preços, consulte Dados não sincronizados.
Para obter detalhes sobre como personalizar o escopo de sincronização, consulte Personalizar a configuração de exportação de escopos do Commerce.
Calendário e monitoramento
Monitorar status por feed da página Data Feed Sync Status no Administrador do Commerce. Consulte Verificar se a sincronização de dados está funcionando.
Envio de feed e tratamento de erros
O processo FeedSubmitter lida com Catalog Data Ingestion API chamadas.
- Separa os itens de atualização dos itens de exclusão (diferentes pontos de extremidade de API).
- Chama, atualiza e exclui pontos de extremidade independentemente.
- Mescla os resultados de status por item novamente em uma única resposta.
Mesclagem de código do status HTTP
Quando as chamadas de atualização e exclusão retornam códigos de status diferentes, FeedSubmitter combina os resultados da seguinte maneira.
errors são exibidos no Administrador e exigem atenção. Outros itens no lote são repetidos.*_feed_resend_failed_items específicos do feed no grupo resync_failed_feeds_data_exporter.