Formato de arquivo CSV do SDS V1

  • Artigo

Importante

CLIENTES DE TRANSIÇÃO SDS (Clássicos): nem todos os campos têm suporte para trazer dados para a nova experiência do SDS com base no formato v1. Você os encontrará anotados no Formato de Arquivo CSV do SDS v1 em coluna Obrigatório? como dados não compatíveis.

Importante

Além disso, valores de grau e valores de Disciplina de Curso passados devem se alinhar aos códigos ENUM (Lista de Valores) correspondentes. Se necessário, utilize a Lista de Valores de Gerenciamento para expandir valores de grau e Sujeito de Curso para dar suporte a valores de código não compatíveis por padrão.

Você pode usar arquivos CSV (valor separado por vírgula) no formato SDS V1 para sincronizar seu SIS (Sistema de Informações Escolares) com Office 365. Usar o formato de arquivo CSV do SDS V1 para ingerir as categorias de dados abaixo permite que você ilumine os principais recursos do SDS para provisionamento. Ele também ajuda você a aprimorar experiências para os produtos e recursos do Microsoft 365.

Se você estiver usando o formato SDS V1, os arquivos devem ser formatados adequadamente. Carregue os arquivos, nomeados exatamente como detalhados abaixo. Os cabeçalhos de coluna são sensíveis a maiúsculas de minúsculas. Os arquivos CSV devem estar em formato UTF-8 e em conformidade com RFC. Além disso, não aceitamos quebras de linha nos dados de entrada. Para examinar e baixar o conjunto de exemplos de arquivos CSV do SDS V1, consulte o Repositório github do SDS.

Importante

Após o upload inicial durante a criação do fluxo de entrada, você precisará sempre fornecer o mesmo conjunto de arquivos para uploads subsequentes, independentemente das alterações de dados feitas nos arquivos opcionais ou não. Se você não fizer isso, o sistema determinará que os registros não estão mais ativos e os marcarão como tal.

Necessário: os três arquivos listados abaixo devem ser selecionados antes que você possa progredir. Se você estiver apenas gerenciando usuários e não classes, você só precisará fornecer esses arquivos.

  • school.csv

  • student.csv

  • teacher.csv

Opcional/Obrigatório: não é necessário se você estiver apenas gerenciando usuários. Se você também estiver gerenciando classes e registros de classe, precisará fornecer os três arquivos listados abaixo, juntamente com os três arquivos acima. Se você não estiver, não selecione nenhum arquivo com esses nomes.

  • section.csv

  • studentenrollment.csv

  • teacherroster.csv

Opcional: eles não são necessários para prosseguir, mas podem aprimorar experiências. Se um dos arquivos abaixo for selecionado, o outro também deverá ser selecionado para prosseguir.

  • user.csv

  • guardianrelationship.csv (requer registro de usuário e aluno para criar associação de contatos.)

Cada arquivo CSV deve conter dados para os campos anotados como 'Sim' em 'Obrigatório', os campos observados 'Não' são dados 'Opcional'. Os cabeçalhos de campo marcados como 'Obrigatórios' devem existir nos arquivos fornecidos ou não serão aceitos. Os cabeçalhos de campo marcados como "Opcional" não devem estar presentes nos arquivos se não passarem 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 compatíveis. O conjunto com suporte de valores padrão para campos Enum vê Lista padrão de valores.

school.csv

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

student.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 123456 ID exclusiva
ID do SIS da escola Sim 456789 ID exclusiva
Nome de usuário Sim jsmith@contoso.edu Cadeia de caracteres
Nome Sim (somente se criar usuários) Davi Cadeia de caracteres
Sobrenome Sim (somente se criar usuários) Smith Cadeia de caracteres
Nome do meio Não William 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 não há suporte para dados
Senha não há suporte para dados
Ano de Formatura não há suporte para dados
ID do Estado não há suporte para dados
  • Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
  • Todos os usuários listados serão definidos como o tipo de função 'student'.
  • Espere que os valores de data sejam fornecidos no formato ISO8601.

teacher.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 654321 ID exclusiva
ID do SIS da escola Sim 456789 ID exclusiva
Nome de usuário Sim jcook@contoso.edu Cadeia de caracteres
Nome Sim (somente se criar usuários) Jane Cadeia de caracteres
Sobrenome Sim (somente se criar usuários) 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 não há suporte para dados
Senha não há suporte para dados
Título não há suporte para dados
ID do Estado não há suporte para dados
Qualificação não há suporte para dados
  • Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
  • Todos os usuários listados serão definidos como o tipo de função "professor".

section.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 334455 ID exclusiva
ID do SIS da escola Sim 456789 ID exclusiva
Nome da seçã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 exclusiva
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 não há suporte para dados
Nome do termo não há suporte para dados
StartDate do termo não há suporte para dados
EndDate do termo não há suporte para dados
Status não há suporte para dados
Periods não há suporte para dados
  • Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
  • Se as informações de termo forem necessárias, é recomendável migrar para o formato CSV do SDS v2.1 e também fornecer academicSessions.csv arquivo.

studentenrollment.csv

Campo Obrigatório? Exemplo Tipo de dados
ID do SIS da seção Sim 334455 ID exclusiva
SIS ID Sim 123456 ID exclusiva
  • Isso requer uma referência à seção associada usando o campo "ID do SIS da Seção". Isso produz uma dependência do arquivo section.csv.
  • Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo student.csv.

teacherroster.csv

Campo Obrigatório? Exemplo Tipo de dados
ID do SIS da seção Sim 334455 ID exclusiva
SIS ID Sim 654321 ID exclusiva
  • Isso requer uma referência à seção associada usando o campo "ID do SIS da Seção". Isso produz uma dependência do arquivo section.csv.
  • Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo 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 exclusiva
  • Se você também estiver sincronizando Relações de Contato (guardiões), deverá incluir um registro para eles no user.csv.
  • Espere que o campo de telefone seja formatado com base no padrão E.164 em que o caractere plus é usado e bem-sucedido pelo número de telefone, ou melhor, o caractere de adição seguido pelo código do país, código de área, prefixo telefônico e número de linha.

guardianrelationship.csv

Campo Obrigatório? Exemplo Tipo de dados
SIS ID Sim 123456 ID exclusiva
Email Sim jsmith@outlook.com Email
Função Não Pai Enum
  • Se você também estiver sincronizando Relações de Contato (guardiões), deverá incluir um registro para eles no user.csv.
  • Isso requer uma referência ao usuário associado usando o campo 'Email'. Isso produz uma dependência do arquivo user.csv.
  • Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo student.csv.
  • Se o valor de função não for fornecido, o valor da relação será padrão para 'userContact'.