Maklumat templat untuk mengimport data ke dalam Apple School Manager
Untuk menambahkan data pada Apple School Manager, anda boleh menggunakan fail .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 Akaun Apple Terurus
Jika medan yang bukan wajib—seperti person_number atau sis_username—sebahagian daripada format Akaun Apple 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 hendaklah dipenuhi:
Struktur
Nama fail .csv hendaklah sepadan dengan nama fail asal dengan tepat.
Jangan ubah kandungan baris pengepala dalam setiap fail.
Jangan padamkan lajur, walaupun lajur kosong.
Anda boleh menambahkan lajur pada templat pelajar, kakitangan dan kelas.
Dalam setiap templat, setiap baris perlu mewakili nilai unik. Contohnya, dalam fail students.csv, setiap baris hendaklah pelajar yang unik.
Untuk templat students.csv dan staff.csv, person_id hendaklah 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 hanya boleh mengemas kini pengguna itu melalui SFTP.
Nilai tertentu boleh kosong. Contohnya, dalam fail students.csv, nama tengah boleh kosong.
Gantikan data contoh dengan data anda sendiri.
Pemformatan
Nilai literal—contohnya, garis pemisah atau tanda petikan dalam nama—perlu dipisahkan dengan garis miring balik (\). Contohnya: \". Mana-mana pengecam yang dimasukkan hendaklah abjad angka dan boleh menyertakan tanda sempang (-).
Jika nilai anda mengandungi ruang ( ) atau koma (,), gunakan tanda petikan lurus (") di sekeliling nilai. Jika nilai anda tiada aksara khas ini, jangan gunakan tanda petikan. Jika anda tidak menggunakan tanda petikan di tempat tanda diperlukan atau anda menggunakan tanda petikan ikal, anda akan mengalami ralat dalam proses muat naik.
Nilai dalam fail .csv anda perlu dipisahkan dengan koma (,) atau koma bernoktah (;), tanpa mengira cara anda mencipta fail. Jangan gunakan ruang atau tab di antara koma atau koma bernoktah dan nilai seterusnya. Setiap fail perlu dikodkan sebagai UTF-8. Untuk mewakili penghujung baris, gunakan kod baris baharu UNIX iaitu \n.
Semua rujukan kunci asing kepada fail .csv lain perlu ditakrifkan dalam fail yang dirujuk.
Memuat naik
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 dipadamkan secara manual sebelum had 120 hari
Semua fail .csv perlu dimampatkan menjadi satu fail arkib zip (.zip) untuk dimuat naik.
Tiada fail boleh diletakkan di dalam folder dalam fail arkib zip.
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 |