~~ODT~~

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

====== Cadastrar Linha Telefônica ======

Este caso de uso realiza o cadastro das linhas telefônicas da instituição. As linhas telefônicas cadastradas serão utilizadas para a consulta do catálogo telefônico da instituição e também para possibilitar a geração de faturas individuais por unidade.

Esta funcionalidade é utilizada por gestores de telefonia e gerentes de unidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Telefonia -> Cadastrar Linha Telefônica//.

Para inserir uma linha telefônica é necessário informar os seguintes dados:

  * **Unidade Pagadora***: Formato - <NOME OU CÓDIGO DA UNIDADE>, Tipo - TEXTO, unidade que paga os gastos das faturas telefônicas ([[#principais_regras_de_negocio|RN02]], [[#principais_regras_de_negocio|RN03]], [[#principais_regras_de_negocio|RN04]] e [[#principais_regras_de_negocio|RN05]]).
  * **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 ([[#principais_regras_de_negocio|RN01]]).
  * **Público**: Formato - SIM/NÃO, Tipo - LÓGICO.

É possível também inserir ramais à linha telefônica. Para inserir um ramal, o sistema solicita que informe:

  * **Descrição***: Tipo - TEXTO.
  * **Número***: Tipo - NUMÉRICO.

Caso algum ramal tenha sido inserido, é exibida uma listagem dos mesmos. É possível alterar ou remover os ramais que foram inseridos. As informações exibidas na listagem de ramais são as seguintes:

  * **__Descrição__**: Tipo - TEXTO.
  * **__Número__**: Tipo - NUMÉRICO.

O usuário confirma o cadastro da linha telefônica selecionando a opção **Cadastrar Linha**. 

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** - Os usuários que possuem o papel ''SipacPapeis.GESTOR_TELEFONIA_UNIDADE_GESTORA'' ou ''SipacPapeis.GESTOR_TELEFONIA_MENU'' só poderão cadastrar linhas telefônicas para unidades pagadoras que pertençam à hierarquia da unidade vinculada à permissão do usuário.
  * **RN03** - Os usuários que possuem o papel ''SipacPapeis.GESTOR_TELEFONIA_UNIDADE_LOCAL'' só poderão cadastrar linhas telefônicas para a unidade pagadora sendo a unidade do usuário.
  * **RN04** - A unidade pagadora deve ser uma unidade orçamentária.
  * **RN05** - Se o usuário tiver acesso ao caso de uso e possuir o papel de ''SipacPapeis.GESTOR_TELEFONIA'', poderá cadastrar linhas telefônicas para qualquer unidade pagadora.

===== 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 -> Cadastrar Linha Telefônica

Usuário:

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

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.

Após o cadastro de linhas telefônicas, verificar se as mesmas são listadas no caso de uso [[atualizar_catalogo_da_unidade|Atualizar Catálogo da Unidade]].

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

Não há.