Thông Tin Mẫu Để Nhập Hồ Sơ Vào Apple School Manager
Apple cung cấp sáu mẫu để sử dụng khi thêm dữ liệu vào vị trí của bạn:
Học sinh/sinh viên: Gồm thông tin về tài khoản của học sinh/sinh viên.
Nhân viên: Gồm thông tin về tài khoản nhân viên, ví dụ: giáo viên/giảng viên.
Khóa học: Xác định các khóa học.
Lớp học: Gồm thông tin về khóa học, giáo viên/giảng viên.
Bảng phân công: Gồm thông tin về lớp học, về học sinh/sinh viên, và vị trí.
Vị trí: Gồm thông tin về vị trí.
Mẫu và ID Apple Được Quản Lý
Nếu ô tùy chọn, chẳng hạn như person_number hoặc sis_username, nằm trong định dạng ID Apple Được Quản Lý của bạn, thì ô đó sẽ trở thành ô bắt buộc. Nếu bạn để trống, quá trình tải lên SFTP sẽ thất bại với lỗi MANAGED_ID_GENERATION_FAILED.
Chuẩn Bị Mẫu
Khi chuẩn bị mẫu, phải đáp ứng các tiêu chí sau:
Đối với các mẫu student.csv và staff.csv, person_id phải là duy nhất với tất cả vị trí.
Quan trọng: Nếu bạn sử dụng SFTP để tải người dùng mới lên và person_id bạn chỉ định đã được chỉ định cho một người dùng khác, thì người dùng mới sẽ ghi đè người dùng hiện có trong Apple School Manager. Sau khi quá trình ghi đè hoàn tất, bạn chỉ có thể cập nhật người dùng đó thông qua SFTP.
Nếu bạn sửa mẫu, hãy thay thế dữ liệu mẫu bằng dữ liệu của riêng bạn. Không thay đổi nội dung của hàng tiêu đề trong mỗi tệp. Không tạo các cột giống nhau trong bất kỳ tệp nào. Bạn có thể thêm cột vào các mẫu cụ thể.
Trong từng mẫu, mỗi hàng phải đại diện cho một giá trị độc nhất. Ví dụ: trong tệp student.csv, mỗi hàng phải là một học sinh/sinh viên duy nhất. Một số giá trị cho học sinh/sinh viên đó có thể bỏ trống. Các giá trị ký tự, ví dụ như dấu ngắt dòng hoặc dấu ngoặc kép trong tên phải có dấu gạch ngược (\) đi trước. Dưới đây là một ví dụ: \". Bất kỳ mã nhận dạng nào được nhập phải ở dạng chữ và số và có thể bao gồm dấu gạch nối (-).
Nếu giá trị chứa dấu cách ( ) hoặc dấu phẩy (,), hãy sử dụng dấu ngoặc kép thẳng (") xung quanh. Nếu giá trị không có bất kỳ ký tự đặc biệt nào, không sử dụng dấu ngoặc kép. Nếu bạn không sử dụng dấu ngoặc kép ở những vị trí cần thiết hoặc bạn sử dụng dấu ngoặc kép tròn, bạn sẽ gặp lỗi trong quá trình tải lên.
Các giá trị trong tệp phải được phân tách bằng dấu phẩy (,) hoặc dấu chấm phẩy (;), bất kể bạn đã tạo tệp bằng cách nào. Không sử dụng dấu cách hoặc tab giữa dấu phẩy hoặc dấu chấm phẩy và giá trị tiếp theo. Mỗi tệp đều phải được mã hóa dưới dạng UTF-8. Để hiển thị kết thúc một dòng, hãy dùng mã hóa UNIX cho dòng mới \n.
Nếu thiếu mục nhập từ lần tải lên trước đó, tài khoản sẽ bị hủy kích hoạt và tự động bị xóa sau 120 ngày, trừ phi tài khoản đã mua nội dung số lượng lớn.
Tên của các tệp.csv phải trùng khớp chính xác với tên tệp gốc.
Để tải lên, tất cả các tệp phải được nén thành một tệp lưu trữ dạng nén (.zip).
Không thể đặt tệp nào vào thư mục trong tệp lưu trữ dạng nén.
Tất cả các tham chiếu khóa ngoài đến các tệp .csv khác phải được xác định trong tệp được tham chiếu.
Giới hạn ký tự trong các mẫu .csv
Một số trường trong mẫu .csv có giới hạn về số lượng ký tự được phép sử dụng.
Trường | Mẫu | Giới hạn ký tự |
---|---|---|
first_name (tên) | Học sinh/Sinh viên, Nhân viên | 32 |
middle_name (tên đệm) | Học sinh/Sinh viên, Nhân viên | 32 |
last_name (họ) | Học sinh/Sinh viên, Nhân viên | 64 |
grade_level (cấp lớp) | Học sinh/Sinh viên | 64 |
email_address (địa chỉ email) | Học sinh/Sinh viên | 256 |
person_number (mã số cá nhân) | Học sinh/Sinh viên, Nhân viên | 64 |
person_id (ID cá nhân) | Học sinh/Sinh viên, Nhân viên, Lớp, Bảng phân công | 256 |
sis_username (tên người dùng SIS) | Học sinh/Sinh viên, Nhân viên | 256 |
class_id (ID lớp) | Lớp, Bảng phân công | 256 |
class_number (mã số lớp) | Lớp | 64 |
course_id (ID khóa học) | Khóa học, Lớp | 256 |
course_name (tên khóa học) | Khóa học | 128 |
course_number (mã số khóa học) | Khóa học | 64 |
location_name (tên vị trí) | Vị trí | 256 |
location_id (ID vị trí) | Học sinh/Sinh viên, Nhân viên, Khóa học, Lớp, Vị trí | 256 |