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

====== Relatório do Quantitativo de Concursos ======

Este caso de uso gera um relatório quantitativo analítico das vagas referentes à um determinado tipo de concurso selecionado e a um ano de referencia. O relatório é usado pelos gestores de Concurso.

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 cadastrado editais/resoluções para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_editais_e_resolucoes|Cadastrar/Alterar Editais e Resoluções]])
  *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 quando o usuário acessa a opção: ''SIGRH -> Concursos -> Consultas/Relatórios -> Candidatos -> Quantitativo de Concursos''.

Para emitir o relatório, após acessar o link indicado acima, o usuário será encaminhado para uma página para filtrar/selecionar uma categoria do concurso que deseja analisar os quantitativos. Será apresentado um filtro com os seguintes dados:

  * **Categoria do Concurso**: Tipo - TEXTO. São apresentadas opções: ''Todas as Categorias ([[#Principais_regras_de_negocio|RN03]]), Professor Efetivo, Professor Efetivo Equivalente, Professor Substituto ou Técnico Administrativo'';
  * **Ano***: Tipo - DATA;

Ao acessar o botão de gerar relatório, será gerado no seguinte formato:

  * Modelo de Relatório

([[#Principais_regras_de_negocio|RN01]]) - ([[#Principais_regras_de_negocio|RN02]]) - ([[#Principais_regras_de_negocio|RN04]])

| **Categoria**: 	Professor Efetivo ||||||
| **Ano**: 	2011 ||||||
| ||||||
^Editais  ^  Vagas Cadastradas^  Vagas Reabertas^  Vagas em Andamento^  Vagas Providas^  Vagas para Reabertura^
|999/AAAAA (DD/MM/AAA)|  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |
|999/AAAAA (DD/MM/AAA)|  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |
|Aproveitamentos|  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |
|Redistribuições|  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |  Tipo Numérico |
|TOTAL|  Soma da Coluna |  Soma da Coluna |  Soma da Coluna |  Soma da Coluna |  Soma da Coluna |


O caso de uso é finalizado.

===== Principais Regras de Negócio =====
  * **RN01** - Para cada edital, serão listados seus quantitativos individuais, mas as vagas de redistribuição e aproveitamento ficam concentradas em uma única linha.
  * **RN02** - Será repetido o quadro quantitativo, no caso de selecionar todas as categorias, onde sera repetido para cada categoria de concurso, levando em consideração que **Professor Efetivo**, **Professor Efetivo Equivalente**, **Professor Efetivo do Magistério Superior** e **Professor Efetivo do Ensino Básico, Técnico e Tecnológico** serão considerados como mesma categoria.
  * **RN03** - Caso o filtro usado para categorias seja "TODAS AS CATEGORIAS", no Final do relatório será gerado um resumo quantitativo geral.
  * **RN04** - Editais são considerados iguais caso tenham número, ano e data de cadastro iguais.

==== 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 -> Quantitativo de Concursos.

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_CONCURSOS

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

Emitir o relatório e analisar as regras de negócio. A ([[#Principais_regras_de_negocio|RN04]]) pode ser validada cadastrando-se editais através de [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_editais_e_resolucoes|Cadastrar/Alterar Editais e Resoluções]] e em seguida cadastrando vagas para este edital através de [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]].

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


  *[[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo| Cadastrar Concurso ]]
  * [[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_editais_e_resolucoes|Cadastrar/Alterar Editais e Resoluções]]
  *[[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]]
  *[[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:cadastrar_alterar_candidatos| Cadastrar Candidatos ]]
  *[[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]]
  *[[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:homologacao_nomeacao_e_posse_candidatos|Homologação/Nomeação e Posse dos Candidatos]]

</ifauth>