Інформація про шаблони для імпорту записів в Apple School Manager
Apple надає шість шаблонів, які можна використовувати під час додавання даних до місцезнаходження:
Студенти: містить інформацію про облікові записи студентів.
Персонал: містить інформацію про облікові записи членів персоналу, як-от викладачів.
Курси: визначає курси.
Заняття: містить інформацію про курс, викладача (члена персоналу).
Розклади: містить інформацію про заняття, студента та місцезнаходження.
Місцезнаходження: містить інформацію про місцезнаходження.
Шаблони та керовані ідентифікатори Apple ID
Якщо необов’язкове поле, як-от person_number (номер особи) або sis_username (ім’я користувача 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 днів, якщо обліковий запис не придбав контент оптом.
Назви файлів .csv мають точно збігатися з оригінальними назвами файлів.
Усі файли потрібно стиснути в один файл архіву (.zip) для закачування.
Не можна розміщувати файли в папці з файлом архіву .zip.
Усі посилання на зовнішні ключі до інших файлів .csv мають бути визначені у файлі посилань.
Обмеження символів у шаблонах .csv
Деякі поля в шаблонах .csv мають обмеження кількості дозволених символів.
Поле | Шаблони | Обмеження символів |
---|---|---|
first_name | Студенти, персонал | 32 |
middle_name | Студенти, персонал | 32 |
last_name | Студенти, персонал | 64 |
grade_level | Студенти | 64 |
email_address | Студенти | 256 |
person_number | Студенти, персонал | 64 |
person_id | Студенти, персонал, заняття, розклади | 256 |
sis_username | Студенти, персонал | 256 |
class_id | Заняття, розклади | 256 |
class_number | Заняття | 64 |
course_id | Курси, заняття | 256 |
course_name | Курси | 128 |
course_number | Курси | 64 |
location_name | Місцезнаходження | 256 |
location_id | Студенти, персонал, курси, заняття, місцезнаходження | 256 |