Compartilhar via

Formato de arquivo V1 do CSV para SDS

  • Artigo

Você pode usar arquivos CSV (valor separado por vírgula) no formato SDS 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 permite aprimorar experiências para os produtos e recursos do Microsoft 365 (Microsoft 365) listados abaixo.

gráfico de recursos principais para O SDS CSV V1.

Ao usar arquivos CSV de formato SDS para Sincronização de Dados Escolares, os arquivos devem ser formatados adequadamente. Esta seção descreve os requisitos de formatação para uso com o SDS. Os arquivos CSV devem estar no formato UTF-8. Os únicos campos absolutamente necessários são realçados em verde abaixo. Isso também se vincula às informações de exemplo em nossa página Exemplos de Arquivo CSV . Você deve ter os seguintes 6 arquivos CSV nomeados exatamente como detalhados abaixo. Para examinar e baixar o conjunto de exemplos de arquivos CSV no formato SDS, consulte o Repositório github do SDS.

student.csv

teacher.csv

school.csv

section.csv

studentenrollment.csv

teacherroster.csv

cada arquivo csv deve conter campos al necessários.

Cada arquivo CSV deve conter todos os campos necessários realçados em verde abaixo. Cada arquivo CSV também pode conter qualquer um dos campos opcionais listados também. Se os arquivos CSV contiverem caracteres sem suporte, eles poderão ser substituídos em linha durante a sincronização selecionando a opção "Substituir caracteres especiais sem suporte" no Assistente de Configuração de Perfil de Sincronização do SDS. No entanto, isso não removerá "espaços brancos", que também não são válidos. As tabelas abaixo listam os atributos necessários e opcionais em um arquivo por arquivo:

Observação

A Microsoft recomenda usar o formato ISO 8601 para todos os campos de datas nos arquivos CSV do SDS, na forma de YYYYY-MM-DD ou YYYYYMMDD. O SDS planeja introduzir recursos nos próximos meses, o que exigirá esse formato nos campos Data de Início e Término de Prazo observados abaixo.

  • >Students.csv Data de Nascimento
  • > StartDate do termo Sections.csv
  • > EndDate de termo Sections.csv

use o formato ISO 8601 para todos os campos de data.

sds está planejando introduzir recursos nos próximos meses.

use o enum correto.

! [se você não usar o enum correto, receberá enumerações separadas].] (imagens/School-Data-Sync-format-CSV-files-for-SDS-5.png)

processo de validação de insights.

Consulte sds para obter informações sobre integridade e monitoramento de dados.