Інформація про шаблони для імпортування даних в Apple School Manager
Щоб додати дані до Apple School Manager, вам потрібно використовувати файли у форматі .csv від Apple чи OneRoster.
Назви шаблонів .csv Apple: студенти, персонал, курси, заняття, розклади, місцезнаходження
Назви шаблонів .csv OneRoster. користувачі, курси, заняття, реєстрації, установи
Ім’я файлу Apple | Ім’я файлу OneRoster | Вміст | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: містить інформацію про облікові записи студентів. OneRoster: містить інформацію про облікові записи студентів, викладачів і членів персоналу. | |||||||||||
Н/Д | Містить інформацію про облікові записи членів персоналу, як-от викладачів. | ||||||||||
Містить інформацію про курс. | |||||||||||
Містить інформацію про заняття та викладачів (персонал). | |||||||||||
Містить інформацію про заняття, студентів і місцезнаходження (розклад). | |||||||||||
Містить інформацію про місцезнаходження (навчального закладу або відділу). | |||||||||||
Шаблони та керовані облікові записи Apple
Якщо необовʼязкове поле, як‑от person_number (номер особи) або sis_username (імvя користувача sis), є частиною формату керованого облікового запису Apple, воно стає обовʼязковим. Якщо залишити його пустим, закачування SFTP завершиться з помилкою «MANAGED_ID_GENERATION_FAILED» (не вдалося згенерувати керований ідентифікатор).
Підготовка шаблонів
Під час підготовки шаблону необхідно дотримуватися наведених нижче критеріїв.
Структура
Назви файлів .csv повинні точно збігатися з оригінальними назвами файлів.
Не змінюйте назву рядка заголовка в будь-якому файлі.
Не видаляйте стовпець, навіть якщо він порожній.
Ви можете додавати стовпці в шаблони students, staff і classes.
У шаблонах кожен рядок має відображати унікальне значення. Наприклад, у файлі students.csv кожен рядок має бути унікальним студентом.
Для шаблонів students.csv та staff.csv значення person_id (ідентифікатор особи) має бути унікальним для всіх місцезнаходжень.
Важливо! Якщо ви закачуєте дані нового користувача за допомогою SFTP, а задане вами значення «person_id» вже призначено іншому користувачу, новий користувач замінить наявного користувача в Apple School Manager. Коли дані буде перезаписано, оновити цього користувача можна буде лише за допомогою SFTP.
Деякі значення можуть бути порожніми. Наприклад, у файлі students.csv значення «по батькові» може бути порожнім.
Замініть дані з прикладу на власні.
Форматування
Буквенні значення, наприклад, пробіл або лапки в імені, необхідно екранувати, підставляючи перед ними зворотню косу риску (\). Ось приклад: \". Будь-які введені ідентифікатори мають бути буквено-цифровими й можуть містити дефіс (-).
Якщо значення містить пробіл ( ) або кому (,), використовуйте прямі лапки (") навколо нього. Якщо значення не містить жодного із цих спеціальних символів, не використовуйте лапки. Якщо лапки не використано там, де вони потрібні, або використано фігурні лапки, під час передавання ви отримаєте помилки.
Значення у ваших файлах .csv повинні розділятися комами (,) або крапкою з комою (;) незалежно від способу створення файлу. Не використовуйте пробіли або табуляцію між комою або крапкою з комою та наступним значенням. Кожен файл повинен бути закодований за стандартом UTF-8. Для відображення нового рядка використовуйте кодування нового рядка UNIX \n.
Усі посилання на зовнішні ключі до інших файлів .csv повинні бути визначені у файлі посилань.
Закачування
Якщо запис із попереднього завантаження відсутній, обліковий запис користувача деактивується та автоматично видаляється через 120 днів, за винятком таких випадків:
Користувач має роль, яка придбала програми або книги оптом
Користувач видаляється вручну до закінчення 120-денного періоду
Усі файли csv необхідно стиснути в один файл архіву (.zip) для передавання.
Не можна розміщувати файли в папці з файлом архіву .zip.
Обмеження символів у шаблонах .csv
Деякі поля в шаблонах .csv мають обмеження кількості дозволених символів.
Назва атрибута | Шаблони | Обмеження символів |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: студенти, персонал OneRoster: користувачі | 32 |
Apple: middle_name OneRoster: middleName | Apple: студенти, персонал OneRoster: користувачі | 32 |
Apple: last_name OneRoster: familyName | Apple: студенти, персонал OneRoster: користувачі | 64 |
Apple: grade_level OneRoster: grades | Apple: студенти OneRoster: користувачі | 64 |
Apple: email_address OneRoster: email | Apple: студенти OneRoster: користувачі | 256 |
Apple: person_number OneRoster: identifier | Apple: студенти, персонал OneRoster: користувачі | 64 |
Apple: person_id OneRoster: sourcedId | Apple: студенти, персонал, класи, розклади OneRoster: користувачі, класи, реєстрації | 256 |
Apple: sis_username OneRoster: username | Apple: студенти, персонал OneRoster: користувачі | 256 |
Apple: class_id OneRoster: sourcedID | Apple: класи, розклади OneRoster: класи, реєстрації | 256 |
Apple: class_number OneRoster: classCode | Apple: студенти, заняття OneRoster: класи | 64 |
Apple: course_id OneRoster: sourcedID | Apple: курси, заняття OneRoster: курси, заняття | 256 |
Apple: course_name OneRoster: title | Apple: курси OneRoster: курси | 128 |
Apple: course_number OneRoster: courseCode | Apple: курси OneRoster: курси | 64 |
Apple: location_name OneRoster: name | Apple: місцезнаходження OneRoster: установи | 256 |
Apple: location_id OneRoster: sourcedID | Apple: студенти, персонал, курси, заняття, місцезнаходження OneRoster: користувачі, курси, класи, установи | 256 |