====== Layout do arquivo de atualização versão 1.0 ====== 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. ===== 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 === |< 100% 10% 6% 84%>| ^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. | === Atributos === |< 100% 10% 30% 60%>| ^Atributos ^Descrição ^Informações adicionais ^ |VERSAO |Versão do layout do arquivo de atualização. |Valor do atributo (fixo): 1.0 | |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. | === Exemplo === ... ... ... ==== ESCOLA ==== Este elemento contém as informações da escola a qual o arquivo pertence. === Elementos filho === |< 100% 10% 6% 84%>| ^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. | === Atributos === Este elemento não tem atributos. === Exemplo === ... 1 32078056 EMEF DARCY RIBEIRO RUA SAO TOME SAO JOSE GUARAPARI ES ... ==== PROFESSORES ==== Este elemento contém as informações de todos os professores da escola. === Elementos filho === |< 100% 10% 6% 84%>| ^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. | === Atributos === Nenhum atributo para esse elemento. === Exemplo === ... 46 MARIA DA SILVA SANTOS ... ... ===== Schema =====