Google Lớp học hỗ trợ tính năng nhập danh sách và đồng bộ hoá sổ điểm cho một số Hệ thống thông tin học sinh (SIS) tuân thủ OneRoster. Google hợp tác với các nền tảng SIS đáp ứng các yêu cầu của OneRoster do Google chỉ định.
Hình 1. Khi Hệ thống thông tin học sinh (SIS) hợp tác với Lớp học, quản trị viên có thể chọn SIS trong trình đơn thả xuống.
Hành trình làm quen với đối tác SIS
Sau đây là thông tin tổng quan ngắn gọn về quy trình tham gia của đối tác SIS:
Bày tỏ sự quan tâm: Nếu bạn muốn hợp tác với Lớp học, hãy điền vào biểu mẫu bày tỏ sự quan tâm.
Khám phá và chạy các bài kiểm thử mức độ tuân thủ: Để biết SIS của bạn đã sẵn sàng tích hợp với Lớp học hay chưa, bạn có thể xem lại các bài kiểm thử mức độ tuân thủ để làm quen với các yêu cầu của Google. Bạn có thể chạy các bài kiểm thử mức độ tuân thủ trước khi bày tỏ sự quan tâm với nhóm Google Lớp học để xác định mức độ đáp ứng của sản phẩm đối với các yêu cầu của Google.
Kết nối với nhóm Google Lớp học: Nhóm Lớp học sẽ liên hệ với bạn sau khi bạn gửi biểu mẫu bày tỏ sự quan tâm nếu có cơ hội hợp tác.
Chia sẻ kết quả kiểm tra và xây dựng quy trình tích hợp toàn diện: Sau khi nhóm Lớp học liên hệ với bạn, hãy chia sẻ kết quả kiểm tra mức độ tuân thủ. Nhóm của bạn sẽ làm việc với Google để xác thực và hoàn tất quá trình tích hợp.
Kiểm thử mức độ tuân thủ
Các bài kiểm tra mức độ tuân thủ do Google xác định giúp các đối tác SIS xác định xem sản phẩm của họ có đáp ứng các yêu cầu của Google về việc sử dụng OneRoster hay không, đồng thời giảm thiểu lỗi mà người dùng có thể gặp phải khi sử dụng các tính năng tích hợp SIS trong Lớp học. Các bài kiểm thử được xuất bản trên GitHub.
Truy cập và chạy chương trình kiểm thử
Để chạy kiểm thử, bạn cần có những điều sau:
- URL mã thông báo để truy xuất thông tin đăng nhập OAuth 2.0
- URL OneRoster kết thúc bằng
/ims/oneroster/v1p2 - Mã ứng dụng khách
- Khoá bí mật của ứng dụng khách
- Địa chỉ email của giáo viên
Bạn có thể chạy các chương trình kiểm thử bằng Google Colab hoặc sổ tay Jupyter. Cả Colab và sổ ghi chú Jupyter đều cho phép bạn chạy tất cả các bài kiểm thử cùng một lúc. Việc này giúp bạn tạo kết quả kiểm thử để chia sẻ với nhóm Google Lớp học.
Yêu cầu và hành vi dự kiến
Hãy đọc kỹ các điểm sau đây về bài kiểm tra. Trong GitHub, mỗi bài kiểm tra đều có một tiêu đề được tham chiếu trong bảng. Những gợi ý này có thể giúp làm rõ các câu hỏi, nhưng đây không phải là danh sách đầy đủ các bài kiểm tra. Hãy đảm bảo bạn đã chạy tất cả các kiểm thử được cung cấp trong GitHub để đảm bảo sự tuân thủ.
| Thử nghiệm | Con trỏ |
|---|---|
| Teachers: GetAllTeachers | Điểm cuối GET /teachers được gọi bằng tham số truy vấn limit. Trong các lần kiểm thử tiếp theo, tham số này được dùng để đảm bảo rằng sản phẩm của bạn có thể hỗ trợ kích thước trang là 10.000. |
| Giáo viên: GetAllTeachers có bộ lọc email | Điểm cuối GET /teachers được gọi bằng tham số truy vấn filter dùng để lọc dựa trên địa chỉ email của giáo viên. Thao tác này sẽ sử dụng địa chỉ email của giáo viên mà bạn đã cung cấp trong phần Thông tin đăng nhập của bài kiểm tra. |
| Lớp học: GetClassesForTeacher | Điểm cuối /teachers/{teacher_sourced_id}/classes được gọi bằng tham số truy vấn filter dùng để lọc dựa trên các lớp học đang hoạt động. |
| Học viên: GetStudentsForClass | Điểm cuối GET /classes/{class_sourced_id}/students được gọi. Email của học viên phải được trả về trong phản hồi. |
| GetGradingPeriodsForTerm | Tính năng hỗ trợ giai đoạn chấm điểm được kiểm thử bằng term_sourced_id. term_sourced_id này được dùng để truy xuất các giai đoạn chấm điểm trong học kỳ bằng cách gọi điểm cuối GET /terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | Bạn không cần phải có giai đoạn chấm điểm khi gọi PUT /lineItems/{line_item_sourced_id}. |
| Mục hàng: Chỉnh sửa | Lệnh gọi API không được trả về lỗi nếu tiêu đề bài tập dài. Bài kiểm tra có tiêu đề dài hơn 100 ký tự. |
| Kết quả: Chỉnh sửa | Bạn có thể đặt score thành một giá trị lớn hơn resultValueMax để thể hiện điểm cộng. |
| Kết quả: Xoá | Bạn phải có điểm cuối DELETE /results/{result_sourced_id}. |
| LineItem (Không bắt buộc/Dọn dẹp): Delete và Get | Bạn không bắt buộc phải có điểm cuối DELETE /lineItems/{line_item_sourced_id}. Đây là trường không bắt buộc và được dùng để dọn dẹp dữ liệu. Điểm cuối GET /classes/{class_sourced_id}/lineItems tiếp theo cũng không bắt buộc và kiểm tra xem mục hàng đã bị xoá hay chưa. |
Chia sẻ kết quả kiểm tra với nhóm Google Lớp học
Sau khi bạn chạy các chương trình kiểm thử, một báo cáo đầy đủ về kết quả của từng chương trình kiểm thử sẽ được tạo. Kết quả này được dùng để xác định xem sản phẩm của bạn có đáp ứng các yêu cầu của Google về việc sử dụng OneRoster 1.2 hay không. Tải xuống hoặc chụp ảnh màn hình của báo cáo đã tạo để chia sẻ với những người liên hệ của bạn trong nhóm Google Lớp học.
Nhận miền minh hoạ dành cho nhà phát triển
Sau khi kết quả kiểm thử mức độ tuân thủ của bạn được nhóm Google Lớp học xem xét, miền minh hoạ dành cho nhà phát triển sẽ giúp bạn xác thực quy trình tích hợp toàn diện. Xin lưu ý rằng việc vượt qua các bài kiểm tra mức độ tuân thủ không đảm bảo rằng bạn sẽ được phê duyệt để hợp tác hoặc tích hợp.
Miền minh hoạ dành cho nhà phát triển là một môi trường Google Lớp học đang hoạt động và dùng để kiểm thử, giúp bạn xác thực rằng hoạt động tích hợp của bạn đang hoạt động như mong đợi. Hoàn tất các bước để nhận miền minh hoạ dành cho nhà phát triển và yêu cầu nâng cấp miền minh hoạ. Khi nâng cấp, miền của bạn sẽ được cấp 10 giấy phép Google Workspace for Education Plus. Bạn cần cấp những giấy phép này cho người dùng thử nghiệm trong miền nhà phát triển của bạn để họ có thể thử nghiệm các tính năng tích hợp SIS trong Lớp học.
Câu hỏi thường gặp
1. Lớp học yêu cầu mô hình dữ liệu nào từ hệ thống thông tin học sinh?
Lớp học tuân thủ quy chuẩn OneRoster 1.2. Nếu SIS của bạn sử dụng cấu trúc dữ liệu khác, bạn có thể gặp phải hành vi không mong muốn. Ví dụ: nếu hệ thống của bạn hỗ trợ mối quan hệ lồng nhau giữa giai đoạn chấm điểm và danh mục điểm, thì mối quan hệ này nằm ngoài quy chuẩn OneRoster 1.2 và bạn nên kiểm thử kỹ lưỡng quy trình tích hợp để đảm bảo khả năng tương thích phù hợp.
2. Những điểm và trạng thái bài tập nào được xuất sang SIS?
Chỉ những điểm đã trả hoặc bài nộp được đánh dấu là "còn thiếu" hoặc "được miễn" mới được xuất sang SIS. Điểm không chính thức sẽ không được xuất.
3. Điều gì sẽ xảy ra với mục riêng trong SIS nếu một bài tập bị xoá trong Lớp học?
Khi bạn xoá một bài tập trong Lớp học, mục hàng tương ứng trong SIS sẽ không bị xoá. Điều này giúp ngăn chặn việc mất dữ liệu do vô tình và xoá xếp tầng ngoài ý muốn.