====== Listar/Alterar Docente Externo ======

Este Caso de Uso tem a finalidade de Alterar ou Remover docentes externos. Essa funcionalidade é utilizada pelos Gestores do Ensino Técnico.

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

O caso de uso inicia quando o usuário acessa //SIGAA -> Técnico -> Turma -> Docentes Externos -> Listar/Alterar//.

Primeiramente tem-se que buscar o docente pelo campo indicado abaixo. 

  * **Nome**: Tipo - TEXTO. Nome do docente externo que se deseja encontrar.
  * **Formação**: Tipo - TEXTO. Formação do docente externo que se deseja encontrar.
  * **Tipo**: Tipo - TEXTO. Tipo do docente externo que se deseja encontrar.
  * **Departamento**: Tipo - TEXTO. Departamento do docente externo que se deseja encontrar.

O resultado é informado em formato de tabela com os seguintes dados:

  * **__Matrícula__**: Tipo - NUMÉRICO.
  * **__Instituição__**: Tipo - TEXTO e NUMÉRICO.
  * **__Nome__**: Tipo - TEXTO.
  * **__Unidade__**: Tipo - TEXTO e NUMÉRICO.

Para cada docente encontrado é possível **Alterar os Dados Pessoais**, para tal basta seguir os passos do [[cadastrar|Cadastro]]. Também é possível fazer a remoção do docente.

O caso de uso é finalizado.

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

Não se Aplica.


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

Não se Aplica. 
<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela ^
| br.ufrn.sigaa.pessoa.dominio.DocenteExterno | sigaa.ensino.docente_externo |
| br.ufrn.sigaa.pessoa.dominio.Pessoa | sigaa.comum.comum |
| br.ufrn.sigaa.dominio.InstituicoesEnsino | sigaa.comum.instituicoes_ensino |
| br.ufrn.sigaa.pessoa.dominio.TipoDocenteExterno | sigaa.ensino.tipo_docente_externo |
| br.ufrn.sigaa.pessoa.dominio.Servidor | sigaa.rh.servidor |
| br.ufrn.sigaa.dominio.Unidade | sigaa.comum.unidade |
| br.ufrn.comum.dominio.PerfilPessoa | sigaa.comum.perfil_pessoa |

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

Sistema: SIGAA

Módulo: Técnico

Link(s): Turma -> Docentes Externos -> Listar/Alterar

Usuário: robcoe

Papel que usuário deve ter: SigaaPapeis.GESTOR_TECNICO 

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

Verificar se está sendo alterado o campo "Válido Até" do docente Externo.

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

Segue a consulta que retorna todo os docentes externo:
Cujos parâmetros devem ser informados:

  * NOME_DOCENTE_EXTERNO: Nome do docente que se deseja buscar;
  * UNIDADE_USUARIO_LOGADO: Unidade do usuário logado;

<code sql>
select *
from ensino.docente_externo de
join comum.pessoa p using(id_pessoa)
join comum.unidade u using(id_unidade)
where de.ativo='t' and de.matricula is not null 
and p.nome like 'NOME_DOCENTE_EXTERNO%' 
and de.id_unidade=UNIDADE_USUARIO_LOGADO
order by p.nome desc
</code>
</ifauth>