~~ODT~~

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

======== Listar/Alterar Materiais =========

Esta operação é utilizada pelos gestores de cadastro de material com a finalidade de listar ou alterar os registros dos materiais ou serviços. 

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

Esse caso de uso é acionado quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Material -> Catálogo -> Gestão de Catálogo -> Listar/Alterar Material//.

O sistema exibe o filtro de busca através do qual o usuário pode selecionar as seguinte opções:

  * **Por Período:** Tipo  DATA, Formato DD/MM/AAAA a DD/MM/AAAA.
  * **Código:** Tipo NUMÉRICO.
  * **Denominação:** Tipo TEXTO.
  * **Grupo de Material:** Tipo AUTOCOMPLETE, formato: CÓDIGO GRUPO - DENOMINAÇÃO GRUPO MATERIAL, entrada de dados: CÓDIGO ou DENOMINAÇÃO. 
  * **Somente Ativos ?:** Tipo LÓGICO.
  * **Exibir Especificação?:** Tipo LÓGICO.
  * **Exibir Descritores?:** Tipo LÓGICO.
  * **Exibir em Formato de Relatório?:** Tipo LÓGICO.

Após informar os critérios de busca  e efetuar a consulta o sistema exibe as materias recuperados de acordo com os critérios de busca informados. Na listagem de materias tem-se as seguintes informações:

  * **__Código:__** Tipo  NUMÉRICO.
  * **__Data de Cadastro:__** Tipo DATA, Formato - DD/MM/AAAA.
  * **__Denominação:__** Tipo TEXTO.
  * **__Unid. Medida:__** Tipo TEXTO.
  * **__Grupo de Material:__** Tipo TEXTO.
  * **__Subgrupo de Material:__** Tipo TEXTO.

Caso a opção //Exibir Especificação// tenho sido marcada o sistema exibe a especificação do material:
  * **__Especificação:__** Tipo TEXTO.

Caso a opção //Exibir Descritores//  tenho sido marcada o sistema exibe o nome e o valor dos descritores do material:
  * **__Descritores:__** Tipo TEXTO, Formato: Nome: valor.


Além dessas informações tem-se as operações  de //Alterar dados do Material//, //Atualizar Preço de Compra//  e //Remover Material//.

Para a operação de //Alterar dados do Material// o usuário pode alterar os dados do material cadastrado através do Caso de Uso [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:cadastro:cadastro:material_servico:autorizacao_tecnica_do_material::cadastrar| Cadastrar Material]].

Para a operação de //Remover Material//  o usuário deve confirmar a operação para efetivação da remoção.

Para a operação de //Atualizar Preço de Compra//  o sistema exibe as informações do material:
  * **__Código do Material/Serviço:__** Tipo  NUMÉRICO. Formato: 9999999999999.
  * **__Denominação:__** Tipo TEXTO.
  * **__Valor Estimado Atual:__** Tipo NUMÉRICO.
  * **__Preço de Compra Atual:__** Tipo TEXTO.
  
O usuário deve informar o novo valor para o preço do material:
  * **Novo Valor *:** Tipo NUMÉRICO.	

Através do código do material pode-se visualizar os dados do material que são:
  * Dados do Material:
    * **__Código:__** Tipo NUMÉRICO. Formato: 9999999999999.
    * **__Código CATMAT:__** Tipo NUMÉRICO.
    * **__Denominação:__** Tipo TEXTO.
    * **__Grupo de Material:__** Tipo TEXTO.
    * **__Unidade de Medida:__** Tipo TEXTO.
    * **__Especificação:__** Tipo TEXTO.
    * **__Links de Busca:__** Tipo TEXTO.
    * **__Valor Estimado:__** Tipo NUMÉRICO, Formato R$ 999.999.999,99.
    * **__Preço de Compra:__** Tipo NUMÉRICO, Formato R$ 999.999.999,99.
  * Histórico de Modificações:
    * **__Data:__** Tipo TEXTO, Formato DD/MM/AAA HH:MM
    * **__Usuário:__** Tipo TEXTO.
    * **__Unidade:__** Tipo TEXTO.
Após informar o novo preço do material o sistema confirma a operação e exibe a listagem de materiais com os dados mencionados anteriormente.

O caso de uso é finalizado.

===== Principais Regras de Negócio =====
 
Não se aplica.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.Material| admnistrativo.comum.material |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoMaterial | admnistrativo.comum.descritor_grupo_material |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoOpcaoValor | admnistrativo.comum.descritor_grupo_opcao_valor |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorSubGrupoMaterial | admnistrativo.comum.descritor_sub_grupo_material |

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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Requisições -> Material -> Catálogo -> Gestão de Catálogo -> Listar/Alterar Materiais

Usuário: diretordmp

Papel que usuário deve ter: GESTOR_CADASTRO_MATERIAL. 

===== Cenários de Teste =====

Pode-se cadastrar materiais através do seguinte Caso de Uso: [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:cadastro:cadastro:material_servico:autorizacao_tecnica_do_material::cadastrar|Cadastrar Material]].

===== Dados para o Teste =====
 
Grupo de material que tem sub-grupos associados: 5235 - EQUIPAMENTOS DE PROCESSAMENTOS DE DADOS