~~ODT~~

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

====== Listar Grupo de Material ======

Esse caso de uso é utilizado pelos gestores com a finalidade de listar e alterar os dados existentes no registro dos grupos de material já inseridos no sistema.

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

Esse caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Compras/Licitação -> Aba Cadastros -> Cadastro -> Grupos de Material -> Listar Grupo de Material.

O sistema exibe um formulário com a finalidade de restringir a listagem de todos os grupos de material já inseridos no sistema, com os seguintes campos:

  ***Código**: Tipo NUMÉRICO.
  ***Nome**: Tipo TEXTO.
  ***Listar Todos**: Tipo LÓGICO.
  ***Considerar Grupos inativos**: Tipo LÓGICO.
  ***__Ordenar por:__**
    ***Denominação**: Tipo - TEXTO.
    ***Código**: Tipo - TEXTO.
    ***Elemento de Despesa**: Tipo - TEXTO.

Essa listagem possui os seguintes campos:

  ***__Código__**: Tipo NUMÉRICO.
  ***__Denominação__**: Tipo TEXTO.
  ***__Elemento de Despesa__**: Tipo TEXTO.
  ***__Bens Intangíveis__**: Tipo TEXTO.
  ***__Depreciável__**: Tipo TEXTO.
  ***__Vida Útil (Anos)__**: Tipo NUMÉRICO.
  ***__Valor Residual (%)__**: Tipo NUMÉRICO.

O sistema disponibiliza as opções para alterar ou remover o grupo de material. Caso o usuário deseje alterar, então o fluxo é remetido à funcionalidade [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:cadastro:cadastro:grupo_de_material:cadastrar_grupo_de_material|Cadastrar Grupos de Material]], com os dados já preenchidos para fins de alteração.

Caso o usuário deseje remover um grupo de material inserido no sistema, será requerida uma confirmação e então o registro será removido do sistema. ([[#Principais_regras_De_negócio|RN01]]).

O caso de uso é finalizado.

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

  * **RN01** - Não é possível remover um grupo de material que esteja relacionado a um registro na base de dados.
  * **RN02** - Não é possível alterar a propriedade "Grupo de Bens Intangíveis?" para um grupo que já possua bens cadastrados no sistema.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | administrativo.comum.grupo_material |


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

Sistema: SIPAC

Módulo: Compras/Licitação

Link(s): Aba Cadastros -> Cadastro -> Grupos de Material -> Listar Grupo de Material

Usuário: san, paulinho.

Papel que usuário deve ter: SipacPapeis.GESTOR_COMPRAS, SipacPapeis.GESTOR_LICITAÇÃO, SipacPapeis.GESTOR_IMPORTAÇÃO, SipacPapeis.GESTOR_SERVIÇOS_COMPRAS, SipacPapeis.GESTOR_RELATÓRIO_COMPRAS ou SipacPapeis.GESTOR_PAGAMENTO_SERVIÇO_PF e GESTOR_CADASTRO_MATERIAL.

===== Cenários de Teste =====
Não se aplica.

===== Dados para o Teste =====
Não se aplica.