Layout do arquivo de diários eletrônicos versão 1.8

Um arquivo de diários é um arquivo XML estruturado para armazenar as ações diárias de uma classe escolar. Esse arquivo armazena basicamente dois tipos de informação: os dados da escola, do curso, da série, os critérios de avaliação, entre outros, e os dados coletados durante o percurso dessa turma no período letivo, ou seja, os alunos que fazem parte da turma e suas aulas dadas, frequências, notas e faltas.

• Exclusão da forma de avaliação do período letivo (tag PERIODOLETIVO);
• Exclusão dos conceitos do período letivo (tag PERIODOLETIVO);
• Exclusão da identificação do conceito dos totalizadores (tag TOTALIZADOR);

As tags XML devem ser escritas todas em maiúsculas, sem caracteres especiais, acentuação ou pontuação de qualquer tipo.

Qualquer nome de arquivo válido, terminado com a extensão ”.diario”.

Nenhuma formatação especial é requerida. Caracteres especiais e de acentuação/pontuação podem ser usados livremente.

Datas devem estar no formado YYYY-MM-DD.

Horas devem estar no formato HH:MM:SS.

Valores numéricos devem ser inseridos com seus separadores, quando necessário. A vírgula (,) deve ser usada como separador decimal, enquanto o ponto (.) deve ser usado como separador de milhar.

Valores booleanos devem ser informados como TRUE ou FALSE, sempre em maiúsculas.

Cada elemento do arquivo, bem como sua função e a origem das informações que os compõem, estão detalhados nas sessões seguintes.

Este elemento é o elemento raiz do documento. Seus elementos filhos devem ser os diários específicos de cada turma/disciplina.

<?xml version="1.0" encoding="utf-8"?>
<DIARIOELETRONICO VERSAO="1.7" DATAGERACAO="2022-10-04" HORAGERACAO="8:40:00">
  <DIARIO ID="21995">...</DIARIO>
  <DIARIO ID="21996">...</DIARIO>   
 ...
</DIARIOELETRONICO>

Este elemento contém as informações referentes às atividades desempenhadas em uma determinada turma. É o equivalente ao diário impresso do professor, que contém uma lista de alunos e informações como frequência, notas e faltas.

Em geral, cada disciplina lecionada pelo professor deve estar representada por um elemento DIARIO no arquivo. Entretanto, em alguns casos (como na educação infantil, por exemplo), um mesmo diário pode conter várias disciplinas. Essa definição de quantas e quais disciplinas farão parte do diário deve ser realizada durante a geração do arquivo.

...
<DIARIO ID="21995">
  <PROFESSOR>...</PROFESSOR> 
  <ESCOLA>...</ESCOLA>
  <CALENDARIOESCOLAR>...</CALENDARIOESCOLAR>
  <CURSO>...</CURSO>
  <SERIE>...</SERIE>
  <TURMA>...</TURMA>
  <DISCIPLINAS>
    <DISCIPLINA>...</DISCIPLINA>
    <DISCIPLINA>...</DISCIPLINA>
    ...  
  </DISCIPLINAS>
  <ALUNOS>
    <ALUNO>...</ALUNO>
    <ALUNO>...</ALUNO>
    ...
  </ALUNOS>
  <PERIODOSLETIVOS>
    <PERIODOLETIVO>...</PERIODOLETIVO>
    <PERIODOLETIVO>...</PERIODOLETIVO>
    ...
  </PERIODOSLETIVOS>
</DIARIO>
...

Este elemento contém as informações do professor ao qual o diário pertence.

Nenhum atributo para esse elemento.

...
<PROFESSOR>
  <ID>154</ID>   
  <NOME>SUEMAR BOTELHO RIANI ARCANJO</NOME>
</PROFESSOR>
...

Este elemento contém as informações da escola a qual o diário pertence.

Este elemento não tem atributos.

...
<ESCOLA>
  <ID>1</ID>
  <CODIGOINEP>32073364</CODIGOINEP>
  <NOME>EMEF MARINALVA ARAGAO AMORIM</NOME>
</ESCOLA>
...

Este elemento contém as informações do calendário escolar vinculado ao curso do diário.

Este elemento não tem atributos.

...
<CALENDARIOESCOLAR>
  <ID>8</ID>
  <ANOLETIVO>2021</ANOLETIVO>
  <PERIODO>INTEGRAL</PERIODO>
</CALENDARIOESCOLAR>
...

Este elemento contém informações do curso ao qual o diário pertence.

Este elemento não tem atributos.

...
<CURSO>
  <ID>1</ID>
  <NOME>ENSINO FUNDAMENTAL</NOME>
  <CODIGOENSINO>2</CODIGOENSINO>
</CURSO>
...

Este elemento contém informações da série a qual o diário pertence.

Este elemento não tem atributos.

...
<SERIE>
  <ID>6</ID>
  <ORDEM>6</ORDEM>
  <CODIGOSERIEETAPA>19</CODIGOSERIEETAPA>
  <MODULO>II</MODULO>
  <NOME>6º ANO</NOME>  
</SERIE>
...

Este elemento contém informações da turma a qual o diário pertence.

Este elemento não tem atributos.

...
<TURMA>
  <ID>1</ID>
  <NOME>6º A</NOME>
  <TURNO>MATUTINO</TURNO>  
</TURMA>
...

Este elemento contém a lista de disciplinas que compõem o diário.

Este elemento não tem atributos.

...
<DISCIPLINAS>
  <DISCIPLINA>
    <ID>46</ID>
    <TIPO>INDIVIDUAL</TIPO>  
    <CODIGOAREA>6</CODIGOAREA>
    <NOME>LÍNGUA PORTUGUESA</NOME>
    <VALIDARNOTAS>TRUE</VALIDARNOTAS>
    <CARGAHORARIA>160</CARGAHORARIA>
    <TIPOAVALIACAO>SOMATIVA (NOTAS)</FORMAAVALIACAO> 
    <TIPOFICHA></TIPOFICHA> 
  </DISCIPLINA> 
 ...
</DISCIPLINAS>
...

Este elemento contém a lista de alunos matriculados na turma.

Este elemento não tem atributos.

...
<ALUNOS>
  <ALUNO>
    <ID>1154</ID>
    <ORDEM>1</ORDEM>
    <NOME>ANA CLARA SANTA ROSA SANTOS</NOME>
    <DATANASCIMENTO>2007-10-02</DATANASCIMENTO>
  </ALUNO>
 ...
</ALUNOS>
...

Este elemento contém a lista de períodos letivos do diário.

...
<PERIODOSLETIVOS>
 <PERIODOLETIVO IMPORTADO="FALSE">
  <ID>1</ID>
  <ORDEM>1</ORDEM>
  <TIPO>NORMAL</TIPO>
  <NOME>1° TRIMESTRE</NOME>
  <PESO>30</PESO>
  <MEDIA>18</MEDIA>
  <AULASDADAS>50</AULASDADAS>
  <TOTALIZADORES>...</TOTALIZADORES>    
 </PERIODOLETIVO>
 ...  
</PERIODOSLETIVOS>
...

Este elemento contém os totalizadores de frequência e nota dos alunos durante o período letivo.

...
<TOTALIZADORES>    
  <TOTALIZADOR IDALUNO="1154" IDDISCIPLINA="46">
    <TOTALFALTAS>5</TOTALFALTAS>
    <NOTAFINAL>18,3</NOTAFINAL>
  </TOTALIZADOR>
 ...                          
</TOTALIZADORES>
...