Formato de arquivo CSV do SDS V1

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.

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

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

student.csv

• 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

• 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

• 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

• 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

• 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

• 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

• 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'.