Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- ajuda:micromedicao:atualizar_leitura_e_anormalidade [28/09/2015 18:11] – a edivaldo.alves
+++ ajuda:micromedicao:atualizar_leitura_e_anormalidade [24/01/2018 17:36] (atual) – tadeu.sarmento
@@ Linha 1: / Linha 1: @@
 [[:ajuda|{{ :ajuda:gsan-micromedicao.png?nolink&200|}}]]
 ====== Atualizar Leitura e Anormalidade ======
+<columns>
+Esta funcionalidade atualiza um conjunto de leituras e anormalidades, bem como a sua consistência e o cálculo do consumo. A opção pode ser acessada via **Menu de sistema**, no caminho **[[:Ajuda:pagina_inicial|GSAN]] > [[:ajuda:Micromedição]] > Atualizar Leitura e Anormalidade**. Feito isso, o sistema acessa a tela abaixo:
+</columns>
-Esta funcionalidade permite a atualização de um conjunto de leituras e anormalidades bem como a sua consistência e o calculo do consumo, podendo ser acessada no caminho [[:Ajuda:pagina_inicial|Gsan]] > [[:ajuda:Micromedição]] > Atualizar Leitura e Anormalidade.
+^Informamos que os dados exibidos nas telas a seguir são fictícios e não retratam informações de clientes.^
+<WRAP center round box 100%>
+{{  :ajuda:micromedicao:1401_a_leituras_anormalidades.jpg?nolink  |}}
+</WRAP>
-Informe o arquivo desejado, clicando no botão {{:ajuda:micromedicao:selecionararquivo.png?nolink|}}.
+<columns>
+Agora, informe o arquivo desejado, clicando no botão {{:ajuda:micromedicao:2401_ea.jpg?nolink|}}. Para cada registro do arquivo leitura e anormalidade, o sistema realiza a consistência dos dados.
-Para cada registro do arquivo leitura e anormalidade, o sistema realiza a consistência dos dados.
+Caso haja alguma crítica neste processamento, é gerada a //Tela Resumo das Leituras e Anormalidades Registradas com Problema// e a operação é cancelada. O primeiro registro do arquivo contém o ano e o mês de referência do faturamento do grupo a ser processado. Além destas, o sistema executa outras validações:
-Caso haja alguma crítica neste processamento será gerada a Tela Resumo das Leituras e Anormalidades Registradas com Problema e a operação será cancelada.
+  - Gerar //Tela Resumo das Leituras e Anormalidades Registradas//:
+  - O sistema gera uma tela de acordo com o movimento registrado com os seguintes campos:
+    - No cabeçalho, imprime o grupo de faturamento informado, o código e descrição da empresa, o código da localidade e o título fixo MOVIMENTO CELULAR quando processado o arquivo de movimento.
+  - O sistema acumula para cada código de setor recebido no movimento os seguintes dados:
+    - Quantidade de registros recebidos (total de registros do arquivo por localidade e setor);
+    - Quantidade de registros com leitura (total de registros do arquivo com leitura do hidrômetro preenchida, diferente de zero e de espaços em branco, e com código da anormalidade de leitura não preenchido, igual à zero ou a espaços em branco);
+    - Quantidade de registros com anormalidade (total de registros do arquivo com Leitura do hidrômetro não preenchida, igual à zero ou a espaços em branco, e com código da anormalidade de leitura preenchida, diferente de zero e de espaços em branco);
+    - Quantidade de registros com leitura e com anormalidade (total de registros do arquivo com leitura do hidrômetro preenchida, diferente de zero e de espaços em branco, e com código da anormalidade de leitura preenchida, diferente de zero e de espaços em branco);
+    - Quantidade de registros inválidos (total de registros do arquivo que não entraram nos totais dos itens acima);
+  - Imprime o total dos registros do arquivo por tipo de acordo com o acumulado acima;
+  - Imprime o resumo por anormalidade de leitura para os registros com anormalidade de leitura preenchida (diferente de zero e de espaços em branco):
+    - Código da Anormalidade de Leitura;
+    - Descrição da Anormalidade de Leitura;
+    - Quantidade de registros no arquivo com a anormalidade correspondente;
+    - Imprime o total dos registros com anormalidade;
+  - Gerar //Tela Resumo das Leituras e Anormalidades Registradas com Problemas//:
+  - O sistema gera uma tela de acordo com o movimento registrado com os seguintes campos:
+    - No cabeçalho, imprime o grupo de faturamento informado, o código e descrição da empresa e ROTA, QUADRA, IMÓVEL iguais à matrícula do imóvel do primeiro registro do arquivo, o código da localidade e o título fixo MOVIMENTO CELULAR, quando processado o arquivo de movimento;
+    - Imprime o erro correspondente encontrado no processamento do imóvel;
+    - Imprime um texto //Arquivo processado com problema e enviado para operação para processar o movimento. Setor Comercial <<Código do Setor Comercial>>//.
+  - Obtém Data de Realização da Atividade Efetuar Leitura:
+  - O sistema obtém a data de leitura máxima recebida a partir do MOVIMENTO ROTEIRO EMPRESA do grupo e a referência que está em processamento;
+  - Caso a data de leitura máxima obtida no passo anterior que estiver entre a data prevista do cronograma do grupo de faturamento em questão para a atividade: efetuar leitura menos 30 dias; e a data prevista do cronograma do grupo de faturamento em questão para a atividade: efetuar leitura mais 30 dias; o sistema atribui a data de leitura máxima obtida no passo anterior à data de realização da atividade de efetuar leitura;
+  - Caso contrário, atribui a data prevista do cronograma do grupo de faturamento em questão para a atividade efetuar leitura.
+  - Verificar existência do arquivo de leituras e anormalidades:
+    - Caso o arquivo de leituras e anormalidades informado não exista no diretório padrão, o sistema exibe a mensagem: //Arquivo de Leituras e Anormalidades inexistente// e cancela a operação.
+  - Verificar existência de dados no arquivo:
+    - Caso o arquivo esteja sem dados, o sistema exibe a mensagem: //Arquivo <<nome do arquivo >> sem dados// e cancela a operação.
+  - Verificar existência do grupo de faturamento:
+    - Caso o grupo de faturamento não exista, o sistema exibe a mensagem: //Grupo de faturamento inexistente// e cancela a operação. **Atenção**: só virá um grupo por arquivo.
+  - Verificar existência da matrícula do imóvel:
+    - Caso a matrícula do imóvel não exista, o sistema exibe a mensagem: //Matrícula do imóvel inexistente: <<número do imóvel>>//.
+  - Verificar tipo de medição:
+    - Caso o tipo de medição seja diferente de zero e não exista, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Tipo de Medição inexistente <<tipo de medição>>//.
+    - Caso o tipo de medição corresponda à ligação de água e não exista hidrômetro instalado para a ligação, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Movimento para ligação de água sem hidrômetro//.
+    - Caso o tipo de medição corresponda a poço e não exista hidrômetro instalado para o poço, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Movimento para poço sem hidrômetro//.
+    - Caso o tipo de medição seja zero e a leitura seja informada e não exista hidrômetro instalado para o imóvel, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Movimento para ligação sem hidrômetro//.
+    - Caso o tipo de medição seja zero e a anormalidade informada não seja compatível com ligação sem hidrômetro, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Anormalidade não permitida para ligação sem hidrômetro//.
+  - Verificar data e hora de leitura:
+    - Caso a data e hora de leitura seja inválida ou maior que a data corrente, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Data e hora de leitura inválida <<data da leitura>>//.
+    - Caso o ano/mês da data de leitura não seja igual ao ano/mês de referência do faturamento do grupo e não seja igual ao ano/mês de referência do faturamento do grupo **menos** um mês e não seja igual ao ano/mês de referência do faturamento do grupo **mais** um mês, o sistema exibe a mensagem: //Data de leitura incompatível com o mês/ano de faturamento//.
+  - Verificar existência da lista de imóveis:
+    - Caso a lista de imóveis esteja sem dados, o sistema exibe a mensagem: //Lista de imóveis sem dados// e cancela a operação.
+  - Verificar existência do código da anormalidade de leitura:
+    - Caso o código da anormalidade seja informado (diferente de zero e de espaços em branco) e não exista no sistema, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Código da Anormalidade de Leitura inexistente <<código da anormalidade>>//.
+  - Validar indicador de confirmação de leitura:
+    - Caso o Indicador de confirmação de leitura não seja válido, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Indicador de Confirmação de Leitura inválido <<indicador de confirmação de leitura>>//.
+  - Verificar sucesso da transação:
+    - Caso o código de retorno da operação efetuada no banco de dados seja diferente de zero, o sistema exibe a mensagem conforme o código de retorno; caso contrário, exibe a mensagem: //<<descrição da função>> efetuada com sucesso//.
+  - Verificar existência do histórico de medição:
+    - Caso já exista o histórico de medição para o imóvel no mês, será feita atualização.
+  - Registro não encontrado:
+    - Caso não encontre o registro no MOVIMENTO ROTEIRO EMPRESA, o sistema exibe a mensagem: //Imóvel: <<número do imóvel>> com Movimento Roteiro Empresa sem dados para processar o imóvel informado//.
+  - Validar tamanho do registro:
+    - Caso o tamanho do registro seja diferente de 176, o sistema exibe a mensagem: //Arquivo com registros de tamanho inválido// e cancela a operação.
-No primeiro registro do arquivo conterá o ano e o mês de referência do faturamento do grupo a ser processado.
+\\
-Gera Tela Resumo das Leituras e Anormalidades Registradas
+====== Preenchimento dos Campos ======
-  * O sistema gera uma tela de acordo com o movimento registrado com os seguintes campos:
+^Campo^Preenchimento dos Campos^
-    * No cabeçalho imprime o grupo de faturamento informado, o código e descrição da empresa, o código da localidade e o título fixo “MOVIMENTO CELULAR” quando processado o arquivo de movimento;
+|Nome do Arquivo|Campo obrigatório - Selecione o arquivo do seu computador.|
-  * O sistema acumula para cada código de setor recebido no movimento os seguintes dados:
+\\
-    * Quantidade de registros recebidos (total de registros do arquivo por localidade e setor);
-      * Quantidade de registros com leitura (total de registros do arquivo com Leitura do hidrômetro preenchida (diferente de zero e de espaços em branco), e com Código da anormalidade de leitura não preenchido (igual à zero ou a espaços em branco));
-      * Quantidade de registros com anormalidade (total de registros do arquivo com Leitura do hidrômetro não preenchida (igual à zero ou a espaços em branco), e com Código da anormalidade de leitura preenchida (diferente de zero e de espaços em branco));
-      * Quantidade de registros com leitura e com anormalidade (total de registros do arquivo com Leitura do hidrômetro preenchida (diferente de zero e de espaços em branco), e com Código da anormalidade de leitura preenchida (diferente de zero e de espaços em branco));
-      * Quantidade de registros inválidos (total de registros do arquivo que não entraram nos totais dos itens acima);
-    * Imprime o total dos registros do arquivo por tipo de acordo com o acumulado acima;
-    * Imprime o resumo por anormalidade de leitura para os registros com anormalidade de leitura preenchida (diferente de zero e de espaços em branco):
-      * Código da Anormalidade de Leitura;
-      * Descrição da Anormalidade de Leitura;
-      * Quantidade de registros no arquivo com a anormalidade correspondente;
-    * Imprime o total dos registros com anormalidade;
-Gera Tela Resumo das Leituras e Anormalidades Registradas com Problemas
+====== Funcionalidade dos Botões ======
-  * O sistema gera uma tela de acordo com o movimento registrado com os seguintes campos:
+^Botão^Descrição da Funcionalidade^
-    * No cabeçalho imprime o grupo de faturamento informado, o código e descrição da empresa e ROTA, QUADRA, IMÓVEL com igual a matrícula do imóvel do primeiro registro do arquivo, o código da localidade e o título fixo “MOVIMENTO CELULAR” quando processado o arquivo de movimento;
+|{{:ajuda:micromedicao:2401_ea.jpg?nolink|}}|Ao clicar neste botão, o sistema seleciona o arquivo de leitura anormalidade desejado.|
-    * Imprime o erro correspondente encontrado no processamento do imóvel;
+|{{:ajuda:arrecadacao:atualizar_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução da atualização, com base no arquivo informado.|
-    * Imprimir um texto “Arquivo processado com problema e enviado para operação para processar o movimento. Setor Comercial <<Código do Setor Comercial>>”;
-Obtém Data de Realização da Atividade Efetuar Leitura
+\\
-  * O sistema obtém a data de leitura máxima recebida a partir da MOVIMENTO ROTEIRO EMPRESA do grupo e a referência que está em processamento;
-  * Caso a data de leitura máxima obtida no passo anterior esteja entre a data prevista do cronograma do grupo de faturamento em questão para a atividade, efetuar leitura menos 30 dias, e a data prevista do cronograma do grupo de faturamento em questão para a atividade, efetuar leitura mais 30 dias, o sistema atribui a data de leitura máxima obtida no passo anterior à data de realização da atividade de efetuar leitura;
-  * Caso contrário, atribui a data prevista do cronograma do grupo de faturamento em questão para a atividade efetuar leitura.
-Verifica existência do arquivo de leituras e anormalidades
+===== Referências =====
-  * Caso o arquivo de leituras e anormalidades informado não exista no diretório padrão, o sistema exibe a mensagem “Arquivo de Leituras e Anormalidades inexistente” e cancela a operação.
-Verifica existência de dados no arquivo
+**[[=postgres:micromedicao:uc0712|Atualizar Leituras e Anormalidades]]**
-  * Caso o arquivo esteja sem dados, o sistema exibe a mensagem “Arquivo <<nome do arquivo >> sem dados” e cancela a operação.
-Verifica existência do grupo de faturamento
-  * Caso o grupo de faturamento não exista, o sistema exibe a mensagem “Grupo de faturamento inexistente” e cancela a operação.
-  * Obs. Só virá um grupo por arquivo.
-Verifica existência da matrícula do imóvel
-  * Caso a matrícula do imóvel não exista, o sistema gera no log de consistência a mensagem “Matrícula do imóvel inexistente: <<número do imóvel>>”.
-Verifica tipo de medição
+==== Termos Principais ====
-  * Caso o tipo de medição seja diferente de zero e não exista no sistema, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Tipo de Medição inexistente <<tipo de medição>>”.
-  * Caso o tipo de medição corresponda à ligação de água e não exista hidrômetro instalado para a ligação, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Movimento para ligação de água sem hidrômetro”.
-  * Caso o tipo de medição corresponda a poço e não exista hidrômetro instalado para o poço, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Movimento para poço sem hidrômetro”.
-  * Caso o tipo de medição seja zero e a leitura seja informada e não exista hidrômetro instalado para o imóvel, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Movimento para ligação sem hidrômetro”.
-  * Caso o tipo de medição seja zero e a anormalidade informada não seja compatível com ligação sem hidrômetro, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Anormalidade não permitida para ligação sem hidrômetro”.
-Verifica data e hora de leitura
+**[[=ajuda:micromedicao|Micromedição]]**
-  * Caso a data e hora de leitura seja inválida ou maior que a data corrente, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Data e hora de leitura inválida <<data da leitura>>”.
-  * Caso o ano/mês da data de leitura não seja igual ao ano/mês de referência do faturamento do grupo e não seja igual ao ano/mês de referência do faturamento do grupo menos um mês e não seja igual ao ano/mês de referência do faturamento do grupo mais um mês, será gerado no log de consistência a mensagem “Data de leitura incompatível com o mês/ano de faturamento”.
-Verifica existência da lista de imóveis
-  * Caso a lista de imóveis esteja sem dados, o sistema exibe a mensagem “Lista de imóveis sem dados” e cancelar a operação.
-Verifica existência do código da anormalidade de leitura
-  * Caso o código da anormalidade seja informado (diferente de zero e de espaços em branco) e não exista no sistema, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Código da Anormalidade de Leitura inexistente <<código da anormalidade>>”.
-Valida indicador de confirmação de leitura
-  * Caso o Indicador de confirmação de leitura não seja válido, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Indicador de Confirmação de Leitura inválido <<indicador de confirmação de leitura>>”.
-Verifica sucesso da transação
-  * Caso o código de retorno da operação efetuada no banco de dados seja diferente de zero, o sistema exibe a mensagem conforme o código de retorno; caso contrário, exibe a mensagem “<<descrição da função>> efetuada com sucesso”.
-Verifica existência do histórico de medição
-  * Caso já exista o histórico de medição para o imóvel no mês, será feita atualização.
-Registro não encontrado
-  * Caso não encontre o registro no MOVIMENTO ROTEIRO EMPRESA, será gerado no log de consistência a mensagem “Imóvel: <<número do imóvel>> com Movimento Roteiro Empresa sem dados para processar o imóvel informado”.
-Valida tamanho do registro
-  * Caso o tamanho do registro seja diferente de 176, será gerado no log de consistência a mensagem “Arquivo com registros de tamanho inválido” e cancelar a operação.
-[[image:Micro - AtualizarLeituraAnormalidade.png]]
-= Preenchimento dos Campos =
-|=Campo|=Orientações para Preenchimento
-|Nome do Arquivo(*)| Campo obrigatório - Selecione o nome do arquivo.
 \\
+\\
+Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN
-= Funcionalidade dos Botões =
-|=Botão|=Descrição da Funcionalidade
-|[[image:http://192.168.64.215:8080/xwiki/bin/download/Micromedicao/Atualizar+Leitura+e+Anormalidade/SelecionarArquivo.png||alt="SelecionarArquivo.png"]]| Ao clicar neste botão, o sistema permite selecionar o arquivo de leitura anormalidade desejado.
-|[[image:Atualizar.png]]| Ao clicar neste botão, o sistema comanda a execução da atualização, com base no arquivo informado.
-\\
-\\
-\\
-Clique [[:ajuda|aqui]] para retornar ao Menu Principal do GSAN