✎ desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:funcionais:consultas_gerais:adicional [WIKI

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
~~ODT~~

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

====== Consultar Adicional ======

Este Caso de Uso tem como objetivo listar os adicionais recebidos pelo servidor. Além do vencimento, serão deferidos aos servidores os seguintes adicionais previstos na [[http://www.planalto.gov.br/ccivil_03/LEIS/L8112cons.htm|Lei 8.112/90]]:
   * Pelo exercício de atividades insalubres, perigosas ou penosas;
   * Pela prestação de serviço extraordinário;
   * Noturno;
   * Férias;
   * Outros, relativos ao local ou à natureza do trabalho.

Esta operação pode ser realizada pelo Gestor do DAP (Departamento de Administração de Pessoal). [[#principais_regras_de_negócio|(RN03)]]

===== Descrição do Caso de Uso =====
O caso de uso inicia ao acessar: //SIGRH → Administração de Pessoal → Consultas/Relatórios → Funcionais → Consultas Gerais → Adicional//

O sistema exibe a opção Buscar por Adicionais, que fornece opções de filtro para consulta de adicionais. Os seguintes campos são exibidos:
   * **Pessoa**: Formato - NOME DO SERVIDOR, Tipo - AUTOCOMPLETE. Entrada de Dados: Matrícula SIAPE, NOME DO SERVIDOR, CPF e Nome de Identificação.
   * **Vínculo de Ocorrência**: Tipo - TEXTO. Apresenta o(s) vínculo(s) de ocorrência referente ao servidor.([[#principais_regras_de_negócio|RN06]])
   * **Categoria**: Tipo - TEXTO. São apresentadas opções: ''Docente, Médico Residente, Não Especificado, Técnico Administrativo''.
   * **Unidade de Lotação**: Tipo - TEXTO. É apresentada uma lista de unidades. Indica a unidade de lotação do servidor.([[#principais_regras_de_negócio|RN02]])
  * **Considerar Unidades Vinculadas à Unidade de Lotação**: TIPO - LÓGICO.
  * **Unidade de Exercício**: Tipo - TEXTO. É apresentada uma lista de unidades. Indica a unidade de exercício do servidor;
  * **Considerar Unidades Vinculadas à Unidade de Exercício**: TIPO - LÓGICO.
   * **Tipo de Adicional**: Tipo - TEXTO, Opções: ''Insalubridade, Periculosidade, Raio-X, Irradiação ionizante, Atividade Penosa''
   * **Período**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA, Período da vigência do adicional;
   * **Percentual**: Tipo - NUMÉRICO, Número percentual que o servidor receberá em contra-cheque referente ao Tipo  de adicional.
   * **Exibir em formato de impressão**: Tipo - LÓGICO.
   * **Apresentar apenas Adicionais Vigentes**:Tipo - LÓGICO. Apresenta no relatório, apenas os adicionais Vigentes.

Após realização da consulta, são retornados os seguintes dados:

  * **__Servidor__**: Tipo - TEXTO, Nome do servidor ([[#principais_regras_de_negócio|RN01,RN04]]);
  * **__Tipo de Adicional__**: Tipo - TEXTO, Tipo de adicional (Insalubridade, Periculosidade, Raio-X);
  * **__Início__**: Tipo - DATA, Data da vigência do adicional;
  * **__Término__**: Tipo - DATA, Data de finalização da vigência do adicional;
  * **__%__**: Tipo - NUMÉRICO, Percentual;
  * **__Vínculo de Ocorrência__**: Tipo - TEXTO.
  * **__Observação__**: Tipo - TEXTO.

Para cada item da listagem o sistema exibe as seguintes opções:

  * //Visualizar Detalhes//
  * //Alterar Dados do Adicional//
  * //Remover Adicional//

Caso o usuário escolha a opção de //Exibir em formato de impressão// o sistema exibe um relatório de acordo com o seguinte modelo:


<PARAMETROS DA BUSCA>

([[#principais_regras_de_negócio|RN01]])

^ Servidor ^ Tipo de Adicional ^ Início ^ Término ^ % ^ Vínculo de Ocorrência ^ Observação ^
|<Nome do Servidor>|Raio-X |09/08/2004|28/02/2010|10| <Sigla da Instituição> (<Matrícula SIAPE>) |OBSERVAÇÃO DE EXEMPLO|
|<Nome do Servidor>|Raio-X |09/08/2004|28/02/2010|10| <Sigla da Instituição> (<Matrícula SIAPE>) |OBSERVAÇÃO DE EXEMPLO|
|<Nome do Servidor>|Raio-X |09/08/2004|28/02/2010|10| <Sigla da Instituição> (<Matrícula SIAPE>) |OBSERVAÇÃO DE EXEMPLO|

Em visualizar detalhes são mostrados os seguintes dados:

  * **__Servidor__**: Tipo - TEXTO, Nome do servidor;
  * **__Vínculo de Ocorrência__**: Tipo - TEXTO;
  * **__Tipo de adicional__**: 	Tipo - TEXTO;
  * **__Percentual__**: Tipo - TEXTO.
  * **__Data de Início__**: Tipo - DATA.
  * **__Data de Término__**: Tipo - DATA.
  * **__Portaria de Publicação da Localização__**: Tipo - TEXTO.
  * **__Data da Portaria de Publicação da Localização: __**: Tipo - DATA.
  * **__Boletim Publicado__**: Tipo - TEXTO.
  * **__Data de Publicação__**: Tipo - DATA.
  * **__Observações__**: Tipo - TEXTO.

  * **__Detalhes do Diploma Legal__**: 
     * **__Número__**: Tipo - NUMÉRICO.
     * **__Data de Publicação__**: Tipo - DATA.
     * **__Descrição__**: Tipo - TEXTO.

  * **__Detalhes do Laudo__**: ([[#principais_regras_de_negócio|RN05]])
     * **__Unidade__**: Tipo - TEXTO.
     * **__Data do laudo__**: Tipo - DATA.
     * **__Data de Cadastro__**: Tipo - DATA.
     * **__Descrição__**: Tipo - TEXTO.


Ao alterar detalhes, são habilitados os mesmos dados mostrados na visualização, exceto o **Servidor** e o **Adicional de tempo averbado**.

Selecionando a opção //Exibir em formato de impressão// o sistema apresenta os dados em formato para impressão.

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

  * **RN01** - Caso seja selecionado servidor como filtro de busca, o dado **Servidor** não será exibido no resultado da busca.
  * **RN02** - A opção de filtro Unidade de Lotação só será exibida se no sistema, o parâmetro UTILIZA_CONCEITO_EXERCICIO estiver ativo.
  * **RN03** - Quando o usuário logado possuir papel com exigência de vinculação a uma unidade, todas as operações somente poderão ser realizadas para servidores lotados na unidade que foi vinculada ao papel; caso não exista unidade vinculada ao papel para o usuário logado, o mesmo terá acesso normalmente a qualquer servidor. Caso contrário, as operações podem ser realizadas para servidores lotados em qualquer unidade.
  * **RN04** - O servidor é exibido apenas se não for utilizado o filtro servidor.
  * **RN05** - Os detalhes do laudo, só serão exibidos caso haja laudo associado ao adicional.
  * **RN06** - O campo **Vínculo de Ocorrência** só é exibido se o filtro de busca servidor for selecionado.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.dominio.TipoAdicional | administrativo.rh_tipos.tipo_adicional |
| br.ufrn.sigrh.financeiro.dominio.Adicional | administrativo.financeiro.adicional |
| br.ufrn.sigrh.financeiro.dominio.TipoAdicionalPercentual | administrativo.rh_tipos.tipo_adicional_percentual |
| br.ufrn.sigrh.funcional.dominio.Servidor | administrativo.rh.servidor |
| br.ufrn.sigrh.pessoal.dominio.Pessoa | administrativo.comum.pessoa |
| br.ufrn.sigrh.dominio.Unidade | administrativo.comum.unidade |

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

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Consultas/Relatórios → Funcionais → Consultas Gerais → Adicional

Usuário: mirian, mlm (SigrhPapeis.GESTOR_DAP)

Papel que usuário deve ter: SigrhPapeis.GESTOR_FINANCEIRO, SigrhPapeis.CONSULTOR_DADOS_FUNCIONAIS, SigrhPapeis.GESTOR_DAP, SigrhPapeis.ADMINISTRADOR_DAP

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

Realizar o [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:adicional:cadastrar|cadastro de adicionais]], e realizar a consulta utilizando os dados do adicional recém cadastrado.

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

Não se aplica.

</ifauth>