Mudanças em relação à versão anterior (1.2)
Convenções
Composição do arquivo
- DIARIOUPDATE
- ESCOLA
- PROFESSORES
- CURSOS
- TURMAS
- VINCULOS
- ALUNOS
- BIMESTRES
- CONFIGURACOES
Schema

Layout do arquivo de atualização versão 1.3

Um arquivo de atualização é um arquivo XML estruturado para armazenar as informações de uma classe escolar, que serão usadas posteriormente para atualizar um arquivo de diários. Esse arquivo deve conter todas as informações de uma escola, de modo que o mesmo arquivo possa ser utilizado para atualizar qualquer diário daquela escola.

Mudanças em relação à versão anterior (1.2)

Exclusão do atributo “Importado” do bimestre vinculado à série (elemento /DIARIOUPDATE/CURSOS/CURSO/SERIES/SERIE/BIMESTRES/BIMESTRE);
Criação da lista de bimestres da turma com o status de importação pelo School (elemento /DIARIOUPDATE/CURSOS/CURSO/SERIES/SERIE/TURMAS/TURMA/BIMESTRES);
Correção da descrição dos atributos dos vínculos de professores com disciplinas (elemento /DIARIOUPDATE/CURSOS/CURSO/SERIES/SERIE/TURMAS/TURMA/VINCULOS);

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

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

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.

DIARIOUPDATE

Este elemento é o elemento raiz do documento. Seus elementos filhos devem ser os elementos que armazenam informações comuns a todos os diários, bem como as informações específicas de cada turma/disciplina.

Elementos filho	Ocorrências	Descrição
ESCOLA	1	Dados da escola.
PROFESSORES	1	Dados dos professores.
CURSOS	1	Dados do curso, suas séries, disciplinas e turmas.
CONFIGURACOES	1	Configurações do arquivo de diários.

Atributos	Descrição	Informações adicionais
VERSAO	Versão do layout do arquivo de atualização.	Valor do atributo (fixo): 1.2
DATAGERACAO	Data em que o arquivo foi gerado.	Formato: YYYY-MM-DD
HORAGERACAO	Hora em que o arquivo foi gerado.	Formato: HH:MM:SS
ORIGEM	Software que gerou o arquivo.	Valores permitidos: SCHOOL, SCHOOLWEB, DIARIO.

Elementos filho	Ocorrências	Descrição
ID	1	Identificação única da escola. Quando os dados forem gerados por outro software (School, School web) o código da escola deve ser utilizado.
CODIGOINEP	1	Identificação única da escola no INEP.
NOME	1	Nome da escola.
ENDERECO	1	Endereço da escola.
BAIRRO	1	Bairro da escola.
MUNICIPIO	1	Município da escola.
UF	1	UF da escola.

Elementos filho	Ocorrências	Descrição
PROFESSOR	1:N	Dados do professor.
– ID	1	Identificação única do professor. Quando os dados forem gerados por outro software (School, School web) o código do professor deve ser utilizado.
– NOME	1	Nome completo do professor.
– SENHA	1	Senha utilizada pelo professor para acesso ao arquivo de diários, caso a proteção por senha esteja habilitada.

Elementos filho	Ocorrências	Descrição
CURSO	1:N	Dados do curso.
– ID	1	Identificação única do curso. Quando os dados forem gerados por outro software (School, School web) o código do curso deve ser utilizado.
– NOME	1	Nome do curso.
– CODIGOENSINO	1	Código do ensino no School.
– TIPOENSINO	1	Tipo de ensino ao qual o curso pertence. Valores permitidos: - EDUCAÇÃO INFANTIL - ENSINO FUNDAMENTAL - ENSINO MÉDIO - EDUCAÇÃO DE JOVENS E ADULTOS - EDUCAÇÃO INFANTIL E ENSINO FUNDAMENTAL - EDUCAÇÃO PROFISSIONAL
– ANOLETIVO	1	Informações do ano letivo.
– REGRASARREDONDAMENTO	1	Regras de arredondamento das notas.
– RESULTADOSFINAIS	1	Resultados finais permitidos para o curso.
– SERIES	1	Séries do curso.

Elementos filho	Ocorrências	Descrição
ANO	1	Identificação numérica do ano (2015, 2016, …).
DATAINICIAL	1	Data de início do ano letivo. Formato: YYYY-MM-DD
DATAFINAL	1	Data de término do ano letivo. Formato: YYYY-MM-DD
TOTALDIASLETIVOS	1	Quantidade de dias letivos no ano letivo.
PESOLETIVO	1	Peso toal do ano letivo (a soma dos pesos de todos os bimestres normais do ano letivo).
PORCENTAGEMAPROVACAO	1	Porcentagem de pontos (em relação ao peso letivo do ano) que o aluno precisa atingir para ser considerado aprovado por nota.
PORCENTAGEMFREQUENCIA	1	Porcentagem de presenças que o aluno precisa atingir para ser considerado aprovado por frequência.
CASASDECIMAISNOTA	1	Quantidade de casas decimais usada para o arredondamento e formatação das notas.

Elementos filho	Ocorrências	Descrição
FINAL0	1	Número que deve ser usado quando o último dígito da nota for igual a 0.
FINAL1	1	Número que deve ser usado quando o último dígito da nota for igual a 1.
FINAL2	1	Número que deve ser usado quando o último dígito da nota for igual a 2.
FINAL3	1	Número que deve ser usado quando o último dígito da nota for igual a 3.
FINAL4	1	Número que deve ser usado quando o último dígito da nota for igual a 4.
FINAL5	1	Número que deve ser usado quando o último dígito da nota for igual a 5.
FINAL6	1	Número que deve ser usado quando o último dígito da nota for igual a 6.
FINAL7	1	Número que deve ser usado quando o último dígito da nota for igual a 7.
FINAL8	1	Número que deve ser usado quando o último dígito da nota for igual a 8.
FINAL9	1	Número que deve ser usado quando o último dígito da nota for igual a 9.

Elementos filho	Ocorrências	Descrição
RESULTADOFINAL	1:N	Armazena as informações de um resultado final específico
– TIPO	1	Tipo do resultado final. Valores permitidos: RENDIMENTO ou MOVIMENTO
– RESULTADO	1	Resultado final. Valores permitidos: 1 - APROVADO 2 - REPROVADO 3 - PROMOVIDO 4 - RETIDO 5 - CURSANDO 6 - TRANSFERIDO 7 - EVADIDO 8 - DESISTENTE 9 - AVANÇADO 10 - FALECIDO 11 - NOA 12 - REMANEJADO 13 - CLASSIFICADO 14 - RECLASSIFICADO
– DESCRICAO	1	Descrição do resultado final.

Elementos filho	Ocorrências	Descrição
SERIE	1	Informações específicas de uma série do curso.
– ID	1	Identificação única da série. Quando os dados forem gerados por outro software (School, School web) o código da série deve ser utilizado.
– MODULO	1	Módulo da série. Valores possíveis: I e II.
– NOME	1	Nome da série.
– AULASPORDIALETIVO	1	Quantidade de aulas que podem ser dadas em um dia letivo.
– FORMULAMEDIA	1	Fórmula utilizada para calcular a média do aluno no final do ano letivo.
– CRITERIOMEDIAFINAL	1	Estabelece o critério que deve ser utilizado para a definição da média final. Valores permitidos: 1 - Utilizar uma fórmula de cálculo 2 - Considerar a maior nota entre as recuperações 3 - Considerar a maior nota entre a média e a recuperação 4 - Considerar a nota da última recuperação
– FORMULAMEDIAFINAL	1	Fórmula utilizada para calcular a média final do aluno (usada apenas quando o critério de definição da média final for 1).
– DISCIPLINAS	1	Lista de disciplinas da série.
– BIMESTRES	1	Lista de bimestres da série.
– TURMAS	1	Lista de turmas da série.

Elementos filho	Ocorrências	Descrição
DISCIPLINA	1:N	Dados da disciplina.
– ID	1	Identificação única da disciplina. Quando os dados forem gerados por outro software (School, School web) o código da disciplina deve ser utilizado.
– TIPO	1	Tipo da disciplina em relação ao diário: - INDIVIDUAL: o diário tem apenas uma disciplina. - CONJUNTA: o diário possui várias disciplinas. - PRINCIPAL: o diário possui várias disciplinas e essa disciplina srá usada para importar os dados de frequência dos alunos.
– CODIGOAREA	1	Código da área a qual a disciplina pertence.
– NOME	1	Nome da disciplina.
– VALIDARNOTAS	1	Indica se a disciplina exige que uma nota seja informada (TRUE) ou não permite que uma nota seja informada (FALSE). Valores permitidos: TRUE, FALSE.
– CARGAHORARIA	1	Carga horária da disciplina na série.
– ITENS	1	Itens da disciplina (utilizados para o preenchimento da ficha descritiva do aluno).
– PLANOENSINO	1	Plano de ensino da disciplina.

Elementos filho	Ocorrências	Descrição
GERAIS	1	Configurações gerais do arquivo de diários.
– LOGOMARCA	1	Armazena a logomarca do município em modo texto.
– ARREDONDAMENTO	1	Define quando os critérios de arredondamento devem ser aplicados.
– PROTECAOSENHA	1	Define se o acesso ao arquivo será protegido por senha e, em caso positivo, define a senha de acesso.
– FICHADESCRITIVA	1	Define se a ficha descritiva será usada e o modelo que deve ser usado.
IMPRESSAO	1	Configurações de impressão dos diários.
– MODELO	1	Modelo de impressão e orientação das páginas do diário.
– FOLHAS	1	Define quais folhas devem estar habilitadas para impressão e seu tipo.
– – CAPA	1	Capa do diário, com a identificação do município, curso e série.
– – NORMAS	1	Normas de uso e preenchimento do diário.
– – FREQUENCIA	1	Aulas dadas e frequências dos alunos.
– – AVALIACOESPERIODICAS	1	Avaliações dadas e notas dos alunos em cada uma delas.
– – FICHADESCRITIVA	1	Ficha descritiva do aluno, contendo a lista de itens da disciplina e as observações ou conceito de cada um.
– – DADOSBIOMETRICOS	1	Dados biométricos (peso e altura) de cada aluno.
– – CONTEUDO	1	Conteúdos ministrados em sala de aula em cada aula dada.
– – RECUPERACAO	1	Dados de aplicação da recuperação final.
– – RECUPERACAOESPECIAL	1	Dados de aplicação da recuperação especial.
– – RESULTADOANUAL	1	Notas finais e faltas dos alunos, bem como seus resultados finais (aprovado, reprovado, …).
– – RESULTADOANUALFREQUENCIA	1	Soma das faltas de cada período letivo e resultado do aluno (aprovado, reprovado, …). Apenas para séries do módulo I.
– – DEMONSTRATIVOAVALIACOES	1	Notas de cada período letivo. Apenas para séries do módulo I.
– – OBSERVACOES	1	Texto contínuo com as observações do diário.

Atributos	Descrição	Informações adicionais
APLICAR (ARREDONDAMENTO)	Define quando aplicar os critérios de arredondamento.	Valores permitidos: - NUNCA: não realiza qualquer tipo de arredondamento. - ANOLETIVO: arredonda apenas a nota final do aluno no ano letivo. - PERIODOLETIVO: arredonda apenas a nota final de cada período letivo. - AVALIACAO: arredonda a nota de cada avaliação registrada.
HABILITADO (DIVERSOS)	Define se um recurso está ou não ativo.	Valores permitidos: TRUE ou FALSE.
TIPO (FICHADESCRITIVA)	Define o tipo de ficha descritiva que será usado.	Valores permitidos: - AVALIATIVA: um conceito poderá ser atribuído a cada item da disciplina. - DESCRITIVA: o desempenho do aluno poderá ser descrito pelo professor, para cada disciplina.
ID (MODELO)	Armazena a identificação do modelo de impressão do diário.	O valor não é validado pelo schema, porém é preciso que o ID seja reconhecido pelo sistema para que a impressão possa ocorrer. Valores reconhecidos: - BREJETUBA - BARRA - ICONHA - RIONOVO - GUARAPARI
NOME (MODELO)	Armazena o nome do modelo de impressão do diário.	Recomenda-se utilizar o nome do município.
ORIENTACAO (MODELO)	Define a orientação da página das folhas do diário e das folas provisórias.	Valores permitidos: - RETRATO - PAISAGEM
TIPOPERIODO (FOLHAS)	Define o tipo de período ao qual as folhas do diário pertencem.	Valores permitidos: - ANUAL: folhas impressas uma vez ao ano. - NORMAL: folhas impressas em cada período letivo regular. - RECUPERACAO: folhas impressas em cada período de recuperação. - RECUPERACAOESPECIAL: folhas impressas nos os períodos de recuperação especial.

Elementos filho	Ocorrências	Descrição
ITEM	0:N	Armazena os dados específico de um item da disciplina.
– ID	1	Identificação do item. Cada item deve ter um identificador numérico que não pode se repetir dentro da mesma disciplina.
– DESCRICAO	1	Descrição do item.

Elementos filho	Ocorrências	Descrição
BIMESTRE	1:N	Dados de um bimestre específico da turma.
– ID	1	Identificação única do bimestre. Quando os dados forem gerados por outro software (School, School web) o código do bimestre deve ser utilizado.
– ORDEM	1	Ordem do bimestre na lista de bimestres.
– TIPO	1	Tipo do bimestre: NORMAL, RECUPERAÇÃO ou RECUPERAÇÃO ESPECIAL.
– NOME	1	Nome do bimestre.
– FORMAAVALIACAO	1	Forma de avaliação adotada no bimestre: MÉDIA ou CONCEITO.
– PESO	1	Peso do bimestre em relação ao período letivo.
– MEDIA	1	Média do bimestre (utilizada para determinar se uma nota está acima ou abaixo do esperado).
– DATAINICIAL	1	Data inicial do bimestre (deve ser gerado vazio para que o professor preencha).
– DATAFINAL	1	Data final do bimestre (deve ser gerado vazio para que o professor preencha).
– AULASPREVISTAS	1	Quantidade de aulas previstas para o bimestre.
– AULASDADAS	1	Quantidade de aulas dadas no bimestre (deve ser gerado com valor zero. Será calculado automaticamente).
– CONCEITOS	1	Informações sobre os conceitos utilizados para avaliar os alunos (quando TIPOAVALIACAO for 2 ou 3).

Elementos filho	Ocorrências	Descrição
CONCEITO	0:N	Armazena os dados específico de um conceito.
– ID	1	Identificação do conceito no bimestre. Cada conceito deve ter um identificador numérico que não pode se repetir dentro do mesmo bimestre.
– CONCEITO	1	Sigla que representa o conceito.
– DESCRICAO	1	Descrição do conceito.

Elementos filho	Ocorrências	Descrição
TURMA	1	Dados específicos de uma turma.
– ID	1	Identificação única da turma. Quando os dados forem gerados por outro software (School, School web) o código da turma deve ser utilizado.
– NOME	1	Nome da turma.
– TURNO	1	Turno em que os alunos da turma estudam. Valores permitidos: - MATUTINO - VESPERTINO - NOTURNO - INTEGRAL - ALTERNADO.
– VINCULOS	1	Lista de vínculos entre as disciplinas e os professores que lecionam na turma.
– ALUNOS	1	Lista de alunos matriculados na turma.
– BIMESTRES	1	Lista de bimestres e seus respectivos status de importação pelo School.

Atributos	Descrição	Informações adicionais
IDPROFESSOR	Identificação única do professor. Quando os dados forem gerados por outro software (School, School web) o código do professor deve ser utilizado.
IDDISCIPLINA	Identificação única da disciplina. Quando os dados forem gerados por outro software (School, School web) o código da disciplina deve ser utilizado.

Elementos filho	Ocorrências	Descrição
ALUNO	1:N	Dados do aluno.
– ID	1	Identificação única do aluno. Quando os dados forem gerados por outro software (School, School web) o código do aluno deve ser utilizado.
– ORDEM	1	Ordem do aluno na lista de alunos.
– NOME	1	Nome completo do aluno e informações de movimentos anteriores.
– DATANASCIMENTO	1	Data de nascimento do aluno.
– DATAMATRICULA	1	Data de matrícula do aluno.
– MOVIMENTO	1	Último movimento realizado pelo aluno. Deve ser usado o número do respectivo movimento, conforme a seguinte lista: 1 - Matriculado 4 - Remanejado 6 - Transferido 7 - Evadido 8 - Avançado 10 - Desistente 11 - Falecido 12 - Classificado 13 - Reclassificado
– DATAMOVIMENTO	1	Data do último movimento realizado pelo aluno.
– ISENTOREPROVACAONOTAS	1	Indica se o aluno é ou não isento à reprovação por nota. Valores permitidos: TRUE ou FALSE.
– ISENTOREPROVACAOFALTAS	1	Indica se o aluno é ou não isento à reprovação por faltas. Valores permitidos: TRUE ou FALSE.

Elementos filho	Ocorrências	Descrição
BIMESTRE	1:N	Dados específicos de um bimestre. Cada nó representa a situação de importação de um bimestre da série, para cada disciplina da turma.
– ID	1	Identificação única do bimestre. Quando os dados forem gerados por outro software (School, School web) o código do bimestre deve ser utilizado.
– IDDISCIPLINA	1	Identificação única da disciplina. Quando os dados forem gerados por outro software (School, School web) o código da disciplina deve ser utilizado.
– IMPORTADO	1	Situação de importação do bimestre no School. Valores permitidos: True ou False.