DocumentaçãoCommerceGuia do Data Export para serviços SaaS

Sincronizar dados com a exportação de dados SaaS

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Administrador
  • Desenvolvedor

Quando você instala um serviço do Commerce que requer exportação de dados, como Serviço de catálogo, Live Search ou Recommendations de produtos, uma coleção de módulos de exportação de dados do Saas é instalada para gerenciar o processo de coleta e sincronização de dados.

A exportação de dados SaaS move os dados do produto de uma instância do Adobe Commerce para a plataforma de serviços da Commerce de forma contínua para manter os dados atualizados. Por exemplo, o Product Recommendations exige as informações atuais do catálogo para retornar com precisão as recomendações com nomes, preços e disponibilidade corretos. Use o painel de Gerenciamento de Dados para observar e gerenciar o processo de sincronização, ou a interface de linha de comando para disparar uma sincronização e reindexar os dados do produto para consumo pelos Serviços Commerce.

O diagrama a seguir mostra o fluxo de exportação de dados SaaS.

Coleta de exportação de dados SaaS e fluxo de sincronização para Adobe Commerce {width="900" modal="regular"}

Os principais componentes do fluxo de exportação de dados SaaS incluem:

  • Módulos de exportação de dados SaaS que coletam os dados para feeds do Adobe Commerce, montam itens de feed, aguardam atualizações e persistem o status do feed.
  • Módulos de exportação SaaS que exportam dados, configuram o roteamento e publicam os feeds para serviços conectados.
  • O Serviço do Adobe Commerce gerencia o processo de assimilação de dados para validar feeds recebidos e atualizações persistentes nos serviços conectados.

Modos de sincronização

A exportação de dados SaaS tem dois modos para processar feeds de entidade:

  • Modo de exportação imediata — Neste modo, os dados são coletados e enviados imediatamente para o Commerce Service em uma única iteração. Esse modo acelera a entrega de atualizações de entidades ao serviço do Commerce e reduz o tamanho do armazenamento das tabelas de feed.

  • Modo de exportação herdado — Neste modo, os dados são coletados em um único processo. Em seguida, um trabalho cron envia os dados coletados para os serviços de comércio conectados. Nas entradas do log de exportação de dados, os feeds que usam o modo herdado são rotulados como (legacy).

Tipos de sincronização

A exportação de dados SaaS suporta três tipos de sincronização - sincronização completa, sincronização parcial e nova tentativa de sincronização de itens com falha.

Sincronização completa

Depois de conectar uma instância do Adobe Commerce ao Commerce Service, execute uma sincronização completa para enviar dados de feed de entidade do Adobe Commerce para o serviço conectado.

NOTE
A sincronização completa é principalmente para a fase de integração. Evite o uso regular para evitar a sobrecarga do banco de dados. Após a sincronização inicial, as alterações em andamento são sincronizadas automaticamente usando a sincronização parcial.

Sincronização parcial

Com a sincronização parcial, a exportação de dados SaaS envia automaticamente as atualizações do aplicativo Commerce, como alterações de nome de produto ou atualizações de preço, para os serviços de comércio conectados.

O processo de exportação de dados usa os seguintes trabalhos cron para automatizar a operação de sincronização parcial.

  • trabalhos do grupo cron "index":

    • O trabalho indexer_reindex_all_invalid reindexa todos os feeds inválidos. É um trabalho cron padrão do Adobe Commerce.
    • O trabalho saas_data_exporter é para feeds de exportação herdados.
    • O trabalho sales_data_exporter é específico ao feed de exportação de dados de vendas.

Esses trabalhos são executados a cada minuto.

Para que a sincronização parcial funcione, o aplicativo Commerce requer a seguinte configuração:

  • O agendamento de tarefas está habilitado por meio de trabalhos cron

  • Todos os indexadores de exportação de dados SaaS estão configurados no modo Update by Schedule.

    Na versão de exportação de dados SaaS 103.1.0 e posterior, o modo Update by Schedule é habilitado por padrão. Você pode verificar a configuração de índice no servidor usando o comando da CLI do Commerce, bin/magento indexer:show-mode | grep -i feed

Repetir sincronização de Itens com Falha

A sincronização Repetir itens com falha usa um processo separado para reenviar itens que não foram sincronizados devido a erros durante o processo de sincronização, por exemplo, um erro de aplicativo, uma interrupção de rede ou um erro de serviço SaaS. A implementação desta sincronização também se baseia em trabalhos cron.

  • resync_failed_feeds_data_exporter trabalhos do grupo cron:
    • O trabalho <feed name>_feed_resend_failed_feeds_items reenvia itens com falha de sincronização, por exemplo products_feed_resend_failed_items.

Exibir e gerenciar o processo de sincronização

A maioria das atividades de sincronização é processada automaticamente com base na configuração do aplicativo. No entanto, a exportação de dados SaaS também fornece ferramentas para gerenciar o processo.

  • Os usuários administradores podem exibir e acompanhar o progresso da sincronização e obter informações sobre os dados no painel de Gerenciamento de Dados.

  • Desenvolvedores, integradores de sistemas ou administradores com acesso ao servidor de aplicativos do Commerce podem gerenciar o processo de sincronização e os feeds de dados usando a CLI (Command-Line Tool, ferramenta de linha de comando) do Adobe Commerce. Consulte Referência de Comando de Exportação de Dados.

Verificar a configuração do aplicativo do Commerce

A sincronização parcial e a sincronização de itens com falha de Repetir funcionam somente se a instância do Commerce tiver sido configurada corretamente. Normalmente, a configuração é concluída ao configurar o serviço do Commerce. Se a exportação de dados não estiver funcionando corretamente, verifique a seguinte configuração.

  • Confirme se os trabalhos cron estão em execução.

  • Verifique se os indexadores estão sendo executados do Admin ou usando o comando bin/magento indexer:info da CLI do Commerce.

  • 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. Você pode verificar os indexadores do Gerenciamento de Índice no Administrador ou usando a CLI (bin/magento indexer:show-mode | grep -i feed).

Notificações do gerenciador de eventos para o log de transferência de dados

Na versão 103.3.4 e posterior, a Exportação de dados SaaS despacha o evento data_sent_outside quando os dados são enviados da instância do Commerce para os serviços da Adobe Commerce.

$this->eventManager->dispatch(
   "data_sent_outside",
   [
       "timestamp" => time(),
       "type" => $metadata->getFeedName(),
       "data" => $data
   ]
);
NOTE
Para obter informações sobre eventos e como se inscrever neles, consulte Eventos e Observadores na Documentação do desenvolvedor do Adobe Commerce.
recommendation-more-help
6183eb5c-cb5c-49fa-bd7b-cd38576b727c