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

====== Relatório de Candidatos por Portaria ======

Este caso de uso consiste em gerar um relatório dos candidatos homologados em um determinado concurso, exibindo as principais informações dos candidatos e do concurso, com opção de filtro de uma portaria específica.

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

Antes de gerar este relatório é necessário:

  *Ter um concurso cadastrado ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo| Cadastrar Concurso ]])
  *Ter vagas cadastradas para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]])
  *Ter candidatos cadastrados para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:cadastrar_alterar_candidatos| Cadastrar Candidatos ]] )
  *Ter uma portaria de nomeação cadastrada para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]] )

===== 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 -> Candidatos por Portaria//

O caso de uso inicia solicitando do usuário as seguintes informações:

  * **Tipo***: Tipo - TEXTO. Opções Exibidas: PORTARIA DO MEC, PORTARIA DE AUTORIZAÇÃO, PORTARIA DE NOMEAÇÃO, PORTARIA DE EXONERAÇÃO, PORTARIA DE DISTRIBUIÇÃO, PORTARIA DE REMOÇÃO, PORTARIA DE VACÂNCIA e PORTARIA DE TORNAR SEM EFEITO.
  * **Número***: Tipo - NUMÉRICO.
  * **Ano***: Formato - AAAA, Tipo - NUMÉRICO.

Após digitar as informações acima solicitadas e clicar no botão Gerar Relatório, será encaminhado para o relatório.

Será exibido um cabeçalho com os dados da portaria em questão:

**Relatório dos Candidatos por Portaria**

  * **__Tipo de Portaria__**: Tipo - TEXTO;
  * **__Número__**: Tipo - NUMÉRICO;
  * **__Ano__**: Formato - AAAA, Tipo - NUMÉRICO.

Depois do cabeçalho serão exibidos os dados das vagas. O relatório é agrupado por concursos (visto que uma mesma portaria pode ter diversos concursos associados):

^Cargo ^Edital ^Área ^Unidade ^Vagas ^Homologadas ^
|Tipo TEXTO|Tipo TEXTO; Formato 9999/AAAAA|Tipo TEXTO|Tipo TEXTO|Tipo NUMERICO|Tipo NUMERICO|

CANDIDATOS SEM NENHUM TIPO DE DEFICIÊNCIA  	QTD. VAGAS = X  	QTD. HOMOLOGADAS = X([[#principais_regras_de_negócio|RN01]])

^Class. ^Nome ^Tipo de Documento ^Número do Documento ^Resolução de Homologação ^Obs. ^Portaria de Nomeação ^Obs. ^Situação ^
|1º | CANDIDATO 1 | CPF | 999.999.999-99 | Tipo TEXTO; Formato 9999(DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO; Formato 9999/AAAAA (DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO |
|2º | CANDIDATO 2 | CPF | 999.999.999-99 | Tipo TEXTO; Formato 9999(DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO; Formato 9999/AAAAA (DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO |
|3º | CANDIDATO 3 | CPF | 999.999.999-99 | Tipo TEXTO; Formato 9999(DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO; Formato 9999/AAAAA (DD/MM/AAAA) | Tipo TEXTO | Tipo TEXTO |
| **Observação da Vaga**: OBSERVAÇÃO |||||||||
| **Histórico da Vaga**: HISTÓRICO |||||||||

Total de Vagas Cadastradas: 2

Total de Vagas Homologadas: 5

Então o caso de uso é finalizado.

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

  * **RN01** - Serão exibidas listagens separadas para candidatos com deficiência e sem deficiência. Caso não haja candidato em uma das condições, a listagem não será exibida.
  * **RN02** - Candidatos desistentes não são considerados na contagem final.

===== 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 |


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

Sistema: SIGRH

Módulo: Concursos

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

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_CONCURSO

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

  * Para realizar o cadastro de uma portaria para mais de um concurso, acesse o caso de uso [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]] e cadastre portarias com o mesmo número, ano e tipo para mais de um concurso;
  * 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 =====

Antes de realizar este caso de uso é necessário:

  *Ter um concurso cadastrado ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo| Cadastrar Concurso ]])
  *Ter vagas cadastradas para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]])
  *Ter candidatos cadastrados para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:cadastrar_alterar_candidatos| Cadastrar Candidatos ]] )
  *Ter uma portaria de nomeação cadastrada para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]] )

</ifauth>