Layout do arquivo de calendários escolares versão 1.1

Um arquivo de calendários escolares é um arquivo XML estruturado para armazenar as informações dos calendários, bem como seus dados gerais (ano letivo, período do ano, datas de início e término…), tipos de eventos e todos os eventos existentes para o ano letivo do calendário escolar.

Mudanças em relação à versão anterior (1.0)

  • Alteração no atributo VERSÃO para VERSAO da tag CALENDARIO;
  • Alteração no valor do atributo VERSAO da tag CALENDARIO, da versão do executável do sistema para o valor fixo “1.1”;
  • Alteração da tag ANOBASE para ANOLETIVO dos dados do ano letivo;
  • Alteração da tag PERIODOLETIVO para PERIODOANO dos dados do ano letivo;
  • Alteração da tag TITULOCALENDARIO para TITULO dos dados do ano letivo;
  • Alteração da tag MESANOINICIOCALENDARIO para MESANOINICIO dos dados do ano letivo;
  • Alteração da tag MESANOTERMINOCALENDARIO para MESANOTERMINO dos dados do ano letivo;
  • Exclusão da tag DESCRICAO dos dados do ano letivo;
  • Exclusão da tag NOMEPERIODOSLETIVO dos dados do ano letivo;
  • Exclusão da tag OBSERVACOESCALENDARIO dos dados do ano letivo;
  • Exclusão da tag POSSUICALENDARIO dos dados do ano letivo;
  • Inclusão da tag INFORMACOESADICIONAIS nos dados do ano letivo;

Convenções

Tags XML

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

Nome do arquivo

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

Regras de formatação

Textos

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

Datas

Datas devem estar no formado DD-MM-YYYY.

Horas

Horas devem estar no formato HH:MM:SS.

Valores numéricos

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

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

Composição do arquivo

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.

CALENDARIO

Este elemento é o elemento raiz do documento. Seus elementos filhos devem ser os elementos que armazenam informações comuns ao calendário.

Elementos filho

Elementos filho Ocorrências Descrição
ANOLETIVO 1 Dados do ano letivo do calendário escolar.
LISTATIPOSEVENTOS 1 Lista dos tipos de eventos do calendário escolar.
LISTAEVENTOS 1 Lista dos eventos do calendário escolar.

Atributos

Atributos Descrição Informações adicionais
NOME Nome do arquivo de calendário escolar. Valor do atributo (fixo): CALENDARIO.TXT
VERSAO Versão do layout do arquivo de calendário escolar. Valor do atributo (fixo): 1.1

Exemplo

<?xml version="1.0" encoding="utf-8"?>
<CALENDARIO NOME="CALENDARIO.TXT" VERSAO="1.1">
 <ANOLETIVO>...</ANOLETIVO>
 <LISTATIPOSEVENTOS>...</LISTATIPOSEVENTOS>
 <LISTAEVENTOS>...</LISTAEVENTOS>
</CALENDARIO>

ANOLETIVO

Este elemento contém os dados do ano letivo do calendário escolar.

Elementos filho

Elementos filho Ocorrências Descrição
ANOLETIVO 1 Dados do ano letivo.
– ANOLETIVO 1 Ano letivo base.
– PERIODOANO 1 Tipo do período do ano:
- INTEGRAL
- 1° SEMESTRE
- 2° SEMESTRE
– TITULO 1 Título do calendário escolar.
– INICIO 1 Data de início do ano letivo.
– TERMINO 1 Data de término do ano letivo.
– MESANOINICIO 1 Mês e ano de início do ano letivo.
– MESANOTERMINO 1 Mês e ano de término do ano letivo.
– DIAS 1 Total de dias letivos do ano letivo.
– CODIGOTIPOEVENTOINICIOPERIODO 1 Código do tipo de evento de início do período letivo.
– CODIGOTIPOEVENTOTERMINOPERIODO 1 Código do tipo de evento de término do período letivo.
– CODIGOTIPOEVENTOCONSELHOCLASSE 1 Código do tipo de evento de conselho de classe do período letivo.
– INFORMACOESADICIONAIS 1 Informações adicionais do ano letivo.

Atributos

Este elemento não tem atributos.

Exemplo

...
<ANOLETIVO>
 <ANOLETIVO>2020</ANOLETIVO>
 <PERIODOANO>INTEGRAL</PERIODOANO>
 <TITULO>CALENDÁRIO ESCOLAR 2020</TITULO>
 <INICIO>05/02/2020</INICIO>
 <TERMINO>15/12/2020</TERMINO>
 <MESANOINICIO>01/01/2020</MESANOINICIO>
 <MESANOTERMINO>31/12/2020</MESANOTERMINO>
 <DIAS>200</DIAS>
 <CODIGOTIPOEVENTOINICIOPERIODO>27</CODIGOTIPOEVENTOINICIOPERIODO>
 <CODIGOTIPOEVENTOTERMINOPERIODO>28</CODIGOTIPOEVENTOTERMINOPERIODO>
 <CODIGOTIPOEVENTOCONSELHOCLASSE>19</CODIGOTIPOEVENTOCONSELHOCLASSE>
 <INFORMACOESADICIONAIS></INFORMACOESADICIONAIS>   
</ANOLETIVO>
...

LISTATIPOSEVENTOS

Este elemento contém a lista dos tipos de eventos do calendário escolar.

Elementos filho

Elementos filho Ocorrências Descrição
LISTATIPOSEVENTOS 1 Lista dos tipos de eventos do calendário escolar.
– TIPOEVENTO 1:N Dados do tipo de evento.

Atributos

Este elemento não tem atributos.

Exemplo

...
<LISTATIPOSEVENTOS>
  <TIPOEVENTO>...</TIPOEVENTO>
  ...  
<LISTATIPOSEVENTOS>
...

TIPOEVENTO

Este elemento contém os dados do tipo de evento.

Elementos filho
Elementos filho Ocorrências Descrição
TIPOEVENTO 1:N Dados do tipo de evento.
– CODIGO 1 Código do tipo de evento.
– SIGLA 1 Sigla do tipo de evento
– TIPO 1 Descrição do tipo de evento.
– COR 1 Cor do tipo de evento.
– DIALETIVO 1 Identifica se o tipo de evento é dia letivo ou não:
- SIM
- NÃO
Atributos

Este elemento não tem atributos.

Exemplo

...
<TIPOEVENTO>    
 <CODIGO>1</CODIGO>
 <SIGLA>CNV</SIGLA>
 <TIPO>RECESSO ESCOLAR</TIPO>
 <COR>$00A00000</COR>
 <DIALETIVO>NÃO</DIALETIVO>						
</TIPOEVENTO>
...

LISTAEVENTOS

Este elemento contém a lista de eventos do calendário escolar.

Elementos filho

Elementos filho Ocorrências Descrição
LISTAEVENTOS 1 Lista de eventos do calendário escolar.
– EVENTO 1:N Dados do evento.

Atributos

Este elemento não tem atributos.

Exemplo

...
<LISTAEVENTOS>
  <EVENTO>...</EVENTO>
  ...  
<LISTAEVENTOS>
...

EVENTO

Este elemento contém os dados do evento.

Elementos filho
Elementos filho Ocorrências Descrição
EVENTO 1:N Dados do evento.
– CODIGOCALENDARIO 1 Código do calendário escolar.
– CODIGOTIPOEVENTO 1 Código do tipo de evento.
– DESCRICAO 1 Descrição do evento.
– DATA 1 Data do evento.
Atributos

Este elemento não tem atributos.

Exemplo

...
<EVENTO>    
 <CODIGOCALENDARIO>20</CODIGOCALENDARIO>
 <CODIGOTIPOEVENTO>5</CODIGOTIPOEVENTO>
 <DESCRICAO>FÉRIAS ESCOLARES</DESCRICAO>
 <DATA>01/01/2020</DATA>						
</EVENTO>
...

Schema

 

 
softwares/school/requisitos/layouts/schemacalendario11.txt · Última modificação: 01/12/2021 11:50 (edição externa)
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki