~~ODT~~

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

Na Instituição, vários cargos distintos podem ser avaliados pelas mesmas competências e o agrupamento funcional se faz necessário para que sejam criados os grupos de cargos que receberão os mesmos formulários de avaliação.

O objetivo deste caso de uso é o de cadastrar os agrupamentos funcionais.

O gestor de avaliação é a pessoa responsável pelo cadastro dos agrupamentos funcionais. 

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

Este caso de uso inicia quando o usuário acessa a opção: //SIGRH -> Avaliação Funcional -> Avaliação por competência -> Cadastros/Atualizações -> Agrupamento Funcional -> Cadastrar//.

Para realizar o cadastro, inicialmente é solicitado uma descrição do agrupamento funcional a ser cadastrado:

  * **__Processo de Avaliação__**: Tipo - TEXTO. ([[#Principais Regras de Negócio|RN02]])
  * **Descrição***: Tipo - TEXTO. ([[#Principais Regras de Negócio|RN04]])
  * **Unidade**: Tipo - TEXTO, AUTOCOMPLETE. Entrada de Dados: Nome da Unidade, código da Unidade. Formato - NOME (CÓDIGO DA UNIDADE).
 
É disponibilizado um link para //Adicionar// a Unidade desejada. Depois que a Unidade é adicionada, esta é exibida com opção de remoção. ([[#Principais Regras de Negócio|RN04]])

Ao //Continuar// o processo, os dados informados são exibidos junto com a solicitação da informação sobre o cargo:
  * **__Descrição__**: Tipo - TEXTO. 
  * **Cargo***: Formato - NOME DO CARGO (CÓDIGO DO CARGO), Tipo - AUTOCOMPLETE. Entrada de Dados: NOME DO CARGO ou CÓDIGO DO CARGO. ([[#Principais Regras de Negócio|RN03]])

Há um link para adicionar o cargo desejado.

À medida que os cargos são adicionados o sistema exibe uma listagem com os cargos associados:
  * **__Cargo__**: Formato - NOME DO CARGO (CÓDIGO DO CARGO), Tipo - TEXTO ([[#Principais Regras de Negócio|RN01]]).
  * **__Categoria__**: Tipo - TEXTO.

Ao //Cadastrar//, a mensagem 'Agrupamento Funcional cadastrado(a) com sucesso!' é exibida.

  * Modelo da listagem:

^Cargo ^Categoria ^
|ENGENHEIRO CIVIL (68013)|Técnico Administrativo | 	  
|ENGENHEIRO DE CONTROLE DE QUALIDADE (61039) |Técnico Administrativo |
|ENGENHEIRO DE MINAS-ESPECIALIDADE (61046) |Técnico Administrativo |
|ENGENHEIRO DE OPERAÇÕES (474011) |Técnico Administrativo |

Para cada item da lista é disponibilizada a opção de remover.

O caso de uso é finalizado.

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

  * **RN01**: Somente cargos com servidores ativos associados podem ser usados para o cadastro de agrupamentos funcionais.
  * **RN02**: Só sera possível escolher esta informação caso o parâmetro ''PERMITE_SELECIONAR_GDH'' esteja com seu valor ajustado como "true". Como false ficara fixo e com o valor mais atual.
  * **RN03**: É possível adicionar todos os cargos existentes informando no campo Cargo a opção TODOS OS CARGOS EXISTENTES. Isto é, todos os cargos retornados pela consulta disponível no final dessa especificação.
  *  **RN04**: Caso o usuário não informe a **Unidade**, a avaliação será aplicada aos Cargos em todas as Unidades da Instituição. O mesmo Cargo pode estar em várias Unidades diferentes. ([[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=56813|56813]], v4.9.0)


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

Não se Aplica.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.competencia.dominio.AgrupamentoFuncional | administrativo.competencia.agrupamento_funcional |
| br.ufrn.sigrh.competencia.dominio.CompetenciaMediador| administrativo.competencia.competencia_mediador |

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

Sistema: SIGRH

Módulo: Avaliação Funcional

Link(s): Avaliação por competência -> Cadastros/Atualizações -> Agrupamento Funcional -> Cadastrar

Usuário: alc

Papel que usuário deve ter: SigrhPapeis.GESTOR_AVALIACAO

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

Cadastrar agrupamento funcional com vários cargos de uma unidade. Verificar se o cadastro foi realizado corretamente através do caso de uso [[desenvolvimento:especificacoes:sigrh:avaliacao_funcional:casos_de_uso:avaliacao_por_competencia:cadastros_atualizacoes:agrupamento_funcional:listar_alterar|Listar/Alterar Agrupamento Funcional]].

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

Script para consultar cargos com servidores ativos associados.

<code sql>
SELECT DISTINCT c.id, c.denominacao FROM rh.servidor s
INNER JOIN rh.cargo c ON c.id = s.id_cargo WHERE 
s.data_desligamento IS NULL ORDER BY c.denominacao ;
</code>

</ifauth>