Формат 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 | данные не поддерживаются | ||
| Город | данные не поддерживаются | ||
| Состояние | данные не поддерживаются | ||
| ZIP | данные не поддерживаются | ||
| Страна | данные не поддерживаются | ||
| Phone | данные не поддерживаются | ||
| Зона | данные не поддерживаются |
- Для всех перечисленных организаций будет задан тип организации school.
student.csv
| Поле | Обязательный? | Пример | Тип данных |
|---|---|---|---|
| Идентификатор SIS | Да | 123456 | Уникальный идентификатор |
| Идентификатор SIS школы | Да | 456789 | Уникальный идентификатор |
| Username | Да | jsmith@contoso.edu | String |
| Имя | Да (только при создании пользователей) | Иван | String |
| Фамилия | Да (только при создании пользователей) | Иванов | String |
| Отчество | Нет | Вильям | String |
| Secondary Email | Нет | jsmith@contoso.edu | Электронная почта |
| Student Number | Нет | 123456 | String |
| Grade | Нет | 8 | Перечисление |
| Birthdate | Нет | 2009-12-19 | Date |
| Состояние | данные не поддерживаются | ||
| Пароль | данные не поддерживаются | ||
| Graduation Year | данные не поддерживаются | ||
| State ID | данные не поддерживаются |
- Требуется ссылка на связанное учебное заведение с использованием поля "Идентификатор SIS учебного заведения". Это создает зависимость от файла school.csv.
- Для всех перечисленных пользователей будет задан тип роли "student".
- Ожидается, что значения даты будут предоставлены в ISO8601 формате.
- Начальные нули "0", отсутствующие во входящем значении для ENUM уровня оценок, например "1", будут соответствовать определенному списку значений (ENUM) "01" и храниться как "01".
teacher.csv
| Поле | Обязательный? | Пример | Тип данных |
|---|---|---|---|
| Идентификатор SIS | Да | 654321 | Уникальный идентификатор |
| Идентификатор SIS школы | Да | 456789 | Уникальный идентификатор |
| Username | Да | jcook@contoso.edu | String |
| Имя | Да (только при создании пользователей) | Бабенка | String |
| Фамилия | Да (только при создании пользователей) | Повар | String |
| Отчество | Нет | Мередит | String |
| Номер преподавателя | Нет | 654321 | String |
| Grade | Нет | 8 | Перечисление |
| Secondary Email | Нет | jcook@contoso.edu | Электронная почта |
| Состояние | данные не поддерживаются | ||
| Пароль | данные не поддерживаются | ||
| Название | данные не поддерживаются | ||
| State ID | данные не поддерживаются | ||
| Qualification | данные не поддерживаются |
- Требуется ссылка на связанное учебное заведение с использованием поля "Идентификатор SIS учебного заведения". Это создает зависимость от файла school.csv.
- Для всех перечисленных пользователей будет задан тип роли "преподаватель".
- Начальные нули "0", отсутствующие во входящем значении для ENUM уровня оценок, например "1", будут соответствовать определенному списку значений (ENUM) "01" и храниться как "01".
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
| Поле | Обязательный? | Пример | Тип данных |
|---|---|---|---|
| Электронная почта | Да | jsmith@outlook.com | Электронная почта |
| Имя | Да | Иван | String |
| Фамилия | Да | Иванов | String |
| Phone | Нет | +1234567890 | Phone |
| Идентификатор SIS | Нет | P_123456 | Уникальный идентификатор |
- Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
- Ожидается, что поле телефона будет отформатировано на основе стандарта E.164, где символ "плюс" используется и заменен номером телефона, или, скорее, символом "плюс", за которым следует код страны, код региона, префикс телефона и номер строки.
guardianrelationship.csv
| Поле | Обязательный? | Пример | Тип данных |
|---|---|---|---|
| Идентификатор SIS | Да | 123456 | Уникальный идентификатор |
| Электронная почта | Да | jsmith@outlook.com | Электронная почта |
| Role | Нет | Родительский элемент | Перечисление |
- Если вы также синхронизируете контактные отношения (опекуны), необходимо включить запись для них в user.csv.
- Для этого требуется ссылка на связанного пользователя, использующий поле "Email". Это создает зависимость от файла user.csv.
- Для этого требуется ссылка на связанного пользователя, использующий поле "Идентификатор SIS". Это создает зависимость от файла student.csv.
- Если значение роли не указано, значение связи по умолчанию равно "userContact".