~~ODT~~

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

====== Relatório Quantitativo de Solicitações de Serviço por Situação ======
Este relatório exibirá a quantidade de solicitações realizadas pelos servidores agrupando-as inicialmente por situação (cancelada, registrada, ...).

São responsáveis por esse relatório os gestores de serviços.

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

Esse caso de uso inicia quando o usuário acessa: //SIGRH -> Módulo Serviços -> Serviços -> Relatórios -> Quantitativo de Solicitações de Serviço por Situação//.

Será exibido uma tabela com as opções de filtro para a busca.
 
   * **Unidade de Exercício**: Tipo - TEXTO, AUTOCOMPLETE. Entrada de Dados: Código da Unidade, Nome da Unidade. Indica a unidade de exercício do servidor;
   * **Considerar Unidades Vinculadas à Unidade de Exercício**: TIPO - LÓGICO.
   * **Unidade de Lotação**: Tipo - TEXTO, AUTOCOMPLETE. Entrada de Dados: Código da Unidade, Nome da Unidade. Indica a unidade de lotação do servidor.
   * **Considerar Unidades Vinculadas à Unidade de Lotação**: TIPO - LÓGICO.
   * **Servidor**: Formato - NOME DO SERVIDOR, Tipo - AUTOCOMPLETE. Entrada de Dados: Matrícula SIAPE, NOME DO SERVIDOR, CPF e Nome de Identificação.
   * **Situação**: Tipo - TEXTO.
   * **Agrupamento**:Tipo - TEXTO. Apresenta as opções de agrupamento por período ([[#principais_regras_de_negócio|RN01]]), mês/ano e ano ([[#principais_regras_de_negócio|RN02]]).

Ao realizar a busca, um relatório já no formato de impressão será gerado e seu formato varia de acordo com o agrupamento escolhido.
^ Situação ^ Quantidade ^ Mês/Ano ([[#principais_regras_de_negócio|RN03]]) ^ Ano ([[#principais_regras_de_negócio|RN04]])^
| Cancelado | 12 | Janeiro/2011 | 2011 |
| Registrado | 2 | Janeiro/2011 | 2011 |
| Registrado | 5 | Feveriro/2011 | 2011 |
É disponibilizada ainda, a opção de cancelar a busca.

O caso de uso é finalizado.

===== Principais Regras de Negócio =====
  * **RN01** - A seleção do início e do fim do período é obrigatório.
  * **RN02** - A especificação de um mês ou ano não é obrigatória.
  * **RN03** - Essa coluna só será exibida caso o agrupamento por Mês/Ano seja selecionado.
  * **RN04** - Essa coluna só será exibida caso o agrupamento por Ano seja selecionado.

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

Não se Aplica.

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


^ Classe ^ Tabela |
| br.ufrn.sigrh.funcional.dominio.SolicitacaoServico | administrativo.funcional.solicitacao_servico |


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

Sistema: SIGPRH

Módulo: Serviços

Link(s): Aba Serviços -> Relatórios -> Quantitativo de Solicitações de Serviço por Situação 

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_SERVICOS

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

Gerar o relatório utilizando todos os filtros nas mais diversas combinações e verificar se o relatório gerado está de acordo com os filtros informados. Verificar também se os dados batem com os valores do banco.

===== Dados para o Teste =====
Consulta base para geração do relatório:

<code sql>
select
sse.denominacao
, year(data_cadastro)
,count(*)
from funcional.solicitacao_servico ss join funcional.status_servico sse using(id_status_servico)
group by year(data_cadastro), sse.denominacao
order by year(data_cadastro), sse.denominacao
</code>