~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>


====== Consultar Solicitação de Auxílio ======

Esse caso de uso tem por objetivo realizar consulta sobre solicitações de auxílios registradas no sistema. O gestor do departamento de administração de pessoal é responsável por tal funcionalidade.

===== Descrição do Caso de Uso =====

O caso de uso inicia quando o usuário acessa //SIGRH -> Administração de Pessoal -> Aba Serviços -> Consultas -> Solicitações de Auxílio//.

No primeiro passo, o usuário realiza uma busca usando um formulário que contém as seguintes informações:
  * **Tipo do Benefício**: Tipo - TEXTO. 
  * **Número/Ano**: Tipo - NUMÉRICO, Formato - 99999999/AAAA
  * **Servidor**: Tipo AUTOCOMPLETE, formato: NOME SERVIDOR, entrada de dados: NOME ou SIAPE ([[#Principais Regras de Negócio|RN01]])
  * **Unidade do Exercício**:  Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE), entrada de dados: DENOMINAÇÃO ou CÓDIGO ([[#Principais Regras de Negócio|RN01]])
  * **Unidade do Lotação**:  Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE), entrada de dados: DENOMINAÇÃO ou CÓDIGO ([[#Principais Regras de Negócio|RN02]])
  * **Situação**: Tipo - TEXTO. As seguintes opções são mostradas: SOLICITADA, CANCELADA, AUTORIZADA, FINALIZADA, NEGADA.
  * **Período de Cadastro**: Tipo - DATA. Formato - dd/mm/aaaa
  * **Período de Autorização**: Tipo - DATA. Formato - dd/mm/aaaa

A consulta retornada apresenta as solicitações com os seguintes dados:
  * **__Número/Ano__**: Tipo NUMÉRICO, formato: ...9/AAAA.
  * **__Data de Cadastro__**: Tipo DATA.
  * **__Servidor__**: Tipo TEXTO, formato: NOME SERVIDOR (MATRÍCULA SIAPE).
  * **__Unidade de Exercício__**: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE(CÓDIGO UNIDADE).
  * **__Unidade de Lotação__**: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE(CÓDIGO UNIDADE).
  * **__Status__**: Tipo TEXTO.
  * **__Tipo de Auxílio__**: Tipo TEXTO;

Para cada solicitação listada, o sistema disponibiliza as opções de: **Visualizar**, **Cancelar**, **Finalizar**, **Reativar** ou **Retornar**.

=== Visualizar Solicitação === 

Caso o usuário deseje visualizar os dados de uma determinada solicitação, o sistema exibe: 

    * **Dados Gerais**:
      * **__Número/Ano__**: Tipo NUMÉRICO, formato: ...9/AAAA.
      * **__Data de Cadastro__**: Tipo DATA.
      * **__Situação__**: Tipo TEXTO.
      * **__Tipo de Auxílio__**: Tipo TEXTO.
      * **__Observações__**: Tipo TEXTO
      * **__Data de Vigência__**: Tipo DATA, Formato DD/MM/AAAA
      * **Check box** de termos de aceitação: Declaro, sob as penas da Lei, serem verdadeiras as informações acima prestadas e, para tanto, autorizo o devido desconto em folha da minha participação no custeio do benefício  da Assistência Alimentar (Decreto nº 977, de 10 de setembro de 1993).

    * **Servidor Interessado**:
      * **__Nome__**: Tipo TEXTO.
      * **__Matrícula__**: Tipo NUMÉRICO.
      * **__Jornada__**: Tipo TEXTO.
      * **__Lotação__**: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE.
      * **__Cargo__**: Tipo TEXTO.

    * **Dependentes Beneficiados** - Uma listagem contendo os beneficiados pelo servidor, com os dados:
      * **__Nome__**: Tipo TEXTO.
      * **__Grau de parentesco__**: Tipo TEXTO.
      * **__Data de Nascimento__**: Tipo DATA.
      * **__Idade__**: Tipo NUMÉRICO.
      * **__Documento__**: Tipo TEXTO.
      * **__Status do Cadastro__**: Tipo TEXTO.
      * **__CPF__**: Tipo NUMÉRICO. Formato 999.999.999-99.

    * **Dependentes Ativos com Grau de Parentesco Cônjuge** - Uma listagem contendo os beneficiados com grau de parentesco cônjuge, exibindo os dados:
      * **__Nome__**: Tipo TEXTO.
      * **__Data de Nascimento__**: Tipo DATA.
      * **__Idade__**: Tipo NUMÉRICO.
      * **__Documento__**: Tipo TEXTO.
      * **__Status do Cadastro__**: Tipo TEXTO.
      * **__CPF__**: Tipo NUMÉRICO. Formato 999.999.999-99.

    * **Lista dos Arquivos Anexados**:
      * **__Arquivo__***: Tipo - TEXTO
      * **__Descrição__***: Tipo - TEXTO

=== Cancelar, Finalizar, Reativar ou Retornar Solicitações === 

Caso o usuário deseje **Cancelar** ([[#Principais Regras de Negócio|RN03]]), **Finalizar** ([[#Principais Regras de Negócio|RN04]]), **Reativar** ([[#Principais Regras de Negócio|RN05]]) ou **Retornar** ([[#Principais Regras de Negócio|RN06]]) uma determinada solicitação de auxílio , o sistema exibe os mesmos dados descritos anteriormente com a adição de:
    * **Observações/Justificativas***: Tipo - TEXTO.

===== ===== 

O caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - Este caso de  uso segue os casos de testes descritos em [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cenarios_de_testes_comuns#ct01|Casos de Teste Comuns]].
  * **RN02** - Este campo só aparece para preenchimento ou para exibição caso o parâmetro __UTILIZA_CONCEITO_EXERCICIO__ esteja setado como "**true**".
  * **RN03** - A opção de **Cancelar**, apenas se o status da solicitação for **AUTORIZADA**, ao clicar para cancelar, vai para uma tela que exige uma justificativa. A confirmação vai implicar em mudar status da solicitação para CANCELADA.
  * **RN04** - A opção de **Finalizar**, apenas se o status da solicitação for **AUTORIZADA**, ao clicar para finalizar, vai para uma tela que exige uma justificativa. A confirmação vai implicar em mudar status da solicitação para FINALIZADA.
  * **RN05** - A opção de **Reativar**, apenas se o status da solicitação for **NEGADA** ou **CANCELADA**, ao clicar para reativar vai para uma tela que exige uma justificativa. A confirmação implica em mudar status da solicitação para **AUTORIZADA**.
  * **RN06** - Ao clicar para retornar implica em mudar status da solicitação para **RETORNADA**.

==== Resoluções/Legislações Associadas ====

Não se Aplica.  

<ifauth @admin>

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigrh.funcional.dominio.Servidor | administrativo.rh.servidor |
| br.ufrn.sigrh.pessoal.dominio.Dependente| administrativo.pessoal.dependente |

====== Plano de Teste ======

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Administração de Pessoal -> Serviços -> Consultas -> Solicitações de Auxílios

Usuário: ananayra, agobrito, mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_DAP


===== Cenários de Teste =====

As solicitações que podem ser consultadas por este caso de uso são as solicitações cadastradas em:

  * [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios_solicitacoes:auxilios:alimentacao:solicitar|Solicitar Auxílio Alimentação]]

  * [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios_solicitacoes:auxilios:natalidade:solicitar|Solicitar Auxílio Natalidade]]

  * [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:auxilios_solicitacoes:auxilios:pre-escolar:solicitar|Solicitar Auxílio Pré-Escolar]]

===== Dados para o Teste =====

  * Retorna as regras de dependências cadastradas no sistema e associadas ao tipo de benefício auxílio pré-escolar indireta.

<code>
SELECT * FROM rh_tipos.relacao_parent_cond_benef WHERE id_tipo_beneficio_dependente = 1 AND ativo IS TRUE
</code>

</ifauth>