~~ODT~~

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

====== Relatório de Bolsistas por Período ======
Este caso de uso permite que coordenadores de cursos do nível Stricto Sensu obtenham uma lista com os discentes que possuem bolsas de estudo do período consultado.

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

Este caso de uso inicia-se quando a opção //SIGAA -> Módulos -> Portal Coord. Stricto Sensu -> Relatórios -> Relatórios de Bolsistas por Período// é acessada.

=== Passo 1 ===     

Será exibido o formulário //Dados do Relatório//, onde o Coordenador deverá informar o período que deseja realizar a consulta. A consulta dos bolsistas poderá ser feita  apenas no programa a qual cada Coordenador está vinculado no Sistema ([[#principais_regras_de_negócio|RN02]]) .

  * __**Programa:**__ Tipo - TEXTO.
  * **Ano - Período*:** Formato - AAAA-9, Tipo - NUMÉRICO.

=== Passo 2 ===

O Sistema exibirá um relatório, ordenado por nome, com a data inicial e final equivalente ao período informado na tela //Dados do Relatório// ([[#principais_regras_de_negócio|RN01]]). O usuário poderá realizar a impressão do relatório de bolsistas. As seguintes informações poderão ser visualizadas:

  * __**Relatório de Bolsistas por Período**__
    * __**Programa:**__ Tipo - TEXTO. 
    * __**Período:**__ Formato - DD/MM/AAAA até DD/MM/AAAA, Tipo - DATA.
    * __**Matrícula:**__ Formato - 9999999999, Tipo - NUMÉRICO.
    * __**Nome:**__ Tipo - TEXTO.
    * __**Data Início:**__ Formato DD/MM/AAAA, Tipo - DATA.
    * __**Data Fim:**__ Formato DD/MM/AAAA, Tipo - DATA.
    * __**Tipo da bolsa:**__ Tipo - TEXTO.


Modelo do Relatório:

^Matrícula^ Nome  ^ Status Discente ^  Data \\ Início  ^  Data Fim  ^ Tipo da Bolsa ^  Status \\ da \\ Bolsa  ^
|9999999999|Nome do discente|Status do discente|DD/MM/AAAA|DD/MM/AAAA|Mestrado/Doutorado | Status|
|------|------ | ------|------ | ------|------ | ------|

O caso de uso é finalizado.


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

  * **RN01:** Na geração do relatório, o Sistema trará o período especificado pela Data Inicial e Final de vigência do período informado pelo usuário no campo Ano-Período. 
  * **RN02:** Cada Coordenador só poderá visualizar os bolsistas referentes ao programa ao qual está logado no Sistema.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.MatriculaComponente  | sigaa.ensino.matricula_componente  |
| br.ufrn.sigaa.ensino.dominio.SituacaoMatricula    | sigaa.ensino.situacao_matricula    |
| br.ufrn.sigaa.pessoa.dominio.Discente             | sigaa.public.discente              |
| br.ufrn.sigaa.ensino.dominio.ComponenteCurricular | sigaa.ensino.componente_curricular |


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

Sistema: SIGAA

Módulo: Portal Coord. Stricto Sensu

Link(s): Relatórios -> Relatório de Bolsistas por Período

Usuário: thais, pauloyvens

Papel que usuário deve ter: SigaaPapeis.GESTOR_STRICTO

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

Não se aplica.

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

 SQL que retorna os dados dos alunos:
    select distinct d.matricula, p.nome, d.id_discente, c.nivel  
    from ensino.matricula_componente m, discente d, pessoa p,
         ensino.situacao_matricula s, ensino.componente_curricular c
    where m.id_discente = d.id_discente
    and d.id_pessoa = p.id_pessoa
    and m.id_situacao_matricula = s.id_situacao_matricula
    and m.id_componente_curricular = c.id_disciplina
    and c.nivel in ('S','E','D')
    -- and c.id_unidade = unidade			
    order by c.nivel, p.nome;

 SQL que retorna os dados dos bolsistas (SIPAC):
    select aluno.id_discente as id_discente, tipo_bolsa.id as id_tipo_bolsa, 
           tipo_bolsa.denominacao as denominacao, bolsa.inicio, bolsa.fim 
    from  bolsas.bolsista bolsista, bolsas.bolsa  bolsa, academico.aluno aluno, 
          bolsas.tipo_bolsa tipo_bolsa 
    where bolsa.id_bolsista = bolsista.id and bolsista.id_aluno = aluno.id_aluno 
    and bolsa.id_tipo_bolsa = tipo_bolsa.id