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

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

Если вы используете формат SDS версии 1, файлы должны быть отформатированы соответствующим образом. Отправьте файлы с именами точно так, как описано в этой статье. В заголовках столбцов учитывается регистр. CSV-файлы должны быть в формате UTF-8 и соответствовать RFC. Кроме того, мы не принимаем разрывы строк во входящих данных. Чтобы просмотреть и скачать пример набора CSV-файлов SDS версии 1, ознакомьтесь с репозиторием SDS GitHub.

Обязательный. Перед выполнением необходимо выбрать следующие три файла. Если вы управляете только пользователями, а не классами, необходимо только предоставить эти файлы.

• school.csv

• student.csv

• teacher.csv

Необязательный или обязательный: не требуется, если вы управляете только пользователями. Если вы также управляете классами и регистрациями классов, необходимо предоставить следующие три файла, а также три ранее упомянутых файла. Если это не так, не выбирайте файлы с такими именами.

• section.csv

• studentenrollment.csv

• teacherroster.csv

Необязательный. Следующие файлы не требуются для продолжения работы, но могут улучшить взаимодействие. Если выбран один из следующих файлов, для продолжения также необходимо выбрать другой.

• user.csv

• guardianrelationship.csv (требуется запись пользователя и учащегося для создания связи контактов.)

Каждый CSV-файл должен содержать данные для полей, отмеченных как "Да" в разделе "Обязательный", а поля , отмеченные как "Нет", являются необязательными. Заголовки полей, помеченные как "Обязательные", должны существовать в предоставленных файлах, иначе они не будут приняты. Заголовки полей, помеченные как "Необязательный", не обязательно должны присутствовать в файлах, если не передаются соответствующие необязательные данные.

Поля с определенными перечисляемыми значениями, отмеченными в столбце "Типы данных", имеют определенный набор значений, которые они поддерживают. Поддерживаемый набор значений по умолчанию для полей перечисления см. в разделе Список значений по умолчанию.

school.csv

• Для всех перечисленных организаций будет задан тип организации school.

student.csv

• Требуется ссылка на связанное учебное заведение, использующий поле "School SIS ID" и создает зависимость от файла school.csv.
• Для всех перечисленных пользователей будет задан тип роли "student".
• Ожидается, что значения даты будут предоставлены в ISO8601 формате.
• Начальные нули "0", отсутствующие во входящем значении для ENUM уровня оценок, например "1", будут соответствовать определенному списку значений (ENUM) "01" и храниться как "01".

teacher.csv

• Требуется ссылка на связанное учебное заведение, использующая поле "School SIS ID", что создает зависимость от файла school.csv.
• Для всех перечисленных пользователей будет задан тип роли "преподаватель".
• Начальные нули "0" отсутствуют во входящем значении для ENUM уровня оценок. Например, "1" будет соответствовать определенному списку значений (ENUM) "01" и храниться как "01".

section.csv

• Требуется ссылка на связанное учебное заведение, использующая поле "School SIS ID", что создает зависимость от файла school.csv.
• Если требуются сведения о термине, рекомендуется перейти на формат CSV SDS версии 2.1 , а также предоставить academicSessions.csv файл.

studentenrollment.csv

• Для этого требуется ссылка на связанный раздел, использующий поле "Идентификатор SIS section", и создается зависимость от файла section.csv.
• Для этого требуется ссылка на связанного пользователя, использующий поле "Идентификатор SIS", и создается зависимость от student.csv файла.

teacherroster.csv

• Для этого требуется ссылка на связанный раздел, использующий поле "Идентификатор SIS section", и создается зависимость от файла section.csv.
• Для этого требуется ссылка на связанного пользователя, использующий поле "Идентификатор SIS", и создается зависимость от teacher.csv файла.

user.csv

• Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
• Ожидается, что поле телефона будет отформатировано на основе стандарта E.164, где символ "плюс" используется и заменен номером телефона, либо символ "плюс", за которым следует код страны, код региона, префикс телефона и номер строки.

guardianrelationship.csv

• Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
• Для этого требуется ссылка на связанного пользователя, использующий поле "Email", и создается зависимость от файла user.csv.
• Для этого требуется ссылка на связанного пользователя, использующий поле "Идентификатор SIS", и создается зависимость от student.csv файла.
• Если значение роли не указано, значение связи по умолчанию равно "userContact".