~~ODT~~

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


====== Consultar Material/Serviço ======

Esse caso de uso é utilizado pelos gestores de patrimônio com a finalidade de consultar os registros dos materiais já inseridos no sistema.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Patrimônio -> Aba Cadastros -> Tombamento -> Material -> Consultar Material.

A fim de consultar um material ou serviço no sistema, o usuário deverá preencher pelo menos um campo do formulário de busca:

  * **Código**: Tipo NUMÉRICO.
  * **Código CATMAT**: Tipo NUMÉRICO.
  * **Começando com**: Tipo TEXTO.
  * **Denominação contém**: Tipo TEXTO.
  * **Especificação contém**: Tipo TEXTO.
  * **Grupo Material**: Tipo TEXTO, formato: CÓDIGO GRUPO MATERIAL - NOME GRUPO MATERIAL. ([[#principais_regras_de_negocio|RN01]])
  * //A consulta pode ser realizada em todos os grupos de material. Basta selecionar a opção **Todos** no esquema de seleção.//
  * **Listar apenas materiais de estoque**: Tipo LÓGICO.
  * **Formato de Relatório?** Tipo LÓGICO.
  * **Exibir Especificação**: Tipo LÓGICO.
  * **Apenas materiais em Sistemas Registro de Preço (Pregões Abertos)**: Tipo LÓGICO.
  * **Apenas materiais em Processos de Compras em Andamento**: Tipo LÓGICO.

Após a realização da busca, será exibida uma listagem contendo os materiais relacionados na busca, com os seguintes campos:

  * **Listar apenas materiais**: Tipo LÓGICO, são apresentadas as opções: 'EM ESTOQUE', 'EM SRP' ou 'EM PROCESSO DE COMPRA'.
  * **__Código__**: Tipo NUMÉRICO.
  * **__CATMAT__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Unidade de Medida__**: Tipo TEXTO.
  * **__Valor Estimado__**: Tipo NUMÉRICO.

Para cada material é possível consultar os seus detalhes com as seguintes informações:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Código CATMAT__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Grupo de Material__**: Tipo TEXTO. ([[#principais_regras_de_negocio|RN01]])
  * **__Unidade de Medida__**: Tipo TEXTO.
  * **__Especificação__**: Tipo TEXTO.
  * **__Valor Estimado__**: Tipo NUMÉRICO.
  * **__Preço de Compra__**: Tipo NUMÉRICO.

Também é exibida uma listagem contendo todos os almoxarifados onde esse material se encontra (caso esteja no estoque), com os seguintes campos:

  * **__Almoxarifado__**: Tipo TEXTO.
  * **__Bloqueado__**: Tipo TEXTO.
  * **__Justificativa__**: Tipo TEXTO.

Em seguida, é exibida outra listagem contendo o histórico das modificações no material, com os seguintes campos: 

  * **__Data__**: Formato: DD/MM/AAAA HH:MM, Tipo DATA.
  * **__Usuário__**: Formato: NOME DO USUÁRIO (LOGIN), tipo DATA.
  * **__Unidade__**: Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE), tipo TEXTO.

Também serão exibidos tanto os registros de preços vigentes quanto as licitações em andamento para o material. Na exibição do primeiro, outra listagem será exibida, com os seguintes campos:

  * **__Licitação__**: Formato: MODALIDADE DA LICITAÇÃO - 9.../AAAA, tipo TEXTO.
  * **__Validade da Ata__**: Formato: DD/MM/AAAA a DD/MM/AAAA, tipo DATA.
  * **__Marca__**: Tipo TEXTO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Firma__**: Tipo TEXTO.
  * //Caso deseje visualizar os detalhes do processo de compra, verifique a especificação:// [[desenvolvimento:especificacoes:sipac:compras_-_registros_de_precos:casos_de_uso:sistema_de_registro_de_precos:relatorios:visualizar_ata_de_um_registro_de_precos|Visualizar Ata de um Registro de Preços]]

Em relação à licitação, também é exibida uma listagem contendo algumas informações acerca dos processos de licitação envolvidos, com os campos:

  * **__Processo__**: Formato: 9.../AAAA, tipo NUMÉRICO.
  * **__Licitação__**: Formato: MODALIDADE DA LICITAÇÃO - 9.../AAAA, tipo TEXTO.
  * **__Situação__**: Tipo TEXTO.
  * //Caso deseje visualizar os detalhes do processo de compra, verifique a especificação:// [[desenvolvimento:especificacoes:sipac:compras_-_registros_de_precos:casos_de_uso:sistema_de_registro_de_precos:relatorios:visualizar_ata_de_um_registro_de_precos|Visualizar Ata de um Registro de Preços]]

O caso de uso então é finalizado.

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

  ***RN01** - 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]].

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

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

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


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

Sistema: SIPAC

Módulo: PATRIMÔNIO

Link(s): Aba Cadastros -> Tombamento -> Material -> Consultar Material

Usuário: diretordmp (Gestor_Patrimonio_Global), adaildo (Gestor Patrimônio Unidade Gestora)

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_PATRIMÔNIO_GLOBAL ou
  * SipacPapeis.GESTOR_PATRIMÔNIO_UNIDADE_GESTORA ou
  * SipacPapeis.GESTOR_RELATÓRIO_PATRIMÔNIO.
===== Cenários de Teste =====
NÃO SE APLICA.


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

NÃO SE APLICA.