~~ODT~~



====== Consultar Catálogo ======

Esta funcionalidade tem o objetivo de pesquisar as linhas as telefônicas cadastradas através do 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 para executar esta funcionalidade. 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 → Consultar Catálogo.

O sistema solicita que informe a palavra chave:

  * **Palavra-Chave***: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN01]])

O usuário confirma a busca e o sistema exibe a lista das linhas telefônicas com os campos descritos abaixo:
  * **Unidade de Localização**: Formato - NOME (SIGLA) (CÓDIGO), Tipo - TEXTO.
  * **Setor**: Formato - NOME (CÓDIGO), Tipo - TEXTO.
  * **Responsável**: Tipo - TEXTO.
  * **Tipo de Telefone**: Tipo - TEXTO.
  * **Descrição**: Tipo - TEXTO.
  * **Número**: Tipo - NUMÉRICO.

O caso de uso é finalizado.

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

  * **RN01**:  A palavra-chave serve como parâmetro de busca pelo número do telefone, nome da unidade, setor, descrição e/ou nome do responsável pela linha. **Observação**: O responsável exibido na lista é o responsável ativo atualmente (Chefe ou vice-chefe da unidade de localização da linha), porém a busca considerará os dois. Desta forma, o usuário poderá fazer a busca tanto pelo nome do chefe quanto do vice.
  * **RN02** - O usuário com apenas o papel de CADASTRADOR_TELEFONES poderá acessar este caso para consulta do catalogo e não poderá visualizar demais funcionalidades do módulo de faturas com exceção dos casos de uso cadastrar e alterar linha telefônica (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.faturas.linha_telefonica |


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

Sistema: SIPAC

Módulo: Faturas

Link(s): Faturas -> Telefonia -> Telefones -> Consultar Catálogo.

Usuário: jbb

Papel que usuário deve ter: GESTOR DE FATURAS, SipacPapeis.CADASTRADOR_TELEFONES 

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

Acessar o caso de uso pelo caminho: Faturas → Telefonia → Telefones → Consultar Catálogo.

Realizar os testes convencionais verificando a busca usando palavras-chave relativas aos campos descritos em ([[#principais_regras_de_negócio|RN01]]).

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

Não se aplica.