~~ODT~~

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

====== Atualizar Catálogo da Unidade ======

Através deste caso de uso é possível alterar ou remover as linhas telefônicas cadastradas na unidade do usuário. Esta operação é utilizada por gestores de telefonia e gerentes de unidade.

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

O caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Telefonia -> Atualizar Catálogo da Unidade//.

O sistema solicita que informe um dos parâmetros de busca ([[#principais_regras_de_negócio|RN01]], [[#principais_regras_de_negócio|RN02]] e [[#principais_regras_de_negócio|RN03]]):

  * **Unidade Pagadora**: Formato - <NOME OU CÓDIGO DA UNIDADE>, Tipo - TEXTO, unidade que paga os gastos das faturas telefônicas.
  * **Unidade de Localização**: Formato - <NOME OU CÓDIGO DA UNIDADE>, Tipo - TEXTO, unidade onde a linha telefônica se encontra fisicamente.
  * **Descrição**: Tipo - TEXTO.
  * **Tipo de Telefone**: Formato - uma dentre as opções ''CELULAR'', ''FAX'', ''FIXO'' ou ''VOIP'', Tipo - SELEÇÃO.
  * **Número**: Tipo - NUMÉRICO.
  * **Público**: Formato - uma dentre as opções ''SIM'' ou ''NÃO'', Tipo - LÓGICO.

O sistema exibe a lista com as linhas telefônicas encontradas com os campos descritos abaixo:

  * **__Unidade Pagadora__**: Formato - <NOME DA UNIDADE> (<CÓDIGO DA UNIDADE>), Tipo - TEXTO.
  * **__Unidade de localização__**: Formato - <NOME DA UNIDADE> (<CÓDIGO DA UNIDADE>), Tipo - TEXTO.
  * **__Tipo de Telefone__**: Tipo - TEXTO.
  * **__Número__**: Formato - 99999999, Tipo - NUMÉRICO.
  * **__Público__**: Tipo - TEXTO.
  * **__Descrição__**: Tipo - TEXTO.

São exibidas as seguintes operações para cada linha telefônica encontrada ([[#principais_regras_de_negócio|RN04]]):

  * **Alterar** - Permite alterar os dados da linha telefônica. Segue o mesmo fluxo do caso de uso de [[cadastrar_linha_telefonica|Cadastrar Linha Telefônica]].
  * **Remover** - Remove a linha telefônica do sistema através da confirmação do usuário.

O caso de uso é finalizado.

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

  * **RN01** - Se o usuário possuir o papel ''SipacPapeis.GESTOR_TELEFONIA_UNIDADE_GESTORA'' ou ''SipacPapeis.GESTOR_TELEFONIA_MENU'', só poderá consultar linhas telefônicas cuja unidade pagadora pertença à hierarquia da unidade vinculada à permissão do usuário.
  * **RN02** - Os usuários que possuem o papel ''SipacPapeis.GESTOR_TELEFONIA_UNIDADE_LOCAL'' só poderão listar linhas telefônicas cuja unidade pagadora seja a unidade do usuário.
  * **RN03** - Se o usuário tiver acesso ao caso de uso e possuir o papel de ''SipacPapeis.GESTOR_TELEFONIA'', poderá listar linhas telefônicas de qualquer unidade.
  * **RN04** - Para os usuários que não tiverem o papel de ''SipacPapeis.GESTOR_TELEFONIA'' não haverá a opção de remover as linhas telefônicas cadastradas e, ao acessarem a operação de **Alterar**, só poderão alterar a descrição da linha telefônica.


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

^ Classe ^ Tabela |
| br.ufrn.sipac.faturas.telefones.dominio.LinhaTelefonica | administrativo.faturas.linha_telefonica |
| br.ufrn.sipac.faturas.telefones.dominio.Ramal | administrativo.faturas.ramal |

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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Telefonia -> Atualizar Catálogo da Unidade

Usuário:

  *cunha (SipacPapeis.GESTOR_TELEFONIA_UNIDADE_GESTORA) ([[#principais_regras_de_negócio|RN01]])
  *aluizio (SipacPapeis.GESTOR_TELEFONIA_MENU) ([[#principais_regras_de_negócio|RN01]])
  *victorpereira (SipacPapeis.GESTOR_TELEFONIA_UNIDADE_LOCAL) ([[#principais_regras_de_negócio|RN02]])
  *larrubia2 (SipacPapeis.GESTOR_TELEFONIA_MENU e SipacPapeis.GESTOR_TELEFONIA) ([[#principais_regras_de_negócio|RN03]])

Papel que o usuário deve ter:

  *SipacPapeis.GESTOR_TELEFONIA_UNIDADE_GESTORA
  *SipacPapeis.GESTOR_TELEFONIA_MENU (papel temporário atribuído ao usuário durante o acesso ao sistema se o mesmo for gerente de unidade)
  *SipacPapeis.GESTOR_TELEFONIA_UNIDADE_LOCAL

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

Verificar todas as regras de negócio, filtros de busca e as operações de alterar e remover.

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

As linhas telefônicas podem ser cadastradas no caso de uso [[cadastrar_linha_telefonica|Cadastrar Linha Telefônica]].