~~ODT~~

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

====== Bolsistas Ativos ======

Este caso de uso é acessado por gestores organizacionais para verificar quais são os bolsistas ativos na instituição. Entende-se como bolsista ativo o discente/docente que possua uma bolsa ainda ativa no sistema.

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

O caso de uso é acionado quando o usuário acessa a opção: //SIGRH -> Dimensionamento -> Operações -> Relatórios -> Bolsistas Ativos//. 

Os seguintes filtros são exibidos na busca:

   * **Unidade**: Formato - Nome da Unidade (Código da Unidade), Tipo - TEXTO ([[#principais_regras_de_negocio|RN01]]);
   * **Vigência da Bolsa**: Formato - DD/MM/AAAA, Tipo - DATA.

O relatório gerado possui as seguintes informações:
   * **__Unidade__**: Tipo - Texto, Formato - Nome da Unidade (Código)
   * **__Matrícula__**: Tipo - Numérico
   * **__Nome__**: Tipo - Texto
   * **__Curso__**: Tipo - Texto
   * **__Início da Bolsa__**: Tipo - DATA, Formato - DD/MM/AAAA
   * **__Fim da Bolsa__**: Tipo - DATA, Formato - DD/MM/AAAA

^Matrícula ^Nome ^Curso ^Início da Bolsa ^Fim da Bolsa^
|Unidade: NOME UNIDADE (90.90)|||||
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|Unidade: NOME UNIDADE (90.90)|||||
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|Unidade: NOME UNIDADE (90.90)|||||
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|
|898978|Aluno Testes e Mais|Curso do Aluno Testes|90/90/1909|89/89/2011|

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

  * **RN01** - Quando o usuário logado possuir papel com exigência de vinculação a uma unidade, todas as operações somente podem ser realizadas para servidores lotados na unidade que foi vinculada ao papel. Caso contrário, as operações podem ser realizadas para servidores lotados em qualquer unidade.

  * **RN02** - Se for gestor organizacional, pode consultar de qualquer unidade de lotação. Se for chefe ou vice de unidade, o combo deve vir apenas com as unidades da responsabilidade do servidor.

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

Não se aplica.
<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sipac.bolsas.dominio.SolicitacaoBolsa | administrativo.bolsas.solicitacao_bolsa |
| br.ufrn.sipac.bolsas.dominio.OportunidadeEstagio | administrativo.bolsas.oportunidade_estagio |
| br.ufrn.sipac.bolsas.dominio.Bolsa | administrativo.bolsas.bolsa |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.tipo_bolsa |



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

Sistema: SIGRH

Módulo: Dimensionamento

Link(s): SIGRH -> Módulos -> Operações -> Relatórios -> Bolsistas Ativos 

Usuário: mirian

Papel que usuário deve ter: SipacPapeis.GESTOR_ORGANIZACIONAL, SigrhPapeis.GESTOR_UNIDADE, SigrhPapeis.VICE_GESTOR_UNIDADE


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

A regra de negócio ([[#Principais Regras de Negócio|RN01]]) pode ser validada da seguinte forma: [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cenarios_de_testes_comuns#ct01|CT01]]

A regra de negócio ([[#Principais Regras de Negócio|RN02]])pode ser validada seguindo os seguintes passos:

1º No SigAdmin -> Gestão de Unidades -> Responsáveis Por Unidade -> Cadatrar/Alterar(com login "gleydson"), cadastrar um "Chefes" e um "Vice chefes" para uma unidade (Apenas unidades com servidores Lotados - vide select em dados para teste);

*Importante focar que os servidores que serão cadastrados no passo 1º, deverão ter também o papel "SigrhPapeis.EMITE_RELATORIO_CALCULOS".

2º Acessar o link do UC descrito no Plano de Teste com os usuários cadastrados no passo um e gerar o relatório (Em formato Impressão e em formato PDF).


Caso de uso para [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:cadastros:cadastros:bolsista:cadastrar|Cadastrar Bolsistas]]

Caso de uso para  [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:bolsas:oportunidades_de_bolsas:listar_oportunidades_ativas_de_bolsas|Listar Oportunidades de Bolsas Ativas]]

Caso de uso para 
[[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:bolsas:oportunidades_de_bolsas:ver_alunos_interessados_cadastrar_bolsista|Ver Alunos Interessados (Cadastrar Bolsista)]]


Os testes podem serem feitos pelos seguintes links:
  *Portal do Servidor -> Chefia da Unidade -> Dimensionamento -> Relatórios -> Bolsistas Ativos
  *Portal da Chefia da Unidade -> Outros -> Dimensionamento -> Relatórios -> Bolsistas Ativos


===== Dados de Teste =====

  * Consulta que pode ser usada para recuperar bolsistas ativos.

<code sql>
select b.matricula, 
       p.nome, 
       curso.denominacao as "curso", 
       bolsa.inicio, 
       bolsa.fim, 
       setor.id_unidade, 
       setor.nome as "nome_unidade",
       setor.codigo_unidade 
from bolsas.bolsa bolsa 
     inner join bolsas.bolsista b on b.id = bolsa.id_bolsista  
     inner join comum.pessoa p on p.id_pessoa = b.id_pessoa 
     inner join comum.unidade setor on setor.id_unidade = bolsa.id_setor_trabalho 
     inner join academico.curso curso on b.id_curso = curso.id_curso 
where 1 = 1 
order by setor.nome, 
         p.nome
limit '10';
         
</code>

</ifauth>