Використання протоколу SFTP для вивантаження даних про студентів, персонал і заняття в Apple School Manager

Якщо ваша система інформації про студентів (SIS) наразі не підтримується в Apple School Manager або якщо у вас немає системи інформації про студентів, ви можете вивантажувати дані про студентів, персонал і заняття в Apple School Manager за протоколом SFTP.

Set up your first SFTP upload

Заповнення файлів даних

Оновлення файлів

Під час налаштування протоколу SFTP в асистенті SIS/SFTP Apple School Manager пропонує файли шаблонів CSV та інформацію про доступ до приватного сервера SFTP. Ви можете експортувати дані із системи SIS, що підтримує таку можливість, або створити файли в програмі для роботи з електронними таблицями, як-от Numbers. Перед експортом із SIS, зверніться до представника цієї системи, щоб переконатись у правильності формату для Apple School Manager.

Щоб виконати вивантаження по протоколу SFTP у macOS, потрібно скористатися сторонньою програмою. Якщо у вас не інстальовано клієнт SFTP, його можна знайти в Mac App Store.

Натискайте кнопки нижче, щоб отримати допомогу з налаштування SFTP-файлів. Якщо ви раніше не вивантажували дані в Apple School Manager по протоколу SFTP, спочатку перейдіть у розділ «Налаштування першого вивантаження за протоколом SFTP».

Налаштування першого вивантаження за протоколом SFTP

1. Увійдіть в Apple School Manager як адміністратор, керівник сайту або менеджер із персоналу.

2. У нижній частині бічної панелі виберіть своє ім’я, натисніть «Параметри» > «Облікові записи» > «Синхронізація каталогів», а потім у розділі SIS/SFTP виберіть «Увімкнути». Перш ніж налаштовувати протокол SFTP, потрібно перевірити домен.

3. Натисніть «Знайти студентів, викладачів і заняття».

   

4. Натисніть «Налаштувати SFTP».

   

5. Apple School Manager згенерує URL-адресу, ім’я користувача та пароль, які використовуватимуться під час вивантаження файлів. Використовуйте цю інформацію, щоб налаштувати клієнт SFTP.

   

6. Натисніть «Завантажити шаблони».

7. Прочитайте інструкції з використання шаблонів у розділі «Заповнення файлів даних».

8. Коли файли даних буде заповнено, створіть ZIP-архів з усіх шести файлів. Можна вибрати файли у Finder, а потім перейти в меню «Файл» і вибрати «Створити архів із 6 елем.». ZIP-архів може мати будь-яке ім’я.

9. Вивантажте ZIP-файл в Apple School Manager. Скористайтеся клієнтом SFTP, щоб під’єднатися до URL-адреси, що відображається в асистенті SIS/SFTP. Коли з’явиться запит на введення даних для входу, укажіть ім’я користувача та пароль, які ви отримали, натиснувши кнопку «Налаштування SFTP». Скопіюйте ZIP-файл у каталог Dropbox.

10. В асистенті SIS/SFTP натисніть «Продовжити». Якщо файли, що вивантажуються, містять помилки, можна переглянути журнал, у якому буде вказано файли та рядки з помилками. Виправте всі помилки у файлах даних, а потім повторіть кроки 8 і 9. Не потрібно вилучати попередній файл із сервера SFTP.

11. Коли імпорт SFTP завершиться, натисніть «Переглянути дані SFTP». Якщо ви виявили помилки, натисніть «Скасувати». Виправте всі помилки у файлах даних, а потім повторіть процес вивантаження. Якщо дані точні й повні, натисніть «Продовжити».

    

12. У розділі «Створити облікові записи та заняття» виберіть формат керованого Apple ID для студентів, викладачів і персоналу. Натисніть «Переглянути облікові записи та заняття». Коли ідентифікатори (ID) будуть у правильному форматі, натисніть «Створити облікові записи та заняття». Лише перевірені домени

    

13. Коли ви створите облікові записи, передайте дані для входу користувачам і призначте ролі персоналу.

    

Заповнення файлів даних

Шаблон для завантаження містить шість файлів зі значеннями (CSV), які розділено комами, для занять (Classes), курсів (Courses), локацій (Locations), списків учасників (Rosters), студентів (Students) і персоналу (Staff). Якщо шаблони недоступні в Apple School Manager або якщо ви загубили копію вихідних шаблонів, їх можна завантажити знову.

Ви можете використовувати систему SIS для експорту даних у форматі, описаному в шаблонах і цій статті, або відредагувати шаблони в програмі для роботи з електронними таблицями, як-от Numbers.

Використовуйте таблиці в цій статті, щоб переконатися, що ви ввели правильну інформацію, а потім збережіть кожен файл, не змінюючи його ім’я.

Форматування значень

Якщо ви редагуєте шаблони, замініть приклади даних власними даними. Не змінюйте вміст клітинок заголовків у файлах. Не додавайте стовпці у файли, окрім описаних нижче випадків.

У кожному шаблоні кожен рядок має представляти унікальне значення. Наприклад, у файлі students.csv кожен рядок має відповідати унікальному студенту. Деякі значення для цього студента можуть бути пустими. Значення літералів, як-от символ розриву рядка чи лапок в імені, потрібно комбінувати зі зворотною скісною рискою (\), наприклад (\"). Будь-які введені ідентифікатори мають складатися лише з букв і цифр і можуть містити символ «-».

Якщо значення містить пробіл ( ) або кому (,), додайте навколо нього прямі лапки ("). Якщо в значенні немає жодних із цих спеціальних символів, не використовуйте лапки. Якщо в потрібних місцях не буде лапок або якщо використовувати лапки шевронами, під час вивантаження виникнуть помилки.

Значення у файлах потрібно розділяти комами (,) або крапками з комою (;) незалежно від того, як ви створили файл. Не використовуйте пробіли чи символи табуляції між комою чи крапкою з комою та наступним значенням. Кожен файл має бути в кодуванні UTF-8. У файлах потрібно використовувати символи нових рядків Unix (\n).

Якщо формат керованого Apple ID включає поле, яке є необов’язковим за інших умов, наприклад person_number або sis_username, воно стає обов’язковим полем. Якщо залишити це поле пустим, вивантаження буде перервано через помилку MANAGED_ID_GENERATION_FAILED.

Файл Locations

У файлі Locations потрібно визначити принаймні одну локацію. Протокол SFTP не можна використовувати для створення облікових записів студентів або персоналу в основній локації («штаб-квартирі»).

Файл Students

Якщо протокол SFTP використовується для вивантаження даних нової людини, а в Apple School Manager уже є призначений вами ідентифікатор person_id, дані цієї людини перезапишуть дані наявного користувача в Apple School Manager. Щойно перезаписування буде завершено, дані цього користувача можна оновити лише за протоколом SFTP.

Призначення декількох локацій

Студенту можна призначити декілька локацій, додавши інші стовпці локацій у файл Students. Можна додати до 998 стовпців локацій з іменами location_id_2, location_id_3 тощо до location_id_999 включно. Для кожного студента можна додатково ввести ще один ідентифікатор location_id у кожен із цих стовпців. Це значення має відповідати ідентифікатору location_id у файлі Locations. Якщо це значення не відповідає значенню у файлі Locations, під час вивантаження виникнуть проблеми.

Файл Staff

Якщо протокол SFTP використовується для вивантаження даних нової людини, а в Apple School Manager уже є призначений вами ідентифікатор person_id, дані цієї людини перезапишуть дані наявного користувача в Apple School Manager. Щойно перезаписування буде завершено, дані цього користувача можна оновити лише за протоколом SFTP. До всього персоналу застосовується стандартна політика щодо паролів (8 і більше буквено-цифрових символів).

Призначення декількох локацій

Співробітнику можна призначити декілька локацій, додавши інші стовпці локацій у файл Staff. Можна додати до 998 стовпців локацій з іменами location_id_2, location_id_3 тощо до location_id_999 включно. Для кожного співробітника можна додатково ввести ще один ідентифікатор location_id у кожен із цих стовпців. Це значення має відповідати ідентифікатору location_id у файлі Locations. Якщо це значення не відповідає значенню у файлі Locations, під час вивантаження виникнуть проблеми.

Файл Courses

Файл Classes

Призначення декількох викладачів

Заняттю можна призначити декілька викладачів, додавши інші стовпці для викладачів у файл Classes. Можна додати до 12 стовпців для викладачів з іменами instructor_id_4, instructor_id_5 тощо до instructor_id_15 включно. Для кожного заняття можна додатково ввести ще один ідентифікатор person_id викладача. Це значення має відповідати ідентифікатору person_id, який використовується у файлі Staff.

Файл Rosters

Оновлення файлів

Якщо потрібно додати чи відредагувати студентів, співробітників і заняття, відредагуйте файли даних і вивантажте нові копії. Щоразу під час вивантаження файлів потрібно вивантажувати всі шість файлів, і кожен файл має містити повний список кожної категорії, а не лише елементи, які ви хочете додати. Інформацію про обліковий запис SFTP можна перевірити, вибравши «Параметри» > «Джерело даних».

Після завершення першого вивантаження нові облікові записи та заняття буде створено автоматично. Якщо виникнуть помилки, ви отримаєте електронний лист від Apple School Manager.

Якщо запис із попереднього виантаження відсутній

Якщо запис із попереднього вивантаження відсутній, обліковий запис буде деактивовано й автоматично видалено через 120 днів, якщо для нього не придбано контент за корпоративною ліцензією.

Якщо курс або заняття вилучено

Якщо курс або заняття вилучено із вивантаження, студентів буде вилучено із заняття, а джерело буде змінено на «Створено вручну». Якщо курси використовувалися в програмі «Шкільні уроки», список учасників буде вилучено, а для повторної реєстрації потрібно створити курс. Якщо заняття використовувалися в програмі «Шкільні уроки», дані про прогрес автоматично видаляться та більше не будуть доступні для викладача чи студента.

Курси та заняття з джерелом, що створюється вручну, надалі синхронізуватимуться з вашим рішенням MDM, але можуть більше не відображатися в програмі «Клас». Заняття, що створюються вручну, можна видалити в Apple School Manager, якщо їх потрібно вилучити із синхронізації.