[[Layout do arquivo de calendários escolares versão 1.2]]
 
Você está aqui: Bem-vindo! » softwares » School+ » Requisitos do sistema - School+ » Layouts de arquivos » Layout do arquivo de calendários escolares versão 1.2
Tabela de conteúdos

Layout do arquivo de calendários escolares versão 1.2

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.1)

  • Exclusão do atributo NOME nos dados do calendário;
  • Inclusão da tag PESO nos dados do ano letivo;
  • Inclusão da tag PERCENTUALAPROVACAO nos dados do ano letivo;
  • Inclusão da tag PERCENTUALFREQUENCIA nos dados do ano letivo;
  • Inclusão da tag CASASDECIMAISNOTA nos dados do ano letivo;
  • Inclusão da tag AULASDIA nos dados do ano letivo;
  • Inclusão da tag DATAAVALIACAONOA nos dados do ano letivo;
  • Inclusão da tag AMPAROLEGAL nos dados do ano letivo;
  • Inclusão da tag CRITERIOSAVALIACAO nos dados do ano letivo;
  • Inclusão da tag OBSERVACAOHISTORICO nos dados do ano letivo;
  • Inclusão da tag CRITERIOSAVALIACAOBOLETIM 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

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

Atributo Descrição Informações adicionais
VERSAO Versão do layout do arquivo de calendário escolar. Valor do atributo (fixo): 1.2

Exemplo

<?xml version="1.0" encoding="utf-8"?>
<CALENDARIO VERSAO="1.2">
 <ANOLETIVO>...</ANOLETIVO>
 <LISTATIPOSEVENTOS>...</LISTATIPOSEVENTOS>
 <LISTAEVENTOS>...</LISTAEVENTOS>
</CALENDARIO>

ANOLETIVO

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

Elementos filho

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.
– 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

...
<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>
 <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>
...

LISTATIPOSEVENTOS

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

Elementos filho

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

...
<LISTATIPOSEVENTOS>
  <TIPOEVENTO>...</TIPOEVENTO>
  ...  
<LISTATIPOSEVENTOS>
...

TIPOEVENTO

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

Elementos filho
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

...
<TIPOEVENTO>    
 <CODIGO>1</CODIGO>
 <SIGLA>CNV</SIGLA>
 <TIPO>RECESSO ESCOLAR</TIPO>
 <COR>$00A00000</COR>
 <DIALETIVO>NÃO</DIALETIVO>						
</TIPOEVENTO>
...

LISTAEVENTOS

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

Elementos filho

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

...
<LISTAEVENTOS>
  <EVENTO>...</EVENTO>
  ...  
<LISTAEVENTOS>
...

EVENTO

Este elemento contém os dados do evento.

Elementos filho
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

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

Schema

<?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.2"/>
    	        </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:positiveInteger" nillable="false"/>
			<xs:element name="DIAS" type="xs:positiveInteger" nillable="false"/>
			<xs:element name="CASASDECIMAISNOTA" type="xs:nonNegativeInteger" nillable="false"/>
			<xs:element name="AULASDIA" type="xs:positiveInteger"/>
			<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>

 
softwares/school/requisitos/layouts/schemacalendario12.txt · Última modificação: 01/12/2021 11:50 (edição externa)
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki