CSV-файлы для School Data Sync

Вы можете использовать CSV-файлы (файлы с разделителями-запятыми) в School Data Sync (SDS) для синхронизации информационной школьной системы (SIS) с Office 365. При использовании этого метода вам потребуются шесть отдельных CSV-файлов для настройки профиля синхронизации в SDS. В этой статье описаны CSV-файлы и их форматирование.

Необходимые CSV-файлы для School Data Sync

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

Обязательные атрибуты для CSV-файлов зависят от параметров профиля синхронизации, выбранных при настройке профиля синхронизации SDS с помощью мастера. Кроме того, если клиент Office 365 находится в Великобритании, существуют отдельные требования к шести CSV-файлам и обязательным атрибутам. См. раздел CSV-файлы для Великобритании в этом документе. Примеры файлов для Великобритании можно найти в репозитории GitHub для SDS.

Примечание : Убедитесь в том, что в CSV-файлах нет недопустимых символов. В них также не должно быть более 500 000 строк с данными. Если их больше, необходимо перенести лишние строки в другой набор из шести CSV-файлов и создать еще один профиль синхронизации, чтобы добавить и синхронизировать эти новые файлы.

Требуются следующие шесть CSV-файлов:

  • School.csv — сведения об учебном заведении.

  • Section.csv — сведения о разделе.

  • Student.csv — сведения об учащихся.

  • Teacher.csv — сведения о преподавателях.

  • StudentEnrollment.csv — сопоставление учащихся с разделами.

  • TeacherRoster.csv — сопоставление преподавателей с разделами.

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

Все CSV-файлы должны находиться в одном каталоге

School.csv

Файл School.csv должен содержать перечисленные ниже атрибуты. Они требуются для создания и синхронизации учебного заведения в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо учебное заведение не будет создано и синхронизировано надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • SIS ID    — идентификатор SIS учебного заведения.

  • Name    — название учебного заведения.

Необязательные атрибуты для School.csv

Файл School.csv может содержать любые из указанных ниже необязательных атрибутов. При настройке профиля синхронизации вы можете включить любые из этих атрибутов, но их также потребуется добавить в соответствующий CSV-файл как заголовок столбца. Атрибуты необходимо указывать точно так, как ниже (с учетом регистра, написания и синтаксиса). Хотя SDS не требует наличия этих полей, они могут быть необходимы приложениям, которые используют синхронизированные данные SDS. Не забудьте включить все атрибуты, необходимые для оптимальной работы приложений. Сведения о том, какие из этих атрибутов используются в приложении, можно получить у его поставщика. При необходимости можно в любой момент изменить или добавить необязательные атрибуты в профиле синхронизации в SDS.

  • School Number

  • School NCES_ID

  • State ID

  • Grade Low

  • Grade High

  • Principal SIS ID

  • Principal Name

  • Principal Secondary Email

  • Address

  • City

  • State

  • Country

  • Zip

  • Phone

  • Zone

На снимке экрана ниже показан мастер настройки профиля синхронизации SDS. Атрибуты, обозначенные серым цветом, являются обязательными. Остальные атрибуты задавать необязательно.

Section.csv

Файл Section.csv должен содержать перечисленные ниже атрибуты. Они требуются для создания и синхронизации раздела в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо раздел не будет создан и синхронизирован надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • SIS ID    — идентификатор SIS раздела.

  • School SIS ID   — идентификатор SIS учебного заведения.

  • Section Name   — название раздела.

Необязательные атрибуты для Section.csv

Файл Section.csv может содержать любые из указанных ниже необязательных атрибутов. При настройке профиля синхронизации вы можете включить любые из этих атрибутов, но их также потребуется добавить в соответствующий CSV-файл как заголовок столбца. Атрибуты необходимо указывать точно так, как ниже (с учетом регистра, написания и синтаксиса). Хотя SDS не требует наличия этих полей, они могут быть необходимы приложениям, которые используют синхронизированные данные SDS. Не забудьте включить все атрибуты, необходимые для оптимальной работы приложений. Сведения о том, какие из этих атрибутов используются в приложении, можно получить у его поставщика. При необходимости можно в любой момент изменить или добавить необязательные атрибуты в профиле синхронизации в SDS.

  • Section Number

  • Term SIS ID

  • Term Name

  • Term StartDate

  • Term EndDate

  • Course SIS ID

  • Course Name

  • Course Number

  • Course Description

  • Course Subject

  • Periods

  • Status

На снимке экрана ниже показан мастер настройки профиля синхронизации SDS. Атрибуты, обозначенные серым цветом, являются обязательными. Остальные атрибуты задавать необязательно.

Student.csv

Файл Student.csv должен содержать перечисленные ниже атрибуты. Они требуются для создания и синхронизации учащегося в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо учащийся не будет создан и синхронизирован надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • SIS ID    — идентификатор SIS учащегося.

  • School SIS ID   — идентификатор SIS учебного заведения.

  • Username — имя пользователя учащегося. 

Если вы выбрали параметр Create and Sync New Users (Создать и синхронизировать новых пользователей) в мастере настройки профиля синхронизации SDS, три указанных ниже атрибута также являются обязательными. Если вы выбрали Sync Existing Users (Синхронизировать существующих пользователей), они не требуются, а SDS не сможет перезаписать их в Azure, если они уже заданы для объекта пользователя.

Необязательные атрибуты для Student.csv

Файл Student.csv может содержать любые из указанных ниже необязательных атрибутов. При настройке профиля синхронизации вы можете включить любые из этих атрибутов, но их также потребуется добавить в соответствующий CSV-файл как заголовок столбца. Атрибуты необходимо указывать точно так, как ниже (с учетом регистра, написания и синтаксиса). Хотя SDS не требует наличия этих полей, они могут быть необходимы приложениям, которые используют синхронизированные данные SDS. Не забудьте включить все атрибуты, необходимые для оптимальной работы приложений. Сведения о том, какие из этих атрибутов используются в приложении, можно получить у его поставщика. При необходимости можно в любой момент изменить или добавить необязательные атрибуты в профиле синхронизации в SDS.

  • State ID

  • Secondary Email

  • Student Number

  • Grade

  • Status

  • Mailing Address

  • Mailing City

  • Mailing State

  • Mailing Zip

  • Mailing Latitude

  • Mailing Longitude

  • Mailing Country

  • Residence Address

  • Residence City

  • Residence State

  • Residence Zip

  • Residence Latitude

  • Residence Longitude

  • Residence Country

  • Gender

  • Birthdate

  • ELL Status

  • FederalRace

  • Graduation Year

На снимке экрана ниже показан мастер настройки профиля синхронизации SDS. Атрибуты, обозначенные серым цветом, являются обязательными. Остальные атрибуты задавать необязательно.

Teacher.csv

Файл Teacher.csv должен содержать перечисленные ниже атрибуты. Они требуются для создания и синхронизации преподавателя в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо преподаватель не будет создан и синхронизирован надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • SIS ID    — идентификатор SIS преподавателя.

  • School SIS ID   — идентификатор SIS учебного заведения.

  • Username — имя пользователя преподавателя.

Если вы выбрали параметр Create and Sync New Users (Создать и синхронизировать новых пользователей) в мастере настройки профиля синхронизации SDS, три указанных ниже атрибута также являются обязательными. Если вы выбрали Sync Existing Users (Синхронизировать существующих пользователей), они не требуются, а SDS не сможет перезаписать их в Azure, если они уже заданы для объекта пользователя.

Необязательные атрибуты для Teacher.csv

Файл Teacher.csv может содержать любые из указанных ниже необязательных атрибутов. При настройке профиля синхронизации вы можете включить любые из этих атрибутов, но их также потребуется добавить в соответствующий CSV-файл как заголовок столбца. Атрибуты необходимо указывать точно так, как ниже (с учетом регистра, написания и синтаксиса). Хотя SDS не требует наличия этих полей, они могут быть необходимы приложениям, которые используют синхронизированные данные SDS. Не забудьте включить все атрибуты, необходимые для оптимальной работы приложений. Сведения о том, какие из этих атрибутов используются в приложении, можно получить у его поставщика. При необходимости можно в любой момент изменить или добавить необязательные атрибуты в профиле синхронизации в SDS.

  • State ID

  • Teacher Number

  • Status

  • Secondary Email

  • Title

  • Qualification

На снимке экрана ниже показан мастер настройки профиля синхронизации SDS. Атрибуты, обозначенные серым цветом, являются обязательными. Остальные атрибуты, обозначенные синим, задавать необязательно.

StudentEnrollment.csv

Файл StudentEnrollment.csv должен содержать перечисленные ниже атрибуты. Они требуются для добавления учащегося в раздел в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо сопоставление Studentenrollment не будет создано и синхронизировано надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • Section SIS ID    — идентификатор SIS раздела.

  • Идентификатор SIS    — идентификатор SIS учащегося.

TeacherRoster.csv

Файл TeacherRoster.csv должен содержать перечисленные ниже атрибуты. Они требуются для добавления преподавателя в раздел в SDS. Если не включить эти атрибуты, при отправке файла произойдет ошибка либо сопоставление TeacherRoster не будет создано и синхронизировано надлежащим образом, а в отчете об ошибках профиля синхронизации будет зарегистрирован сбой.

  • Section SIS ID    — идентификатор SIS раздела.

  • Идентификатор SIS    — идентификатор SIS преподавателя.

CSV-файлы для Великобритании

Если вы включаете School Data Sync с помощью CSV-файлов для клиента Office 365, расположенного в Великобритании, обязательные атрибуты немного отличаются от указанных выше. Ниже описаны все обязательные атрибуты CSV-файлов для Великобритании. Необязательные атрибуты остаются такими же.

School.csv

  • DfE number — номер учебного заведения, присвоенный Министерством образования.

  • Name — название учебного заведения.

Section.csv

  • ID — идентификатор раздела.

  • School DfE number — номер учебного заведения, присвоенный Министерством образования.

  • Section Name — название раздела.

Student.csv

  • ID — идентификатор учащегося.

  • School ​​​​​​​DfE number — номер учебного заведения, присвоенный Министерством образования.

  • Username — имя пользователя учащегося.

Teacher.csv

  • ID — идентификатор преподавателя.

  • School ​​​​​​​DfE number — номер учебного заведения, присвоенный Министерством образования.

  • Username — имя пользователя преподавателя.

StudentEnrollment.csv

  • Section ID — идентификатор раздела.

  • ID — идентификатор SIS преподавателя.

TeacherRoster.csv

  • Section ID — идентификатор раздела.

  • ID — идентификатор преподавателя.

См. также:

Общие сведения о School Data Sync и Classroom

Развертывание School Data Sync с помощью CSV-файлов

Совершенствование навыков
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×