Reprocessamento de Contador para Bens com Contador Próprio

Características do Requisito

Descrição

Implementado no Manutenção de Ativos (SIGAMNT) a rotina de Acerto/Reprocessamento de Contadores (MNTA876). Esta nova rotina tem por objetivo apoiar os usuários na realização de acerto no histórico de contadores, permitindo ter uma visão de todos os registros de contador de Bens com contador próprio, presentes na tabela STP - Ordem de Serviço Acompanhamento. 

A rotina permite aos usuários exportar os registros de histórico, sendo todos os registros ou "a partir de data" , também permitindo  permitindo posteriormente a importação dessas informações no mesmo formato para ajuste e reprocessamento de todo o histórico. O reprocessamento de contador utilizado nesta rotina é destinado a bens de qualquer categoria, desde que tenham contador 1 próprio (T9_TEMCONT = ‘S’).

Os detalhes referente referentes aos processos de exportação e importação do arquivo seguem abaixo:

1. Exportação:
   O processo de exportação de histórico de contador é o primeiro passo para o reprocessamento de contador. Ao selecionar essa opção, é apresentado ao usuário uma lista com todos os bens cadastrados que possuam contador próprio.  A lista é apresentada no formato de de markbrowse com os campos de de Filial (T9_FILIAL), Código (T9_CODBEM), Nome (T9_NOME), Tipo Modelo (T9_TIPMOD) e sua descrição, Família (T9_CODFAM) e sua descrição. Desta  Desta forma é possível realizar a seleção dos Bens cuja a necessidade de realização do acerto de contador. Ao  
   
   Ao confirmar a tela de seleção, um arquivo uma janela para alterar o nome do arquivo é apresentada, após a alteração, um arquivo com extensão .dbf ou .dtc (conforme o ambiente do cliente)é gerado com o histórico de contador dos bens selecionados com selecionados com os seguintes campos: TP_FILIAL, TP_CODBEM, TP_DTLEITU, TP_HORA, TP_POSCONT, TP_ ACUMCON e TP_TIPOLAN, na  na ordem apresentada. Os registros são ordenados por TP_CODBEM + TP_DTLEITU + TP_HORA + TP_FILIAL, em ordem crescente, referente a data de leitura, e o arquivo é é salvo em uma pasta específica no dicionário, no caminho caminho ROOTPATH + STARTPATH + \NG, exemplo: "C:\NGAP118\Protheus_Data\DicP118\NG". Ao final da rotina, é apresentada uma tela para o usuário escolher o nome do arquivo, com o nome padrão no formato NG876STPYYYYMMDDHHMMSS.dtc.
   
   Obs.:Importante É importante ressaltar que o campo de variação dia não é exportado visto que seu valor é consequência do reporte de contador, assim não deve ser informado manualmente. Seu cálculo se baseia na fórmula Variação fórmula Variação Dia = (Contador Acumulado Final – Contador Acumulado Inicial) / Diferença de Dias entre reportes). Da mesma forma o contador o contador acumulado é preenchido automaticamente. Além disso, a informação de contador de contador acumulado só é alterável para o primeiro registro de inclusão do bem, os demais registros serão calculados com base na informação de posição do contador.
   
   
2. Importação:
   Na sequência do processo, o usuário deve realizar a importação do arquivo que foi exportado para adequação do histórico de todos os bens, através da mesma rotina rotina MNTA876. O usuário tem a possibilidade de alterar ou excluir os registros existentes no histórico e também de incluir novos registros, através de uma interface em em getdados, que é apresentada logo após a seleção do arquivo gerado na exportação. 
   

   Após selecionar o arquivo para importação, finalizar a edição deste arquivo e confirmar no botão OK, é realizada a leitura dos registros alterados em tela, gravando-os em uma tabela temporária, no mesmo formato do arquivo exportado, de forma ordenada por TP_CODBEM + TP_DTLEITU + TP_HORA + TP_FILIALcódigo do bem mais data e hora de leitura mais filial. Além disso, é efetuado um backup da tabela STP, filtrando os bens contidos no arquivo importado. O backup é salvo no mesmo diretório Protheus em ROOTPATH + STARTPATH + \NG + \backup, com o formato STPXX0_YYYYMMDDHHMMSS_backup.dbf, sendo YYYYMMDD e HHMMSS substituídos pela data e hora do processamento.

   No processo de importação é possível ainda, determinar alguns parâmetros para validação, determinando assim o comportamento da rotina durante a validação de Variação Dia, de Contador do bem e referente ao Eixo Suspenso para veículos.       Existem três comportamentos determinados para o caso de ser encontrado um registro com erro na Variação dia ou no seu contador:

   • Bloquear o registro com erro, cancelando o processo e retornando para a tela de importação;
   • Liberar o registro, ignorando o erro;
   • Perguntar ao usuário através de uma mensagem durante o processamento se ele deseja inserir o registro com erro.

   Para os casos de validação verificando o Eixo Suspenso:

   2.1 Validação inicial

   A validação dos registros lidos consiste inicialmente na verificação da existência de um registro único e inicial do tipo “Inclusão” (TP_TIPOLAN = ‘I’), na base (tabela STP), para cada filial em que o bem esteve presente. A rotina então varre as tabelas relacionadas ao histórico de contador, buscando registros com a mesma chave de BEM + DATA + HORA na tabela STP. Caso não encontre algum registro, apresenta um log ao usuário (com opção de imprimir), permitindo retornar à tela de ajuste para inclusão dos novos registros, sem abortar o reprocessamento. Na sequência, cada registro do histórico é excluído, sem passar por validações de exclusão padrão, visto que os relacionamentos citados anteriormente iriam impedir o processo de exclusão.

   2.2 Validação Secundária

   Já estando ordenado por TP_CODBEM + TP_DTLEITU + TP_HORA, o reprocessamento consiste em executar as funções de validação padrão para cada registro individualmente. Após validar o registro, a rotina irá seguir com sua gravação.

   Importante considerar que o primeiro registro do histórico, por ser do tipo de “inclusão” segue a regra existente na inclusão e na transferência do bem, já os demais registros do tipo “C - Contador”, “A- Abastecimento”, "Q - Quebra", "V - Virada" ou "P -  seguem a regra de reporte pelo fluxo de funções:

   • Valor contido no campo TP_POSCONT não deve estar vazio;
   • Valor contido no campo TP_POSCONT deve ser positivo, maior que zero;
   • Valor do TP_POSCONT deve estar dentro do limite validado pela função de consistência da posição do contador com o limite;
   • Valor do campo TP_POSCONT deve ser adequado ao histórico, validado pela função que valida o lancamento no histórico;
   • Valor do campo TP_POSCONT deve ter variação dia adequada, validado pela função que checa a variação dia – estando dentro do percentual, a rotina não solicita confirmação, apenas grava.

    O fluxo de validação é padrão e foi baseado na classe NGMovBem, onde as validações reaproveitam funções e fluxos já existentes no padrão, evitando a criação de novas funções.

   Registros do tipo Quebra e Virada, seguem as respectivas validações de quebra e virada realizadas pela rotina MNTA840 (quebra) e MNTA835 (Ações Relacionadas / Virada). Em nenhum momento é realizada quebra ou virada de forma automática durante esse processamento, somente quando o registro for do tipo V ou Q (ou ainda quando do tipo P). Um registro de abastecimento, por exemplo, não realiza virada automática.

   Havendo alguma inconformidade o processo é abortado. As informações são apresentadas no final, em um log.

   Em situação de exceção, no caso de uma inconformidade resultante das validações realizadas, não somente o histórico da tabela STP é restaurado como também os valores das tabelas relacionadas que foram alteradas.

   2.3 Observações gerais:

   A gravação de cada registro de histórico ocorre de forma individual e após a conclusão da etapa de validação, utilizando a função que gera registro de histórico, padrão do sistema.

   Na gravação do registro da STP os campos TP_DTORIGI, TP_DTREAL e TP_USULEI são alterados para a data em que a rotina está sendo executada e para o código do usuário que está logado.

   Para cada registro gravado, havendo algum relacionamento com outras tabelas, o registro da outra tabela também tem seu valor atualizado, obedecendo a regra da respectiva tabela em que se vai realizar a posição do contador, e desde que, certamente, o valor atual tenha sofrido alguma alteração em relação ao histórico. Por exemplo, ao identificar um registro na STP para data X + hora Y, havendo o mesmo registro na TQN (abastecimento), essa tabela será atualizada.

   As etapas de validação são realizadas bem a bem, inicialmente validando o bem e depois reprocessando seu histórico. Um próximo bem só pode ser validado e reprocessado quando o processamento do bem anterior for concluído. As validações então são feitas em duas etapas, apresentadas a seguir.

    

Importante

Antes de executar o compatibilizador UPDMNTC6 é imprescindível:

1. Em Microsiga Protheus TOTVS Smart Client, digite U_UPDMNTC6 no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 03/08/2016.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Foi realizado também ajustes na rotina de Reprocessamento de Pneus (MNTA877) presente na rotina de Acerto de Contador, melhoria liberada para a versão 11 no chamado TRNZSX: DT_Reprocessamento_de_Pneus_BRA.

Com o ajuste a rotina passa a se chamar "Reprocessamento de Contador em Estrutura (Componentes)" e agora é responsável por realizar o ajuste de contador para todos os bens filhos de uma estrutura, não somente irá realizar reprocessamento de contador para pneus. Além da alteração no filtro para trazer todos os bens que são filhos de uma estrutura, quando selecionado a opção de reprocessamento "Por Lista", será possível verificar um campo de pesquisa que pode apoiar o usuário a encontrar diferentes bens para seleção.

O reprocessamento para os componentes de uma estrutura continua sendo realizado conforme apresentados na documentação referenciada DT_Reprocessamento_de_Pneus_BRA, porém a diferença se verifica também que não será mais gerado o arquivo texto denominado "mntpneus.txt" após o reprocessamento.

 Importante:

Procedimento para Implantação

Aplicar atualização dos programas: NGUTIL04.PRX, MNTA840MNTA840.PRX, MNTA875.PRX, MNTA876.PRW, MNTA877.PRW e NGUTIL04.PRX.

Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado.
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Atualizações do Compatibilizador

1. Criação de Parâmetro no arquivo SX6 – Parâmetros:

Nome da Variável

MV_NGPERCV

Tipo

Procedimento para Utilização

1. No módulo de Manutenção de Ativos acesse Atualizações/ Controle de Oficina/ Contador/ Acerto (MNTA875). 
2. O sistema apresenta uma nova janela com três as opções de funcionalidade.
   Image Removed: Acerto Individual de Contador, Ajuste/Reprocessamento de Contador Próprio e Reprocessamento de Contador em Estrutura (Componentes).
3. Escolha a opção de “Ajuste/Reprocessamento de Contador Próprio” e clique em Confirmar.
4. Logo após, uma nova janela com duas opções são é apresentada.
   Image Removed
5. Selecione a opção “Exportar histórico de Contador”, se preferir também informe a partir de que data os registros devem ser considerados. 
6. O sistema irá apresentar uma nova janela, onde é possível visualizar todos os bens disponíveis na empresa com contador próprio.Image Removed
7. Selecione os bens que pretende realizar o ajuste de contador e clique em OK.
8. Logo após o sistema apresenta uma nova janela, onde é possível agora visualizar o nome do arquivo e se desejar este pode ser alterado. Clique em OK para prosseguir.Image Removed
9. O sistema cria um arquivo com todo o histórico de contador dos bens selecionados, no diretório do ambiente (dicionário Protheus) dentro de pasta "NG" com extensão em .dtc ou .dbf, conforme ambiente do cliente.
10. Novamente em Atualizações/ Controle de Oficina/ Contador/ Acerto (MNTA675MNTA875), escolha a opção de "Ajuste/Reprocessamento de Contador Próprio (MNTA676MNTA876)" e prossiga.
11. Selecione a opção “Importar histórico de Contador” e clique em Próximo. 
12. O sistema irá apresentar janela com o diretório do ambiente. Selecione o arquivo anteriormente criado.
13. Após a confirmação o sistema apresenta os registros de contador contidos no arquivo exportado, desta forma confira os registros presentes no arquivo, altere ou inclua registros e após a manutenção do arquivo clique em ‘OK’.Image Removed
14. O sistema irá validar todos os registro de acordo com a parametrização informada em Parâmetros, botão presente na tela de manutenção dos registros. A validação ocorre também em cima dos demais registros em tabelas relacionadas em todo o ambiente.
15.  No final, caso não encontre nenhuma inconsistência nos registros presentes no arquivo, o sistema irá apresenta a mensagem de importação realizada com sucesso. Caso algum erro seja encontrado será apresentado um log com as inconsistências encontradas, este será para apoiar o usuário no ajuste de contador, assim como o destaque apresentado em linhas amarelas.
16. Ao corrigir, caso necessário, confirme para que o reprocessamento seja realizado novamente. 
17. Ao final do ajuste será apresentado mensagem de importação realizada com sucesso, caso ainda o(s) bem(ns) ajustados possuam estrutura de bens, será apresentado indicação ao usuário que realize o reprocessamento de contador para bens filhos da estrutura. 
18. Acesse novamente em Atualizações/ Controle de Oficina/ Contador/ Acerto de contador (MNTA875).
19. O sistema apresenta uma nova janela com as opções: Acerto Individual de Contador, Ajuste/Reprocessamento de Contador Próprio e Reprocessamento de Contador em Estrutura (Componentes).
20. Escolha a opção de “Reprocessamento de Contador em Estrutura (Componentes)” e clique em Confirmar.

21. O sistema exibirá uma tela de observações sobre o processo: leia atentamente e confirme.

22. O sistema exibirá uma tela para seleção do subprocesso: Por parâmetros, Por lista ou Correção de dados.

23. Selecione a segunda opção (Por lista) e confirme.

24. O sistema exibirá uma listagem com todos os componentes de estrutura. Selecione os componentes desejados e confirme.

25. O sistema exibirá uma mensagem perguntando se deve considerar bens inativos para correção: Selecione a opção desejada e confirme.

26. O sistema processará enquanto exibe uma barra de evolução e poderá apresentar ao final do processamento:

    1. Um log ao final do processo informando quais bens foram corrigidos (Processo terminado).

    2. Uma mensagem “Que não há nada para corrigir”(Processo terminado).

    3. Uma mensagem “Que precisa-se ajustar o registro do bem” (ST9-BENS) para correção. (Realizar procedimentos apresentados a partir do próximo item)

27. Acessar novamente Atualizações/ Controle de Oficina/ Contador/ Acerto de contador (MNTA875).

28. O sistema exibirá a tela de escolha de processo: Acerto Individual de Contador, Ajuste/Reprocessamento de Contador Próprio e Reprocessamento de Contador em Estrutura (Componentes).

29. Selecione a opção: Reprocessamento de Contador em Estrutura (Componentes) - MNTA877 e confirme.

30. O sistema exibirá uma tela de observações sobre o processo: Confirme.

31. O sistema exibirá a tela para seleção do subprocesso: Por parâmetros, Por lista ou Correção de dados.

32. Selecione a terceira opção e confirme.

33. O sistema exibirá uma mensagem sobre os campos a serem corrigidos: Leia atentamente e confirme.

34. O sistema exibirá uma tela com os dados do bem disposto em linhas.

35. Preencha as informações faltantes e confirme.

36. Após a correção execute novamente o reprocessamento para os componentes da estrutura.