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.
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 ”.xml”.
Nenhuma formatação especial é requerida. Caracteres especiais e de acentuação/pontuação podem ser usados livremente.
Datas devem estar no formado DD-MM-YYYY.
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 elementos que armazenam informações comuns ao calendário.
| 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 | Descrição | Informações adicionais |
|---|---|---|
| NOME | Nome do arquivo de calendário escolar. | Valor do atributo (fixo): CALENDARIO.TXT |
| VERSÃO | Versão do layout do arquivo de calendário escolar. | Valor do atributo: Versão do executável do School que o arquivo foi gerado |
<?xml version="1.0" encoding="utf-8"?> <CALENDARIO NOME="CALENDARIO.TXT" VERSÃO="2.62.0.0"> <ANOLETIVO>...</ANOLETIVO> <LISTATIPOSEVENTOS>...</LISTATIPOSEVENTOS> <LISTAEVENTOS>...</LISTAEVENTOS> </CALENDARIO>
Este elemento contém os dados do ano letivo do calendário escolar.
| Elementos filho | Ocorrências | Descrição |
|---|---|---|
| ANOLETIVO | 1 | Dados do ano letivo. |
| – ANOBASE | 1 | Ano letivo base. |
| – PERIODOLETIVO | 1 | Tipo do período do ano: - INTEGRAL - 1° SEMESTRE - 2° SEMESTRE |
| – DESCRICAO | 1 | Descrição do ano letivo. |
| – DIAS | 1 | Total de dias letivos do ano letivo. |
| – INICIO | 1 | Data de início do ano letivo. |
| – TERMINO | 1 | Data de término do ano letivo. |
| – TITULOCALENDARIO | 1 | Título do calendário escolar. |
| – MESANOINICIOCALENDARIO | 1 | Mês e ano de início do ano letivo. |
| – MESANOTERMINOCALENDARIO | 1 | Mês e ano de término do ano letivo. |
| – NOMEPERIODOSLETIVO | 1 | Nomes dos períodos letivos: - MÊS - BIMESTRE - TRIMESTRE - SEMESTRE |
| – OBSERVACOESCALENDARIO | 1 | Observações do calendário escolar. |
| – POSSUICALENDARIO | 1 | Identifica se o ano letivo possui calendário ou não: - SIM - NÃO |
| – 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. |
Este elemento não tem atributos.
... <ANOLETIVO> <ANOBASE>2020</ANOBASE> <PERIODOLETIVO>INTEGRAL</PERIODOLETIVO> <DESCRICAO>CALENDÁRIO ESCOLAR ENSINO REGULAR 2020</DESCRICAO> <DIAS>200</DIAS> <INICIO>05/02/2020</INICIO> <TERMINO>15/12/2020</TERMINO> <TITULOCALENDARIO>CALENDÁRIO ESCOLAR ENSINO REGULAR 2020</TITULOCALENDARIO> <MESANOINICIOCALENDARIO>01/01/2020</MESANOINICIOCALENDARIO> <MESANOTERMINOCALENDARIO>31/12/2020</MESANOTERMINOCALENDARIO> <NOMEPERIODOSLETIVO>TRIMESTRE</NOMEPERIODOSLETIVO> <OBSERVACOESCALENDARIO></OBSERVACOESCALENDARIO> <POSSUICALENDARIO>SIM</POSSUICALENDARIO> <CODIGOTIPOEVENTOINICIOPERIODO>27</CODIGOTIPOEVENTOINICIOPERIODO> <CODIGOTIPOEVENTOTERMINOPERIODO>28</CODIGOTIPOEVENTOTERMINOPERIODO> <CODIGOTIPOEVENTOCONSELHOCLASSE>19</CODIGOTIPOEVENTOCONSELHOCLASSE> </ANOLETIVO> ...
Este elemento contém a lista dos tipos de eventos do calendário escolar.
| 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. |
Este elemento não tem atributos.
... <LISTATIPOSEVENTOS> <TIPOEVENTO>...</TIPOEVENTO> ... <LISTATIPOSEVENTOS> ...
Este elemento contém os dados do tipo de evento.
| 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 |
Este elemento não tem atributos.
... <TIPOEVENTO> <CODIGO>1</CODIGO> <SIGLA>CNV</SIGLA> <TIPO>RECESSO ESCOLAR</TIPO> <COR>$00A00000</COR> <DIALETIVO>NÃO</DIALETIVO> </TIPOEVENTO> ...
Este elemento contém a lista de eventos do calendário escolar.
| Elementos filho | Ocorrências | Descrição |
|---|---|---|
| LISTAEVENTOS | 1 | Lista de eventos do calendário escolar. |
| – EVENTO | 1:N | Dados do evento. |
Este elemento não tem atributos.
... <LISTAEVENTOS> <EVENTO>...</EVENTO> ... <LISTAEVENTOS> ...
Este elemento contém os dados do evento.
| 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. |
Este elemento não tem atributos.
... <EVENTO> <CODIGOCALENDARIO>20</CODIGOCALENDARIO> <CODIGOTIPOEVENTO>5</CODIGOTIPOEVENTO> <DESCRICAO>FÉRIAS ESCOLARES</DESCRICAO> <DATA>01/01/2020</DATA> </EVENTO> ...