~~ODT~~

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


====== Consultar Termo de Acautelamento ======

Este caso de uso permite a consulta aos Termos de Acautelamento realizados em  [[desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:acautelamento:abertura_de_termo_de_acautelamento|Abertura de Termo de Acautelamento]].

O Termo de Acautelamento registra a ação de acautelar um bem, que é transferir a responsabilidade dele a determinado servidor em específico. Para mais informações verifique o [[desenvolvimento:especificacoes:sipac:patrimonio_movel:negocio|Documento de Negócio do Módulo Patrimônio]].

É utilizado apenas pelos gestores de patrimônio quando desejarem realizar tal consulta.

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

Este caso de uso inicia-se quando o usuário acessa a opção //SIPAC -> Módulo Patrimônio -> Aba Consultas -> Movimentações -> Termo de Acautelamento//.

Para realizar a consulta é necessário informar pelo menos um dos filtros abaixo:
  * **Número do Termo**: Formato - 9999/AAAA, Tipo NUMÉRICO.
  * **Unidade do Termo**: Tipo AUTOCOMPLETE. Formato: NOME DA UNIDADE (CÓDIGO). Entrada de Dados: NOME ou CÓDIGO DA UNIDADE. ([[#principais regras de negócio|RN04 e RN06]]).
  * **Localidade do Termo**: Tipo - AUTOCOMPLETE. Formato - CÓDIGO - NOME DA LOCALIDADE. Entrada de Dados: NOME ou CÓDIGO DA LOCALIDADE. ([[#principais regras de negócio|RN01]])
  * **Detentor**: Formato - JOSÉ DA SILVA (CARGO - 9999999), Tipo - AUTOCOMPLETE. Entrada de Dados: NOME DO SERVIDOR ou CÓDIGO SIAPE. ([[#principais regras de negócio|RN05 e RN07]]).
  * **Período de Abertura**: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.
  * **Período de Fechamento**: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.
  * **Período Previsto para Fechamento**: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.
  * **Período da Entrega/Devolução do Bem**: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.

  * **Unidade do Servidor**: Tipo AUTOCOMPLETE. Formato: NOME DA UNIDADE (CÓDIGO). Entrada de Dados: NOME ou CÓDIGO DA UNIDADE.
  * **Incluir Unidades Vinculadas à Unidade Responsável**: Tipo - LÓGICO.
  * **Localidade do Servidor**: Tipo AUTOCOMPLETE. Formato: NOME DA LOCALIDADE. Entrada de Dados: NOME DA LOCALIDADE.

  * **Bem**: Formato: AAAA999999 - DENOMINAÇÃO DO BEM. Tipo - AUTOCOMPLETE. Entrada de Dados: NÚMERO DE TOMBAMENTO ou DENOMINAÇÃO DO BEM.
  * **Nota Fiscal**: Formato - NÚMERO - SÉRIE. Tipo - NUMÉRICO.
  * **Fornecedor**: Tipo - AUTOCOMPLETE. Formato - NOME DO SERVIDOR. Entrada de Dados: NOME DO SERVIDOR.
  * **Marca do Bem**: Tipo - AUTOCOMPLETE. Formato - NOME DA MARCA. Entrada de Dados: NOME DA MARCA.
  * **Grupo de Material**: Formato - 9999 - NOME DO GRUPO. Tipo - TEXTO. ([[#principais regras de negócio|RN02, RN03]]).

  * **Somente Termos Ativos**: Tipo - LÓGICO.

Os termos de acautelamento encontrados são exibidos, com as seguintes informações:

  * **__Termo__**: Formato - 9.../AAAA, Tipo NUMÉRICO.
  * **__Data de Abertura__**: Tipo - DATA.
  * **__Servidor__**: Tipo - TEXTO
  * **__Matrícula Interna__**: Tipo NUMÉRICO.
  * **__Data Prevista para Fechamento__**: Formato DD/MM/AAAA. Tipo DATA.
  * **__Data de Fechamento__**: Formato DD/MM/AAAA. Tipo DATA.

Para cada termo de acautelamento encontrado existem as opções de //visualizar// o termo escolhido e //gerar relatório// [[#Principais_regras_de_negocio|RN12]].

Ao visualizar, o sistema exibe as seguintes informações:

  * **__Servidor:__**: Tipo TEXTO. Formato: NOME DO SERVIDOR. Detentor dos bens listados na cautela.
  * **__N°. SIAPE__**: Tipo NUMÉRICO. Matrícula SIAPE.
  * **__Lotação__**: Tipo TEXTO. 
  * **__Cargo__**: Tipo TEXTO.
  * **__Unidade de Acautelamento__**: Tipo TEXTO.
  * **__Localidade__**: Tipo TEXTO.
  * **__Data e Hora de Abertura__**: Tipo DATA.
  * **__Data Prevista para Fechamento__**: Tipo DATA. [[#Principais_regras_de_negocio|RN08]]
  * **__Data e Hora de Fechamento__**: Tipo DATA. [[#Principais_regras_de_negocio|RN09]]
  * **__Termo Anterior Renovado__**: Tipo TEXTO. Formato: 9.../AAAA - SIGLA UNIDADE OU LOCALIDADE.	
  * **__Termo Gerado para Renovação__**: Tipo TEXTO. Formato: 9.../AAAA - SIGLA UNIDADE OU LOCALIDADE. 

**Bens acautelados pendentes de recebimento** [[#Principais_regras_de_negocio|RN13]]

  * **__N°. Tombamento__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Data Prevista para Devolução__**: Tipo DATA
  * **__Valor do Bem (R$)__**: Tipo NUMÉRICO.
  * **__Usuário de Inserção__**: Tipo TEXTO. Formato: login - Nome do usuário.
  * **__Data de Acautelamento__**: Tipo - DATA.
  * **__Data de Recebimento__**: Tipo - DATA.
  * **__Documento__**: Tipo - TEXTO.
  * **__Grupo de Material__**: Tipo - TEXTO.
  * **__Unidade__**: Tipo - TEXTO.
  * **__Localidade__**: Tipo - TEXTO.
  * **__Marca__**: Tipo - TEXTO.

**Bens acautelados recebidos** [[#Principais_regras_de_negocio|RN10]]

  * **__N°. Tombamento__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Data Prevista para Devolução__**: Tipo DATA
  * **__Valor do Bem (R$)__**: Tipo NUMÉRICO.
  * **__Usuário de Inserção__**: Tipo TEXTO. Formato: login - Nome do usuário.
  * **__Data de Acautelamento__**: Tipo - DATA.
  * **__Data de Recebimento__**: Tipo - DATA.
  * **__Documento__**: Tipo - TEXTO.
  * **__Grupo de Material__**: Tipo - TEXTO.
  * **__Unidade__**: Tipo - TEXTO.
  * **__Localidade__**: Tipo - TEXTO.
  * **__Marca__**: Tipo - TEXTO.

**Bens Devolvidos**[[#Principais_regras_de_negocio|RN11]]
  * **__Tombamento__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Data de Acautelamento__**: Tipo - DATA.
  * **__Entrega__**: Tipo DATA.
  * **__Devolução__**: Tipo DATA.
  * **__Marca__**: Tipo TEXTO.
  * **__Valor do Bem (R$)__**: Tipo NUMÉRICO.
  * **__Usuário de Devolução__**: Tipo TEXTO. Formato: login - Nome do usuário. Usuário que registrou a devolução do bem no termo de acautelamento.

Além dessas informações, é disponibilizada a opção de imprimir o termo de acautelamento, onde serão exibidas as informações acima, com adição dos campos:

  * **__Valor total:__** Tipo NUMÉRICO.
  * **__Detentor__**: Tipo TEXTO. Espaço para o detentor assinar.
  * **__Setor de Patrimônio__**: Tipo TEXTO. Espaço para o responsável pelo patrimônio assinar.

O caso de uso é finalizado.



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

  ***RN01** - A exibição deste campo depende de um [[desenvolvimento:especificacoes:sigadmin:casos_de_uso:portal_da_administracao:config_do_sistema:parametros:listar_alterar_parametros|parâmetro do sistema]]. Se PERMITE_OPERACOES_PATRIMONIO_POR_LOCALIDADE for verdadeiro, é possível realizar operações nas localidades, da mesma forma que nas unidades.
    - Caso seja exibido o campo **Localidade**, verifique mais regras de negócio em [[desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:localidade:cadastrar#principais regras de negócio|Cadastrar Localidade]].
  ***RN02** - Ao ser escolhido o Grupo de Material, pode haver descritores ou subgrupos associados, se houverem subgrupos associados, irá aparecer para mais um filtro da pesquisa ser realizado, além do que se existir descritores de materiais cadastrados para aquele grupo ou subgrupo, é possível fazer a consulta por estes descritores também. Para mais informações acesse  [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:cadastro:cadastro:material_servico:descritor_do_material:cadastrar_descritor_do_material|Cadastrar Descritor de Material]]. 
  ***RN03** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio_movel:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]].
** Perfil: Gestor de Patrimônio Local** 
  * <del>**RN04** - O gestor de patrimônio local só poderá buscar cautelas da unidade e de suas filhas que estão associadas à permissão GESTOR_PATRIMONIO_LOCAL. </del>(Deletada em 05/03/2012, referente a tarefa 85289)
  * <del>**RN05** - O gestor de patrimônio local só poderá buscar cautelas de detentores da unidade associada à permissão GESTOR_PATRIMONIO_LOCAL. </del>(Deletada em 05/03/2012, referente a tarefa 85289)
** Perfil: Gestor de Patrimônio Unidade Gestora** 
  * **RN06** - O gestor de patrimônio unidade gestora só poderá buscar cautelas da sua unidade gestora e de suas filhas. (Adicionada em 05/03/2012, referente a tarefa 85289)
  * **RN07** - O gestor de patrimônio local só poderá buscar cautelas de detentores da sua unidade gestora e suas filhas. (Adicionada em 05/03/2012, referente a tarefa 85289)
  * **RN08** - A data prevista para fechamento é exibida caso o termo de acautelamento não tenha sido finalizado. Um termo é finalizado quando todos os bens são devolvidos.
  * **RN09** - A data de fechamento é exibida caso o termo de acautelamento tenha sido finalizado. Um termo é finalizado quando todos os bens são devolvidos.
  * **RN10** - Os bens acautelados são exibidos caso haja bens não devolvidos na cautela.
  * **RN11** - Essas informações são exibidas caso haja bens devolvidos.
  * **RN12** - Caso a opção de relatório seja selecionada, é gerado um relatório com as informações dos servidores e os dados dos bens acautelados e devolvidos abaixo do nome de cada servidor.
  * **RN13** - Os bens acautelados pendentes de recebimento serão apresentados caso o detentor do termo ainda não tenha confirmado o recebimento via portal administrativo.

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

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

^ Classe ^ Tabela |
| br.ufrn.sipac.patrimonio.acautelamento.dominio.Cautela | administrativo.patrimonio.cautela |
| br.ufrn.sipac.patrimonio.acautelamento.dominio.ItemCautela | administrativo.patrimonio.item_cautela |

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

Sistema: SIPAC

Módulo: Patrimônio

Link(s): 

  * Patrimônio -> Aba Consultas -> Movimentações -> Termo de Acautelamento.

Usuário: san (Gestor de Patrimônio Global), adaildo (Gestor de Patrimônio da Unidade Gestora).

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_PATRIMONIO_GLOBAL
  * SipacPapeis.GESTOR_PATRIMONIO_UNIDADE_GESTORA
===== Cenários de Teste =====

Não se aplica.

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

Não se aplica.