~~ODT~~

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

Este relatório tem por finalidade informar os servidores afastados de uma determinada unidade por um período superior ao calculado, sendo este último baseado na data corrente e no período, em dias, informado pelo usuário.
O que informa este afastamento é a existência de uma concomitância de um afastamento com período superior ao informado e dentro dos limites do mesmo.
O que marca o período de uma ocorrência são os atributos "inicio" e "fim". As pessoas que tem acesso são administrador ou gestor do departamento de pessoal([[#principais_regras_de_negócio|RN01]]).

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

O usuário acessa pelo link Administração de Pessoal -> Consulta/Relatórios → Funcionais → Servidores Afastados → Afastamentos Vencidos

São exibidos os seguintes filtros:

  * **Servidor**: Tipo - AUTOCOMPLETE, Entrada de Dados - NOME DO SERVIDOR, SIAPE DO SERVIDOR.
  * **Tipo da Ausência**: Tipo - COMBO, São exibidas as seguintes opções: 'A DISPOSIÇÃO DO DDRH, ABONO DE FALTA, etc.'.
  * **Unidade de Exercício**: Tipo - AUTOCOMPLETE, Entrada de Dados - NOME DA UNIDADE, CÓDIGO DA UNIDADE.
  * **Incluir Unidades subordinadas**: Tipo - LÓGICO. Só é habilitado se Unidade do Exercício for informada.
  * **Período Superior a (dias)***: Tipo - NUMÉRICO, Inicializado com o valor 180.
  * **Vencimento***: São exibidas as opções: ''**Sem término real informado**'', ''**Já vencidos**'', ''**Com término próximo**''. ([[#principais_regras_de_negócio|RN02]]).	
  * **Iniciado Desde**: Tipo - DATA, Formato DD/MM/AAAA. Busca os afastamentos com início a partir da data informada.
  * **Com Encerramento Previsto Até**: Tipo - DATA, Formato DD/MM/AAAA. Busca os afastamentos com término previsto até a data informada. 
  * 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 com opção para impressão com os seguintes dados:

  * **__Siape__**: Tipo - NUMÉRICO 
  * **__Nome__**: Tipo - TEXTO.
  * **__Descrição__**: Tipo - TEXTO.
  * **__Início da Cessão__**: Tipo - DATA.
  * **__Fim da Cessão__**: Tipo - DATA.

Exemplo:

^Siape  ^Nome ^Descrição ^Início  ^Fim^
|  99999999  |nome  |descrição  |DD/MM/AAAA  |DD/MM/AAAA |

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** - 
      * Ao marcar a opção ''**Com Término Próximo**'', a busca irá considerar todos os afastamentos com até dois meses a partir da data atual e que não possuírem o término real populado.
      * Ao marcar a opção ''**Já Vencidos**'', a busca irá considerar todas os afastamentos que já expiraram sua data de fim e que não possuírem o término real populado.
      * Ao marcar a opção ''**Sem término real informado**'', a busca irá considerar todas os afastamentos que não possuírem o término real populado. Os servidores que estiverem com o término do afastamento próximo de terminar (até 2 meses), serão destacados em **negrito**.
  * **RN03** - Caso o campo ''Com Término Próximo'' esteja marcado o campo ''Encerrado Até'' não deve aparecer e nem ser considerado.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.dominio.Unidade | administrativo.comum.unidade |
| br.ufrn.sigrh.funcional.dominio.Ausencia | administrativo.funcional.ausencia |

====== Plano de Testes ======
Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Consulta/Relatórios -> Funcionais-> Servidores Afastados -> Afastamentos Vencidos

Usuário: mirian (GESTOR_DAP), giuliana (ADMINISTRADOR_DAP)

Papel que usuário deve ter: GESTOR_DAP, ADMINISTRADOR_DAP

===== Cenários de Testes =====

Testar os diversos filtros e verificar se o relatório exibe os dados de acordo com os filtros informados.

===== Dados de Testes =====

A geração do relatório se dá quando o usuário informar um período. O período é válido se for inteiro, não nulo, maior que zero. Preencher os dados desejados e gerar o relatório. Conferir com a consulta descrita no sql abaixo, assim como os outros relatórios que são gerados com informações similares, descritos em relatórios similares.

==== Sql para verificar a corretude do relatório ====

No sql abaixo foi considerado como unidade a Superintendência de informática, de id 2, e a data corrente assim como um período de 30 dias.

<code>
select s.siape, p.nome, o.descricao, a.inicio, a.fim
     from funcional.ausencia as a inner join rh.servidor as s on a.id_servidor = s.id_servidor
          inner join unidade as u on s.id_unidade = u.id_unidade
          inner join pessoa as p on s.id_pessoa = p.id_pessoa
          inner join funcional.ocorrencia as o on a.id_ocorrencia = o.id_ocorrencia
     where u.id_unidade = 2 and a.inicio <= '05-08-2009' and 
          (a.fim >= '05-08-2009' or a.fim is null) and ((a.fim - a.inicio) is null or
          (a.fim - a.inicio) >= 30)
     order by p.nome
</code>

</ifauth>