[[:ajuda|{{ :ajuda:gsan-atendimento.png?nolink&200|}}]]
====== Informar Programação de Abastecimento e Manutenção ====== 
<columns>
O objetivo desta funcionalidade é informar (inserir, atualizar ou remover) a programação de abastecimento e manutenção para um período de referência e uma área de bairro. A opção pode ser encontrada via **Menu de Sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:atendimento|Atendimento ao Público]] >  [[:ajuda:atendimento:abastecimento_e_manutencao|Abastecimento e Manutenção]] > Informar Programação de Abastecimento e Manutenção**.
</columns>

Feito isso, o sistema exibe a tela a seguir:

==== Observação ====
^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:y_filtrar_programacao_am.jpg?nolink  |}}
</WRAP>

<columns>
Acima, informe os parâmetros para preenchimento dos campos. Em seguida clique no botão {{:ajuda:botaopesquisar.jpg?nolink|}}. Em seguida, o sistema visualiza a tela abaixo:
</columns>

<WRAP center round box 100%>
{{  :ajuda:tela_inicial_informar_programacao_am.jpg?nolink  |}}
</WRAP>

<columns>
A partir dos parâmetros informados, o sistema seleciona toda a programação de abastecimento e manutenção existente (caso exista), e permite que novas programações sejam adicionadas. Clique no botão {{:ajuda:adicionar.png?nolink|}} dos quadros **Programação de Abastecimento** e **Programação de Manutenção** que será exibido um popup para que sejam informados os dados, conforme tela apresentada, respectivamente, **[[=ajuda:informar_programacao_de_abastecimento_e_manutencao#programacao_de_abastecimento|AQUI]]** e **[[=ajuda:informar_programacao_de_abastecimento_e_manutencao#programacao_de_manutencao|AQUI]]**.

Caso não exista programação de abastecimento ou de manutenção previamente cadastrada para o município e bairro informados, o sistema permite que seja efetuada uma cópia da programação já cadastrada para outro município e bairro no mesmo mês/ano de referência, habilitando o botão {{:ajuda:copiar.png?nolink|}}.
</columns>

<WRAP center round box 100%>
{{  :ajuda:ab.jpg?550  |}}
</WRAP>

==== Programação de Abastecimento ====
<columns>
Para informar nova programação de abastecimento, clique no botão {{:ajuda:adicionar.png?nolink|}}, informe os dados obrigatoriamente, e clique no botão {{:ajuda:inserir.png?nolink|}}. Para detalhes sobre o preenchimento dos campos clique **[[=ajuda:informar_programacao_de_abastecimento_e_manutencao&#preenchimento_dos_campos|AQUI]]**.
</columns>

<WRAP center round box 100%>
{{  :ajuda:z_b_adicionar_informar_programacao_abastecimento.jpg?nolink  |}}
</WRAP>


==== Programação de Manutenção ====
<columns>
Para informar nova programação de manutenção, clique no botão {{:ajuda:adicionar.png?nolink|}}, tela **Informar Programação de Abastecimento e Manutenção**, informe os dados obrigatoriamente, e clique no botão {{:ajuda:inserir.png?nolink|}}. Para detalhes sobre o preenchimento dos campos clique **[[=ajuda:informar_programacao_de_abastecimento_e_manutencao#preenchimento_dos_campos1|AQUI]]**.
</columns>

<WRAP center round box 100%>
{{  :ajuda:b_adicionar_informar_programacao_manutencao.jpg?nolink  |}}
</WRAP>

A tela abaixo, apresenta uma programação de abastecimento e manutenção cadastrada:

<WRAP center round box 100%>
{{  :ajuda:tela_inicial_preenchida_informar_programacao_am.jpg?nolink  |}}
</WRAP>

<columns>
Ao clicar no //link// do campo //Data Inicio//, será exibido o popup contendo os dados da programação de abastecimento. Ao clicar no //link// do campo **Descrição**, será exibido o popup contendo os dados da programação de manutenção.

Para remover uma programação de abastecimento cadastrada, clique no botão {{:ajuda:relatorios:botao_remover_faixa.jpg?nolink|}}. Para remover uma programação de manutenção cadastrada, clique no botão {{:ajuda:relatorios:botao_remover_faixa.jpg?nolink|}}.

Para comandar a conclusão da programação de abastecimento/manutenção, clique no botão {{:ajuda:relatorios:concluir.jpg?nolink|}}.

Durante o preenchimento dos campos, o sistema executa algumas validações:

  - Verificar existência do município:
    - Caso o município não exista, será exibida a mensagem: //Município inexistente//.
  - Verificar informação do município:
    - Caso o município não tenha sido informado, será exibida a mensagem: //Informe Município//.
  - Verificar existência do bairro:
    - Caso o bairro informado não exista, será exibida a mensagem: //Bairro inexistente//.
  - Validar mês e ano de referência:
    - Caso o mês e ano de referência estejam inválidos, será exibida a mensagem: //Mês/Ano de Referência inválido//.
  - Verificar Data Início de Abastecimento:
    - Caso a Data Início de Abastecimento seja uma data inválida, será exibida a mensagem: //Data Início de Abastecimento inválida//.
    - Caso o mês/ano da Data Início de Abastecimento não seja igual ao mês/ano de referência informado, será exibida a mensagem: //Mês e Ano da Data Início de Abastecimento não corresponde ao Mês e Ano de Referência informado//.
  - Verificar Data Fim de Abastecimento:
    - Caso a Data Fim de Abastecimento seja uma data inválida, será exibida a mensagem: //Data Fim de Abastecimento inválida//.
    - Caso o mês/ano da Data Fim de Abastecimento não seja igual ao mês/ano de referência informado, será exibida a mensagem: //Mês e Ano da Data Fim de Abastecimento não corresponde ao Mês e Ano de Referência informado//.
    - Caso a Data Fim de Abastecimento seja anterior à Data Início de Abastecimento, será exibida a mensagem: //Data Fim de Abastecimento deve ser igual ou posterior à Data Início de Abastecimento//.
  - Verificar Hora Início de Abastecimento:
    - Caso a Hora Início de Abastecimento seja uma hora inválida, será exibida a mensagem: //Hora Início de Abastecimento inválida//.
  - Verificar Hora Fim de Abastecimento:
    - Caso a Hora Fim de Abastecimento seja uma hora inválida, será exibida a mensagem: //Hora Fim de Abastecimento inválida//.
    - Caso a Data Fim de Abastecimento seja igual à Data Início de Abastecimento e a Hora Fim de Abastecimento seja anterior à Hora Início de Abastecimento, será exibida a mensagem: //Hora Fim de Abastecimento deve ser igual ou posterior à Hora Início de Abastecimento//.
  - Verificar Existência de Programação de Abastecimento:
    - Caso a Data Início de Abastecimento informada esteja compreendida entre o intervalo de datas de início e fim de alguma programação já existente no //grid//; ou a Data Fim de Abastecimento informada esteja compreendida entre o intervalo de datas de início e fim de alguma programação já existente no //grid//; e a Hora Início de Abastecimento informada esteja compreendida entre o intervalo de horas de início e fim desta programação já existente no //grid//; ou a Hora Fim de Abastecimento informada esteja compreendida entre o intervalo de horas de início e fim desta programação já existente no //grid//, será exibida a mensagem: //Já existe programação de abastecimento para o período <<data início da programação de abastecimento existente>> a <<data fim da programação de abastecimento existente>> de <<hora início da programação de abastecimento existente>> a <<hora fim da programação de abastecimento existente>>//.
    - OBS: Atentar para o caso de programações com dias consecutivos, cujo intervalo de horas a ser considerado compreende o período de início e fim entre as datas distintas.
  - Verificar Data Início de Manutenção:
    - Caso a Data Início de Manutenção seja uma data inválida, será exibida a mensagem: //Data Início de Manutenção inválida//.
    - Caso o mês/ano da Data Início de Manutenção não seja igual ao mês/ano de referência informado, será exibida a mensagem: //Mês e Ano da Data Início de Manutenção não corresponde ao Mês e Ano de Referência informado// e retorna para o passo correspondente no fluxo principal.
  - Verificar Data Fim de Manutenção:
    - Caso a Data Fim de Manutenção seja uma data inválida, será exibida a mensagem: //Data Fim de Manutenção inválida//.
    - Caso o mês/ano da Data Fim de Manutenção não seja igual ao mês/ano de referência informado, será exibida a mensagem: //Mês e Ano da Data Fim de Manutenção não corresponde ao Mês e Ano de Referência informado//.
    - Caso a Data Fim de Manutenção seja anterior à Data Início de Manutenção, será exibida a mensagem: //Data Fim de Manutenção deve ser igual ou posterior à Data Início de Manutenção//.
  - Verificar Hora Início de Manutenção:
    - Caso a Hora Início de Manutenção seja uma hora inválida, será exibida a mensagem: //Hora Início de Manutenção inválida//.
  - Verificar Hora Fim de Manutenção:
    - Caso a Hora Fim de Manutenção seja uma hora inválida, será exibida a mensagem: //Hora Fim de Manutenção inválida//.
    - Caso a Data Fim de Manutenção seja igual à Data Início de Manutenção e a Hora Fim de Manutenção seja anterior à Hora Início de Manutenção, será exibida a mensagem: //Hora Fim de Manutenção deve ser igual ou posterior à Hora Início de Manutenção//.
  - Verificar Existência de Programação de Manutenção:
    - Caso [(a Data Início de Manutenção informada esteja compreendida entre o intervalo de datas de início e fim de alguma programação já existente no //grid//) ou (a Data Fim de Manutenção informada esteja compreendida entre o intervalo de datas de início e fim de alguma programação já existente no //grid//)] e [(a Hora Início de Manutenção informada esteja compreendida entre o intervalo de horas de início e fim desta programação já existente no //grid//) ou (a Hora Fim de Manutenção informada esteja compreendida entre o intervalo de horas de início e fim desta programação já existente no //grid//)], será exibida a mensagem: //Já existe programação de manutenção para o período <<data início da programação de manutenção existente>> a <<data fim da programação de manutenção existente>> de <<hora início da programação de manutenção existente>> a <<hora fim da programação de manutenção existente>>// e retorna para o passo correspondente no fluxo principal. 
    - OBS: Atentar para o caso de programações com dias consecutivos, cujo intervalo de horas a ser considerado compreende o período de início e fim entre as datas distintas.
  - Verificar Caracteres Especiais:
    - Caso seja informado algum caracter especial na Descrição, será exibida a mensagem: //Descrição possui caracteres especiais//.
  - Verificar sucesso da transação:
    - Caso o código de retorno de alguma operação efetuada no banco de dados seja diferente de zero, será exibida a mensagem conforme o código de retorno.
  - Atualização realizada por outro usuário:
    - Caso o usuário esteja tentando atualizar uma programação que já tenha sido atualizada durante a manutenção corrente, será exibida a mensagem: //Esse(s) registro(s) foi(ram) atualizado(s) ou removido(s) por outro usuário durante a operação. Realize uma nova manutenção//.
  - Verificar Existência de Programação de Abastecimento a Ser Copiada:
    - Caso não exista na base de dados nenhuma programação de abastecimento para o mês de referência, e a área de bairro informada para a cópia, o sistema exibe a mensagem: //Não existe Programação de Abastecimento para <<xxxxxxxxx>> em <<mês/ano de referência informado>> para ser copiada//.
  - Verificar Existência de Programação de Abastecimento Já Informada:
    - Caso já exista no grid alguma programação de abastecimento informada, ou seja, o grid não está vazio, o sistema desabilita o botão //Copiar//.
</columns>

====== Preenchimento dos Campos ======
^Campo^Orientações para Preenchimento^
|**Dados da Programação de Abastecimento**| |
|Data Inicio|Campo obrigatório. Informe a data de inicio da programação de abastecimento, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
|Data Fim|Campo obrigatório. Informe a data de fim da programação de abastecimento, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
|Hora Inicio|Campo obrigatório. Informe a hora de inicio da programação de abastecimento, no formato hh:mm (hora, minuto).|
|Hora Fim|Campo obrigatório. Informe a hora de fim da programação de abastecimento, no formato hh:mm (hora, minuto).|


\\



====== Preenchimento dos Campos ======
^Campo^Orientações para Preenchimento^
|**Dados da Programação de Manutenção**| |
|Descrição|Campo obrigatório. Informe a descrição, com no máximo 200 (duzentos) caracteres.\\ Caso seja informado algum caracter especial na //Descrição//, o sistema exibe a mensagem //Descrição possui caracteres especiais//.|
|Situação|Campo obrigatório. Selecione uma das opções disponibilizadas pelo sistema.|
|Data Inicio|Campo obrigatório. Informe a data de inicio da programação de abastecimento, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
|Data Fim|Campo obrigatório. Informe a data de fim da programação de abastecimento, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
|Hora Inicio|Campo obrigatório. Informe a hora de inicio da programação de abastecimento, no formato hh:mm (hora, minuto).|
|Hora Fim|Campo obrigatório. Informe a hora de fim da programação de abastecimento, no formato hh:mm (hora, minuto).|


====== Funcionalidade dos Botões ======


^Botão^Descrição da Funcionalidade^ 
|{{:ajuda:lupa.gif?nolink|}}|Ao clicar no botão, o sistema permite consultar um dado na base de dados.|
|{{:ajuda:borracha.gif?nolink|}}|Ao clicar no botão, o sistema apaga o conteúdo do campo em exibição.|
|{{:ajuda:relfinanceiro:b_x_limpar.jpg?nolink|}}|Ao clicar no botão, o sistema limpa o conteúdo dos campos da tela.|
|{{:ajuda:botaopesquisar.jpg?nolink|}}|Ao clicar no botão, o sistema comanda a pesquisa, de acordo com os parâmetros informados.|
|{{:ajuda:copiar.png?nolink|}}|Ao clicar no botão, o sistema permite copiar dados de programação cadastrada para gerar nova programação de abastecimento.|
|{{:ajuda:adicionar.png?nolink|}}|Ao clicar no botão, o sistema exibe a tela popup para que sejam informados os dados da programação de abastecimento/manutenção.|
|{{:ajuda:calendario.gif?nolink|}}|Ao clicar no botão, o sistema permite selecionar uma data no calendário, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
|{{:ajuda:fechar.png?nolink|}}|Ao clicar no botão, o sistema fecha a tela popup.|
|{{:ajuda:inserir.png?nolink|}}|Ao clicar no botão, o sistema comanda a inserção dos dados da programação de abastecimento e manutenção.|
|{{:ajuda:relatorios:botao_remover_faixa.jpg?nolink|}}|Ao clicar no botão, o sistema remove uma programação de abastecimento/manutenção cadastrada.|
|{{:ajuda:desfazer.png?nolink|}}|Ao clicar no botão, o sistema desfaz o último procedimento realizado.|
|{{:ajuda:micromedicao:cancelar_1.jpg?nolink|}}|Ao clicar no botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:relatorios:concluir.jpg?nolink|}}|Ao clicar no botão, o sistema comanda a conclusão dos procedimentos de cadastramento de programação de abastecimento e manutenção.|

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

**[[=postgres:atendimento_ao_publico:uc0414|Informar Programação de Abastecimento e Manutenção]]**.

==== Termos Principais ====

**[[=ajuda:d#distrito_operacional|Distrito Operacional]]**

**[[=ajuda:z|Zona de Abastecimento]]**

**[[=ajuda:s#setor_de_abastecimento|Setor de Abastecimento]]**

===== Vídeos =====
**[[=treinamentos:livre:video-aulas:informar_programacao_de_abastecimento_e_manutencao|Informar Programação de Abastecimento e Manutenção]]**




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