[[ajuda:cadastro|{{ :ajuda:gsan-cadastro.png?nolink&200|}}]]
====== Gerar Arquivo Texto Dados Cadastrais ======
<columns>
O objetivo desta funcionalidade é gerar arquivo texto com dados cadastrais. A funcionalidade pode ser acessada via **Menu do sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Cadastro]] > [[:ajuda:Arquivos para BBL]] > Gerar Arquivo Texto Dados Cadastrais**.
</columns>

Feito isso, o sistema acessa 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:g_arquivo_texto_dados_cadastrais.jpg?nolink  |}}
</WRAP>

<columns>
Acima, selecione os critérios de filtro para os imóveis que julgar necessários e clique no botão {{:ajuda:arrecadacao:y_gerar.jpg?nolink}}. Para detalhes sobre o preenchimento dos campos clique **[[=ajuda:gerar_arquivo_texto_dados_cadastrais#preenchimento_dos_campos|AQUI]]**.

Além dos critérios utilizados no filtro, o sistema seleciona apenas os imóveis ativos. O sistema solicita confirmação da geração do arquivo em formato TXT. Caso o usuário confirme, o sistema gera o arquivo de imóveis ativos a partir dos imóveis selecionados pelos critérios de filtro, classificado pela inscrição do imóvel.

O sistema recupera as subcategorias do imóvel selecionado, até um limite máximo de cinco subcategorias, ordenando-as por ordem decrescente de quantidade de economias e ordem crescente de código da subcategoria, ordenadas decrescentemente por quantidade de economia.

Antes de gerar o Arquivo Texto, algumas validações são efetuadas:

  - 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, é exibida 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, com indicador de uso igual a ativo, o sistema exibe a mensagem //Localidade inexistente//.
    - Caso o código da localidade informada não pertença à unidade de negócio selecionada, é exibida a mensagem //Localidade não pertence à unidade de negócio selecionada <<unidade de negócio selecionada>>//.
    - 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 <<gerência regional selecionada>>//.
  - Verificar existência do setor comercial:
    - Caso o código do setor comercial informado não exista na tabela com indicador de uso igual a ativo, o sistema exibe a mensagem //Setor Comercial inexistente//.
    - Caso o código do setor comercial informado não pertença à localidade informada, é exibida a mensagem //Setor Comercial não pertence à localidade informada <<localidade informada>>//.
  - Verificar existência da rota:
    - Caso o código da rota informada não exista na tabela com indicador de uso igual a ativo, o sistema exibe a mensagem //Rota inexistente//.
    - Caso o código da rota informada não pertença ao setor comercial informado, é exibida a mensagem //Rota não pertence ao setor comercial informado <<setor comercial informado>>//.
  - 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, é exibida a mensagem //Informe <<nome do atributo>> inicial//.
    - Caso o conteúdo do atributo final seja menor (inferior, anterior) ao conteúdo do atributo inicial, é exibida a mensagem //<<Nome do atributo>> Final é menor que o <<Nome do atributo>> Inicial//.
  - Nenhum registro encontrado:
    - Caso a busca não retorne nenhum registro, o sistema exibe a mensagem //A pesquisa não retornou nenhum resultado//.
  - Verificar o preenchimento dos campos:
    - Caso não tenha sido informada nenhuma opção de filtragem, o sistema exibe a mensagem //Informe pelo menos uma opção de seleção//.
</columns>
\\

===== Preenchimento dos campos =====
^Campo^Orientações para Preenchimento^
|Gerência Regional|O sistema popula a Gerência Regional com os nomes das gerências regionais ativas. Selecione uma das opções disponibilizadas pelo sistema.|
|Unidade de Negócio|O sistema popula a Unidade de Negócio com os nomes das unidades de negócio ativas. 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 no máximo cinco dígitos.|
|Sequencial Inicial da Rota|Informe o sequencial inicial da rota com no máximo 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 no máximo cinco dígitos.|
|Sequencial Final da Rota|Informe o sequencial final da rota com no máximo 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