====== Layout do arquivo de calendários escolares versão 1.3 ======
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.2) =====
  * Inclusão da tag //TEMPOAULA// 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.          |
 
=== Atributo ===
|< 100% 10% 30% 60%>|
^Atributo           ^Descrição                                               ^Informações adicionais          ^
|VERSAO             | Versão do layout do arquivo de calendário escolar.     |Valor do atributo (fixo): 1.3   |


=== Exemplo ===
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<CALENDARIO VERSAO="1.3">
 <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.  Formato: YYYY-MM-DD                        |
|-- TERMINO                        |1             |Data de término do ano letivo.  Formato: YYYY-MM-DD                       |
|-- MESANOINICIO                   |1             |Mês e ano de início do ano letivo.  Formato: YYYY-MM-DD                   |
|-- MESANOTERMINO                  |1             |Mês e ano de término do ano letivo.  Formato: YYYY-MM-DD                  |
|-- PESO                           |1             |Peso do ano letivo.                                                       |
|-- PERCENTUALAPROVACAO            |1             |Percentual de aprovação do ano letivo.                                    |
|-- PERCENTUALFREQUENCIA           |1             |Percentual de frequência do ano letivo.                                   |
|-- DIAS                           |1             |Total de dias letivos do ano letivo.                                      |
|-- CASASDECIMAISNOTA              |1             |Número de casas decimais da nota.                                         |
|-- AULASDIA                       |1             |Quantidade de aulas por dia letivo.                                       |
|-- TEMPOAULA                      |1             |Tempo de cada aula, em minutos.                                           |
|-- DATAAVALIACAONOA               |1             |Data de avaliação da prova NOA.  Formato: YYYY-MM-DD                      |
|-- 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.         |
|-- AMPAROLEGAL                    |1             |Descrição de lei de amparo legal para o ano letivo.                       |
|-- CRITERIOSAVALIACAO             |1             |Critérios de avaliação utilizado no documento de histórico no ano letivo. |
|-- OBSERVACAOHISTORICO            |1             |Observações referentes ao documento de histórico no ano letivo.           |
|-- CRITERIOSAVALIACAOBOLETIM      |1             |Critérios de avaliação utilizado no documento de boletim no ano 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>2020-02-05</INICIO>
 <TERMINO>2020-12-15</TERMINO>
 <MESANOINICIO>2020-01-01</MESANOINICIO>
 <MESANOTERMINO>2020-12-31</MESANOTERMINO>
 <PESO>100</PESO>
 <PERCENTUALAPROVACAO>60</PERCENTUALAPROVACAO>
 <PERCENTUALFREQUENCIA>75</PERCENTUALFREQUENCIA>
 <DIAS>200</DIAS>
 <CASASDECIMAISNOTA>1</CASASDECIMAISNOTA>
 <AULASDIA>4</AULASDIA>
 <TEMPOAULA>50</TEMPOAULA>
 <DATAAVALIACAONOA>2021-01-15</DATAAVALIACAONOA>
 <CODIGOTIPOEVENTOINICIOPERIODO>27</CODIGOTIPOEVENTOINICIOPERIODO>
 <CODIGOTIPOEVENTOTERMINOPERIODO>28</CODIGOTIPOEVENTOTERMINOPERIODO>
 <CODIGOTIPOEVENTOCONSELHOCLASSE>19</CODIGOTIPOEVENTOCONSELHOCLASSE>
 <AMPAROLEGAL>A SEMED, DE ACORDO COM A RESOLUÇÃO COMEG Nº 03/2004 DE 07/12/2004, AMPLIA DE OITO PARA NOVE ANOS O ENSINO FUNDAMENTAL.</AMPAROLEGAL>
 <CRITERIOSAVALIACAO>CICLO BÁSICO - COMPOSTO POR DOIS ANOS LETIVOS, EM QUE OS ALUNOS SERÃO AVALIADOS ATRAVÉS DE FICHA DESCRITIVA DE ACORDO COM PARECER COMEG ...</CRITERIOSAVALIACAO>
 <OBSERVACAOHISTORICO></OBSERVACAOHISTORICO>
 <CRITERIOSAVALIACAOBOLETIM>A AVALIAÇÃO SOMATIVA É TRIMESTRAL E TRADUZIDA EM PONTOS...</CRITERIOSAVALIACAOBOLETIM>
 <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.  Formato: YYYY-MM-DD   |


=== 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.  Formato: YYYY-MM-DD | 


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

 
== Exemplo ==
<code xml>
...
<EVENTO>    
 <CODIGOCALENDARIO>20</CODIGOCALENDARIO>
 <CODIGOTIPOEVENTO>5</CODIGOTIPOEVENTO>
 <DESCRICAO>FÉRIAS ESCOLARES</DESCRICAO>
 <DATA>2020-01-01</DATA>						
</EVENTO>
...
</code>    



===== Schema =====
<code xml>
<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
	<xs:element name="CALENDARIO">
    	<xs:complexType>
      		<xs:sequence>
        		<xs:element name="ANOLETIVO" type="ANOLETIVO"/>				
				<xs:element name="LISTATIPOSEVENTOS" type="LISTATIPOSEVENTOS"/>
				<xs:element name="LISTAEVENTOS" type="LISTAEVENTOS"/>
      		</xs:sequence>
			<xs:attribute name="VERSAO" use="required" type="xs:string" fixed="1.3"/>
    	</xs:complexType>
  	</xs:element>
	<xs:complexType name="ANOLETIVO">    
    	<xs:sequence>
      		<xs:element name="ANOLETIVO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="PERIODOANO" nillable="false">
				<xs:simpleType>
					<xs:restriction base="xs:string">
						<xs:enumeration value="INTEGRAL"/>
						<xs:enumeration value="1° SEMESTRE"/>
						<xs:enumeration value="2° SEMESTRE"/>
					</xs:restriction>
				</xs:simpleType>
			</xs:element>
			<xs:element name="TITULO" type="xs:string" nillable="false"/>
			<xs:element name="INICIO" type="xs:date" nillable="false"/>
			<xs:element name="TERMINO" type="xs:date" nillable="false"/>
			<xs:element name="MESANOINICIO" type="xs:date" nillable="false"/>
			<xs:element name="MESANOTERMINO" type="xs:date" nillable="false"/>
			<xs:element name="PESO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="PERCENTUALAPROVACAO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="PERCENTUALFREQUENCIA" type="xs:nonNegativeInteger" nillable="true"/>
			<xs:element name="DIAS" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="CASASDECIMAISNOTA" type="xs:nonNegativeInteger" nillable="false"/>
			<xs:element name="AULASDIA" type="xs:nonNegativeInteger"/>
			<xs:element name="TEMPOAULA" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="DATAAVALIACAONOA" type="xs:date"/>
			<xs:element name="CODIGOTIPOEVENTOINICIOPERIODO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="CODIGOTIPOEVENTOTERMINOPERIODO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="CODIGOTIPOEVENTOCONSELHOCLASSE" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="AMPAROLEGAL" type="xs:string"/>
			<xs:element name="CRITERIOSAVALIACAO" type="xs:string"/>
			<xs:element name="OBSERVACAOHISTORICO" type="xs:string"/>
			<xs:element name="CRITERIOSAVALIACAOBOLETIM" type="xs:string"/>
			<xs:element name="INFORMACOESADICIONAIS" type="xs:string"/>
    	</xs:sequence>
  	</xs:complexType>
	<xs:complexType name="LISTATIPOSEVENTOS">    
    	<xs:sequence>
      		<xs:element name="TIPOEVENTO" type="TIPOEVENTO" maxOccurs="unbounded"/>
    	</xs:sequence>
  	</xs:complexType>
	<xs:complexType name="LISTAEVENTOS">    
    	<xs:sequence>
      		<xs:element name="EVENTO" type="EVENTO" maxOccurs="unbounded"/>
    	</xs:sequence>
  	</xs:complexType>
	<xs:complexType name="TIPOEVENTO">
		<xs:sequence>
			<xs:element name="CODIGO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="SIGLA" type="xs:string" nillable="false"/>
			<xs:element name="TIPO" type="xs:string" nillable="false"/>
			<xs:element name="COR" type="xs:string" nillable="false"/>
			<xs:element name="DIALETIVO" nillable="false">
				<xs:simpleType>
					<xs:restriction base="xs:string">
						<xs:enumeration value="SIM"/>
						<xs:enumeration value="NÃO"/>
					</xs:restriction>
				</xs:simpleType>
			</xs:element>
		</xs:sequence>
	</xs:complexType>
	<xs:complexType name="EVENTO">
		<xs:sequence>
			<xs:element name="CODIGOCALENDARIO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="CODIGOTIPOEVENTO" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="DESCRICAO" type="xs:string" nillable="false"/>
			<xs:element name="DATA" type="xs:date" nillable="false"/>
		</xs:sequence>
	</xs:complexType>
</xs:schema>
</code>