Guia de Boas Práticas para o Sincronismo de Documentos na Aplicação BI CIGAM

De CIGAM WIKI

FAQ_CIGAM > FAQ_BI > Dashboards > Guia de Boas Práticas para o Sincronismo de Documentos na Aplicação BI CIGAM

Palavras-Chave

[editar]

Cálculo de Margem.Sincronismo dos documentos.Logs com Pendências.Performance da Tarefa.Gestão de Resultados.

Este documento tem como objetivo orientar a correta configuração e manutenção das tarefas de GR - Sincronismo Gestão de Resultados, com o intuito de:

  • Melhoria da performance do ambiente, especialmente durante o horário comercial;

  • Tratamento adequado de documentos com inconsistência de custo, garantindo que apenas dados válidos sejam processados;

  • Evitar reprocessamentos desnecessários, reduzindo a carga de trabalho do servidor e o tempo de execução das rotinas;

  • Aprimorar a confiabilidade das informações de margem apresentadas nos dashboards;

Além disso, este é um guia prático com a finalidade de garantir que o BI opere de forma eficiente para:

  • Evitar atrasos ou falhas na atualização dos dashboards, causadas por inconsistências nos dados de custo;

  • Ajustar a execução das rotinas de sincronismo de modo a preservar o desempenho do sistema durante o horário comercial;

  • Reduzir o retrabalho, ao impedir que documentos com pendências sejam reprocessados repetidamente;

  • Diagnosticar e corrigir materiais com falha de custo, garantindo que as informações de margem sejam calculadas corretamente;

Orientações Sincronismo de Documentos do BI CIGAM a ser adotado para melhora de Performance

[editar]

Localizar a Tarefa Responsável pela Carga de Dados

[editar]

No ambiente do BI, identifique a Tarefa responsável pelas cargas de dados de vendas/faturamento e Gestão de Resultados,como padrão nomeada GR - Sincronismo Gestão de Resultados.


Tarefa Sincronismo dos Documentos 01
Tarefa Sincronismo dos Documentos 01


Configurar os Parâmetros da Tarefa

[editar]

Acesse a tarefa e vá até a aba Passos na etapa 5 “Sincronismo de Documentos” e clique em Editar.

Caso a empresa não utilize os módulos Estratégia de Preço e Gestão de Resultados, ajuste o parâmetro Calcular Margem para “Não”.

Para empresas que utilizam esses módulos, habilite a opção Ignorar “Logs com Pendências”.

  • Por que isso é importante?

Materiais com inconsistências de custo serão ignorados durante as execuções diárias da tarefa, evitando que esses registros sejam reprocessados repetidamente.

Caso essa opção esteja desabilitada, o BI tenta processar todos os documentos, incluindo os com inconsistências, o que pode aumentar significativamente o tempo de execução e impactar a performance.

Mais detalhes acesse:Sincronismo de Documentos.


Tarefa Sincronismo dos Documentos 02
Tarefa Sincronismo dos Documentos 02



Complementar
Complementar


Se a empresa não utiliza os módulos Estratégia de preço e Gestão de resultados, ajuste o calcular margem para “Não”.

Empresas que utilizam os módulos, marque para Ignorar “Logs com Pendências”. Desta forma, materiais que possuam inconsistências de custos serão ignorados e não serão reprocessados nas execuções da tarefa agendada para o horário comercial com recorrência ao longo do dia. Com a opção desmarcada, BI faz a busca por todos os documentos, passando sempre por aqueles que possuem inconsistência, e dependendo do volume, afeta o tempo de execução e performance.

Importante: Se a opção Ignorar Logs com Pendências não estiver disponível ao abrir a tarefa, será necessário atualizar para a versão mais recente do sistema.

Criar uma Cópia da Tarefa para execução fora do horário comercial

[editar]

Após habilitar a opção de ignorar logs, crie uma cópia da tarefa original para execução em horário alternativo.


Tarefa Sincronismo dos Documentos 03
Tarefa Sincronismo dos Documentos 03


No agendamento da cópia da tarefa, programe para um horário fora do expediente comercial.

Dentro da cópia da tarefa, habilite a configuração de validade para os logs.

  • Recomendamos um período padrão de 5 dias.

  • Essa configuração garante que, nesta execução específica, o sistema busque e processe informações de custo com inconsistências referentes ao período indicado, possibilitando a correção dos dados ajustados.


Tarefa Sincronismo dos Documentos 04
Tarefa Sincronismo dos Documentos 04


Monitoramento e correção de Inconsistências

[editar]

Utilize o Painel de Inconsistências para identificar os materiais que estão com custos ausentes ou incorretos.

Uma das inconsistências é a falta de custo na tela Material/Mercadoria no módulo Estratégia de Preços no CIGAM,podendo ser ajustados manualmente ou via rotinas automáticas de C2 Sincroniza Custos Materiais ou Liberação de Custos .

Essa correção é fundamental para eliminar inconsistências e garantir que as margens apresentadas pelo BI sejam coerentes e confiáveis.

Mais detalhes acesse: Qual dashboard do BI CIGAM pode ser usado para identificar inconsistências nos produtos vendidos?


Tarefa Sincronismo dos Documentos 05
Tarefa Sincronismo dos Documentos 05


Mas por que ocorrem esses acúmulos de log no sincronismo do BI?

[editar]

Quando a opção "Avaliar Margem" está ativada na tarefa de sincronismo, é fundamental observar que alguns parâmetros que impactam diretamente o cálculo da margem das vendas. Configurações inadequadas podem levar a dificuldades no processamento dos documentos — especialmente aqueles com inconsistências relacionadas a custos(conforme o link informado na etapa anterior) resultando no acúmulo de logs e na redução da performance no ambiente.

Para minimizar esses efeitos e garantir maior estabilidade e eficiência, foram introduzidas estas otimizações na Tarefa de Sincronismo.

Segue abaixo a demonstração em vídeo.

[editar]