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


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

Важно!

SDS (классическая) TRANSITION CUSTOMERS: не все поля поддерживаются для переноса данных в новый интерфейс SDS на основе формата v1. Вы найдете их в формате CSV sds версии 1 в столбце Обязательный? как данные не поддерживаются.

Важно!

Кроме того, значения оценок и переданных значений темы курса должны соответствовать соответствующим кодам списка значений (ENUM). При необходимости используйте управление списком значений , чтобы развернуть значения оценок и субъект курса для поддержки значений кода, не поддерживаемых по умолчанию.

Для синхронизации учебной информационной системы (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

Поле Обязательный? Пример Тип данных
Идентификатор SIS Да 456789 Уникальный идентификатор
Имя Да Средняя школа Contoso String
School NCES_ID Нет 456789 String
School Number данные не поддерживаются
Grade Low данные не поддерживаются
Grade High данные не поддерживаются
State ID данные не поддерживаются
Principal SIS ID данные не поддерживаются
Имя участника данные не поддерживаются
Principal Secondary Email данные не поддерживаются
Address данные не поддерживаются
Город данные не поддерживаются
State данные не поддерживаются
ZIP данные не поддерживаются
Страна данные не поддерживаются
Phone данные не поддерживаются
Зона данные не поддерживаются
  • Для всех перечисленных организаций будет задан тип организации school.

student.csv

Поле Обязательный? Пример Тип данных
Идентификатор SIS Да 123456 Уникальный идентификатор
Идентификатор SIS школы Да 456789 Уникальный идентификатор
Username Да jsmith@contoso.edu String
Имя Да (только при создании пользователей) Иван String
Фамилия Да (только при создании пользователей) Иванов String
Отчество Нет Уильям String
Secondary Email Нет jsmith@contoso.edu Email
Student Number Нет 123456 String
Grade Нет 8 Перечисление
Birthdate Нет 2009-12-19 Date
Состояние данные не поддерживаются
Пароль данные не поддерживаются
Graduation Year данные не поддерживаются
State ID данные не поддерживаются
  • Требуется ссылка на связанное учебное заведение с использованием поля "Идентификатор SIS учебного заведения". Это создает зависимость от файла school.csv.
  • Для всех перечисленных пользователей будет задан тип роли "student".
  • Ожидается, что значения даты будут предоставлены в ISO8601 формате.

teacher.csv

Поле Обязательный? Пример Тип данных
Идентификатор SIS Да 654321 Уникальный идентификатор
Идентификатор SIS школы Да 456789 Уникальный идентификатор
Username Да jcook@contoso.edu String
Имя Да (только при создании пользователей) Джейн String
Фамилия Да (только при создании пользователей) Готовить String
Отчество Нет Мередит String
Номер преподавателя Нет 654321 String
Grade Нет 8 Перечисление
Secondary Email Нет jcook@contoso.edu Email
Состояние данные не поддерживаются
Пароль данные не поддерживаются
Название данные не поддерживаются
State ID данные не поддерживаются
Qualification данные не поддерживаются
  • Требуется ссылка на связанное учебное заведение с использованием поля "Идентификатор SIS учебного заведения". Это создает зависимость от файла school.csv.
  • Для всех перечисленных пользователей будет задан тип роли "преподаватель".

section.csv

Поле Обязательный? Пример Тип данных
Идентификатор SIS Да 334455 Уникальный идентификатор
Идентификатор SIS школы Да 456789 Уникальный идентификатор
Имя раздела Да Период 1 — всемирная история String
Section Number Нет 334466 String
Course SIS ID Нет 123456789 Уникальный идентификатор
Course Name Нет Мировая история 10 String
Course Number Нет 123456789 String
Course Description Нет История мира String
Course Subject Нет 54999 Перечисление
Term SIS ID данные не поддерживаются
Term Name данные не поддерживаются
Term StartDate данные не поддерживаются
Term EndDate данные не поддерживаются
Состояние данные не поддерживаются
Periods данные не поддерживаются
  • Требуется ссылка на связанное учебное заведение с использованием поля "Идентификатор SIS учебного заведения". Это создает зависимость от файла school.csv.
  • Если требуются сведения о термине, рекомендуется перейти в формат CSV SDS версии 2.1 , а также предоставить academicSessions.csv файл.

studentenrollment.csv

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

teacherroster.csv

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

user.csv

Поле Обязательный? Пример Тип данных
Email Да jsmith@outlook.com Email
Имя Да Иван String
Фамилия Да Иванов String
Phone Нет +1234567890 Phone
Идентификатор SIS Нет P_123456 Уникальный идентификатор
  • Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
  • Ожидается, что поле телефона будет отформатировано на основе стандарта E.164, где символ "плюс" используется и заменен номером телефона, или, скорее, символом "плюс", за которым следует код страны, код региона, префикс телефона и номер строки.

guardianrelationship.csv

Поле Обязательный? Пример Тип данных
Идентификатор SIS Да 123456 Уникальный идентификатор
Email Да jsmith@outlook.com Email
Role Нет Родительский элемент Перечисление
  • Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
  • Для этого требуется ссылка на связанного пользователя, использующий поле "Email". Это создает зависимость от файла user.csv.
  • Для этого требуется ссылка на связанного пользователя, использующий поле "Идентификатор SIS". Это создает зависимость от файла student.csv.
  • Если значение роли не указано, значение связи по умолчанию равно "userContact".