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

School Data Sync (SDS) дає змогу синхронізувати інформаційну систему навчального закладу з Office 365 за допомогою CSV-файлів. Якщо ви використовуєте цей метод, вам знадобиться шість окремих CSV-файлів, щоб налаштувати профіль синхронізації в SDS. У цій статті описано CSV-файли та їх відповідне форматування.

Обов’язкові CSV-файли для School Data Sync

Коли ви налаштовуєте SDS за допомогою CSV-файлів, адміністратори повинні створити шість окремих CSV-файлів, які містять усі вказані нижче обов’язкові атрибути. У ці файли можна також додати деякі необов’язкові атрибути. Докладні відомості про налаштування профілю синхронізації за допомогою CSV-файлів в SDS див. в статті Розгортання School Data Sync за допомогою CSV-файлів. Приклад набору CSV-файлів, який містить зразки даних із відповідними значеннями й форматуванням атрибутів, див. в цьому репозиторії GitHub.

Необхідні атрибути CSV-файлів залежать від параметрів профілю синхронізації SDS, вибраних у процесі його налаштування за допомогою майстра. Крім того, якщо клієнт Office 365 розташований у Сполученому Королівстві Великої Британії та Північної Ірландії, до шести CSV-файлів і їхніх обов’язкових атрибутів застосовуються конкретні вимоги. Докладні відомості про ці вимоги див. в розділі CSV-файли для Сполученого Королівства Великої Британії та Північної Ірландії цієї статті або прогляньте відповідні зразки файлів у цьому репозиторії GitHub.

Примітка : Переконайтеся, що CSV-файли не містять недопустимих символів. Крім того, вони не мають містити понад 500 000 рядків даних. Якщо їх кількість перевищує це значення, необхідно перенести зайві рядки в інший набір із шести CSV-файлів і створити додатковий профіль синхронізації, щоб їх завантажити та синхронізувати.

Шість необхідних CSV-файлів:

  • School.csv – відомості про навчальний заклад.

  • Section.csv – відомості про секцію.

  • Student.csv – відомості про учнів.

  • Teacher.csv – відомості про викладачів.

  • StudentEnrollment.csv – зіставлення учнів із секціями.

  • TeacherRoster.csv – зіставлення викладачів із секціями.

Примітка : Цим CSV-файлам потрібно надати точно такі імена, як показано нижче. Усі вони мають розміщуватися в одній папці або одному каталозі на локальному комп’ютері. Цей каталог не має містити інших файлів. Крім того, усі вказані нижче імена атрибутів для CSV-файлів використовуватимуться як заголовки у відповідних CSV-файлах.

Усі CSV-файли мають міститися в одному каталозі.

School.csv

Нижче наведено атрибути, які необхідно обов’язково вказати у файлі School.csv. Це мінімальний набір атрибутів, що дає змогу створити та синхронізувати відомості про навчальний заклад в SDS. Якщо не додати їх, можливо, файл не завантажиться або не вдасться належним чином створити або синхронізувати відомості про навчальний заклад. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • SIS ID    (Ідентифікатор SIS) – ідентифікатор SIS навчального закладу.

  • Name    (Назва) – назва навчального закладу.

Необов’язкові атрибути для School.csv

Файл School.csv може містити будь-які з вказаних нижче необов’язкових атрибутів. Коли ви налаштовуєте профіль синхронізації, у нього можна додати будь-які з наведених нижче необов’язкових атрибутів, але потім їх слід додати у відповідний CSV-файл як заголовки стовпців. Ці атрибути мають повністю відповідати вказаним нижче іменам (включно з орфографією, регістром і синтаксисом). Хоча ці поля не обов’язково вказувати SDS, будь-які програми, які використовують синхронізовані дані SDS, можуть скористатися цими атрибутами. Обов’язково вкажіть усі атрибути, необхідні для оптимальної роботи програми. Запитайте в постачальника програм, з якими програмами необхідно використовувати ці атрибути. За потреби ви завжди можете додати необов’язкові атрибути в профіль синхронізації в SDS і змінити їх.

  • School Number (Номер навчального закладу);

  • School NCES_ID (Ідентифікатор NCES навчального закладу);

  • State ID (Код області);

  • Grade Low (Найнижча оцінка);

  • Grade High (Найвища оцінка);

  • Principal SIS ID (Ідентифікатор SIS учасника);

  • Principal Name (Ім’я учасника);

  • Principal Secondary Email (Додаткова адреса електронної пошти учасника);

  • Address (Адреса);

  • Місто

  • State (Область);

  • Country (Країна);

  • Zip (Поштовий індекс);

  • Phone (Телефон);

  • Zone (Зона).

На знімку екрана нижче показано майстер налаштування профілю синхронізації SDS. Сірим кольором відображаються необхідні атрибути (решта атрибутів необов’язкові).

Section.csv

Нижче наведено атрибути, які необхідно обов’язково вказати у файлі Section.csv. Це мінімальний набір атрибутів, що дає змогу створити та синхронізувати відомості про секцію в SDS. Якщо не додати їх, можливо, файл не завантажитися або не вдасться належним чином створити або синхронізувати відомості про секцію. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • SIS ID    (Ідентифікатор SIS) – ідентифікатор SIS секції.

  • School SIS ID    (Ідентифікатор SIS навчального закладу) – ідентифікатор SIS навчального закладу.

  • Section Name    (Назва секції) – назва секції.

Необов’язкові атрибути для Section.csv

Файл Section.csv може містити будь-які з вказаних нижче необов’язкових атрибутів. Коли ви налаштовуєте профіль синхронізації, у нього можна додати будь-які з наведених нижче необов’язкових атрибутів, але потім їх слід додати у відповідний CSV-файл як заголовки стовпців. Ці атрибути мають повністю відповідати вказаним нижче іменам (включно з орфографією, регістром і синтаксисом). Хоча ці поля не обов’язково вказувати SDS, будь-які програми, які використовують синхронізовані дані SDS, можуть скористатися цими атрибутами. Обов’язково вкажіть усі атрибути, необхідні для оптимальної роботи програми. Запитайте в постачальника програм, з якими програмами необхідно використовувати ці атрибути. За потреби ви завжди можете додати необов’язкові атрибути в профіль синхронізації в SDS і змінити їх.

  • Section Number (Номер секції);

  • Term SIS ID (Ідентифікатор SIS терміну);

  • Term Name (Назва терміну);

  • Term StartDate (Дата початку терміну);

  • Term EndDate (Дата закінчення терміну);

  • Course SIS ID (Ідентифікатор SIS курсу);

  • Course Name (Ім’я курсу);

  • Course Number (Номер курсу);

  • Course Description (Опис курсу);

  • Course Subject (Тема курсу);

  • Periods (Періоди);

  • Status (Стан).

На знімку екрана нижче показано майстер налаштування профілю синхронізації SDS. Сірим кольором відображаються необхідні атрибути (решта атрибутів необов’язкові).

Student.csv

Нижче наведено атрибути, які необхідно обов’язково вказати у файлі Student.csv. Це мінімальний набір атрибутів, що дає змогу створити та синхронізувати відомості про учнів в SDS. Якщо не додати їх, можливо, файл не завантажиться або не вдасться належним чином створити або синхронізувати відомості про учнів. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • SIS ID    (Ідентифікатор SIS) – ідентифікатор SIS учня.

  • School SIS ID    (Ідентифікатор SIS навчального закладу) – ідентифікатор SIS навчального закладу.

  • Username (Ім’я користувача) – ім’я учня. 

Якщо ви в процесі налаштування профілю синхронізації SDS за допомогою майстра вибрали параметр Create and Sync New Users (Створити й синхронізувати нових користувачів), 3 вказаних нижче атрибути також є обов’язковими, а якщо вибрали 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 (Стан ELL);

  • FederalRace (Раса);

  • Graduation Year (Рік випуску).

На знімку екрана нижче показано майстер налаштування профілю синхронізації SDS. Сірим кольором відображаються необхідні атрибути (решта атрибутів необов’язкові).

Teacher.csv

Файл Teacher.csv має містити вказані нижче атрибути. Це мінімальний набір атрибутів, що дає змогу створити та синхронізувати відомості про викладачів в SDS. Якщо не додати їх, можливо, файл не завантажиться або не вдасться належним чином створити або синхронізувати відомості про викладачів. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • SIS ID    (Ідентифікатор SIS) – ідентифікатор SIS викладача.

  • School SIS ID    (Ідентифікатор SIS навчального закладу) – ідентифікатор SIS навчального закладу.

  • Username (Ім’я користувача) – ім’я викладача.

Якщо ви в процесі налаштування профілю синхронізації SDS за допомогою майстра вибрали параметр Create and Sync New Users (Створити й синхронізувати нових користувачів), 3 вказаних нижче атрибути також є обов’язковими, а якщо вибрали 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. Якщо не додати їх, можливо, файл не завантажиться або не вдасться належним чином створити або синхронізувати відомості про реєстрацію учнів. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • Section SIS ID    (Ідентифікатор SIS секції) – ідентифікатор SIS секції.

  • SIS ID    (Ідентифікатор SIS) – ідентифікатор SIS учня.

TeacherRoster.csv

Файл TeacherRoster.csv має містити вказані нижче атрибути. Це мінімальний набір атрибутів, що дає змогу додавати викладачів до секції в SDS. Якщо не додати їх, можливо, файл не завантажиться або не вдасться належним чином створити або синхронізувати список викладачів. Відповідну помилку можна переглянути у звіті про помилки профілю синхронізації.

  • Section SIS ID    (Ідентифікатор SIS секції) – ідентифікатор SIS секції.

  • SIS ID    (Ідентифікатор 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

Розгортання School Data Sync за допомогою CSV-файлів

Отримуйте нові функції раніше за інших
Приєднайтеся до оцінювачів Office

Ця інформація корисна?

Дякуємо за ваш відгук!

Дякуємо за відгук! Схоже, вам може стати в нагоді допомога одного з наших спеціалістів служби підтримки Office, з яким ми вас можемо з’єднати.

×