~~ODT~~

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

====== Listar/Alterar Empresas Concessionárias======

Esse caso de uso é utilizado pelos gestores de contratos com a finalidade permitir a listagem e edição das pessoas físicas ou jurídicas cadastradas que serão relacionadas como contratadas nos contratos firmados com a instituição em questão. 

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Aba Cadastros -> Empresas/Concessionárias -> Listar/Alterar.

Esse caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Almoxarifado -> Aba Cadastros -> Pessoa Física/Jurídica -> Listar Pessoa Física/Jurídica.

É exibido um formulário de busca de pessoas físicas ou jurídicas já inseridas no sistema com a finalidade de refinar a listagem contendo a totalidade dos registros, com os seguintes campos:

  ***CPF/CNPJ/UG:** Tipo NUMÉRICO.
  ***Razão Social:** Tipo TEXTO.
  ***Todos:** Tipo LÓGICO.

Como já mencionado, o sistema exibe uma listagem contendo todos os registros relacionados na listagem, com os seguintes campos:

  ***__CPF/CNPJ:__** Tipo NUMÉRICO.
  ***__Razão Social:__** Tipo TEXTO.
  ***__Email:__** Tipo TEXTO.
  ***__Tipo Fornecedor__**: Tipo TEXTO. Formato XX.

E também as opções de alterar os dados do fornecedor ou removê-lo. Caso o usuário deseje alterar, então o sistema remete-o para o caso de uso [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:cadastros:empresas_concessionarias:cadastrar|Cadastrar]] com os dados já preenchidos para fins de alteração. 

Caso o usuário deseje remover um registro, será requerida uma confirmação e então o registro será removido ([[#Principais Regras de Negócio|RN01]]).


O caso de uso é finalizado.


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

  * **RN01**: Um fornecedor não poderá ser excluído caso possua um registro na base de dados relacionado a ele.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.comum.dominio.Pessoa       | adminsitrativo.comum.pessoa  |
| br.ufrn.comum.dominio.Usuario      | adminsitrativo.comum.usuario |

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

Sistema: SIPAC

Módulo: Contratos

Link(s): SIPAC → Módulo Contratos → Aba Cadastros → Empresas/Concessionárias → Listar/Alterar. 

Usuário: rcsl

Papel que usuário deve ter: GESTOR_CONTRATO (manipular contratos)

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

  * Relizar testes nos filtros da consulta;
  * Realizar uma alteração em um registro listado;

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

Realizar um cadastro de Empresas/Concessionárias no casos de uso:

  * SIPAC → Módulo Contratos → Aba Cadastros → Empresas/Concessionárias → Cadastrar.