====== Consultar Bens de Terceiros ======

Esta função permite que o gestor de patrimônio visualize o histórico de um bem cadastrado como bem de terceiro na Intituição. Essa função é acessada sempre que for necessário visualizar detalhes sobre esse bem.

Para mais detalhes acerca de bens de terceiros, visualize a especificação [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:bens:bens_de_terceiros:cadastrar|Especificação Cadastrar Bens de Terceiros]].
===== Descrição do Caso de Uso =====

=== Passo 1 ===

É solicitado o preenchimento de pelo menos um dos campos a seguir para consulta:

  * **Período**: Formato: DD/MM/AAAA a DD/MM/AAAA, tipo DATA. 
  * **Documento**: Formato 999999/AAAA, tipo NUMÉRICO.
  * **Tombamento**: Tipo NUMÉRICO.
  * **Número Antigo:** Tipo NUMÉRICO.
  * **Responsável:** Tipo AUTOCOMPLETE, formato: NOME DO SERVIDOR - DOCUMENTO DE IDENTIFICAÇÃO DO SERVIDOR, entrada de dados: NOME DO SERVIDOR.
  * **Marca do Produto:** Tipo AUTOCOMPLETE, formato: NOME DA MARCA, entrada de dados: NOME DA MARCA.
  * **Material**: Tipo AUTOCOMPLETE, formato: NOME DO MATERIAL (CÓDIGO) UNIDADE DE MEDIDA, entrada de dados: NOME DO MATERIAL ou CÓDIGO.
  * **Projeto**: Formato: NOME DO PROJETO (CÓDIGO DO PROJETO), tipo TEXTO. ([[#principais regras de negócio|RN01]])
  * **Origem**: Tipo TEXTO, são apresentadas opções tais quais: CNPQ, FUNDAÇÃO. Para mais detalhes acerca das opções existentes para seleção, verifique a especificação: [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:cadastros:tombamento:origem_de_bens_de_terceiros:cadastrar_listar_alterar|Cadastrar Origem de Bens de Terceiros]].
  * **Unidade**: Formato: UNIDADE (CÓDIGO DA UNIDADE), Tipo - TEXTO.
    * Observa-se também a opção de buscar a unidade, que exibe uma busca por unidade através do nome da mesma.
  * **Localidade**: Formato: UNIDADE (CÓDIGO DA UNIDADE) LOCALIDADE (CÓDIGO DA LOCALIDADE), tipo AUTOCOMPLETE. Entrada de dados: NOME DA LOCALIDADE.  ([[#Principais_regras_de_negócio|RN02]]).


=== Passo 2 === 
É exibida uma lista de bens encontrados pela consulta com as informações de:

  * **Tombamento**: Tipo NUMÉRICO.
  * **Descrição**: Tipo TEXTO.
  * **Unidade**: Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE), tipo TEXTO.
  * **Origem**: Tipo TEXTO.
  * **Valor (R$)**: Tipo NUMÉRICO.

Ao selecionar o bem, são exibidas as informações do bem e todo o seu histórico, para mais informações, verifique a especificação [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:bens:bens_de_terceiros:historico_de_um_bem|Histórico de Bens de Terceiros]].

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

  * **RN01** - Os dados de **Projeto** apenas são exibidos se o parâmetro //TOMBAMENTO_FUNDACAO// tiver valor verdadeiro.
  * **RN02** - 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:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:localidade:cadastrar#principais regras de negócio|Cadastrar Localidade]].

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

< PREENCHER >

^ Classe ^ Tabela |
| < PREENCHER > | < PREENCHER > |


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

Sistema: SIPAC
Módulo: Patrimônio

Link(s): Consultas -> Bens -> Bens de Terceiros

Usuário: diretordmp

Papel que usuário deve ter:
  
  * GESTOR_PATRIMONIO_GLOBAL
  * GESTOR_PATRIMONIO_FUNDACAO
  * GESTOR_PATRIMONIO_UNIDADE_GESTORA
  * GESTOR_PATRIMONIO_LOCAL
  * GESTOR_RELATORIO_PATRIMONIO





===== Cenários de Teste =====
<PREENCHER>


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

< PREENCHER>