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

====== Consulta Geral ======

Este caso de uso possibilita que gestores de concursos possam consultar de forma geral os candidatos aprovados em concursos e já registrados no sistema. A consulta pode ser filtrada através de opções como CPF e Nome do Candidato, Categoria do Concurso, Edital e Portaria de Nomeação. Além disso, é permitido que o resultado da consulta seja apresentada em formato de relatório.

Os gestores de concursos do setor de administração de pessoal são as pessoas que analisam este tipo de relatório.

Pré-requisitos para visualizar relatório:

  * [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo|Cadastrar Concursos/Processo Seletivo]];
  * Realizar o cadastro de [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_editais_e_resolucoes|Editais e Resoluções]].

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

Este caso de uso inicia-se quando o usuário acessa a opção //SIGRH -> Módulos -> Concursos -> Consultas/Relatórios -> Candidatos -> Consulta Geral//.

Os seguintes filtros são exibidos para que se realize uma consulta:

  * **CPF**: Tipo - NUMÉRICO;
  * **Passaporte**: Tipo - NUMÉRICO;
  * **Nome**: Tipo - TEXTO;
  * **Categoria de Concurso**: Tipo - TEXTO;
  * **Portaria de Nomeação (Número/Ano)**: Formato - Número da Portaria / Ano da Portaria, Tipo - NUMÉRICO;
  * **Edital (Número/Ano)**: Formato - Número do Edital / Ano do Edital, Tipo - NUMÉRICO;
  * **Formato de Impressão**: Tipo - LÓGICO.

Ao clicar em "Consultar" após informar algum filtro, caso a opção formato de impressão não tenha sido selecionada, é exibida uma listagem contendo os seguintes dados:

  * **__Nome__**: Tipo - TEXTO;
  * **__Tipo de Documento__**: Tipo - TEXTO;
  * **__Número de Documento__**: Tipo - NUMÉRICO;
  * **__Categoria de Concurso__**: Tipo - TEXTO;
  * **__Portaria de Nomeação(Número/Ano)__**: Formato - Número/Ano da Portaria, Tipo - TEXTO;
  * **__Edital(Número/Ano)__**: Formato - Número/Ano do Edital, Tipo - TEXTO;

Ao clicar em //Visualizar Detalhes// os seguintes dados do candidato são mostrados:

  * **__Nome__**: Tipo - TEXTO.
  * **__Data de Nascimento__**: Tipo - DATA. Formato DD/MM/AAAA.
  * **__Sexo__**: Tipo - TEXTO.
  * **__Estado Civil__**: Tipo - TEXTO.
  * **__Possui Alguma Deficiência__**: Tipo - TEXTO.
  * **__Documentos de Identificação__**:
    * **__Tipo de Documento__**: Tipo - TEXTO.
    * **__Número do Documento__**: Tipo - NUMÉRICO.
    * **__Identidade__**: Tipo - NUMÉRICO.
    * **__Órgão expedidor__**: Tipo - TEXTO.
    * **__Data de expedição__**: Tipo - DATA. Formato DD/MM/AAAA.
    * **__UF do RG__**: Tipo - TEXTO.
  * **__Endereço__**:
     * **__Logradouro__**: Tipo - TEXTO. 
     * **__Número__**: Tipo - NUMÉRICO.
     * **__Complemento__**: Tipo - TEXTO. 
     * **__Bairro__**:  Tipo - TEXTO. 
     * **__Município__**: Tipo - TEXTO.
     * **__UF__**: Tipo - TEXTO.
  * **__Contato__**:
    * **__E-mail__**: Tipo - TEXTO.
    * **__Telefone__**: Tipo - NUMÉRICO. 
    * **__Celular__**: Tipo - NUMÉRICO.

Caso a opção formato de impressão tenha sido selecionada, é exibido um relatório com opção de impressão.

Será exibido um cabeçalho com os filtros usados na consulta. Depois do cabeçalho serão exibidos os dados dos candidatos:

^Nome ^Tipo de Documento ^Número de Documento ^Categoria de Concurso ^Portaria de Nomeação(Número/Ano) ^Edital(Número/Ano)^
|Nome do Candidato | CPF | 999.999.999.99 |Categoria de Concurso |NÚMERO/ANO) |NÚMERO/ANO) |

O caso de uso é finalizado.

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

Não se aplica.

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

Não se Aplica

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigprh.concursos.dominio.Concurso | administrativo.concursos.concurso |
| br.ufrn.sigprh.concursos.dominio.VagaConcurso | administrativo.concursos.vaga_concurso |
| br.ufrn.sigprh.concursos.dominio.CandidatoAprovado | administrativo.concursos.candidato_aprovado |
| br.ufrn.sigprh.concursos.dominio.PortariaConcurso| administrativo.concursos.portaria_concurso |
| br.ufrn.sigprh.concursos.dominio.TipoConcurso| administrativo.concursos.tipo_concurso |


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

Sistema: SIGRH

Módulo: Concursos

Link(s): SIGRH -> Módulos -> Concursos -> Consultas/Relatórios -> Candidatos -> Consulta Geral

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_CONCURSO

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


  * [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo|Cadastrar Concursos/Processo Seletivo]];
  * Realizar o cadastro de [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_editais_e_resolucoes|Editais e Resoluções]].
  * Dentre os concursos já cadastrados, acessar o relatório, filtrando com todas as possibilidades, a fim de validar o filtro criado. 

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

Não se aplica.

</ifauth>