====== Demonstrativo de Excedentes de Cotas de Bolsas ======

Permite a geração de relatórios de Demonstrativos de Excedentes de Cotas de [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:bolsas:negocio|bolsas]], informando os valores gastos com cotas extras.

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

     *É pedido ao usuário o período a ser considerado, assim como o tipo de bolsa, podendo ser todas.

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

     *É necessário informar tanto o período quanto o tipo de bolsa.

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

^ Classe ^ Tabela |
| sipac.bolsas.cota_bolsa | br.ufrn.sipac.bolsas.dominio.CotaBolsa |
| sipac.bolsas.tipo_bolsa | br.ufrn.sipac.bolsas.dominio.TipoBolsa |


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

Sistema: SIPAC

Módulo: BOLSAS

Link(s): Bolsas -> Operações-> Relatórios -> Demonstrativo de Excedentes de Cotas de Bolsas

Usuário: 
        rcn

Papel que usuário deve ter: SipacPapeis.GESTOR_BOLSAS_GLOBAL

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

A tela de geração do relatório é bastante simples, apenas com a entrada de dois dados. O ano e o tipo de bolsa, sendo ambas informações obrigatorias.

Nâo existem muitas entradas no banco para isto ainda, a tabela é bem recente. Poderá ser verificada entradas que trarão resultados analisando a tabela referente à classe CotaBolsa.

A consulta para tal seria:

       select count(cota_bolsa.id_cota_bolsa), tipo_bolsa.denominacao 
            from bolsas.cota_bolsa left join bolsas.tipo_bolsa on bolsas.cota_bolsa.id_tipo_bolsa = bolsas.tipo_bolsa.id
	        group by cota_bolsa.id_cota_bolsa, tipo_bolsa.denominacao

Neste caso obtemos como resultado a quantidade de cota_bolsa e a denominação do seu tipo, esta denominação é a usada para gerar o relatório.
Rodando hoje na minha máquina obtive o seguinte resultado:

{{:desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:relatorios:resultado.jpg|}}

Se necessário pode-se prolongar a busca para trazer o ano também, neste caso ela seria:
        select count(cota_bolsa.id_cota_bolsa), tipo_bolsa.denominacao,  cota_bolsa.ano
            from bolsas.cota_bolsa left join bolsas.tipo_bolsa on bolsas.cota_bolsa.id_tipo_bolsa = bolsas.tipo_bolsa.id
	       group by cota_bolsa.id_cota_bolsa, tipo_bolsa.denominacao, cota_bolsa.ano

No caso, os dois exemplos acina sâo do ano de 2009.