Поделиться через

Формат CSV-файла SDS версии 2

  • Статья

Основные возможности SDS и функции Microsoft 365 по методу приема

Для синхронизации учебной информационной системы (SIS) с Office 365 можно использовать CSV-файлы (значения, разделенные запятыми) в формате SDS версии 2. Использование формата CSV-файла SDS версии 2 для приема указанных ниже категорий данных позволяет осветить основные возможности SDS для подготовки. Это также позволяет улучшить возможности продуктов и функций Microsoft 365 (Microsoft 365), перечисленных ниже. Формат CSV-файла SDS версии 2 будет продолжать расширять поддерживаемые категории данных.

Примечание.

Текущие клиенты формата CSV версии 2 могут продолжать использовать до мая 2022 г. Мы рекомендуем использовать формат CSV версии 2.1 с его дополнительными возможностями.

csv-file-v2.png.

При использовании формата SDS версии 2 файлы должны быть отформатированы соответствующим образом. В этой статье описываются требования к форматированию и поддерживаемые атрибуты для использования с SDS. Необходимо отправить все четыре файла с именами точно так, как описано ниже. В заголовках файлов и столбцов учитывается регистр. Чтобы просмотреть и скачать пример набора CSV-файлов SDS версии 2, ознакомьтесь с репозиторием SDS GitHub.

csv-file-v2-1.png.

Каждый CSV-файл должен содержать все обязательные поля, выделенные зеленым цветом ниже. Поля, которые не выделены, являются необязательными. Хотя содержимое некоторых атрибутов может быть необязательным, заголовки столбцов являются обязательными. Кроме того, атрибуты с определенными значениями перечисления, помеченными в столбце Типы, имеют определенный набор значений, которые они поддерживают. Сведения о поддержке перечисляемых значений для каждого атрибута перечисления см. в следующем разделе.

csv-file-v2-2.png.

csv-file-v2-3.png.

csv-file-v2-4.png.

csv-file-v2-5.png.

Поддерживаемые перечислимые значения (перечисление)

В новом формате SDS версии 2 есть несколько атрибутов, определенных как перечислимые значения, что означает, что в CSV-файлах можно предоставить только выбранный набор значений. Все, кроме указанных значений, приведет к ошибке во время обработки синхронизации. В приведенном ниже разделе определяются значения перечисления, поддерживаемые в формате SDS версии 2.

users.csv содержит атрибут role, поддерживая приведенные ниже значения перечисления.

csv-file-v2-6.png.

users.csv содержит атрибут grade и поддерживает приведенные ниже значения перечисления.

csv-file-v2-7.png.

orgs.csv содержит атрибут type и поддерживает приведенные ниже значения перечисления.

csv-file-v2-8.png.

enrollments.csv содержит атрибут role и поддерживает приведенные ниже значения перечисления.

csv-file-v2-9.png.