~~ODT~~

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

====== Emitir Histórico ======

Este Caso de Uso é destinado aos Discentes da Instituição, tendo como finalidade permitir que os mesmos possam Emitir seu o Histórico pessoal. 

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

Este caso de uso inicia-se quando a opção //SIGAA -> Portal do Discente -> Ensino -> Emitir Histórico// é acessada.

Ao acessar o caso de uso é necessário que o usuário informe o seguinte dado:

   * **Seleção de Idioma para Emissão de Histórico**:  Tipo - TEXTO. Opções: 'PORTUGUÊS', 'FRANCÊS', 'INGLÊS' e 'ESPANHOL'.

Após selecionar o idioma o sistema emitirá um arquivo em formato PDF, contendo as seguintes informações dos Discentes:

  * **__Histórico Escolar - Emitido em__**: Formato: DD/MM/AAAA às HH:MM. Tipo - DATA e HORA.

**Dados Pessoais**
  * **__Nome__**: Tipo - TEXTO.
  * **__Matrícula__**: Tipo - NUMÉRICO.
  * **__Data de Nascimento__**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **__Local de Nascimento(Município e UF)__**: Tipo - TEXTO.
  * **__Nome do Pai__**: Tipo - TEXTO.
  * **__Nome da Mãe__**: Tipo - TEXTO. 
  * **__Endereço__**: Tipo - TEXTO. 
  * **__Bairro__**: Tipo - TEXTO.
  * **__Município__**: Tipo - TEXTO.
  * **__UF__**: Tipo - TEXTO.

**Dados do Curso**
  * **__Curso__**: Formato - NOME DO CURSO/NOME DO CENTRO - CAMPUS - TURNO, Tipo - TEXTO.
  * **__Status__**: Tipo - TEXTO.
  * **__Ênfase__**: Tipo - TEXTO.
  * **__Currículo__**: Tipo - Tipo - TEXTO.
  * **__Índices Acadêmicos(MC e MCN)__**: Tipo - NUMÉRICO
  * **__Autorização do Curso__**: Tipo - TEXTO.
  * **__Ato Normativo__**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **__D.O.U.__**: Formato - dd/mm/aaaa, Tipo - NUMÉRICO.
  * **__Ano/Período Letivo Inicial__**: Formato - AAAA.9, Tipo - NUMÉRICO.
  * **__Perfil Inicial__**: Tipo - NUMÉRICO.
  * **__Forma de Ingresso__**: Tipo - TEXTO.
  * **__Período Letivo Atual__**: Tipo - NUMÉRICO.
  * **__Prazo para Conclusão__**: Formato - AAAA.9, Tipo - NUMÉRICO.
  * **__Trancamentos__**: Tipo - TEXTO.
  * **__Prorrogações__**: Tipo - TEXTO.
  * **__Ano/Período Letivo de Integralização__**: Formato - AAAA.9, Tipo - NUMÉRICO.
  * **__Ano/Período Letivo de Saída__**: Formato - AAAA.9, Tipo - NUMÉRICO.
  * **__Data da Colação de Grau__**: Formato: DD/MM/AAAA. Tipo - DATA.
  * **__Tipo Saída__**: Tipo - TEXTO.
  * **__Trabalho de Conclusão de Curso__**: Tipo - TEXTO.

**Componentes Curriculares Cursados/Cursando**
  * **__Ano/Período Letivo__**: Formato - AAAA.9, Tipo - NUMÉRICO.
  * **__Código__**: Tipo - TEXTO.
  * **__Componente Curricular__**: Tipo - TEXTO.
  * **__Carga Horária__**: Tipo NUMÉRICO.
  * **__Horas-Aula__**: Tipo NUMÉRICO ([[#principais regras de negócio|RN01]]).
  * **__Turma__**: Tipo - TEXTO.
  * **__Frequência em %__**: Tipo - NUMÉRICO.
  * **__Média__**: Tipo NUMÉRICO.
  * **__Nota Mínima__**: Tipo NUMÉRICO.
  * **__Situação__**: Tipo - TEXTO.

**Componentes Curriculares Obrigatórios Pendentes**
  * **__Código__**: Tipo - TEXTO.
  * **__Componente Curricular__**: Tipo - TEXTO.
  * **__Situação__**: Tipo - TEXTO.
  * **__Carga horária__**: Formato 80 h, Tipo - TEXTO.

É informado um código de autenticidade para o usuário.

O caso de uso é finalizado.

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

  * **RN01** - Quando o componente curricular for do tipo ATIVIDADE e possuir "Carga Horária de Aula" (Campo da caracterização do componente curricular), considerá-la para o cálculo do número de horas-aula.
  * **RN02**: - Quando o componente curricular não tiver Traduzido, o sistema não emitirá o Histórico.

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

Não se aplica.

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


^ Classe ^ Tabela |
| sigaa.dominio.Usuario | sigaa.comum.usuario |
| sigaa.ensino.dominio.HorarioTurma| sigaa.ensino.horario_turma |

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

Sistema: SIGAA

Módulo: Portal do Discente

Link(s): Ensino -> Emitir Histórico

Usuário: wiltonnunes, walquiriamelo 

Papel que usuário deve ter: discente

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

Tentar gerar o atestado para alunos com e sem matrículas no período atual, assim como com e sem renovações de matrículas

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

Consulta para encontrar os discentes que tiveram renovação de matrícula (trocar as duas '?' pelo ano e período desejados, respectivamente)
<code>
select * from comum.usuario where id_pessoa in 
  (select id_pessoa from discente where id_discente in (
  	select mc.id_discente from stricto_sensu.renovacao_atividade_pos ren
			left join graduacao.solicitacao_matricula sol using (id_solicitacao_matricula)
			join ensino.matricula_componente mc on (ren.id_matricula_componente = mc.id_matricula_componente or sol.id_matricula_gerada = mc.id_matricula_componente)
		where ren.ano = ? and ren.periodo = ?
		)
	)
</code>

Consulta para encontrar os discentes que **não** tiveram renovação de matrícula (trocar as duas '?' pelo ano e período desejados, respectivamente)
<code>
select * from comum.usuario where id_pessoa in 
	(select id_pessoa from discente where id_discente not in (
		select mc.id_discente from stricto_sensu.renovacao_atividade_pos ren
			left join graduacao.solicitacao_matricula sol using (id_solicitacao_matricula)
			join ensino.matricula_componente mc on (ren.id_matricula_componente = mc.id_matricula_componente or sol.id_matricula_gerada = mc.id_matricula_componente)
		where ren.ano = ? and ren.periodo = ?
		)
	)
</code>