[[ajuda:cadastro|{{ :ajuda:gsan-cadastro.png?nolink&200|}}]]
====== Gerar Arquivo Texto de Ligações com Hidrômetro ======
<columns>
O objetivo desta funcionalidade é gerar arquivo texto de ligações com hidrômetro (conforme solicitação da CAERN). Ela pode ser acessada via **Menu do sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Cadastro]] > [[:ajuda:Arquivos para BBL]] > Gerar Arquivo Texto de Ligações com Hidrômetro**.
</columns>

Feito isso, o sistema visualiza a tela abaixo:

^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:z_hidrometro_arquivo_texto.jpg?nolink  |}}
</WRAP>

<columns>
Acima, o sistema seleciona os imóveis **ativos**  e com existência de hidrômetro na instalação de água. Informe os campos desejados e clique no botão {{:ajuda:arrecadacao:y_gerar.jpg?nolink}}. Para detalhes sobre o preenchimento dos campos clique **[[=ajuda:gerar_arquivo_texto_de_ligacoes_com_hidrometro#preenchimento_dos_campos|AQUI]]**.

O sistema solicita confirmação da geração do arquivo em formato TXT. Caso o usuário confirme, o arquivo de imóveis ativos é gerado a partir dos imóveis selecionados pelos critérios informados no filtro, classificando pela matrícula do imóvel.

Antes da geração do Arquivo Texto, o sistema efetua algumas validações:

  - Verificar existência de dados:
    - Caso não exista a tabela na base de dados, o sistema exibe a mensagem: //Tabela «nome da tabela» inexistente// e cancela a operação.
    - Caso a tabela esteja sem dados, o sistema exibe a mensagem: //Tabela «nome da tabela» sem dados para seleção// e cancela a operação.
  - Verificar existência da localidade:
    - Caso o código da localidade informada não exista, o sistema exibe a mensagem: //Localidade inexistente// e retorna para o passo correspondente no fluxo principal.
    - Caso o código da localidade informada não pertença à unidade de negócio selecionada o sistema exibe a mensagem: //Localidade não pertence à unidade de negócio selecionada// e retorna para o passo correspondente no fluxo principal.
    - Caso o código da localidade informada não pertença à Gerência regional selecionada o sistema exibe a mensagem: //Localidade não pertence à gerência regional selecionada// e retorna para o passo correspondente no fluxo principal.
  - Verificar existência do setor comercial:
    - Caso o código do setor comercial informado não exista o sistema exibe a mensagem: //Setor Comercial inexistente// e retorna para o passo correspondente no fluxo principal.
    - Caso o código do setor comercial informado não pertença à localidade informada, o sistema exibe a mensagem: //Setor Comercial não pertence à localidade informada// e retorna para o passo correspondente no fluxo principal.
  - Verificar existência da rota:
    - Caso o código da rota informada não exista o sistema exibe a mensagem: //Rota inexistente// e retorna para o passo correspondente no fluxo principal.
    - Caso o código da rota informada não pertença ao setor comercial informado, o sistema exibe a mensagem: //Rota não pertence ao setor comercial informado// e retorna para o passo correspondente no fluxo principal.
  - Verificar atributos inicial e final:
    - Caso seja informado o atributo inicial e não seja informado o atributo final, o sistema exibe a mensagem: //Informe «nome do atributo» final//;
    - Caso seja informado o atributo final e não seja informado o atributo inicial, o sistema exibe a mensagem: //Informe «nome do atributo» inicial//;
    - Caso o conteúdo do atributo final seja menor (inferior, anterior) ao conteúdo do atributo inicial, o sistema exibe a mensagem: //«Nome do atributo» Final é menor que o «Nome do atributo» Inicial// e retorna para o passo correspondente no fluxo principal.
  - Nenhum registro encontrado:
    - Caso a busca não retorne nenhum registro, o sistema exibe a mensagem: //A pesquisa não retornou nenhum resultado// e retorna para o passo 1 do fluxo principal.
</columns>
\\

====== Tela de Sucesso ======
<WRAP center round box 100%>
{{  :ajuda:cad_-_gerararqbbl_-_gerararqtextolighidrom_-_telasucesso.png?nolink  |}}
</WRAP>
\\

====== Preenchimento dos campos ======
^Campo^Orientações para Preenchimento^
|Gerência Regional|Selecione uma das opções disponibilizadas pelo sistema.|
|Unidade de Negócio|Selecione uma das opções disponibilizadas pelo sistema.|
|Localidade Inicial|Informe o código da localidade com até três dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_localidade|Pesquisar Localidade]]**, para selecionar a localidade desejada. O nome da localidade é exibido no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição. \\ **Regra associada**: Ao digitar o conteúdo do campo, o sistema replica no campo **Localidade Final**. Ao apagar o conteúdo deste campo, o sistema apaga no campo **Localidade Final**.|
|Setor Comercial Inicial|Informe o código do setor comercial com até três dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_setor_comercial|Pesquisar Setor Comercial]]**, para selecionar o setor desejado. O nome do setor é exibido no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.\\ **Regra associada**: Ao digitar o conteúdo do campo, o sistema replica no campo **Setor Comercial Final**. Ao apagar o conteúdo deste campo, o sistema apaga no campo **Setor Comercial Final**.|
|Rota Inicial|Informe a rota inicial com até cinco dígitos.|
|Sequencial Inicial da Rota|Informe o sequencial inicial da rota com até cinco dígitos.|
|Localidade Final|Informe o código da localidade com até três dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_localidade|Pesquisar Localidade]]**, para selecionar a localidade desejada. O nome da localidade é exibido no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
|Setor Comercial Final|Informe o código do setor comercial com até três dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_setor_comercial|Pesquisar Setor Comercial]]**, para selecionar o setor desejado. O nome do setor é exibido no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
|Rota Final|Informe a rota final com até cinco dígitos.|
|Sequencial Final da Rota|Informe o sequencial final da rota com até cinco dígitos.|
\\

====== Funcionalidade dos Botões ======
^Botão^Descrição da Funcionalidade^
|{{:ajuda:lupa.gif?nolink|}}|Ao clicar neste botão, o sistema permite consultar um dado nas bases de dados.|
|{{:ajuda:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.|
|{{:ajuda:seguranca:bbotao_limparr.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo da tela.|
|{{:ajuda:arrecadacao:y_gerar.jpg?nolink}}|Ao clicar neste botão, o sistema comanda a geração do arquivo texto de ligações com hidrômetro.|

===== Referências =====

**[[=postgres:cadastro:uc0762|Gerar Arquivo Texto com Dados Cadastrais]]**

**[[=postgres:cadastro:uc0763|Gerar Arquivo Texto de Ligações com Hidrômetro]]**

**[[=ajuda:gerar_arquivo_texto_de_ligacoes_com_hidrometro|Gerar Arquivo Texto de Ligações com Hidrômetro]]**

==== Termos Principais ====

**[[=ajuda:g#gerencia_regional|Gerência Regional]]**

**[[=ajuda:u#unidade_de_negocio|Unidade de Negócio]]**

**[[=ajuda:l#localidade|Localidade]]**

**[[=ajuda:s#setor_comercial|Setor Comercial]]**

**[[=ajuda:r#rota_de_leitura|Rota]]**

\\   
\\
Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN