Formato de arquivo CSV do SDS V2

Recursos principais do SDS e recursos do Microsoft 365 por método de ingestão

Você pode usar arquivos CSV (valor separado por vírgula) no formato SDS V2 para sincronizar seu SIS (Sistema de Informações Escolares) com Office 365. Usar o formato de arquivo CSV do SDS V2 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. O formato de arquivo CSV do SDS V2 continuará a expandir quais categorias de dados ele dá suporte.

Observação

Os clientes atuais do formato CSV V2 podem continuar a usar até maio de 2022. Recomendamos usar o formato CSV V2.1 com seus recursos adicionais.

Ao usar o formato SDS V2, os arquivos devem ser formatados adequadamente. Este artigo descreve os requisitos de formatação e os atributos com suporte para uso com SDS. Você deve carregar todos os quatro arquivos, nomeados exatamente como detalhados abaixo. Os arquivos e cabeçalhos de coluna são sensíveis a maiúsculas de minúsculas. Para examinar e baixar o conjunto de exemplos de arquivos CSV do SDS V2, consulte o Repositório github do SDS.

Cada arquivo CSV deve conter todos os campos necessários realçados em verde abaixo. Os campos não realçados são opcionais. Embora o conteúdo de determinados atributos possa ser opcional, os cabeçalhos de coluna são necessários. Além disso, os atributos com valores Enum definidos, conforme marcado na coluna Tipos, têm um conjunto específico de valores compatíveis. Consulte o conjunto de suporte de valores enumerados para cada atributo de enumeração na próxima seção.

Valores enumerados (Enum) com suporte

No novo formato SDS V2, há vários atributos definidos como valores Enumerados, o que significa que você só pode fornecer um conjunto selecionado de valores nos arquivos CSV. Qualquer coisa diferente dos valores especificados resultará em um erro durante o processamento de sincronização. A seção a seguir define os valores de enumeração com suporte no Formato SDS V2.

O users.csv contém o atributo "role" que dá suporte aos valores de enumeração abaixo.

O users.csv contém o atributo "grade" e dá suporte aos valores de enumeração abaixo.

O orgs.csv contém o atributo "tipo" e dá suporte aos valores de enumeração abaixo.

O enrollments.csv contém o atributo "função" e dá suporte aos valores de enumeração abaixo.