📄 Layouts Excel para Importação

Documentação completa dos formatos de planilhas Excel para importação de dados acadêmicos no EDUMIZE. Especificações técnicas, exemplos práticos e guias de preenchimento.

10 Tipos de Layout
140+ Campos Mapeados
100% Compatibilidade

📚 Dados Acadêmicos

Layouts para importação de cursos, disciplinas e estruturas curriculares.

Cursos

fundamental Excel (.xlsx) 3 campos

Cadastro de cursos superiores (Bacharelado, Licenciatura, Tecnólogo).

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_curso Texto 10 Código único do curso CC
nome_curso Texto 255 Nome completo do curso Ciência da Computação
tipo_curso Lista - Modalidade do curso Bacharelado

📝 Valores Válidos para tipo_curso:

  • Bacharelado - Cursos de graduação bacharelado
  • Licenciatura - Cursos de licenciatura
  • Tecnólogo - Cursos superiores de tecnologia

Currículos

fundamental Excel (.xlsx) 9 campos

Definição de matrizes curriculares para os cursos oferecidos.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo Texto 50 Código único do currículo ADS001|CUR2025
nome Texto 300 Nome descritivo do currículo ADS Integral|Matriz 2025
codigo_curso Texto 20 Referência ao curso (FK) ADS
formato Texto 20 Modalidade de ensino Presencial
data_criacao Data - Data de criação (DD/MM/AAAA) 01/01/2025
data_extincao Data - Data de extinção (DD/MM/AAAA) 31/12/2027
quantidade_semanas_aula Número - Semanas de aula por período 20
quantidade_periodos Número - Número total de períodos 6
regime_academico Texto 20 Regime do curso Semestral
carga_horaria Decimal - Carga horária total 2400

Áreas de Conhecimento

pré-requisito Excel (.xlsx) 2 campos

Classificação das disciplinas por áreas temáticas ou departamentos.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_area Texto 20 Código único da área COMP
nome_area Texto 255 Nome descritivo da área Ciências da Computação
⚠️ Importante: As áreas de conhecimento devem ser importadas antes das disciplinas.

Disciplinas

fundamental Excel (.xlsx) 5 campos

Cadastro de disciplinas com classificação e natureza.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_disciplina Texto 20 Código único da disciplina ALG001
nome_disciplina Texto 255 Nome completo da disciplina Algoritmos I
codigo_area Texto 20 Referência à área (FK) COMP
natureza Lista - Classificação da disciplina Curricular
subnatureza Lista - Subclassificação específica Regular

📝 Valores Válidos para natureza:

  • Curricular - Disciplinas regulares do currículo
  • Estágio - Estágios obrigatórios e não obrigatórios
  • Atividade complementar - Atividades extracurriculares

📝 Valores Válidos para subnatureza:

  • Regular - Disciplina regular
  • TCC - Trabalho de Conclusão de Curso
  • Prática componente curricular
  • Internato
  • Iniciação científica
  • Monitoria
  • Evento científico
  • Trabalho voluntário
  • Atividade cultural
  • Empreendedorismo
  • Extensão
  • Estágio não obrigatório

Cargas Horárias das Disciplinas

fundamental Excel (.xlsx) 6 campos

Distribuição detalhada das cargas horárias por tipo e modalidade.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_disciplina Texto 20 Código da disciplina (FK) ALG001
tipo Lista - Tipo de carga horária Teoria
modalidade Lista - Modalidade de ensino Presencial
valor Número - Horas para este tipo/modalidade 60
aulas_semanais Número - Aulas por semana 3
codigo_ambiente_tipo Texto 20 Tipo de ambiente requerido SALA

📝 Valores Válidos para tipo:

  • Teoria - Aulas teóricas
  • Prática - Aulas práticas/laboratório
  • Extensão - Atividades de extensão

📝 Valores Válidos para modalidade:

  • Presencial - Aulas presenciais
  • Síncrona - Aulas online ao vivo
  • Assíncrona - Aulas gravadas/EAD

🏗️ Estrutura Física e Curricular

Layouts para ambientes físicos, grades curriculares e relacionamentos entre disciplinas.

Tipos de Ambiente

básico Excel (.xlsx) 5 campos

Categorização dos tipos de ambientes físicos disponíveis.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_ambiente_tipo Texto 20 Código único do tipo SALA
nome_ambiente_tipo Texto 100 Nome do tipo de ambiente Sala de Aula Tradicional
teorica Booleano - Adequado para aulas teóricas (0/1) 1
pratica Booleano - Adequado para aulas práticas (0/1) 0
presencial Booleano - Adequado para aulas presenciais (0/1) 1
sincrona Booleano - Adequado para aulas síncronas (0/1) 1

📝 Exemplos de Tipos:

  • SALA - Salas de aula convencionais (teórica=1, prática=0)
  • LAB_INFO - Laboratório de Informática (teórica=0, prática=1)
  • AUDITORIO - Auditórios (teórica=1, prática=0)

Ambientes

essencial Excel (.xlsx) 8 campos

Cadastro detalhado dos ambientes físicos para alocação de turmas.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_ambiente Texto 20 Código único do ambiente SALA01
nome_ambiente Texto 100 Nome descritivo do ambiente Sala 01 - Bloco A
codigo_ambiente_tipo Texto 20 Referência ao tipo de ambiente (FK) SALA
predio Texto 100 Nome do prédio Bloco A
andar Texto 20 Andar do ambiente
capacidade_maxima_alunos Número - Capacidade máxima (padrão: 70) 50
area Decimal - Área em metros quadrados 45.5
quantidade_computadores Número - Número de computadores 20

Grades Curriculares

fundamental Excel (.xlsx) 5 campos

Estrutura curricular detalhada com disciplinas por período e caráter.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
curriculo_codigo Texto 50 Referência ao currículo (FK) ADS001|CUR2025
disciplina_codigo Texto 20 Referência à disciplina (FK) PROG001
periodo_letivo Número - Período recomendado (1, 2, 3...) 3
carga_horaria_minima Decimal - Carga horária mínima específica 80
carater Lista - Caráter da disciplina no currículo Obrigatória

📝 Valores Válidos para carater:

  • Obrigatória - Disciplina obrigatória do currículo
  • Optativa - Disciplina optativa com escolha livre
  • Eletiva - Disciplina eletiva com restrições

Equivalências

avançado Excel (.xlsx) 3 campos

Mapeamento de disciplinas equivalentes para aproveitamento de estudos.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_disciplina_base Texto 20 Disciplina de referência (FK) PROG001
opcao Texto 20 Grupo de equivalência EQ001
codigo_disciplina Texto 20 Disciplina equivalente (FK) PROG_OLD

💡 Como Funciona:

Disciplinas com o mesmo opcao são consideradas equivalentes entre si. Use códigos únicos para cada grupo de equivalências (ex: EQ001, EQ002...).

Pré-requisitos

avançado Excel (.xlsx) 3 campos

Definição de dependências entre disciplinas para controle de matrícula.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_disciplina_base Texto 20 Disciplina que possui pré-requisitos PROG002
opcao Texto 20 Grupo de pré-requisitos REQ001
codigo_disciplina Texto 20 Disciplina pré-requisito (FK) PROG001

💡 Lógica de Pré-requisitos:

  • Disciplinas com mesmo opcao = requisitos alternativos (AND)
  • Grupos diferentes = requisitos obrigatórios (OR)
  • Exemplo: Para cursar PROG002, precisa de (PROG001 E MAT001) OU (LOG001)

👥 Pessoas e Contratos

Layouts para importação de dados de alunos, professores e vínculos contratuais.

⚠️ Importante - Contexto de Importação:

📊 Layouts Institucionais: Os layouts de Cursos, Currículos, Áreas de Conhecimento, Disciplinas, Tipos de Ambientes, Ambientes, Grades Curriculares, Equivalências e Pré-requisitos aplicam-se a toda a instituição - faça uma única importação por layout.

🎯 Layouts Contextuais: Os layouts de Matrículas, Contratos e Históricos são específicos para unidade e período. Para importar dados de 3 unidades diferentes, será necessário fazer 3 importações separadas para cada layout contextual.

Exemplo: Se você tem alunos em Campus SP (2025-1), Campus RJ (2025-1) e Campus MG (2024-2), precisará de 3 arquivos de matrículas distintos.

Matrículas (Alunos)

operacional Excel (.xlsx) 12 campos

Cadastro completo de alunos matriculados com dados pessoais e acadêmicos.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_aluno Texto 20 Código único do aluno 2024001
nome Texto 200 Nome completo do aluno João Silva Santos
sexo Lista - Gênero do aluno Masculino
cpf Texto 14 CPF (com ou sem formatação) 123.456.789-00
email Email 200 Endereço de email joao@email.com
telefone Texto 20 Telefone de contato (11) 99999-9999
curriculo_codigo Texto 50 Referência ao currículo (FK) ADS001|CUR2025
quantidade_aulas_semanais Número - Carga semanal (padrão: 20) 20
aula_manha Booleano - Estuda de manhã (0/1) 1
aula_tarde Booleano - Estuda de tarde (0/1) 0
aula_noite Booleano - Estuda de noite (0/1) 1

📝 Valores Válidos para sexo:

  • Masculino
  • Feminino

🕐 Turnos de Estudo:

Use 1 para indicar que o aluno estuda no turno, 0 para não. Um aluno pode estudar em múltiplos turnos.

📄 Formato do curriculo_codigo:

Use o formato: CODIGO_CURSO|ANO|VERSAO
Exemplo: CC|2024|01 para Ciência da Computação, turma 2024, versão 01

Titulações de Professores

complementar Excel (.xlsx) 5 campos

Registro das titulações acadêmicas dos professores.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_academico Texto 20 Código do professor (FK) PROF001
titulacao Lista - Tipo de titulação Mestrado
area_conhecimento Texto 200 Área da titulação Ciência da Computação
instituicao Texto 200 Instituição onde obteve o título USP
ano_conclusao Número - Ano de conclusão 2020

📝 Valores Válidos para titulacao:

  • Graduação
  • Especialização
  • Mestrado
  • Doutorado
  • Pós-Doutorado

Contratos (Professores)

operacional Excel (.xlsx) 10 campos

Cadastro de professores com dados pessoais e disponibilidade de horários.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_academico Texto 20 Código único do professor PROF001
nome Texto 200 Nome completo do professor Maria Oliveira Silva
sexo Lista - Gênero do professor Feminino
cpf Texto 14 CPF (com ou sem formatação) 987.654.321-00
email Email 200 Endereço de email maria@instituicao.edu
telefone Texto 20 Telefone de contato (11) 88888-8888
quantidade_aulas_semanais Número - Carga semanal (padrão: 40) 40
aula_manha Booleano - Disponível de manhã (0/1) 1
aula_tarde Booleano - Disponível de tarde (0/1) 1
aula_noite Booleano - Disponível de noite (0/1) 0

Disciplinas Habilitadas por Professores

operacional Excel (.xlsx) 2 campos

Vinculação entre professores e as disciplinas que estão habilitados a lecionar.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_academico Texto 20 Código do professor (FK) PROF001
codigo_disciplina Texto 20 Código da disciplina (FK) ALG001

💡 Como Funciona:

Cada linha representa uma habilitação. Um professor pode estar habilitado para múltiplas disciplinas, e uma disciplina pode ter múltiplos professores habilitados.

📝 Exemplo de Importação:

  • PROF001 | ALG001 - Prof. João habilitado para Algoritmos I
  • PROF001 | ALG002 - Prof. João habilitado para Algoritmos II
  • PROF002 | ALG001 - Prof. Maria também habilitada para Algoritmos I

Históricos Acadêmicos

complementar Excel (.xlsx) 5 campos

Registro do histórico acadêmico dos alunos com disciplinas cursadas.

Nome da Coluna Obrigatório Tipo Tamanho Descrição Exemplo
codigo_academico Texto 20 Código do aluno (FK) 2025001
codigo_disciplina Texto 20 Código da disciplina (FK) MAT001
cursando Booleano - Está cursando atualmente (0/1) 0
liberada Booleano - Disciplina aprovada (0/1) 1
periodo Texto 10 Período em que cursou 2024-2

📊 Status das Disciplinas:

  • cursando = 1, liberada = 0 - Cursando atualmente
  • cursando = 0, liberada = 1 - Aprovado anteriormente
  • cursando = 0, liberada = 0 - Reprovado (não importar)

🚀 Guia de Implementação

1. Ordem de Importação

Para evitar erros de relacionamento, siga esta sequência:

🏛️ ETAPA 1 - Dados Base (Independentes):

  1. Áreas de Conhecimento - Classificação temática
  2. Cursos - Oferta acadêmica
  3. Alunos & Matrículas - Dados dos alunos
  4. Professores & Contratos - Dados dos docentes
  5. Tipos de Ambientes - Categorias de espaços

📚 ETAPA 2 - Dependências Nível 1:

  1. Disciplinas - Componentes curriculares (requer Áreas)
  2. Ambientes - Espaços físicos (requer Tipos de Ambientes)

⚡ ETAPA 3 - Dependências Nível 2:

  1. Equivalências - Disciplinas equivalentes (requer Disciplinas)
  2. Pré-requisitos - Dependências entre disciplinas
  3. Currículos - Matrizes curriculares (requer Disciplinas e Cursos)
  4. Cargas Horárias - Distribuição de horas (requer Disciplinas e Tipos de Ambientes)

📝 ETAPA 4 - Dependências Nível 3:

  1. Grades Curriculares - Estrutura por período (requer Currículos)
  2. Históricos Escolares - Registros acadêmicos (requer Alunos)
  3. Titulações de Professores - Formação acadêmica (requer Professores)
  4. Disciplinas Habilitadas - Habilitações docentes (requer Professores e Disciplinas)

🎯 Layouts Contextuais (por unidade e período):

  1. Matrículas - Dados dos alunos
  2. Contratos - Dados dos professores
  3. Históricos - Registros acadêmicos

2. Preparação dos Arquivos

📁 Formato de Arquivo

  • Use sempre .xlsx (Excel)
  • Evite .xls ou .csv
  • Uma planilha por arquivo
  • Headers na primeira linha

🔤 Codificação de Texto

  • UTF-8 para acentos
  • Evite caracteres especiais
  • Códigos sem espaços em branco
  • Preserve zeros à esquerda

🔢 Formatação Numérica

  • Use vírgula para decimais
  • Evite pontos como separador
  • Booleanos: 0 ou 1
  • Datas: DD/MM/AAAA

3. Validações Automáticas

O sistema realizará as seguintes verificações:

Campos Obrigatórios

Verifica se todos os campos marcados como obrigatórios estão preenchidos

🔗
Integridade Referencial

Confirma que códigos FK existem nas tabelas relacionadas

📏
Tamanhos e Formatos

Valida comprimento de campos e formatos específicos (email, CPF, etc.)

🎯
Valores Válidos

Verifica se os valores estão dentro das listas permitidas

4. Tratamento de Erros

🔴 Erros Críticos

Impedem a importação completa:

  • Campos obrigatórios vazios
  • Códigos FK inexistentes
  • Formatos inválidos (datas, decimais)
  • Valores fora das listas permitidas

🟡 Avisos

Permitem importação com correções:

  • Campos opcionais vazios
  • Códigos duplicados (sobrescrita)
  • Caracteres especiais removidos
  • Cores geradas automaticamente

Precisa de Ajuda com a Importação?

Nossa equipe técnica está pronta para auxiliar na preparação e importação dos seus dados acadêmicos.