====== Layout do arquivo de calendários escolares versão 1.0 ======
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.

===== 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 ===
|< 100% 10% 6% 84%>|
^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 ===
|< 100% 10% 30% 60%>|
^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 |


=== Exemplo ===
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<CALENDARIO NOME="CALENDARIO.TXT" VERSÃO="2.62.0.0">
 <ANOLETIVO>...</ANOLETIVO>
 <LISTATIPOSEVENTOS>...</LISTATIPOSEVENTOS>
 <LISTAEVENTOS>...</LISTAEVENTOS>
</CALENDARIO>
</code>  



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


=== Elementos filho ===
|< 100% 24% 6% 70%>|
^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.           |


=== Atributos ===
Este elemento não tem atributos.

=== Exemplo ===
<code xml>
...
<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>
...
</code>  



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


=== Elementos filho ===
|< 100% 24% 6% 70%>|
^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 ===
<code xml>
...
<LISTATIPOSEVENTOS>
  <TIPOEVENTO>...</TIPOEVENTO>
  ...  
<LISTATIPOSEVENTOS>
...
</code>



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


== Elementos filho ==
|< 100% 20% 6% 74%>|
^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 ==
<code xml>
...
<TIPOEVENTO>    
 <CODIGO>1</CODIGO>
 <SIGLA>CNV</SIGLA>
 <TIPO>RECESSO ESCOLAR</TIPO>
 <COR>$00A00000</COR>
 <DIALETIVO>NÃO</DIALETIVO>						
</TIPOEVENTO>
...
</code>  



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


=== Elementos filho ===
|< 100% 24% 6% 70%>|
^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 ===
<code xml>
...
<LISTAEVENTOS>
  <EVENTO>...</EVENTO>
  ...  
<LISTAEVENTOS>
...
</code> 



=== EVENTO ===
Este elemento contém os dados do evento.


== Elementos filho ==
|< 100% 20% 6% 74%>|
^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 ==
<code xml>
...
<EVENTO>    
 <CODIGOCALENDARIO>20</CODIGOCALENDARIO>
 <CODIGOTIPOEVENTO>5</CODIGOTIPOEVENTO>
 <DESCRICAO>FÉRIAS ESCOLARES</DESCRICAO>
 <DATA>01/01/2020</DATA>						
</EVENTO>
...
</code>    



===== Schema =====
<code xml>

</code>