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 |
| VERSAO | Versão do layout do arquivo de calendário escolar. | Valor do atributo (fixo): 1.1 |
<?xml version="1.0" encoding="utf-8"?> <CALENDARIO NOME="CALENDARIO.TXT" VERSAO="1.1"> <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. |
| – 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. |
Este elemento não tem atributos.
... <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> ...
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> ...