~~ODT~~

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

====== Listar Materiais ======

Esse caso de uso é utilizado pelos gestores de almoxarifado com a finalidade de listar os registros dos materiais que estão registrados no catálogo de materiais da instituição.

===== Descrição do Caso de Uso =====
O caso de uso inicia-se através de: //SIPAC -> Módulo Almoxarifado -> Aba Cadastros -> Materiais -> Listar Materiais//.

===Passo 1===
São exibidos os seguintes filtros para consulta:

  ***Por Período**: Tipo DATA. Formato DD/MM/AAAA a DD/MM/AAAA.
  ***Código**: Tipo NUMÉRICO. Formato 9999999999999999999999999.
  ***Denominação**: Tipo TEXTO.
  ***Grupo de Material**: Tipo AUTOCOMPLETE. Formato 9999 - NOME DO GRUPO DE MATERIAL. Entrada de dados: CÓDIGO ou NOME DO GRUPO DE MATERIAL. ([[#principais regras de negócio|RN01, RN02]])
  ***Código CATMAT**: Tipo NUMÉRICO.
  ***Somente Ativos?** Tipo LÓGICO.
  ***Exibir Especificação?** Tipo LÓGICO.
  ***Exibir em Formato de Relatório?** Tipo LÓGICO.

===Passo 2===

Os materiais encontrados de acordo com os filtros acima são exibidos com as seguintes informações:

  ***__Código__**: Tipo NUMÉRICO.
  ***__CATMAT__**: Tipo NUMÉRICO.
  ***__Data de Cadastro__**: Tipo DATA.
  ***__Denominação__**: Tipo TEXTO.
  ***__Unid. Medida__**: Tipo TEXTO.
  ***__Grupo de Material__**: Tipo TEXTO. ([[#principais regras de negócio|RN01]])
  ***__Subgrupo__**: Tipo TEXTO. ([[#principais regras de negócio|RN01]])


Para cada material é possível alterá-lo, atualizar o seu preço de compra ou removê-lo.

Ao alterar, o caso de uso segue o fluxo de [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:cadastros:materiais:cadastrar_materiais|Cadastrar Materiais]].

Ao atualizar o preço de compra, segue o fluxo de [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:cadastros:materiais:solic._atual._preco_de_material|Solicitar Atualização de Preço de Material]].

Ao remover, uma mensagem de confirmação é exibida e ao confirmar o caso de uso é 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]].
  ***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:cadastros_manuais:cadastro:material_servico:descritor_do_material:cadastrar_descritor_do_material|Cadastrar Descritor de Material]].

==== Resoluções/Legislações Associadas ====

Não se aplica.

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

^ Classe ^ Tabela |
|  | |


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

Sistema: SIPAC

Módulo: ALMOXARIFADO

Link(s): Aba Cadastros -> Materiais -> Listar Materiais

Usuário: genibaldo (almoxarifado)

Papel que usuário deve ter:
    * SipacPapeis.AUDITOR_ALMOXARIFADO.

===== Cenários de Teste =====
NÃO SE APLICA.


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

NÃO SE APLICA.