====== Relatório de Designação  ======

Esse caso de uso gera um relatório de servidores com [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:designacao:cadastrar|designações]].

Os gestores do departamento de administração pessoal, os funcionários do setor de auto atendimento e os auditores, tem a possibilidade de gerar um relatório com as designações existentes. ([[#principais_regras_de_negócio|RN01]])

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

Este caso de uso inicia quando o usuário acessa //SIGRH → Administração de Pessoal → Consultas/Relatórios → Relatórios → Relatórios → Designações//. 

Para a geração do relatório é necessário fazer uma busca utilizando pelo menos um dos seguintes filtros:

  * **Unidade de Exercício**: Tipo - TEXTO. Unidade para qual os servidores foram designados.
  * **Função**: Tipo - TEXTO. São apresentadas opções: ''CD, DAS, ETG, FC, FG, DGA'', Função desempenhada pelo servidor.
  * **Histórico**: Tipo - TEXTO, São apresentadas opções: ''Ativas'' e ''Inativas''.

É possível utilizar os filtros combinando-os.

O sistema gera um relatório, com as seguintes opções de exibição:

  * ** Formato PDF**: Exibição em arquivo no formato ''.pdf''.
  * ** Formato de Planilha**: Exibição em arquivo no formato ''.xls''.

O relatório gerado será exibido com as seguintes informações:

  * **__Nome__**: Tipo - TEXTO.
  * **__SIAPE__**: Tipo - NUMÉRICO.
  * **__Inicio__**: Tipo - DATA.
  * **__Fim__**: Tipo - DATA.
  * **__Cargo__**: Tipo - TEXTO.
  * **__Unidade__**: Tipo - TEXTO. 
  * **__Função__**: Tipo - TEXTO.
  * **__Nível de Responsabilidade__**: Tipo - TEXTO.

Exemplo:
^Nome^Siape^Inicio^Fim^Cargo^Unidade^Função^Nível de Responsabilidade^
|nome|99999999|DD/MM/AAAA|DD/MM/AAAA|cargo|unidade|função|nivel de responsabilidade|

Os registros do relatório serão exibidos ordenadamente pelo nome do servidor.

O caso de uso é finalizado.

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

  * **RN01**: Caso o usuário logado tenha unidade associada a sua permissão, serão listadas apenas as unidades que se encontrarem na hierarquia das unidades associadas a permissão do usuário logado.

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

Não se aplica.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.rh.dominio.Designacao | administrativo.rh.designacao |
| br.ufrn.sigrh.dominio.Unidade | administrativo.comum.unidade |
| br.ufrn.sigrh.funcional.dominio.GrupoNivelDesignacao | administrativo.funcional.grupo_nivel_designacao |
| br.ufrn.sigrh.funcional.dominio.NivelDesignacao | administrativo.funcional.nivel_designacao |
| 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 -> Designações

Usuário: mirian 

Papel que usuário deve ter:  SigrhPapeis.ADMINISTRADOR_DAP, SigrhPapeis.USUARIO_AUTO_ATENDIMENTO, SigrhPapeis.GESTOR_DAP, SipacPapeis.AUDITOR


===== Cenários de Teste ===== 
Deve-se realizar a inclusão de permissão para um usuário com o papel GESTOR_DAP e associar uma unidade para a realização dos testes.

Testar os diversos filtros separadamente ou combinando-os e verificar se o relatório exibido está de acordo com os filtros selecionados.


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

Não se aplica.

</ifauth>