[[sigaa:tecnico:documentacao_tecnica:aba_relatorios| << Voltar]]   

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

====== Relatório de Alunos por Cidade ======

Este relatório lista, para o gestor de curso técnico, os alunos matriculados por município e curso, restrito à unidade do usuário.

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

Este caso de uso inicia quando o usuário acessa a opção: SIGAA -> Técnico -> Relatórios -> Listas -> Relatório de Alunos por Cidade

Para gerar o relatório, o usuário deverá informar:

  * **__Unidade__**: Tipo - TEXTO.
  * **Ano-Período**: Tipo - NUMÉRICO. Formato - 9999-9
  * **Formato do Relatório**: Tipo - TEXTO. Formato -  PDF / XLS (Excel) / HTML

O relatório será gerado no formato escolhido, no formato:

^ **__MUNICÍPIO__**: Tipo - TEXTO ^^^|
^ **__MATRÍCULA__**: tipo - NUMÉRICO ^ **__NOME__**: Tipo - TEXTO ^ **__CURSO__**: Tipo - TEXTO ^ **__ESPECIALIZAÇÃO__**: Tipo - TEXTO |
|  -----  |  -----  |  -----   |  -----  |
| |||  **__TOTAL__**: Tipo - NUMÉRICO |

O caso de uso é finalizado.

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

  * **RN01** - Será listado apenas os alunos dos cursos da unidade do usuário.

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

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.dominio.Curso | sigaa.public.curso |
| br.ufrn.sigaa.pessoa.dominio.Discente | sigaa.public.discente |
| br.ufrn.sigaa.pessoa.dominio.Municipio | sigaa.comum.municipio |
| br.ufrn.sigaa.dominio.UnidadeFederativa | sigaa.comum.unidade_federativa |


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

Sistema: SIGAA

Módulo: Técnico

Link(s): Relatórios -> Listas -> Relatório de Alunos por Cidade

Usuário: marcel.oliveira

Papel que usuário deve ter: SigaaPapeis.GESTOR_TECNICO

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

Testar o relatório para vários usuários.


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

<code sql>
SELECT * FROM (
SELECT D.MATRICULA,P.NOME,M.ID_MUNICIPIO,M.NOME AS CIDADE, C.NOME AS CURSO,COALESCE(ATE.DESCRICAO,'') AS ESPECIALIZACAO,
       (SELECT COUNT(*)
          FROM ENSINO.MATRICULA_COMPONENTE M
         WHERE M.ID_DISCENTE=D.ID_DISCENTE
           AND M.ANO=$P{ano}
           AND M.PERIODO=$P{periodo}
       ) AS MATRICULAS
  FROM PUBLIC.DISCENTE D
  INNER JOIN TECNICO.DISCENTE_TECNICO DT ON DT.ID_DISCENTE=D.ID_DISCENTE
  LEFT  JOIN TECNICO.TURMA_ENTRADA_TECNICO TE ON TE.ID_TURMA_ENTRADA=DT.ID_TURMA_ENTRADA
  LEFT  JOIN TECNICO.ESPECIALIZACAO_TURMA_ENTRADA ATE ON ATE.ID_ESPECIALIZACAO_TURMA_ENTRADA=TE.ID_ESPECIALIZACAO_TURMA_ENTRADA
  INNER JOIN PUBLIC.CURSO C ON C.ID_CURSO=D.ID_CURSO
  INNER JOIN COMUM.PESSOA P ON P.ID_PESSOA=D.ID_PESSOA
  INNER JOIN COMUM.ENDERECO E ON E.ID_ENDERECO=P.ID_ENDERECO_CONTATO
  INNER JOIN COMUM.MUNICIPIO M ON M.ID_MUNICIPIO=E.ID_MUNICIPIO
WHERE C.ID_UNIDADE=$P{unidade} -- 284 = MUSICA
  AND C.NIVEL='T'
  AND D.STATUS=1 -- ATIVO
ORDER BY M.NOME,P.NOME
) A
WHERE MATRICULAS>0
</code>
</ifauth>