Compartilhar via

Formato de ficheiro CSV SDS V1

Importante

CLIENTES DE TRANSIÇÃO Clássica do School Data Sync (SDS): nem todos os campos são suportados para trazer dados para a nova experiência do SDS com base no formato v1. Pode encontrá-los indicados no Formato de Ficheiro CSV SDS v1 na coluna Obrigatório? como dados não suportados.

Importante

Além disso, os valores de Classificação e os valores do Requerente do Curso transmitidos têm de estar alinhados com os códigos de Lista de Valores (ENUM) correspondentes. Se necessário, utilize Gerir Lista de Valores para expandir valores de Nota e Assunto do Curso para suportar valores de código não suportados por predefinição.

Pode utilizar ficheiros CSV (valores separados por vírgulas) no formato SDS V1 para sincronizar o seu Sistema de Informação Escolar (SIS) com Office 365. Utilizar o formato de ficheiro CSV SDS V1 para ingerir as categorias de dados permite-lhe iluminar as principais capacidades de SDS para aprovisionamento. Também o ajuda a melhorar as experiências dos produtos e funcionalidades do Microsoft 365.

Se estiver a utilizar o formato SDS V1, os ficheiros têm de estar devidamente formatados. Carregue os ficheiros com o nome exatamente conforme detalhado neste artigo. Os cabeçalhos de coluna são sensíveis às maiúsculas e minúsculas. Os ficheiros CSV têm de estar no formato UTF-8 e em conformidade com RFC. Além disso, não aceitamos quebras de linha nos dados recebidos. Para rever e transferir o conjunto de exemplos de ficheiros CSV do SDS V1, veja o Repositório do GitHub do SDS.

Importante

Após o carregamento inicial durante a criação do fluxo de entrada, terá de fornecer sempre o mesmo conjunto de ficheiros para carregamentos subsequentes, independentemente das alterações de dados efetuadas nos ficheiros opcionais. Se não o fizer, o sistema determina que os registos já não estão ativos e marca-os como tal.

Obrigatório: os três ficheiros seguintes têm de ser selecionados antes de poder progredir. Se estiver apenas a gerir utilizadores e não classes, só precisa de fornecer estes ficheiros.

  • school.csv

  • student.csv

  • teacher.csv

Opcional/Obrigatório: não é necessário se estiver apenas a gerir utilizadores. Se também estiver a gerir turmas e inscrições nas aulas, terá de fornecer os três ficheiros seguintes, juntamente com os três ficheiros mencionados anteriormente. Se não estiver, não selecione quaisquer ficheiros com estes nomes.

  • section.csv

  • studentenrollment.csv

  • teacherroster.csv

Opcional: os seguintes ficheiros não são necessários para continuar, mas podem melhorar as experiências. Se um dos seguintes ficheiros estiver selecionado, o outro também tem de estar selecionado para continuar.

  • user.csv

  • guardianrelationship.csv (Requer que o registo de utilizadores e estudantes crie uma associação de contactos.)

Cada ficheiro CSV tem de conter dados para os campos indicados "Sim" em "Obrigatório", os campos indicados "Não" são dados "Opcionais". Os cabeçalhos de campo marcados como "Obrigatório" têm de existir nos ficheiros fornecidos ou não serão aceites. Os cabeçalhos de campo marcados como "Opcional" não têm de estar presentes nos ficheiros se não forem transmitidos os dados opcionais correspondentes.

Os campos com valores enumerados definidos como marcados na coluna "Tipos de Dados" têm um conjunto específico de valores que suportam. O conjunto suportado de valores predefinidos para campos Enumeração , veja Lista Predefinida de Valores.

school.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 456789 ID Exclusivo
Nome Sim Escola Secundária da Contoso Cadeia de caracteres
ID do NCES da escola Não 456789 Cadeia de caracteres
Número da Escola dados não suportados
Nota Baixa dados não suportados
Nota Alta dados não suportados
ID do Estado dados não suportados
ID do SIS do Diretor dados não suportados
Nome do Diretor dados não suportados
Email Secundário do Diretor dados não suportados
Endereço dados não suportados
Cidade dados não suportados
Estado dados não suportados
CEP dados não suportados
País/Região dados não suportados
Telefone dados não suportados
Zona dados não suportados
  • Todas as organizações listadas serão definidas para o tipo de organização "escola".

student.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 123456 ID Exclusivo
ID do SIS da Escola Sim 456789 ID Exclusivo
Nome de usuário Sim jsmith@contoso.edu Cadeia de caracteres
Nome Sim (apenas se criar utilizadores) Davi Cadeia de caracteres
Sobrenome Sim (apenas se criar utilizadores) Smith Cadeia de caracteres
Nome do meio Não Guilherme Cadeia de caracteres
Email Secundário Não jsmith@contoso.edu Email
Número do Aluno Não 123456 Cadeia de caracteres
Nota Não 8 Enum
Data de Nascimento Não 2009-12-19 Data
Status dados não suportados
Senha dados não suportados
Ano de Formatura dados não suportados
ID do Estado dados não suportados
  • Requer uma referência à escola associada através do campo "School SIS ID" e produz uma dependência no ficheiro school.csv.
  • Todos os utilizadores listados serão definidos para o tipo de função "estudante".
  • Espere que os valores de data sejam fornecidos no formato ISO8601.
  • Zeros à esquerda "0" em falta no valor de entrada para Enumeração de Nível de Grau, por exemplo "1", corresponderão à Lista de Valores definida (ENUM) "01" e serão armazenados como "01".

teacher.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 654321 ID Exclusivo
ID do SIS da Escola Sim 456789 ID Exclusivo
Nome de usuário Sim jcook@contoso.edu Cadeia de caracteres
Nome Sim (apenas se criar utilizadores) Joana Cadeia de caracteres
Sobrenome Sim (apenas se criar utilizadores) Cozinhar Cadeia de caracteres
Nome do meio Não Meredith Cadeia de caracteres
Número do professor Não 654321 Cadeia de caracteres
Nota Não 8 Enum
Email Secundário Não jcook@contoso.edu Email
Status dados não suportados
Senha dados não suportados
Título dados não suportados
ID do Estado dados não suportados
Qualificação dados não suportados
  • Requer uma referência à escola associada através do campo "School SIS ID", que produz uma dependência no ficheiro school.csv.
  • Todos os utilizadores listados serão definidos para o tipo de função "professor".
  • Zeros à esquerda "0" em falta no valor de entrada para ENUM de Nível de Nota. Por exemplo, "1" corresponderá à Lista de Valores definida (ENUMERAÇÃO) "01" e será armazenada como "01".

section.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 334455 ID Exclusivo
ID do SIS da Escola Sim 456789 ID Exclusivo
Nome da Secção Sim Período 1 - História mundial Cadeia de caracteres
Número da seção Não 334466 Cadeia de caracteres
ID do SIS do Curso Não 123456789 ID Exclusivo
Nome do curso Não História Mundial 10 Cadeia de caracteres
Número do curso Não 123456789 Cadeia de caracteres
Descrição do curso Não História do Mundo Cadeia de caracteres
Assunto do curso Não 54999 Enum
ID do SIS do Termo dados não suportados
Nome do termo dados não suportados
StartDate do termo dados não suportados
EndDate do termo dados não suportados
Status dados não suportados
Periods dados não suportados
  • Requer uma referência à escola associada através do campo "School SIS ID", que produz uma dependência no ficheiro school.csv.
  • Se forem necessárias informações de Termos, recomendamos que aceda ao formato CSV SDS v2.1 e que forneça também academicSessions.csv ficheiro.

studentenrollment.csv

Campo Obrigatório? Exemplo Tipo de dados
ID do SIS da Secção Sim 334455 ID Exclusivo
SIS ID Sim 123456 ID Exclusivo
  • Isto requer uma referência à secção associada com o campo "ID do SIS da Secção" e produz uma dependência no ficheiro section.csv.
  • Isto requer uma referência ao utilizador associado através do campo "ID do SIS" e produz uma dependência no ficheiro student.csv.

teacherroster.csv

Campo Obrigatório? Exemplo Tipo de dados
ID do SIS da Secção Sim 334455 ID Exclusivo
SIS ID Sim 654321 ID Exclusivo
  • Isto requer uma referência à secção associada com o campo "ID do SIS da Secção" e produz uma dependência no ficheiro section.csv.
  • Isto requer uma referência ao utilizador associado através do campo "ID do SIS" e produz uma dependência no ficheiro teacher.csv.

user.csv

Campo Obrigatório? Exemplo Tipo de dados
Email Sim jsmith@outlook.com Email
Nome Sim Davi Cadeia de caracteres
Sobrenome Sim Smith Cadeia de caracteres
Telefone Não +1234567890 Telefone
SIS ID Não P_123456 ID Exclusivo
  • Se também estiver a sincronizar Relações de Contacto (tutores), tem de incluir um registo para os mesmos no user.csv.
  • Espere que o campo de telefone seja formatado com base na norma E.164 em que o caráter de adição é utilizado e executado com êxito pelo número de telefone ou pelo caráter de adição seguido de código de país, código de área, prefixo de telefone e número de linha.

guardianrelationship.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 123456 ID Exclusivo
Email Sim jsmith@outlook.com Email
Função Não Pai Enum
  • Se também estiver a sincronizar Relações de Contacto (tutores), tem de incluir um registo para os mesmos no user.csv.
  • Isto requer uma referência ao utilizador associado através do campo "Email" e produz uma dependência no ficheiro user.csv.
  • Isto requer uma referência ao utilizador associado através do campo "ID do SIS" e produz uma dependência no ficheiro student.csv.
  • Se o Valor da função não for fornecido, o valor da relação é predefinido como "userContact".
  • Last updated on