Інформація про шаблони для імпортування даних в Apple School Manager
Щоб додати дані до Apple School Manager, вам потрібно використовувати файли шаблонів у форматі .csv від Apple чи OneRoster.
Назви шаблонів .csv Apple: студенти, персонал, курси, заняття, розклади, місцезнаходження
Назви шаблонів .csv OneRoster. користувачі, курси, заняття, реєстрації, установи
Ім’я файлу Apple | Ім’я файлу OneRoster | Вміст | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: містить інформацію про облікові записи студентів. OneRoster: містить інформацію про облікові записи студентів, викладачів і членів персоналу. | |||||||||||
Н/д | Містить інформацію про облікові записи членів персоналу, як-от викладачів. | ||||||||||
Містить інформацію про курс. | |||||||||||
Містить інформацію про заняття та викладачів (персонал). | |||||||||||
Містить інформацію про заняття, студентів і місцезнаходження (розклад). | |||||||||||
Містить інформацію про місцезнаходження (навчального закладу або відділу). | |||||||||||
Шаблони та керовані ідентифікатори Apple ID
Якщо необовʼязкове поле, як‑от person_number (номер особи) або sis_username (імvя користувача sis), є частиною формату керованого Apple ID, воно стає обовʼязковим. Якщо залишити його пустим, закачування SFTP завершиться з помилкою «MANAGED_ID_GENERATION_FAILED» (не вдалося згенерувати керований ідентифікатор).
Підготовка шаблонів
Під час підготовки шаблону необхідно дотримуватися наведених нижче критеріїв.
Для шаблонів students.csv та staff.csv значення person_id (ідентифікатор особи) має бути унікальним для всіх місцезнаходжень.
Важливо! Якщо ви закачуєте дані нового користувача за допомогою SFTP, а задане вами значення «person_id» вже призначено іншому користувачу, новий користувач замінить наявного користувача в Apple School Manager. Коли дані буде замінено, оновити цього користувача можна буде лише за допомогою SFTP.
Якщо ви редагуєте шаблони, замініть дані прикладів власними даними. Не змінюйте вміст рядка заголовка в кожному файлі. Не створюйте дубльовані стовпці в будь-якому файлі. Ви можете додати стовпці до конкретних шаблонів.
У шаблонах кожен рядок має відображати унікальне значення. Наприклад, у файлі students.csv кожен рядок має бути унікальним студентом. Певні значення для цього студента можуть бути порожніми. Буквенні значення, наприклад, пробіл або лапки в імені, слід екранувати, підставляючи перед ними зворотню косу риску (\). Ось приклад: \". Будь-які введені ідентифікатори мають бути буквено-цифровими та можуть містити дефіс (-).
Якщо значення містить пробіл ( ) або кому (,), використовуйте прямі лапки (") навколо нього. Якщо значення не містить жодного з цих спеціальних символів, не використовуйте лапки. Якщо лапки не використано там, де вони потрібні, або використано фігурні лапки, під час закачування ви отримаєте помилки.
Значення у ваших файлах повинні розділятися комами (,) або крапкою з комою (;) незалежно від способу створення файлу. Не використовуйте пробіли або табуляцію між комою або крапкою з комою та наступним значенням. Кожен файл повинен бути закодований за стандартом UTF-8. Для відображення нового рядка використовуйте кодування нового рядка UNIX \n.
Якщо запис із попереднього завантаження відсутній, обліковий запис користувача деактивується та автоматично видаляється через 120 днів, за винятком таких випадків:
Користувач має роль, яка придбала програми або книги оптом.
Користувач видаляється вручну до закінчення 120-денного періоду.
Назви файлів .csv мають точно збігатися з оригінальними назвами файлів.
Усі файли потрібно стиснути в один файл архіву (.zip) для закачування.
Не можна розміщувати файли в папці з файлом архіву .zip.
Усі посилання на зовнішні ключі до інших файлів .csv мають бути визначені у файлі посилань.
Обмеження символів у шаблонах .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 |