~~ODT~~

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

====== Gastos por Tipo de Bolsa e por Período ======

Esse caso de uso gera o relatório de gastos com bolsas em um período de meses de um determinado ano por tipo de bolsa. Os gastos das bolsas são obtidos a partir das frequências enviadas referentes a cada bolsa. Assim, este relatório exibe as quantidades de bolsas cujas frequências foram enviadas, no período informado, e o valor total gasto por estas bolsas, estas informações são separadas pelo tipo das bolsas.

O relatório dos gastos com bolsas pode ser visualizado pelos usuários responsáveis da Pró-Reitoria de Administração - PROAD, mais especificamente da Seção de Bolsas.

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

O caso de uso começa mostrando as opções para a geração do relatório. Estas opções são: 

  * **Mês Inicial/Final***: Formato - MÊS/MÊS, Tipo - TEXTO.
  * **Ano***: Formato - AAAA, Tipo - NUMÉRICO.
  * **Incluir bolsas de convênio **: Tipo LÓGICO.

Ao realizar a consulta o sistema exibe os seguintes dados dos gastos das bolsas, conforme modelo: 

**__Relatório de Gastos por Tipo de Bolsa e por Período__**

  * **__Período__**: Formato - MÊS ABREVIADO./AAAA à MÊS ABREVIADO./AAAA, Tipo - TEXTO e NUMÉRICO.
  * **__Incluir bolsas de convênio__** ([[gastos_por_tipo_de_bolsa_e_por_periodo#Principais Regras de Negócio|RN01]]): Tipo TEXTO.

^ ^  Jan./AAAA  ^^  Fev./AAAA  ^^  Mar./AAAA  ^^  Abr./AAAA  ^^  Mai./AAAA  ^^  Jun./AAAA  ^^  MÊS ABREVIADO./AAAA  ^^  Total  ^^
^ Tipo da Bolsa  ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^  Qtd. ^  Valor ^
|DENOMINAÇÃO (SIGLA UNIDADE PAGADORA)  |  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|
| ------  |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |  ------ |
|  **Totais** |  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  999 |  R$ 99.99|  

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

  - **RN01** - Os tipo de bolsas de convênio só são mostradas caso a opção //**Incluir bolsas de convênio**// seja informada.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.bolsas.dominio.Bolsa | administrativo.bolsas.bolsa |
| br.ufrn.sipac.bolsas.dominio.Frequencia | administrativo.bolsas.frequencia |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.tipo_bolsa |

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

Sistema: SIPAC

Módulo: Bolsas

Link(s): Módulos -> Bolsas -> Operações -> Relatórios -> Gastos por Tipo de Bolsa e por Período

Usuário: rcn

Papel que usuário deve ter: SipacPapeis.GESTOR_BOLSAS_GLOBAL

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

O registro de frequências de uma bolsa para o mês atual, ocasionando a alteração do relatório neste mês, pode ser feito pelo caminho:

  * Módulos -> Bolsas -> Operações -> Operações -> Frequências -> Enviar Folha de Frequência

OBS.: Por determinação da PROAD/UFRN, não é possível o envio de frequências fracionadas. Apenas 0% ou 100% são aceitos. Assim, caso seja informado a frequência 0%, o valor gasto para essa bolsa será 0 e ao informar 100% o valor gasto para esta bolsa será o valor atual da bolsa. A consulta abaixo retorna o valor atual da bolsa pelo tipo informado.

<code sql>
SELECT tipo.valor
FROM bolsas.tipo_bolsa tipo
WHERE tipo.denominacao = '<DENOMINAÇÃO DO TIPO DE BOLSA>'
</code>


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

Abaixo segue a consulta SQL para a obter os dados do relatório de acordo com as opções informadas:

<code sql>
SELECT f.mes_pgto, f.ano_pgto, tipo.id AS id_tipo, tipo.denominacao, u.sigla, sum(1) AS qtd, sum(f.valor) AS valor 
FROM bolsas.bolsa b, bolsas.frequencia f, bolsas.tipo_bolsa tipo, comum.unidade u 
WHERE b.id = f.id_bolsa 
AND tipo.id = b.id_tipo_bolsa 
AND u.id_unidade = tipo.id_unidade_pagadora 
AND f.mes_pgto >= <MÊS INICIAL> 
AND f.mes_pgto <= <MÊS FINAL> 
AND f.ano_pgto = <ANO> 
AND b.id_convenio is null -- Caso a opção Incluir bolsas de convênio não tenha sido informada, caso contrário, retire a cláusula. 
GROUP BY f.mes_pgto, f.ano_pgto, tipo.id, tipo.denominacao, u.sigla 
ORDER BY tipo.denominacao, f.ano_pgto, f.mes_pgto
</code>

  * OBS.: Os meses vão de 0(Janeiro) à 11(Dezembro)

Os valores gastos pelo tipo de bolsa pode ser verificados pela caminho:

  * Módulos -> Bolsas -> Operações -> Operações -> Pagamentos -> Gerar Folha de Pagamento

Onde devem ser informados o //tipo da bolsa//, o mês e ano do //Pagamento//, caso o campo //Formato Emissão// seja mostrado informar a opção //TODAS// e a opção //Ocultar Alunos do Relatório//.