Visão geral dos processos de sincronização de dados
Search
Search Indirect Tax Help and Support.

This article applies to:

  • Product: onesource-determination,onesource-indirect-tax

Streaming

É possível usar esse método de sincronização para aplicar pequenas alterações de configuração de UI ou API ao ambiente do cliente em minutos.

Sobre o streaming

O streaming é um método de sincronização para pequenas alterações imediatas feitas na interface do usuário (IU) ou por meio de APIs de configuração. Isso reflete essas mudanças delta no ambiente do cliente em minutos.

Uso do streaming

O processo de streaming funciona como uma conversa contínua entre o cliente e o Mothership.
  1. Mudança feita:
     Um usuário atualiza a interface do usuário ou API. As atualizações podem incluir editar uma regra fiscal, alterar o nome de um comerciante ou inserir um novo certificado de isenção.
  2. Registro de eventos:
     O Mothership registra essa alteração como um novo evento com um número de sequência.
  3. Pesquisa:
     O ambiente do cliente automaticamente consulta (contata) o Mothership em um intervalo configurável (padrão: a cada 5 minutos), solicitando quaisquer novos eventos que tenham ocorrido desde a última verificação.
  4. Aplicação da mudança:
     O Mothership devolve apenas as novas alterações (o “delta”). O cliente recebe este pequeno pacote de informações e aplica a atualização diretamente ao banco de dados.

Principais características e limitações

Rápido para solicitar alterações de interface do usuário ou API:
 Esse processo é eficiente para mudanças pontuais de configuração, pois somente a própria alteração é transmitida.
Quando o Streaming voltar para uma importação completa:
 Em alguns cenários, o Streaming não pode aplicar uma alteração delta e executará uma importação completa de todos os dados de configuração. Em seguida, o cliente de streaming para de processar eventos delta e aciona uma importação completa usando o método configurado: Importação em massa ou SDI. A transmissão recorre à importação completa nos seguintes cenários:
  • Um evento de streaming não é corretamente aplicado:
     Se um evento de streaming não puder ser aplicado, o sistema iniciará a reconciliação. Ele limpa as entidades afetadas e aciona uma importação completa para restaurar a sincronização com o Mothership.
  • Um evento de importação/exportação em massa é detectado (evento de sincronização completa):
     O Mothership registra operações em massa, como importações ou exportações completas, como eventos de
    Sincronização completa
    . No próximo ciclo de pesquisa, o cliente exibe este evento. Uma alteração delta não é suficiente; então aciona uma importação completa.
  • O botão
    Sincronizar todas as configurações
     está selecionado:
     Selecionar o botão
    Sincronizar todas as configurações
     grava um evento de sincronização completo no registro de alterações do Mothership. O cliente de streaming detecta isso no próximo ciclo de pesquisa e inicia uma importação completa.
    note
    Isso ainda ocorre na programação regular de pesquisa do cliente. Não aciona uma sincronização imediata ou improvisada.

O streaming pode pausar

Além dos cenários anteriores de fallback completo, há situações em que o cliente de streaming pausará temporariamente o processamento delta. Isso significa que ele impede a aplicação de outras alterações de streaming e aguarda até que a condição de acionamento seja resolvida. Ao contrário de um fallback, uma pausa não necessariamente aciona uma importação completa por conta própria. O streaming não será retomado até que a condição que causou a pausa tenha sido concluída. O streaming pausará nos seguintes cenários:
  • Ocorre um evento de importação da interface do usuário:
     Uma importação de configuração pausa o processamento delta até que a importação seja concluída. Isso evita que alterações conflitantes ou sobrepostas sejam aplicadas simultaneamente.
  • Ocorre uma alteração no delta de conteúdo ou no banco de dados:
     Quando o sistema detecta uma alteração no conteúdo ou no banco de dados direto, o cliente de streaming pausa. Ele retoma a sincronização delta após a alteração ser processada.
  • O botão
    Sincronizar todas as configurações
     está selecionado:
     Selecionar este botão pausa a transmissão. A transmissão é retomada após o próximo ciclo de pesquisa processar o evento de sincronização completo. Nenhuma alteração delta adicional é aplicada durante esse período. O processamento delta é retomado após a conclusão da importação completa.
  • Uma sincronização sob demanda é acionada (botão
    Revisar alterações e, em seguida, Sincronizar
    ):
     O recurso
    Revisar alterações e, em seguida, Sincronizar
     no Painel do DA contém as alterações para revisão. O cliente de streaming pausa o processamento delta até que o administrador verifique as alterações e inicie a sincronização. Isso garante que apenas alterações revisadas e aprovadas sejam aplicadas ao ambiente do cliente.
Opções de configuração:
 O
modo de streaming
 é o
modo-padrão operacional
 para o sistema, por padrão programado para verificar alterações a cada 5 minutos. O processo de fallback que ele aciona para eventos de sincronização completa também é configurável. Por padrão, ele voltará ao processo SDI legado. Se o
Modo de importação em massa
 estiver ativado por meio de uma sobreposição de cliente, o sistema usará de forma inteligente o processo de importação em massa muito mais rápido para esses fallbacks.
Opções de agendamento:
 Os itens a seguir estão ativados na Sobreposição.
  • Padrão: A cada 5 minutos para alterações delta quase em tempo real
  • Isso pode ser ajustado para intervalos mais longos (10 minutos, 30 minutos, por hora) com base nos requisitos de frequência de sincronização. Intervalos mais rápidos fornecem mais atualizações em tempo real, mas aumentam a frequência de pesquisa

Conceitos-chave

Prazo
Descrição
Mothership
O servidor mestre central é onde a cópia principal de todos os dados de configuração é armazenada para o Determination Anywhere. Este é o mesmo lugar onde o ONESOURCE Enterprise Cloud Determination está hospedado.
Cliente/locatário
Instância ou ambiente de DA específico do cliente, que sincroniza dados do Mothership e realiza determinação fiscal.
Prefetch
Um processo em segundo plano do servidor que é executado no Mothership em um agendamento configurado. Ele gera e valida o arquivo de exportação que os ambientes do cliente consomem durante uma importação em massa ou sincronização de SDI. O agendamento do
Prefetch
 prévio é um fator-chave na determinação do tempo total para que uma alteração de configuração seja refletida no ambiente do cliente.
Dados de configuração
Todas as configurações que você pode controlar, incluindo regras fiscais, taxas, entidades, lógica personalizada.
Alteração delta
Uma alteração pequena e incremental, como editar uma única regra. É nisso que o Streaming é melhor.
Sincronização completa
Uma sincronização completa de todos os dados de configuração. O sistema usa SDI ou Importação em massa para lidar com isso.
Chave da entidade
Uma combinação exclusiva de campos (por exemplo, nome, tipo) que a SDI usa para identificar uma parte da configuração.

Exemplo de casos de uso

Cenário 1: Uma atualização rápida de regras (tratada por streaming)
  • Jane, uma gerente fiscal, percebe que uma regra fiscal personalizada precisa de uma pequena correção. Jane faz login, edita a regra personalizada e salva a alteração.
  • Nos bastidores: A transmissão capta a mudança no próximo ciclo de 5 minutos. Em seguida, cria um arquivo cache usando o servidor de busca prévia para atender à solicitação de pesquisa do cliente. Em minutos, o ambiente do cliente de Jane é atualizado com a regra corrigida.
note
Se a sincronização sob demanda estiver ativada, Jane poderá revisar as alterações no Painel do DA antes de iniciar o processo de streaming usando o botão
Revisar alterações e, em seguida, sincronizar
 disponível no Painel do DA.
Cenário 2: Transferindo a configuração de UAT para produção (manuseado por SDI ou importação em massa)
  • John, um administrador de sistema, terminou de configurar e testar um novo conjunto de regras no ambiente UAT. John exporta toda a configuração e está pronto para importá-la para Produção.
  • O modo antigo (SDI):
     John inicia a importação. O processo SDI começa, executando entidade por entidade. Leva horas e, durante o processo, falha devido a um conflito de ordenação de regras. A equipe precisará investigar e resolver o problema manualmente antes de reiniciar a sincronização.
  • A nova maneira (importação em massa):
     John inicia a importação. O processo de importação em massa é iniciado. Ele exclui a configuração antiga e insere o novo conjunto. Toda a operação é concluída com sucesso em menos de 20 minutos, sem erros.

Related Content