====== 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 ===
|< 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                              |
|VERSAO                          |Versão do layout do arquivo de calendário escolar.                            |Valor do atributo (fixo): 1.1                                         |


=== Exemplo ===
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<CALENDARIO NOME="CALENDARIO.TXT" VERSAO="1.1">
 <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.                                                 |
|-- 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 ===
<code xml>
...
<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>
...
</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>