~~ODT~~

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

====== Relatório Sintético De Cargos Por Lotação ======

Esse caso de uso tem por finalidade gerar um relatório sintético de cargos por lotação. Ele tem opção de impressão e para ser gerado precisa ser informado um filtro de data limite para admissões e desligamentos. 

O responsável por esse caso de uso é o gestor de pessoal.

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

O caso de uso inicia quando o usuário acessa //SIGRH → Administração de Pessoal → Consultas/Relatórios → Relatórios → Relatórios → Relatório Sintético de Cargos por Lotação//. 

Para gerar o relatório o usuário informa os seguintes dados:
  * **Unidade Raiz**: Tipo - AUTOCOMPLETE. Entrada de Dados - Código da Unidade ou Nome da Unidade.
  * **Incluir Unidades Vinculadas:** Tipo - LÓGICO. ([[#Principais Regras de Negócio|RN02]])
  * **Data Limite para Admissão e Desligamento***: Tipo - DATA.
  * **Categoria***: Tipo - TEXTO, São apresentadas opções: ''DOCENTE, TÉCNICO ADMINISTRATIVO, TODAS''. ([[#Principais Regras de Negócio|RN03]])
  * **Somente cargos associados a servidores ativos atualmente**: Tipo - LÓGICO.

O usuário também informa uma das opções para visualização:
    * **Apenas Consulta**: Tipo - LÓGICO. Exibe o resultado da consulta em uma tabela HTML.
    * **Formato de Relatório**: Tipo - LÓGICO. Exibe o relatório no formato HTML com estilo do relatório.
    * **Formato de Planilha**: Tipo - LÓGICO. Exibe o relatório no formato de planilha eletrônica (.XLS).

O sistema gera um relatório que lista a quantidade de cargos por unidade. Se a opção ''Exibir árvore expandida'' for selecionada, as unidades são dispostas em forma hierárquica (formato de árvore) 

Para cada unidade, exibe-se:
  * **__Unidade/Setor__**: Tipo - TEXTO.
  * **__Categoria__**: Tipo - TEXTO.
  * **__Cargos__**: Tipo - TEXTO.
  * **__Quantidades__**: Tipo - NUMÉRICO.

  * **Modelo do relatório**:

**Relatório de Cargos Por Lotação**\\
**Data Limite para Admissões e Desligamentos: DD/MM/AAAA**\\

^  Unidade/Setor: UNIDADE 1/SETOR 1 ^^^
^Categoria ^Cargos  ^  Quantidades^
|Categoria |Cargo 1  |  1|
|Categoria |Cargo 2  |  1|
|Categoria |Cargo 3  |  9|
| |           |  Total: 11|
^  Unidade/Setor: UNIDADE 2/SETOR 2 ^^^
^Categoria ^Cargos  ^  Quantidades^
|Categoria |Cargo 4  |  2|
|Categoria |Cargo 5  |  1|
|Categoria |Cargo 6  |  2|
| |           |  Total: 5|
^  Unidade/Setor: UNIDADE 3/SETOR 3 ^^^
^Categoria ^Cargos  ^  Quantidades^
|Categoria |Cargo 7  |  1|
|Categoria |Cargo 8  |  1|
|Categoria |Cargo 9  |  1|
| |           |  Total: 3|
| |           ||
| |           |  Total Geral: 15|

É possível visualizar os Servidores de qualquer Unidade e Cargo listados, basta clicar no quantitativo de cada cargo. Deste modo é exibida uma listagem dos servidores que ocupam o cargo selecionado. A listagem contém as seguintes informações:
  * **__Siape__**: Tipo - NÚMERICO
  * **__Nome__**: Tipo - TEXTO


O caso de uso é finalizado.

===== 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**: O campo **Incluir Unidades Vinculadas** será habilitado para seleção apenas quando uma unidade for selecionada no campo **Unidade Raiz**.
  * **RN03**: Caso o campo **Categoria** seja ''TÉCNICO ADMINISTRATIVO'', no relatório o sistema deverá retornar as informações dos ''TECNICO_ADMINISTRATIVO'' e ''CONTRATO_TEMPORARIO''. Caso seja ''DOCENTE'', o sistema deve retornar apenas os ''DOCENTES'', se selecionarem ''TODOS'', a consulta deve retornar os ''TECNICO_ADMINISTRATIVO'', ''CONTRATO_TEMPORARIO'' e ''DOCENTE''. ([[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=144395|144395]])

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

Não se aplica.

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

^Classe ^Tabela ^
| br.ufrn.rh.dominio.Categoria | administrativo.rh.categoria |
| br.ufrn.sigrh.dominio.TipoRegimeJuridico | administrativo.rh_tipos.tipo_regime_juridico |
| br.ufrn.sigrh.dominio.TipoSituacaoServidor | administrativo.rh.situacao_servidor |
| br.ufrn.sigrh.dominio.Unidade | administrativo.comum.unidade |
| br.ufrn.sigrh.funcional.dominio.Servidor | administrativo.rh.servidor |

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

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Consultas/Relatórios -> Relatórios -> Relatórios -> Relatório Sintético De Cargos Por Lotação

Usuário: mirian(GESTOR_DAP/EMITE RELATÓRIO CALCULOS), elizabeth(GESTOR_DAP/EMITE RELATÓRIO CALCULOS)

Papel que usuário deve ter: SigrhPapeis.GESTOR_DAP, SigrhPapeis.EMITE RELATÓRIO CALCULO


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

A única maneira de alterar os dados exibidos no formulário é realizando a admissão de novos servidores ou realizando o desligamento de servidores atualmente em exercício. Este último caso normalmente se faz através da leitura da fita espelho.

Para cadastrar novos servidores, acesse o caso de uso [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:cadastrar_novo_servidor|Cadastrar Novo Servidor]].

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]]

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

Essa consulta é mais abrangente e retorna os cargos dos servidores lotados em suas respectivas unidades:

<code>
select c.id as "Código do Cargo", c.denominacao as "Cargo", u.codigo_unidade as "Código da Unidade", 

u.nome as "Nome da Unidade", s.siape as "SIAPE", p.nome as "Nome", s.admissao as "Data de Admissão", s.data_desligamento as "Data de Desligamento"

from rh.servidor s 

left join comum.pessoa p on p.id_pessoa = s.id_pessoa 
left join rh.cargo c on s.id_cargo = c.id 
left join comum.unidade u on u.id_unidade = s.id_unidade 

where s.id_categoria = 2 and s.id_tipo_regime_juridico <> 4 and s.id_situacao <> 12 and s.id_cargo not in  ( 0,1 ) 

group by c.id, c.denominacao, u.codigo_unidade, u.nome, s.siape, p.nome, s.admissao, s.data_desligamento 

order by u.nome, c.denominacao, p.nome, s.admissao, s.data_desligamento
</code>