Maklumat templat untuk mengimport rekod ke dalam Apple School Manager
Apple menyediakan enam templat untuk digunakan apabila menambah data ke lokasi anda:
Pelajar: Mengandungi maklumat akaun pelajar.
Kakitangan: Mengandungi maklumat akaun kakitangan, seperti pengajar.
Kursus: Mentakrifkan kursus.
Kelas: Mengandungi maklumat kursus, pengajar (kakitangan).
Jadual: Mengandungi maklumat kelas, pelajar dan lokasi.
Lokasi: Mengandungi maklumat lokasi.
Templat dan Apple ID Terurus
Jika medan yang bukan wajib—seperti person_number atau sis_username—sebahagian daripada format Apple ID Terurus, maka medan ini akan menjadi medan yang diperlukan. Jika anda membiarkannya kosong, muat naik SFTP akan gagal dengan ralat MANAGED_ID_GENERATION_FAILED.
Sediakan templat
Semasa menyediakan templat, kriteria berikut mesti dipenuhi:
Untuk templat students.csv dan staff.csv, person_id mestilah unik untuk semua lokasi.
Penting: Jika anda menggunakan SFTP untuk memuat naik pengguna baharu dan person_id yang anda untukkan telah pun diuntukkan kepada pengguna lain, pengguna baharu akan menulis ganti pengguna sedia ada dalam Apple School Manager. Selepas tulis ganti selesai, anda akan hanya boleh mengemas kini pengguna itu melalui SFTP.
Jika anda mengedit templat, gantikan contoh data dengan data anda sendiri. Jangan ubah kandungan baris pengatas dalam setiap fail. Jangan cipta lajur pendua dalam sebarang fail. Anda boleh menambahkan lajur kepada templat tertentu.
Dalam setiap templat, setiap baris mesti mewakili nilai unik. Contohnya, dalam fail students.csv, setiap baris mesti menjadi pelajar yang unik. Nilai tertentu untuk pelajar tersebut boleh dibiarkan kosong. Nilai literal—contohnya, garis putus atau tanda petikan dalam nama—mesti dipisahkan dengan garis belakang (\). Contohnya: \". Sebarang pengecam yang dimasukkan mestilah abjad angka dan boleh termasuk tanda sempang (-).
Jika nilai anda mengandungi ruang ( ) atau koma (,), gunakan tanda petikan lurus (") di sekelilingnya. Jika nilai anda tidak mempunyai aksara khas ini, jangan gunakan tanda petikan. Jika anda tidak menggunakan petikan di tempat ia diperlukan atau anda menggunakan petikan kerinting, anda akan mendapat ralat dalam proses muat naik.
Nilai dalam fail anda mesti dipisahkan dengan koma (,) atau koma bernoktah (;), tanpa mengira cara anda mencipta fail. Jangan gunakan ruang atau tab antara koma atau koma bernoktah dan nilai seterusnya. Setiap fail mesti dikodkan sebagai UTF‑8. Untuk mewakili baris akhir, gunakan baris baharu UNIX dengan kod \n.
Jika masukan daripada muat naik terdahulu tiada, akaun akan dinyahaktifkan dan dipadamkan secara automatik selepas 120 hari, melainkan akaun itu telah membeli kandungan pukal.
Nama fail .csv hendaklah sepadan dengan nama fail asal dengan tepat.
Semua fail mesti dimampatkan ke dalam satu fail arkib zip (.zip) untuk dimuat naik.
Tiada fail boleh diletakkan di dalam folder dalam fail arkib zip.
Semua rujukan kunci asing ke fail .csv lain mesti ditakrifkan dalam fail yang dirujuk.
Had aksara dalam templat .csv
Sesetengah medan dalam templat .csv mempunyai had pada bilangan aksara yang dibenarkan.
Medan | Templat | Had aksara |
---|---|---|
first_name | Pelajar, Kakitangan | 32 |
middle_name | Pelajar, Kakitangan | 32 |
last_name | Pelajar, Kakitangan | 64 |
grade_level | Pelajar | 64 |
email_address | Pelajar | 256 |
person_number | Pelajar, Kakitangan | 64 |
person_id | Pelajar, Kakitangan, Kelas, Jadual | 256 |
sis_username | Pelajar, Kakitangan | 256 |
class_id | Kelas, Jadual | 256 |
class_number | Kelas | 64 |
course_id | Kursus, Kelas | 256 |
course_name | Kursus | 128 |
course_number | Kursus | 64 |
location_name | Lokasi | 256 |
location_id | Pelajar, Kakitangan, Kursus, Kelas, Lokasi | 256 |