~~ODT~~

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

Este Caso de Uso tem como objetivo listar todas as entradas realizadas no histórico de Lotação e Exercício do Servidor. [[#principais_regras_de_negócio|(RN05)]]

As informações listadas neste caso de uso são cadastradas nos seguintes casos de uso: [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:atualizar_dados_do_servidor|Atualizar dados do servidor]], [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:alterar_lotacao_ou_exercicio|alterar lotação ou exercício do servidor]] ou pelo processamento da Fita

Pessoas que trabalham com recursos humanos são os responsáveis por essa funcionalidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIGRH -> Administração de Pessoal → Consultas/Relatórios → Funcionais → Consultas Gerais → Consultar Lotação/Exercício//.

Ao acessar o caso de uso, o sistema apresentará os [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:filtros_para_relatorios|Filtros para relatórios]].

Caso o formato selecionado seja ''Apenas Consulta'', o sistema exibirá uma listagem com os seguintes dados representando cada entrada no histórico de lotação.
São mostrados os seguintes dados:

  * **__SIAPE__**: Tipo - NUMÉRICO.
  * **__Nome__**: Tipo - TEXTO.
  * **__Cargo__**: Tipo - TEXTO.
  * **__Tipo de Alteração__**: Tipo - TEXTO.
  * **__Data de Apresentação__**: Tipo - DATA.
  * **__Data de Desligamento__**: Tipo - DATA.
  * **__Unidade de Lotação__**: Tipo - TEXTO.
  * **__Unidade de Exercício__**: Tipo - TEXTO. 
  * **__Origem__**: Tipo - TEXTO. 
  * **__Quantidades de dias__**: Tipo - NUMÉRICO. O tempo é informado ano, mês e dias (total de dias).
     *  **__Lotação__**: Tipo - TEXTO.
     * **__Exercício__**: Tipo - TEXTO. 

 

Além disso, na listagem são exibidas as opções ''Visualizar detalhes'', ''Alterar'' e ''Remover'', de acordo com as regras de negócio (As opções só aparecerão, se as regras de negócio permitirem).

Ao optar por visualizar detalhes, os seguintes dados são exibidos:

  * **__Servidor__**: Tipo - TEXTO. 
  * **__Lotação Atual__**: Tipo - TEXTO. 
  * **__Lotação Anterior__**: Tipo - TEXTO. 
  * **__Exercício Atual__**: Tipo - TEXTO. 
  * **__Exercício Anterior__**: Tipo - TEXTO. 
  * **__Origem__**: Tipo - TEXTO. 

Ao optar por alterar, os dados exibidos nos detalhes são novamente exibidos e disponibilizados para edição, caso esta alteração de unidade não seja do tipo Alteração de dados funcionais:

  * **__Servidor__**: Tipo - TEXTO. 
  * **__Lotação Atual__**: Tipo - TEXTO. 
  * **__Exercício Atual__**: Tipo - TEXTO. 
  * **Tipo de Alteração Lotação***: Tipo - TEXTO. São apresentadas opções: ''Cessão, Mudança de Exercício, Remoção''.
  * **Observações**: Tipo - TEXTO. 

No caso de alteração de unidade do tipo Alteração de dados funcionais, serão disponibilizados e exibidos os campos para edição:

  * **__Servidor__**: Tipo - TEXTO.
  * **__Origem__**: Tipo - TEXTO.
  * **__Lotação Atual__**: Tipo - TEXTO.
  * **__Exercício Atual__**: Tipo - TEXTO.
  * **Nova Lotação***: Tipo - TEXTO.
  * **Novo Exercício***: Tipo - TEXTO.
  * **Observações**: Tipo - TEXTO.

De acordo com o //Tipo de Alteração Lotação// escolhido, o sistema exibe diferentes campos para inserção de dados:
  * **Cessão**: 
    * **Tipo de Alteração Lotação***: Tipo - TEXTO.
    * **Data da Portaria***: Tipo - DATA.
    * **Data de Desligamento da Origem**: Tipo - DATA.
    * **Órgão de Destino***: Tipo - NUMÉRICO.
    * **Data de Início da Cessão***: Tipo - DATA.
    * **Data de Término da Cessão**: Tipo - DATA.
    * **Observações**: Tipo - TEXTO.
  * **Mudança de Exercício**:
    * **Data da Portaria***: Tipo - DATA.
    * **Data de Desligamento do Exercício Anterior**: Tipo - DATA.
    * **Observações**: Tipo - TEXTO.
  * **Remoção**:
    * **Modalidade***: Tipo - TEXTO.
    * **Documento de Apresentação***: Tipo - TEXTO.
    * **Data de Apresentação***: Tipo - DATA.
    * **Documento de Desligamento da Lotação anterior**: Tipo - TEXTO.
    * **Observações**: Tipo - TEXTO.

Selecionando a opção ''Formato de Relatório'', o sistema gera um Relatório no formato PDF com os mesmos dados da listagem exibida na opção ''Apenas Consulta''.

Caso a opção selecionada seja ''Formato de Planilha'', as seguintes informações devem ser apresentadas:
  * **__SIAPE__**: Tipo - NUMÉRICO.
  * **__Nome__**: Tipo - TEXTO. 
  * **__CPF__**: Tipo - NUMÉRICO.
  * **__Endereço__**: Tipo - TEXTO. 
  * **__CEP__**: Tipo - NUMÉRICO.
  * **__Telefone__**: Tipo - NUMÉRICO.
  * **__E-mail__**: Tipo - TEXTO. 
  * **__Data de Nascimento__**: Tipo - DATA.
  * **__Sexo__**: Tipo - TEXTO. 
  * **__Data de Admissão__**: Tipo - DATA.
  * **__Carga Horária__**: Tipo - NUMÉRICO.
  * **__Regime Jurídico__**: Tipo - TEXTO. 
  * **__Categoria__**: Tipo - TEXTO. 
  * **__Cargo__**: Tipo - TEXTO. 
  * **__Classe Funcional__**: Tipo - TEXTO. 
  * **__Unidade de Exercício__**: Tipo - TEXTO. 
  * **__Unidade de Lotação__**: Tipo - TEXTO. 
  * **__Data de Apresentação__**: Tipo - DATA.
  * **__Data de Desligamento__**: Tipo - DATA.
  * **__Tempo__**: Tipo - NUMÉRICO. O tempo é informado ano, mês e dias (total de dias).

O caso de uso é finalizado.

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

  * **RN01** - A listagem deve ser exibida em ordem cronológica, ou seja, do mais antigo para o mais atual, portanto o último da listagem deverá ser o item mais recente.
  * **RN02** - Qualquer registro poderá ser alterado ou excluído. O valor do parâmetro PERMITE_MANIPULAR_HISTORICO_LOTACAO vai definir a forma ou condição de como os registros serão alterados ou excluído. Caso PERMITE_MANIPULAR_HISTORICO_LOTACAO igual a FALSE, a exclusão será em cascata (a partir do registro mais recente), para edição vide **RN03**. Caso PERMITE_MANIPULAR_HISTORICO_LOTACAO igual a TRUE, quaisquer registro poderá ser alterado ou removido livremente.
  * **RN03** - No caso do parâmetro PERMITE_MANIPULAR_HISTORICO_LOTACAO igual a FALSE. Só permitir alterar as unidades de //Lotação// e //Exercício// e o //Tipo de Alteração da Lotação// se a alteração mais recente, não for originada do SIAPE. Porque sendo uma mudança informada pelo SIAPE, não pode ser alterada no SIGRH.
  * **RN04** - Caso o Tipo de Alteração da Lotação seja nulo, e a origem seja siape, a informação veio do siape. Caso o Tipo de Alteração da Lotação seja nulo, e a origem seja sigrh, o histórico foi derivado do caso de uso de alteração de dados funcionais.
  * **RN05** - 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.
  * **RN06** - Caso o Tipo de Alteração na listagem seja Alteração de dados funcionais, será alterado as unidades de lotação e exercício apenas.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.dominio.HistoricoLotacao | administrativo.funcional.historico_lotacao |
| 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 → Funcionais → Consultas Gerais → Consultar Lotação/Exercício

Usuário: mirian

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

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

Inicialmente deve ser realizada uma alteração na lotação / exercício do servidor, através do caso de uso [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:alterar_lotacao_ou_exercicio]]

Após realizada essa alteração, voltar para o caso de uso de Consulta e realizar a busca a partir do nome do servidor e selecionar a opção //Em Tela// no COMBOBOX //Formato de Relatório//. Deverão ser listadas (a)s alterações realizadas, em ordem cronológica.

Caso o registro possa ser alterado, realizar a alteração com base no caso de uso [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:alterar_lotacao_ou_exercicio]].
Caso o registro seja excluido, realizar novamente a Consulta e verificar se realmente o registro foi retirado da listagem.

Verificar Regras de Negócio.

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

Como sugestão, utilizar o servidor ADELAIDE MARIA FERREIRA DE LIMA para os testes.
Deverá ser usado o usuário Mirian, ou qualquer outro que possua os papéis supracitados.

Para realizar as alterações que serão listadas no caso de uso, realizar tais alterações no caso de uso: [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:alterar_lotacao_ou_exercicio]]

</ifauth>