Maklumat templat untuk mengimport data ke dalam Apple School Manager
Untuk menambahkan data pada Apple School Manager, anda boleh menggunakan fail templat .csv yang diformatkan oleh Apple atau OneRoster.
Nama templat .csv Apple: Pelajar, Kakitangan, Kursus, Kelas, Jadual, Lokasi
Nama templat .csv OneRoster: Pengguna, Kursus, Kelas, Pendaftaran, Organisasi
Nama fail Apple | Nama fail OneRoster | Kandungan | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Mengandungi maklumat akaun pelajar. OneRoster: Mengandungi maklumat akaun pelajar, pengajar dan kakitangan. | |||||||||||
T/B | Mengandungi maklumat akaun kakitangan seperti pengajar. | ||||||||||
Mengandungi maklumat kursus. | |||||||||||
Mengandungi maklumat kelas dan pengajar (kakitangan). | |||||||||||
Mengandungi maklumat kelas, pelajar dan lokasi (jadual). | |||||||||||
Mengandungi maklumat lokasi (sekolah atau jabatan). | |||||||||||
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 tugaskan telah ditugaskan 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 kemasukan daripada muat naik terdahulu hilang, akaun pengguna akan dinyahaktifkan dan dipadam secara automatik selepas 120 hari, melainkan:
Pengguna mempunyai peranan yang membeli app atau buku secara pukal.
Pengguna dipadam secara manual sebelum had 120 hari.
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.
Nama atribut | Templat | Had aksara |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Pelajar, Kakitangan OneRoster: Pengguna | 32 |
Apple: middle_name OneRoster: middleName | Apple: Pelajar, Kakitangan OneRoster: Pengguna | 32 |
Apple: last_name OneRoster: familyName | Apple: Pelajar, Kakitangan OneRoster: Pengguna | 64 |
Apple: grade_level OneRoster: gred | Apple: Pelajar OneRoster: Pengguna | 64 |
Apple: email_address OneRoster: e-mel | Apple: Pelajar OneRoster: Pengguna | 256 |
Apple: person_number OneRoster: pengecam | Apple: Pelajar, Kakitangan OneRoster: Pengguna | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Pelajar, Kakitangan, Kelas, Jadual OneRoster: Pengguna, Kelas, Pendaftaran | 256 |
Apple: sis_username OneRoster: nama pengguna | Apple: Pelajar, Kakitangan OneRoster: Pengguna | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Kelas, Jadual OneRoster: Kelas, Pendaftaran | 256 |
Apple: class_number OneRoster: classCode | Apple: Pelajar, Kelas OneRoster: Kelas | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Kursus, Kelas OneRoster: Kursus, Kelas | 256 |
Apple: course_name OneRoster: tajuk | Apple: Kursus OneRoster: Kursus | 128 |
Apple: course_number OneRoster: courseCode | Apple: Kursus OneRoster: Kursus | 64 |
Apple: location_name OneRoster: nama | Apple: Lokasi OneRoster: Organisasi | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Pelajar, Kakitangan, Kursus, Kelas, Lokasi OneRoster: Pengguna, Kursus, Kelas, Organisasi | 256 |