~~ODT~~

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

Este caso de uso permite listar/alterar **vagas** que são ou que virão a ser ocupadas por servidores da instituição.
O principal responsável pelo gerenciamento de vagas é o gestor de vagas.



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

Este caso de uso inicia-se quando o usuário acessa a opção //SIGRH → Banco de Vagas -> Geral -> Vaga -> Listar/Alterar//.

Inicialmente, o sistema requer que o usuário realize uma busca a fim de indicar sob qual vaga cadastrada as operações serão realizadas, através dos seguintes campos:

  * **Código**([[#Principais Regras de Negócio|RN01]]): Tipo - NUMÉRICO;
  * **Tipo de Vaga**: Tipo - TEXTO. São exibidas as seguintes opções: DOCENTE, INDEFINIDO e TÉCNICO;
  * **Servidor**: Tipo - AUTOCOMPLETE. Formato - Nome do Servidor (SIAPE);
  * **Cargo***: Tipo - TEXTO;
  * **Classe Funcional**: Tipo - TEXTO;
  * **Origem da Vaga**: Tipo - TEXT. São exibidas as seguintes opções: PORTARIA, CARATER ESTRATÉGICO e INDEFINIDO.
  * **Situação**: Tipo - TEXTO; São apresentadas as opções: ''Provimento em Andamento'', ''Vaga Desocupada'', ''Vaga Desocupada/Reservada para Concurso'', ''Vaga Desocupada/Reservada para Distribuição'', ''Vaga Desocupada/Reservada para Redistribuição'', ''Vaga Desocupada/Reservada para Remoção'', ''Vaga Desocupada/Permuta em Andamento'', ''Vaga Desocupada/Cargo Extinto'', ''Vaga Desocupada/Extinta'', ''Vaga Ocupada'', ''Vaga Permutada'', ''Redistribuição/Vaga Encerrada'' e ''Vaga Desocupada/Reservada para Unidade''. 
  * **Portaria de Autorização de Concurso**: Tipo - TEXTO;	
  * **Portaria de Autorização de Provimento**: Tipo - TEXTO;
  * **Somente Vagas sem Servidor Associado**: Tipo - LÓGICO;

Após a consulta, é exibida uma listagem com os seguintes dados de busca:

 * **Listagem de Vagas**
  * **__Código__**: Tipo - NUMÉRICO;
  * **__Tipo de Vaga__**: Tipo - TEXTO;
  * **__Origem da Vaga__**: Tipo - TEXTO;
  * **__Cargo__**: Tipo - TEXTO, Formato - NOME (CÓDIGO).
  * **__Classe Funcional__**: Tipo - TEXTO.
  * **__Situação__**: Tipo - TEXTO.
  * **__Lotação Atual__**: SIGLA DA UNIDADE (CÓDIGO DA UNIDADE)
  * **__Lotação Anterior__**: SIGLA DA UNIDADE (CÓDIGO DA UNIDADE)
  
E, para cada registro relacionado na listagem, é disponibilizada a opção de "Alterar" ,"Visualizar" ou "Remover".

=== Visualizar Vaga ===

Na opção de visualização são exibidos os seguintes dados:

 * **Dados da Vaga**
   * **__Código__**: Tipo - NUMÉRICO
   * **__Tipo de Vaga__**: Tipo - TEXTO
   * **__Classe Funcional__**: Tipo - TEXTO
   * **__Origem da Vaga__**: Tipo - TEXTO
   * **__Lei__**: Tipo - TEXTO
   * **__Portaria__**: Tipo - TEXTO

 * **Dados Funcionais do Servidor** ([[#Principais Regras de Negócio|RN08]])
   * **__Nome Completo__**: Tipo - TEXTO
   * **__Matrícula SIAPE__**: Tipo - NUMÉRICO
   * **__Nome de Identificação__**: Tipo - TEXTO ([[#Principais Regras de Negócio|RN06]])
   * **__Matrícula Interna__**: Tipo - NUMÉRICO ([[#Principais Regras de Negócio|RN07]])
   * **__Cargo__**: Tipo - TEXTO, Formato - NOME (CÓDIGO)
   * **__Unidade de Lotação__**:  Tipo - TEXTO, Formato - NOME (CÓDIGO)
   * **__Unidade de Exercício__**:  Tipo - TEXTO, Formato - NOME (CÓDIGO)

 * **Movimentação da Vaga** ([[#Principais Regras de Negócio|RN03]])
  ***__Tipo de Movimentação__**: Tipo TEXTO.
  ***__Unidade__**: Tipo TEXTO. Formato SIGLA DA UNIDADE - (CÓDIGO)
  ***__Servidor__**: Tipo TEXTO.
  ***__Data da Movimentação__**: Tipo DATA.

 * **Histórico da Vaga por Servidores ** ([[#Principais Regras de Negócio|RN03]])
  ***__Servidor (Siape)__**: Tipo TEXTO.
  ***__Data de Admissão__**: Tipo DATA.
  ***__Data de Desligamento__**: Tipo DATA.
  ***__Unidade de Exercício__**: Tipo TEXTO.

=== Alterar Vaga ===

Caso o usuário deseje alterar uma determinada vaga cadastrada, o sistema segue o fluxo indicado em [[cadastrar|Cadastrar Nova Vaga]]. 

=== Remover Vaga ===

Caso deseje remover ([[#Principais Regras de Negócio|RN04]]), uma confirmação é requerida, e então, o registro é eliminado do sistema. 

O caso de uso é finalizado.

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

  * **RN01** - Não é possível cadastrar uma vaga com um código que já tenha sido cadastrado;
  * **RN02** - Será exibida a movimentação, caso a vaga tenha tido alguma movimentação;
  * **RN03** - Será exibido o histórico caso haja algum registro no histórico funcional dos servidores associados ao código da vaga;
  * **RN04** - Não é possível remover vagas que estejam na situação "VAGA OCUPADA". Isto é, vagas que possuam servidores associados;
  * **RN06** - Campo só exibido caso o servidor associado a vaga o tenha;
  * **RN07** - Campo só exibido caso o valor do parâmetro UTILIZA_CONCEITO_MATRICULA_INTERNA seja true;
  * **RN08** - Esta seção de dados só aparece caso a vaga tenha servidor associado.


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

Não se aplica.

<ifauth @admin>

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

^ Classe ^ Tabela |
| concursos.vaga | administrativo.br.ufrn.sigrh.concurso.bancovagas.dominio.Vaga |
| concursos.tipo_vaga | administrativo.br.ufrn.sigrh.concurso.bancovagas.dominio.TipoVaga |
| concursos.tipo_vaga_banco_equivalencia | administrativo.br.ufrn.sigrh.concurso.bancovagas.dominio.TipoVagaBancoEquivalencia |
| concursos.status_vaga | administrativo.br.ufrn.sigrh.concurso.bancovagas.dominio.StatusVaga |
| concurso.tipo_provimento_vaga | administrativo.br.ufrn.sigrh.concurso.dominio.TipoProvimentoVaga |
| comum.unidade | administrativo.br.ufrn.sigrh.dominio.Unidade |
| funcional.historico_funcional | administrativo.br.ufrn.sigrh.funcional.dominio.HistoricoServidor |

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

Sistema: SIGRH

Módulo: Banco de Vagas

Link(s): Aba Geral -> Vaga -> Listar/Alterar

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_BANCO_VAGAS

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

Alterar e verificar se os dados foram cadastrados corretamente. As vagas são cadastradas em Banco de Vagas -> Geral -> Cadastrar

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

Vagas com Servidores Associados

   SELECT * FROM concurso.vaga WHERE id_vaga IN (SELECT id_vaga FROM funcional.dados_complementares_servidor WHERE id_vaga is not null);

</ifauth>