~~ODT~~

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

====== Alterar/Listar linha telefônica ======

Esta funcionalidade tem a finalidade de alterar as linhas telefônicas cadastradas no caso de uso [[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:telefones:cadastrar|Cadastrar Linha Telefônica]]. 

Pré-condições:  O usuário deve possuir o papel de Gestor de Faturas acrescido de um dos papéis: Gestor de Telefones. Ou deverá ter o papel de Cadastrador de Telefones.
===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Módulo Faturas -> Aba Telefonia -> Telefones -> Listar/Alterar.

O sistema solicta que informe um dos parâmetros de busca permitindo selecionar mais de uma opção:

  * **Unidade Pagadora***: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO). Unidade que paga os gastos das faturas telefônicas. ([[#principais_regras_de_negócio|RN04]])
  * **Unidade de localização***:  Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO). Unidade onde a linha telefônica se encontra fisicamente.
  * **Descrição da linha telefônica***: Tipo - TEXTO.
  * **Tipo de Telefone**: Tipo TEXTO, são apresentadas as opções: ''CELULAR'', ''FAX'', ''FIXO'' e ''VOIP''.
  * **Perfil de Telefone**: Tipo TEXTO. Campo exibido se houverem perfis cadastrados para o tipo de telefone selecionado.
  * **Número***: Tipo NUMÉRICO.
  * **Público**: Tipo TEXTO, são apresentadas as opções: ''SIM'', ''NÃO''.

O resultado da consulta exibe os mesmos campos descritos no caso de uso [[cadastrar|Alterar linha telefônica]]


O caso de uso é finalizado.

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

  * **RN01** - Não é possível cadastrar uma nova linha com um número de outra linha previamente cadastrada
  * **RN02** - A unidade pagadora só podem ser unidades que são orçamentárias.
  * **RN03** - Se o Tipo de Telefone selecionado possuir perfis cadastrados, o sistema deve solicitar a escolha do perfil ao usuário.
  * **RN04** - O usuário com apenas o papel de CADASTRADOR_TELEFONES poderá acessar este caso para alterar a linha telefônica e não poderá visualizar demais funcionalidades do módulo de faturas, com exceção dos casos de uso cadastrar e consultar catálogo (Tarefa 167345, adicionada em 10/11/2015).


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

Não se aplica.  




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

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


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

Sistema: SIPAC

Módulo: Faturas

Link(s): 
  * Faturas -> Telefonia -> Telefones -> Cadastrar
  * Menu Administrativo -> Outros -> Telefonia -> Cadastrar Linha telefônica

Usuário: lof,lmarcos,cunha

Papel que usuário deve ter: SipacPapeis.GESTOR_TELEFONIA, SipacPapeis.CADASTRADOR_TELEFONES

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

Não se aplica.

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

Para obter as linhas telefônicas cadastradas Faturas -> Telefonia -> Telefones -> Listar/Alterar

Consulta para verificar as unidade orçamentárias:

select unidade_orcamentaria from unidade where unidade_orcamentaria=true and codigo_unidade = ?