~~ODT~~

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

====== Consulta de Agregados ======

Esse caso de uso realiza a busca por [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:agregados|agregados cadastrados]]. Após localizado o agregado em questão, é possível realizar algumas operações, como alterar, excluir, o anexar documentos para o agregado.

Os funcionários do atendimento do departamento de administração de pessoal são os principais usuários desse caso de uso. ([[#principais_regras_de_negócio|RN04]])

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

Este caso de uso se inicia em //SIGRH → Administração de Pessoal → Consultas/Relatórios → Consultas Gerais -> Agregados//.
 
  * **Responsável pelo Agregado***: Tipo - TEXTO. São apresentadas as opções: ''Servidor'' e ''Pensionista''. ([[#principais_regras_de_negócio|RN01]]) 
  * **Servidor Responsável**: Tipo - TEXTO. Formato - NOME DO SERVIDOR (999999). Tipo - AUTOCOMPLETE. Entrada de dados: Matrícula SIAPE, NOME DO SERVIDOR ou CPF. ([[#principais_regras_de_negócio|RN06]])
  * **Pensionista Responsável**: Tipo - TEXTO. Formato - NOME DO PENSIONISTA. Tipo - AUTOCOMPLETE. Entrada de dados: NOME DO SERVIDOR ou CPF. ([[#principais_regras_de_negócio|RN07]])
  * **Nome do Agregado**: Tipo - TEXTO.
  * **Filiação do Agregado**: Tipo - TEXTO.
  * **Data de Nascimento**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **Tipo de Documento**: Tipo - TEXTO. São apresentadas as opções: ''CPF'' e ''RG''.
  * **Número do Documento**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN02]])
  * **Data de Cadastro**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **Considerar Apenas Ativos**: Tipo - LÓGICO.

Após realizar a busca, o sistema exibe os agregados encontrados, e para cada agregado, são exibidos os seguintes dados:

  * **__Nome do Agregado__**: Tipo  - TEXTO.
  * **__Servidor Responsável__**: Tipo  - TEXTO.
  * **__Cargo Servidor__**: Tipo  - TEXTO.
  * **__Grau de Parentesco__**: Tipo - TEXTO.
  * **__Data de Nascimento__**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **__Data de Cadastro__**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **__Situação__**: Tipo  - TEXTO.

Para cada item listado, o usuário pode optar por //Visualizar detalhes, Alterar Dados do Agregado// e //Remover Agregado//.

**Visualizar Detalhes**

Tendo optado pela visualização detalhada dos dados do agregado, o sistema exibe as seguintes informações: 

  * **__Nome__**: Tipo - TEXTO.
  * **__Data de Nascimento__**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **__Sexo__**: Tipo - TEXTO.
  * **__Filiação 1__**: Tipo - TEXTO. 
  * **__CPF de Filiação 1__**: Tipo - NUMÉRICO.
  * **__Filiação 2__**: Tipo - TEXTO. 
  * **__CPF de Filiação 2__**: Tipo - NUMÉRICO.
  * **__CEP__**: Tipo - NUMÉRICO.
  * **__Endereço__**: Tipo - TEXTO. 
  * **__Número__**: Tipo - NUMÉRICO. 
  * **__Bairro__**: Tipo - TEXTO. 
  * **__Cidade__**: Tipo - TEXTO. 
  * **__UF__**: Tipo - TEXTO. 
  * **__Tel. Residencial__**: Tipo - NUMÉRICO. 
  * **__Tel. Comercial__**: Tipo - NUMÉRICO. 
  * **__Tel. Celular__**: Tipo - NUMÉRICO. 
  * **__E-mail__**: Tipo - TEXTO. 

  * Dados do Responsável
    * **__Servidor Responsável__**: Tipo - TEXTO.
    * **__Matrícula SIAPE__**: Tipo - NUMÉRICO. 
    * **__Cargo__**: Tipo - TEXTO. 
    * **__Situação__**: Tipo - TEXTO. 
    * **__Unidade de Exercício__**: Tipo - TEXTO. 
    * **__Grau de Parentesco__**: Tipo - TEXTO. 
    * Documentos Cadastrados para o Agregado
      * **__Tipo de Documento__**: Tipo - TEXTO. 
      * **__Número do Documento__**: Tipo - NUMÉRICO. 

Para cada documento cadastrado para o agregado, tem-se a opção de baixar o arquivo anexado. 

**Alterar Dados do Agregado**

O usuário é redirecionado para o mesmo formulário de [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:agregados|cadastrar novo agregado]] previamente preenchido com os dados já cadastrados disponíveis para alteração. Entretanto, com a diferença que os campos **Responsáveis pelo Agregado**, **Servidor Responsável** ou **Pensionista Responsável** são exibidos apenas para leitura.

**Remover Agregado**

O usuário pode optar pela remoção do agregado no sistema. ([[#principais_regras_de_negócio|RN03]])

O caso de uso é finalizado.

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

  * **RN01** - A busca deve ser realizada através da utilização de um dos filtros disponíveis, Servidor ou Pensionista.
  * **RN02** - A busca utilizará para a filtragem o número dos RGs e CPFs existentes.
  * **RN03** - Ao remover um agregado, o seu registro não é removido, apenas inativado. O campo registro de remoção e inativado são setados na entidade que armazena os dados do agregado.
  * **RN04** - 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** - O campo será visualizado quando o filtro responsável pelo agregado for Servidor. 
  * **RN07** - O campo será visualizado quando o filtro responsável pelo agregado for Pensionista.

==== Resoluções/Legislações Associadas ====
//Não se aplica.//

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sigrh.pessoal.dominio.Agregado| administrativo.pessoal.agregado |
| br.ufrn.sigrh.pessoal.dominio.DocumentoAgregado| administrativo.pessoal.documento_agregado |
| br.ufrn.sigrh.dominio.TipoGrauParentesco| administrativo.rh_tipos.tipo_grau_parentesco |






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

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Consultas/Relatorios -> Funcionais -> Consultas Gerais -> Agregados

Usuário: mirian, sas

Papel que o usuário deve ter: não há restrição de papel.

===== Cenário de Teste =====

Realizar buscas usando combinações de filtros, a fim de validar a busca realizada. 

===== Dados Para o Teste =====

    * O cadastro dos agregados pode ser realizada a partir do seguinte link:
      * [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:registros_para_o_servidor:agregados|Administração de Pessoal → Cadastros → Registros para o Servidor →  Agregados]]

</ifauth>