====== Consultar Bens Reutilizáveis ======

Esse caso de uso é destinado a exibir uma listagem de bens que encontram-se disponíveis para serem solicitados e movidos para a unidade do usuário logado. Os bens estarão em uma unidade especificada pelo gestor de patrimônio que será tida como unidade de bens reutilizáveis. Uma vez que o usuário identifique que um bem é de seu interesse ele deverá guardar a informação desse bem e abrir um chamado patrimonial para que o gestor envie esse bem para sua unidade.

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

 Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Portal Administrativo -> Patrimônio Móvel -> Consultar Bens Reutilizáveis.

==== Passo 1 ====

Para realizar a busca é necessário o preenchimento de pelo menos um dos campos listados abaixo: 

=== Informações Relativas ao Bem ===

    * **Tombamento**: Formato: AAAA999999. Tipo: NUMÉRICO. [[#Principais Regras de Negócio|(RN01)]]
    * **Período da Disponibilização**: Formato: DD/MM/AAAA a DD/MM/AAAA. Tipo: DATA.
    * **Grupo do Material**: Formato: NOME DO GRUPO MATERIAL, tipo TEXTO. [[#Principais Regras de Negócio|(RN02, RN03)]]
    * **Denominação**: Tipo: TEXTO.
    * **Material**: Tipo AUTOCOMPLETE, formato: NOME MATERIAL(9999999999999) UNID, entrada de dados: NOME do MATERIAL ou CÓDIGO DO MATERIAL.
    * **Marca**: Tipo AUTOCOMPLETE, formato: NOME DA MARCA, entrada de dados: NOME DA MARCA.
    * Descritores do Grupo de Material ([[#Principais Regras de Negócio|RN02]])
      * **__Nome__**: Tipo TEXTO.
      * **__Destino__**: Tipo TEXTO.
      * **Valor**: Tipo NUMÉRICO.

=== Outras Informações ===

  * **Ordenar por**: Tipo TEXTO, permite que os bens encontrados na busca sejam exibido em ordem de **Denominação** ou por **Número de Tombamento**.
  * **Agrupar dados por**: Tipo TEXTO, permite que os bens encontrados na busca sejam agrupados por **Grupo de Material** [[#Principais Regras de Negócio|(RN03)]] ou por **Unidade Responsável de Origem**.
  * **Formato de Saída**: Tipo TEXTO, indica se o relatório deverá ser exposto em tela ou gerar uma planilha. [[#Principais Regras de Negócio|(RN04)]]

====Passo 2====

Realizada a consulta, os resultados são exibidos em uma listagem com os seguintes dados: [[#Principais Regras de Negócio|(RN05)]]

| **Total de bens encontrados:** 9999                                                                           |||
^ Tombamento                                                  ^ Denominação                 ^ Valor Atual do Bem  ^
| Grupo de Material: DENOMINAÇÃO DO GRUPO DE MATERIAL                                                           |||
^ Unidade de Origem: DENOMINAÇÃO DA UNIDADE DE ORIGEM DO BEM                                                    |||
| 9999999999                                                  | DENOMINAÇÃO DO BEM          | R$ 9999,99          |
^                                                             |                         Quantidade de bens: 9999 ||
| :::                                                         |                       Total do Grupo: R$ 9999,99 ||

=====  =====
O caso de uso é finalizado.

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

  ***RN01** - Quando o filtro **Tombamento** é marcado, os outros filtros são desabilitados para consulta.
  ***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:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:tombamento:tombar_bens:definir_descritores_do_bem|Definir Descritor do Bem]].
  ***RN03** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]].
  ***RN04** - Caso a saída do relatório seja em planilha, o sistema limitará a quantidade de bens exibidos em 10 mil registros.
  ***RN05** - Caso o filtro "Agrupar dados por" tenha valor selecionado de "Unidade Responsável de Origem" os bens serão agrupados apenas por unidade de origem. No caso da seleção ser por "Grupo de Material" os bens serão listados em blocos de acordo com os grupos e internamente pelas unidades de origem. 

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

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


^ Classe ^ Tabela |
| br.ufrn.sipac.patrimonio.patrimonio.dominio.Bem | admnistrativo.patrimonio.Bem |


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

Sistema: SIPAC
 
Módulo: PATRIMÔNIO

Link(s): SIPAC → Portal Administrativo → Patrimônio Móvel → Consultar Bens Reutilizáveis.

Usuário: dilson.

Papel que usuário deve ter: 

  * Qualquer usuário do sistema pode utilizar o relatório.
===== Cenários de Teste =====
Passo 01:

Em SIPAC → Patrimônio Móvel → Gerência → Movimentações → [[desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:gerencia:movimentacoes:enviar_bens | Enviar Bens]]

Realizar a transferência dos bens para unidade de reutilização (parâmetro: **UNIDADE_REUTILIZACAO_BENS**.). 

Passo 02:

Realizar a criação do relatório de bens para reutilização, o relatório deve apresentar todos os bens transferidos.

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

  * Para verificar a unidade de reutilização (parâmetro: **UNIDADE_REUTILIZACAO_BENS**), usamos:
<code sql>
SELECT * FROM comum.parametro WHERE codigo = '1_600_84';
</code>

  * Para atualizar a unidade de reutilização (parâmetro: **UNIDADE_REUTILIZACAO_BENS**), usamos:
<code sql>
UPDATE comum.parametro SET valor = 'ID_UNIDADE_REUTILIZACAO' WHERE codigo = '1_600_84'
</code>