Como o migrador funciona

Camada processada automaticamente pelo Jenkins

Os dados de Movimentação do Unicoo são migrados para o TOTVS através de processos automáticos do Jenkins. O tempo entre uma execução e outra é parametrizável. O default é 15 minutos.

A cada ciclo do processo, todos os erros identificados em execuções anteriores são eliminados, e é realizada nova tentativa de importação dos registros correspondentes.

Ao final de cada ciclo, são gerados relatórios de acompanhamento, a serem analisados pelos consultores e usuários chave, afim de realizarem possíveis saneamentos de dados, DEPARAs e parâmetros, e checar na execução seguinte se o erro foi saneado com a sua ação.

O local para geração desses arquivos é parametrizável em variável de ambiente do Jenkins.

Dentro do diretório parametrizado existe uma subdivisão de pastas por modulo, e cada pasta contém o relatório em html:

Resumindo o contexto do migrador: 

1. são executados os extratores: extraem dados do unicoo e gravam em área temporária;
2. são executadas as filas de importação: lêem essa área temporária e tentam integrar os dados no TOTVS, normalmente a cada 15 minutos;
3. são gerados os relatórios com os resultados da tentativa de integração;

Os diversos tipos de processos podem ser executados de forma simultânea, de modo que algumas dependências podem ser observadas. Segue um esboço:

Neste exemplo vamos considerar o relatório de erros dos títulos a pagar. Imaginem um cenário onde o migrador está executando o extrator do TIT_AP, porém ainda faltam registros de fornecedores a serem integrados. Em um primeiro momento este tipo de erro pode ser ignorado pois na próxima rodada quando o migrador executar novamente o processo de extração de dados do fornecedor serão criados os registros faltantes. Por sua vez na próxima execução dos títulos a pagar o fornecedor já estará criado e o tipo de erro "Fornecedor não encontrado" não irá ocorrer novamente. Sendo assim o relatório será gerado novamente, desta vez sem informar os erros que havia sido informado anteriormente.

O formato de exibição dos relatórios é praticamente o mesmo para todos:

1: Tabela contendo o status dos registros importados, sendo eles: 

Nas execuções que ocorrem a cada 15 minutos, todos os registros que estão com status "ER" e "PE" são apagados e recriados novamente para uma nova tentativa de migração. Portanto a ação que você tomou anteriormente para corrigir os registros nos status "ER" e "PE" terá efeito na próxima rodada do migrador.

2:Tabela contendo uma curva ABC dos erros, onde mostra qual foi o erro de maior ocorrência;

3:Tabela contendo a descrição detalhada dos erros;

Exemplo do relatório de erros de CLIENTES:

Com os relatórios gerados a cada 15 minutos, qualquer pessoa consegue consultar o status atual de migração de cada modulo e, consequentemente, proceder com ajustes necessários tanto em saneamento de dados, parâmetros ou de-paras.