~~ODT~~

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

====== Consultar Usuários ======

Este caso de uso é utilizado por usuários que possuem a permissão de realizar consultas a usuários, com o objetivo de concretizar tal operação. É possível restringir esta consulta pelos filtros ''Login'', ''CPF'', ''Nome'', ''Papel'', ''Unidade'' e ''Buscar somente usuários ativos''.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIGAdmin -> Portal Admin -> Usuários -> Consultar Usuários//.

Inicialmente, são disponibilizados alguns filtros para a realização da busca de usuários, mostrados a seguir:

  * **Login**: Tipo - TEXTO.
  * **CPF**: Formato - 999.999.999-99, Tipo - NUMÉRICO.
  * **Nome**: Tipo - TEXTO.
  * **Tipo de Usuário**: Tipo - TEXTO. São apresentadas opções: ''Aluno, Cosignatária, Consultor, Cooperação''...
  * **Papel**: Tipo - TEXTO.
  * **Unidade**: Formato - NOME DA UNIDADE (CODIGO), Tipo - AUTOCOMPLETE. Entrada de dados: CÓDIGO DA UNIDADE ou NOME DA UNIDADE.
  * **Buscar somente usuários ativos**: Tipo - LÓGICO.
  * **Buscar usuários com apenas um ÚNICO papel (informado acima no campo "Papel")**: Tipo - LÓGICO.

Ao realizar a consulta, o sistema mostra uma lista de usuários, sendo possível a visualização das seguintes informações:

  * **__Foto__**
  * **__Nome__**: Tipo - TEXTO.
  * **__Ramal__**: Tipo - NUMÉRICO.
  * **__E-mail__**: Tipo - TEXTO.
  * **__Unidade__**: Tipo - TEXTO.

Para cada item do resultado, o sistema apresenta as opções de [[.::visualizar_detalhes_usuario|visualizar detalhes]] e [[.::selecionar_usuario|selecionar usuário]].

O caso de uso é finalizado.

===== Principais Regras de Negócio =====
Não se aplica.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.comum.dominio.Permissao | sistemas_comum.comum.permissao |
| br.ufrn.comum.dominio.UsuarioGeral | sistemas_comum.comum.usuario |
| br.ufrn.comum.dominio.Papel | sistemas_comum.comum.papel |
| br.ufrn.comum.dominio.Unidade | sistemas_comum.comum.unidade |
| br.ufrn.comum.dominio.Pessoa | sistemas_comum.comum.pessoa |
| br.ufrn.comum.dominio.Sistema | sistemas_comum.comum.sistema |
| br.ufrn.comum.dominio.Subsistema | sistemas_comum.comum.sub_sistema |

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

Sistema: SIGAdmin

Módulo: Portal Admin

Link(s): Usuários -> Consultar Usuários

Usuário: laenilson, valquiria

Papel que usuário deve ter: AdminPapeis.CONSULTA_USUARIOS, AdminPapeis.SUPORTE_SISTEMAS, AdminPapeis.ADMINISTRADOR_SIGADMIN

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

Não se aplica.

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

Não se aplica.