Formato de arquivo CSV SDS V1

Você pode usar arquivos CSV (valor separado por vírgula) no formato SDS V1 para sincronizar seu Sistema de Informações Escolares (SIS) com o Office 365. Usar o formato de arquivo CSV SDS V1 para ingerir as categorias de dados 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 deverão ser formatados adequadamente. Carregue os arquivos, nomeados exatamente como detalhado neste artigo. Os cabeçalhos de coluna diferenciam maiúsculas de minúsculas. Os arquivos CSV devem estar no formato UTF-8 e em conformidade com RFC. Também não aceitamos quebras de linha em dados de entrada. Para examinar e baixar o conjunto de exemplo de arquivos CSV do SDS V1, consulte o Repositório GitHub do SDS.

Obrigatório: os três arquivos a seguir devem ser selecionados antes que você possa avançar. Se você estiver gerenciando apenas usuários e não classes, só precisará fornecer esses arquivos.

• school.csv

• student.csv

• teacher.csv

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

• section.csv

• studentenrollment.csv

• teacherroster.csv

Opcional: os arquivos a seguir não são necessários para continuar, mas podem aprimorar as experiências. Se um dos arquivos a seguir for selecionado, o outro também deverá ser selecionado para continuar.

• user.csv

• guardianrelationship.csv (Requer o registro de usuário e aluno para criar a associação de contato.)

Cada arquivo CSV deve conter dados para os campos marcados como "Sim" em "Obrigatório", e os campos marcados como "Não" são dados "Opcionais". Os cabeçalhos de campo marcados como 'Obrigatório' devem existir nos arquivos fornecidos ou não serão aceitos. Os cabeçalhos de campo marcados como "Opcionais" não precisam estar presentes nos arquivos se não estiverem passando os dados opcionais correspondentes.

Os campos com valores enumerados definidos, conforme marcado na coluna 'Tipos de dados', têm um conjunto específico de valores com suporte. O conjunto de valores padrão com suporte para campos Enum consulte Lista de valores padrão.

school.csv

• Todas as organizações listadas serão definidas para o tipo de organização 'escola'.

student.csv

• Requer uma referência à escola associada usando o campo 'School SIS ID' e produz uma dependência no arquivo school.csv.
• Todos os usuários listados serão definidos para o tipo de função 'aluno'.
• Espere que os valores de data sejam fornecidos em ISO8601 formato.
• Os zeros à esquerda '0' ausentes no valor de entrada para o ENUM de Nível de Série, por exemplo '1', corresponderão à Lista de Valor definida (ENUM) '01' e serão armazenados como '01'.

teacher.csv

• Requer uma referência à escola associada usando o campo 'School SIS ID', produzindo uma dependência no arquivo school.csv.
• Todos os usuários listados serão definidos para o tipo de função 'professor'.
• Zeros à esquerda '0' ausentes no valor de entrada para ENUM de Nível de Série. Por exemplo, "1" corresponderá à Lista de Valor definida (ENUM) "01" e será armazenado como "01".

section.csv

• Requer uma referência à escola associada usando o campo 'School SIS ID', produzindo uma dependência no arquivo school.csv.
• Se forem necessárias informações sobre o termo, recomendamos mudar para o formato CSV da SDS v2.1 e também fornecer academicSessions.csv arquivo.

studentenrollment.csv

• Isso requer uma referência à seção associada usando o campo 'ID do SIS da Seção' e produz uma dependência no arquivo section.csv.
• Isso requer uma referência ao usuário associado usando o campo 'SIS ID' e produz uma dependência no arquivo student.csv.

teacherroster.csv

• Isso requer uma referência à seção associada usando o campo 'ID do SIS da Seção' e produz uma dependência no arquivo section.csv.
• Isso requer uma referência ao usuário associado usando o campo 'SIS ID' e produz uma dependência no arquivo teacher.csv.

user.csv

• 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, onde o caractere de adição é usado e sucedido pelo número de telefone ou o caractere de adição seguido pelo código do país, código de área, prefixo de telefone e número de linha.

guardianrelationship.csv

• 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' e produz uma dependência no arquivo user.csv.
• Isso requer uma referência ao usuário associado usando o campo 'SIS ID' e produz uma dependência no arquivo student.csv.
• Se o valor Role não for fornecido, o valor da relação será padrão para 'userContact'.