Mudanças entre as edições de "Documentação Relatórios"

De Gennera Wiki
Ir para: navegação, pesquisa
Linha 33: Linha 33:
 
==== Filtros ====
 
==== Filtros ====
  
Atualmente, as fontes de dados disponíveis são:
+
Além dos relacionamentos, existem os filtros, que são utilizados no momento da emissão. Eles são importantes por dois motivos, o primeiro está em encontrar os dados corretos. Por exemplo, se for necessário emitir um histórico escolar para um aluno específico, de nada adianta emitir para vários e depois precisar localizá-lo em meio a inúmeras páginas. Além disso, geralmente a emissão deste tipo de documento envolve a obtenção e manipulação de um grande volume de dados, assim, quanto mais específico forem os filtros mais rápido será o processo de emissão do documento.
 +
 
 +
Assim, a combinação dos relacionamentos corretos no modelo do relatório com um conjunto de filtros específico é a garantia de criar e emitir relatórios com o máximo de agilidade e performance.
 +
 
 +
Para entender melhor as fontes de dados com seus relacionamentos e seus filtros, vamos abordar cada uma delas:
  
 
==== Matrícula ====
 
==== Matrícula ====

Edição das 10h54min de 22 de julho de 2018

O módulo de relatórios permite a criação, modificação e emissão de diversos tipos de documentos como: contratos, declarações, históricos escolares, boletins, requerimentos, listas entre outros tipos de documentos.

Existe ainda um conjunto de documentos pré-definidos e padronizados que podem ser adaptados para a realidade de cada instituição de ensino pela equipe da Gennera ou da própria instituição.

Relatório

Um relatório é composto basicamente por:

  • Descrição
  • Fonte de Dados
    • Relacionamentos
  • Conteúdo
    • HTML
    • CSS
    • JavaScript

A descrição é útil para localizá-lo tanto no módulo de relatórios quanto em outros módulos. É importante lembrar que outros módulos como matrícula, sala de aula e eventos permitem vincular relatórios aos seus processos de negócio, sendo assim, a descrição é fundamental para associá-los corretamente nestas situações.

Fontes de Dados

A fonte de dados indica basicamente qual é o conjunto de dados que deve ser obtido e disponibilizado para renderização. A fonte de dados de matrícula é recomendada quando o relatório for emitido por matrícula. Por exemplo, um contrato é emitido por matrícula assim como um boletim. Uma ata de sala, onde consta a lista de alunos matriculados em uma determinada turma ou disciplina não é emitida por matrícula sendo mais recomendado utilizar uma outra fonte de dados como turma ou disciplina.

Todas as fontes de dados estão associadas com relacionamentos e filtros e eles variam de acordo com a fonte de dados.

Relacionamentos

Os relacionamentos existem de forma explícita, em primeiro lugar, por uma questão de performance. Só na fonte de dados de matrícula existem mais de 30 relacionamentos, por exemplo, ao renderizar um conjunto de dados da fonte de matrícula é possível retornar também os dados do aluno. A partir dos dados do aluno é possível chegar nos dados das pessoas relacionadas a ele como o pai, a mãe e outras pessoas associadas ao aluno. Da mesma forma, a partir da matrícula é possível chegar nos contratos associados e deles chegar nas faturas de cada contrato.

A questão é, quanto mais relacionamentos, mais dados são necessário e mais tempo irá demorar para realizar a consulta no banco de dados. Assim, caso seja necessário renderizar um boletim, a partir da fonte de dados de matrícula, é interessante utilizar os relacionamentos de disciplinas, notas, médias e frequência mas não utilizar contratos, faturas e pagamentos.

Isso faz com que o módulo de relatórios possa ter uma excelente performance, desde que os relatórios sejam construídos de forma adequada.

Filtros

Além dos relacionamentos, existem os filtros, que são utilizados no momento da emissão. Eles são importantes por dois motivos, o primeiro está em encontrar os dados corretos. Por exemplo, se for necessário emitir um histórico escolar para um aluno específico, de nada adianta emitir para vários e depois precisar localizá-lo em meio a inúmeras páginas. Além disso, geralmente a emissão deste tipo de documento envolve a obtenção e manipulação de um grande volume de dados, assim, quanto mais específico forem os filtros mais rápido será o processo de emissão do documento.

Assim, a combinação dos relacionamentos corretos no modelo do relatório com um conjunto de filtros específico é a garantia de criar e emitir relatórios com o máximo de agilidade e performance.

Para entender melhor as fontes de dados com seus relacionamentos e seus filtros, vamos abordar cada uma delas:

Matrícula

Toda fonte de dados está associada a um conjunto de filtros. No caso da matrícula, os filtros são os seguintes:

  • Calendário Acadêmico
  • Curso
  • Módulo
  • Turma
  • Matrícula
  • Status


  • Turma
  • Fatura
  • Biblioteca
  • Histórico Acadêmico
  • Disciplina
  • Evento