Sử dụng SFTP để tải dữ liệu của học sinh/sinh viên, nhân viên và lớp học lên Apple School Manager
Nếu hệ thống thông tin của học sinh/sinh viên (SIS) của bạn hiện không được Apple School Manager hỗ trợ hoặc bạn không có hệ thống thông tin của học sinh/sinh viên, bạn có thể tải dữ liệu của học sinh/sinh viên, nhân viên và lớp học lên Apple School Manager bằng cách sử dụng SFTP.
Thiết lập lần tải lên SFTP đầu tiên
Khi bạn thiết lập SFTP trong Trợ lý SIS/SFTP, Apple School Manager sẽ cung cấp cho bạn các tệp mẫu CSV và thông tin truy cập cho máy chủ SFTP riêng. Bạn có thể xuất dữ liệu từ một SIS được hỗ trợ hoặc tạo tệp trong ứng dụng bảng tính như Numbers. Trước khi bạn xuất từ SIS, hãy liên hệ với SIS để đảm bảo định dạng đó là chính xác cho Apple School Manager.
Bạn cần có ứng dụng của bên thứ ba trên macOS khi tải lên qua SFTP. Nếu chưa cài đặt ứng dụng khách SFTP, bạn có thể tìm thấy ứng dụng khách này trong Mac App Store.
Hãy sử dụng các nút bên dưới để được trợ giúp khi thiết lập tệp SFTP. Nếu bạn chưa sử dụng SFTP để tải dữ liệu lên Apple School Manager, bạn nên bắt đầu với phần Thiết lập lần tải lên SFTP đầu tiên.
Thiết lập lần tải lên SFTP đầu tiên
Đăng nhập vào Apple School Manager với tư cách là Quản trị viên, Người quản lý trang hoặc Người quản lý con người.
Bấm vào tên của bạn ở cuối thanh bên, bấm vào Tùy chọn > Tài khoản > Đồng bộ hóa thư mục, sau đó chọn Bật trong phần SIS/SFTP. Bạn phải xác minh miền
Bấm vào Tìm học sinh/sinh viên, giảng viên và lớp học.
/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
Bấm vào Thiết lập SFTP.
/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple School Manager tạo URL, tên người dùng và mật khẩu để sử dụng khi tải tệp lên. Hãy sử dụng thông tin này để định cấu hình ứng dụng khách SFTP.
/2022-asm-sftp-upload-data-sftp-info-step-5.png)
Bấm vào Tải mẫu về.
Đọc hướng dẫn sử dụng các mẫu trong phần “Điền vào tệp dữ liệu”.
Khi bạn đã điền vào tệp dữ liệu, hãy tạo một kho lưu trữ zip gồm cả sáu tệp. Trong Finder, bạn có thể chọn các tệp, sau đó chuyển đến menu Tệp và chọn Nén 6 mục. Việc bạn đặt tên cho kho lưu trữ zip là gì không quan trọng.
Hãy tải tệp zip lên Apple School Manager. Sử dụng ứng dụng khách SFTP để kết nối với URL hiển thị trong Trợ lý SIS/SFTP. Khi được yêu cầu cung cấp thông tin đăng nhập, hãy sử dụng tên người dùng và mật khẩu bạn đã nhận được khi bấm vào Thiết lập SFTP. Sao chép tệp zip vào thư mục dropbox.
Bấm vào Tiếp tục trong Trợ lý SIS/SFTP. Nếu nội dung bạn tải lên có lỗi, bạn có thể xem lại nhật ký xác định các tệp và dòng có lỗi. Sửa mọi lỗi trong tệp dữ liệu, sau đó lặp lại các bước 8 và 9. Bạn không cần xóa tệp trước đó khỏi máy chủ SFTP.
Khi nhập xong SFTP, hãy bấm vào Xem lại dữ liệu SFTP. Nếu bạn tìm thấy bất kỳ lỗi nào, hãy bấm vào Hủy. Sửa mọi lỗi trong tệp dữ liệu, sau đó lặp lại quá trình tải lên. Nếu dữ liệu đã chính xác và đầy đủ, hãy bấm vào Tiếp tục.
/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
Trong Tạo tài khoản và lớp học, hãy chọn định dạng ID Apple được quản lý cho học sinh/sinh viên, giáo viên/giảng viên và nhân viên. Bấm vào Xem trước tài khoản và lớp học. Khi các ID ở đúng định dạng, hãy bấm vào Tạo tài khoản và lớp học. Bạn chỉ có thể sử dụng các miền đã xác minh
/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
Sau khi tạo tài khoản, hãy phân phối thông tin đăng nhập cho người dùng và chỉ định vai trò cho nhân viên.
/2022-asm-sftp-upload-data-done-step-13.png)
Điền vào tệp dữ liệu
Nội dung tải về mẫu bao gồm sáu tệp giá trị được phân tách bằng dấu phẩy (CSV) cho Lớp học, Khóa học, Vị trí, Bảng phân công, Học sinh/sinh viên và Nhân viên. Nếu các mẫu không có sẵn trong Apple School Manager hoặc nếu bạn bị mất bản sao của các mẫu gốc, bạn có thể tải chúng về lần nữa.
Bạn có thể sử dụng SIS để xuất dữ liệu ở định dạng được mô tả trong các mẫu và bài viết này, hoặc bạn có thể sửa mẫu trong một chương trình bảng tính, chẳng hạn như Numbers.
Hãy sử dụng các bảng trong bài viết này để đảm bảo rằng bạn nhập thông tin chính xác, sau đó lưu từng tệp mà không thay đổi tên tệp.
Định dạng giá trị
Nếu bạn sửa mẫu, hãy thay thế dữ liệu của mẫu bằng dữ liệu của riêng bạn. Không thay đổi nội dung của các ô tiêu đề trong mỗi tệp. Không thêm cột trong bất kỳ tệp nào, ngoại trừ như được mô tả bên dưới.
Trong mọi mẫu, mỗi hàng phải đại diện cho một giá trị duy nhất. Ví dụ: trong student.csv, mỗi hàng phải là một học sinh/sinh viên duy nhất. Các giá trị nhất định cho học sinh/sinh viên đó có thể để trống. Các giá trị văn tự như dấu ngắt dòng hoặc ký tự dấu ngoặc kép trong tên phải được thoát bằng dấu gạch chéo ngược (\), như (\”). Mọi mã nhận dạng được nhập phải là chữ và số và có thể bao gồm một dấu "-".
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 giá trị đó. Nếu giá trị không có bất kỳ ký tự đặc biệt nào trong số này, 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 nơi cần thiết hoặc bạn sử dụng dấu ngoặc kép cong, thì 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 như thế nào. Không sử dụng dấu cách hoặc tab giữa một dấu phẩy hoặc dấu chấm phẩy và giá trị tiếp theo. Mỗi tệp phải được mã hóa dưới dạng UTF-8 và sử dụng dòng mới Unix (\n).
Nếu một trường tùy chọn khác như person_number hoặc sis_username là một phần của định dạng ID Apple được quản lý, thì trường đó sẽ trở thành trường bắt buộc. Nếu bạn để trống trường đó, quá trình tải lên sẽ không thành công và có lỗi MANAGED_ID_GENERATION_FAILED.
Tệp Vị trí
location_id | Mã nhận dạng duy nhất được tạo bằng số và/hoặc chữ cái không chứa dấu cách. | Bắt buộc |
location_name | Tên địa điểm. | Bắt buộc |
Bạn phải xác định ít nhất một vị trí trong tệp Vị trí. Bạn không thể sử dụng SFTP để tạo tài khoản học sinh/sinh viên hoặc nhân viên ở địa điểm chính là "trụ sở chính".
Tệp Học sinh/sinh viên
Nếu bạn sử dụng SFTP để tải lên một người mới và person_id mà bạn chỉ định đã tồn tại trong Apple School Manager, thì người 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 đó qua SFTP.
person_id | Mã nhận dạng duy nhất cho một học sinh/sinh viên cụ thể. person_id này phải khớp với mã nhận dạng duy nhất trong SIS, nếu có. person_id này là mã nhận dạng duy nhất cho học sinh/sinh viên trong Apple School Manager. Hãy sử dụng giá trị này để chỉ học sinh/sinh viên trong tệp Bảng phân công và giáo viên/giảng viên trong tệp Lớp học. | Bắt buộc |
person_number | Một giá trị khác có thể xác định một học sinh/sinh viên trong trường. Đây có thể là mã nhận dạng học sinh/sinh viên. | Không bắt buộc |
first_name | Tên của học sinh/sinh viên. | Bắt buộc |
middle_name | Tên đệm của học sinh/sinh viên. | Không bắt buộc |
last_name | Họ của học sinh/sinh viên. | Bắt buộc |
grade_level | Cấp lớp của học sinh/sinh viên. | Không bắt buộc |
email_address* | Địa chỉ email của học sinh/sinh viên. | Không bắt buộc |
sis_username | Tên người dùng của học sinh/sinh viên trong SIS. | Không bắt buộc |
password_policy | Sử dụng trường password_policy để chỉ định chính sách mật khẩu cho từng học sinh/sinh viên cụ thể. Trường password_policy phải có số 4, số 6, số 8 hoặc để trống. Nếu bạn chọn 8, đây sẽ là chính sách mật khẩu tiêu chuẩn (8+ ký tự chữ và số). Giá trị này ghi đè chính sách mật khẩu vị trí và mọi chính sách mật khẩu bạn đã đặt trước đó cho học sinh/sinh viên đó. Nếu bạn để trống password_policy, chính sách mật khẩu mặc định cho vị trí sẽ được sử dụng cho học sinh/sinh viên mới và không có thay đổi nào được thực hiện đối với học sinh/sinh viên hiện tại. | Không bắt buộc |
location_id | location_id cho học sinh/sinh viên. Giá trị này phải tương ứng với một location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên. | Bắt buộc |
* Nếu bật tính năng xác thực có liên kết Nếu địa chỉ email nằm trong miền được liên kết, thì tài khoản người dùng sẽ được liên kết.
Chỉ định nhiều vị trí
Bạn có thể chỉ định nhiều vị trí cho một học sinh/sinh viên bằng cách thêm nhiều cột vị trí hơn vào tệp Học sinh/sinh viên. Bạn có thể thêm tối đa 998 cột vị trí có tên là location_id_2, location_id_3, đến location_id_999. Đối với mỗi học sinh/sinh viên, bạn có thể nhập location_id khác vào mỗi cột này, nếu muốn. Giá trị này phải tương ứng với một location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên.
Tệp Nhân viên
Nếu bạn sử dụng SFTP để tải lên một người mới và person_id mà bạn chỉ định đã tồn tại trong Apple School Manager, thì người 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 đó qua SFTP. Tất cả nhân viên đều nhận được chính sách mật khẩu tiêu chuẩn (8+ ký tự chữ và số).
person_id | Mã nhận dạng duy nhất cho một mã nhân viên cụ thể. person_id này phải khớp với mã nhận dạng duy nhất trong SIS, nếu có. person_id này là mã nhận dạng duy nhất cho mã nhân viên trong Apple School Manager. Hãy sử dụng giá trị này để tham chiếu đến giáo viên/giảng viên trong tệp Lớp học. | Bắt buộc |
person_number | Một giá trị khác có thể xác định một nhân viên trong trường. Đây có thể là số huy hiệu của nhân viên. | Không bắt buộc |
first_name | Tên nhân viên. | Bắt buộc |
middle_name | Tên đệm của nhân viên. | Không bắt buộc |
last_name | Họ của nhân viên. | Bắt buộc |
email_address* | Địa chỉ email của nhân viên này. | Không bắt buộc |
sis_username | Tên người dùng của nhân viên trong SIS. | Không bắt buộc |
location_id | location_id cho nhân viên. Giá trị này phải tương ứng với một location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên. | Bắt buộc |
* Nếu bật tính năng xác thực có liên kết Nếu địa chỉ email nằm trong miền được liên kết, thì tài khoản người dùng sẽ được liên kết.
Chỉ định nhiều vị trí
Bạn có thể chỉ định nhiều vị trí cho một nhân viên bằng cách thêm nhiều cột vị trí vào tệp Nhân viên. Bạn có thể thêm tối đa 998 cột vị trí có tên là location_id_2, location_id_3, đến location_id_999. Đối với mỗi nhân viên, bạn có thể nhập location_id khác vào mỗi cột này, nếu muốn. Giá trị này phải tương ứng với một location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên.
Tệp Khóa học
course_id | Mã nhận dạng duy nhất cho khóa học. Mã này phải khớp với course_id tương ứng được sử dụng trong tệp Lớp học. | Bắt buộc |
course_number | Mã cho khóa học. Mã này có thể là mã khóa học trong SIS hoặc hướng dẫn chương trình giảng dạy. | Không bắt buộc |
course_name | Tên khóa học. | Không bắt buộc |
location_id | location_id cho khoá học. Giá trị này phải tương ứng với một location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên. | Bắt buộc |
Tệp Lớp học
class_id | Mã nhận dạng duy nhất cho lớp học. | Bắt buộc |
class_number | Một số hoặc mã xác định lớp này trong tổ chức. Không giống như class_id, class_number không được sử dụng để chỉ lớp này trong bảng phân công ở định dạng CSV. | Không bắt buộc |
course_id | course_id của khóa học có lớp này. Giá trị này phải khớp với course_id trong tệp Khóa học. | Bắt buộc |
instructor_id | person_id cho giáo viên/giảng viên. Giá trị này phải khớp với person_id được sử dụng trong tệp Nhân viên. | Không bắt buộc |
instructor_id_2 | person_id cho giáo viên/giảng viên. Giá trị này phải khớp với person_id được sử dụng trong tệp Nhân viên. | Không bắt buộc |
instructor_id_3 | person_id cho giáo viên/giảng viên. Giá trị này phải khớp với person_id được sử dụng trong tệp Nhân viên. | Không bắt buộc |
location_id | location_id cho lớp học. Giá trị này phải tương ứng với location_id trong tệp Vị trí. Nếu mục nhập này không khớp với mục nhập trong tệp Vị trí, thì bạn sẽ gặp sự cố trong quá trình tải lên. | Bắt buộc |
Chỉ định nhiều giáo viên/giảng viên
Bạn có thể chỉ định nhiều hơn ba giáo viên/giảng viên cho một lớp học bằng cách thêm nhiều cột giáo viên/giảng viên hơn vào tệp Lớp học. Bạn có thể thêm tối đa 12 cột giáo viên/giảng viên khác có tên là instructor_id_4, instructor_id_5, đến instructor_id_15. Đối với mỗi lớp, bạn có thể nhập một person_id khác cho giáo viên/giảng viên, nếu muốn. Giá trị này phải khớp với person_id được sử dụng trong tệp Nhân viên.
Tệp Bảng phân công
roster_id | Mã nhận dạng duy nhất cho bảng phân công trong SIS hoặc cơ sở dữ liệu của khóa học khác (nếu có). | Bắt buộc |
class_id | Mã nhận dạng ở dạng chữ và số duy nhất cho lớp học. Mã này phải khớp với class_id trong tệp Lớp học. | Bắt buộc |
student_id | person_id cho một học sinh. | Bắt buộc |
Tệp Bảng phân công được sử dụng để thêm học sinh/sinh viên vào lớp học của họ. Mỗi dòng trong tệp phải có một roster_id duy nhất và chỉ chứa một class_id và một person_id.
Cập nhật tệp
Khi bạn muốn thêm hoặc sửa học sinh/sinh viên, nhân viên và lớp học, hãy sửa tệp dữ liệu và tải lên các bản sao mới. Bất cứ khi nào tải tệp lên, bạn phải tải lên cả sáu tệp và mỗi tệp phải chứa danh sách đầy đủ của từng danh mục, chứ không chỉ các mục bạn định thêm. Bạn có thể kiểm tra thông tin tài khoản SFTP bằng cách chọn Cài đặt > Nguồn dữ liệu.
Nếu bạn ngắt kết nối SFTP trong Apple School Manager, tài khoản và lớp học sẽ chuyển sang thủ công. Để giải quyết vấn đề này, hãy khôi phục kết nối SFTP và thực hiện một lượt tải lên mới.
Sau lần tải lên đầu tiên, các tài khoản và lớp học mới sẽ được tạo tự động khi bạn tải lên. Nếu có bất kỳ lỗi nào, Apple School Manager sẽ gửi cho bạn một email.
Nếu mục nhập từ lần tải lên trước đó bị thiếu
Nếu mục nhập từ lần tải lên trước đó bị thiếu, thì 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 khối lượng lớn.
Nếu một khóa học hoặc một lớp học bị xóa
Nếu một khóa học hoặc một lớp học bị xóa khỏi phần tải lên, học sinh/sinh viên sẽ bị xóa khỏi lớp học và nguồn sẽ chuyển thành Thủ công. Nếu các khóa học đã được sử dụng trong Schoolwork, bảng phân công sẽ bị xóa và bạn phải tạo một khóa học mới để đăng ký lại. Nếu các lớp học được sử dụng trong Schoolwork, dữ liệu tiến trình sẽ tự động bị xóa và không hiển thị với giáo viên hoặc học sinh/sinh viên nữa.
Các khóa học và lớp học có nguồn thủ công tiếp tục đồng bộ hóa với giải pháp MDM của bạn, nhưng có thể không còn xuất hiện trong ứng dụng Classroom nữa. Có thể xóa các lớp học thủ công trong Apple School Manager nếu bạn muốn xóa chúng khỏi chế độ đồng bộ hóa.
Apple không đề xuất hay chứng thực thông tin về các sản phẩm không do Apple sản xuất hoặc các trang web độc lập không chịu sự kiểm soát hay kiểm tra của Apple. Apple không chịu trách nhiệm về việc lựa chọn, hiệu suất hay việc sử dụng trang web hoặc sản phẩm của bên thứ ba. Apple không đưa ra tuyên bố nào về tính chính xác hay độ tin cậy của trang web bên thứ ba. Liên lạc với nhà cung cấp để biết thêm thông tin.
