Để tích hợp hệ thống thông tin học sinh (SIS) với Lớp học, hãy xác thực rằng sản phẩm của bạn đáp ứng các yêu cầu về mối quan hệ đối tác của Lớp học bằng cách chạy bộ kiểm tra mức độ tuân thủ được cung cấp.
Truy cập và chạy bài kiểm thử
Bạn có thể truy cập vào các bài kiểm thử về tính tuân thủ trên GitHub. Để chạy kiểm thử, bạn cần có:
- URL mã thông báo để truy xuất thông tin xác thực OAuth 2.0
- Một URL đội hình kết thúc bằng
/ims/oneroster/v1p1 - Client ID
- Mật khẩu ứng dụng khách
- Địa chỉ email của giáo viên
Có ba phần trong bộ kiểm thử:
- Đồng bộ hoá điểm cơ bản
- Loại điểm
- Giai đoạn chấm điểm
Bạn có thể chạy kiểm thử bằng cách dùng Google Colab hoặc Sổ tay Jupyter. Cả Colab và sổ tay Jupyter đều cho phép bạn chạy tất cả các thử nghiệm cùng một lúc. Thao tác này sẽ giúp bạn tạo kết quả kiểm thử để chia sẻ với nhóm Google Lớp học.
Các yêu cầu đối với hệ thống thông tin học sinh và hành vi dự kiến
Các bài kiểm thử do Google xác định được tạo ra để duy trì tính nhất quán và giảm thiểu lỗi mà người dùng có thể gặp phải khi sử dụng các công cụ tích hợp hệ thống thông tin học sinh với Lớp học. Hãy đọc các điểm sau đây về kiểm thử. Trong GitHub, mỗi bài kiểm thử được đánh dấu bằng @title. Những tiêu đề này được tham chiếu trong các con trỏ.
Xin lưu ý những nội dung sau đây về phần Đồng bộ hoá điểm cơ bản:
Trong kiểm thử
GetAllTeachers, điểm cuốiGET /teachersđược gọi bằng tham số truy vấnlimit=. Trong các hoạt động kiểm thử tiếp theo, tham số này 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.Trong kiểm thử
GetAllTeachers with email filter, điểm cuốiGET /teachersđược gọi bằng tham số truy vấnfilter=dùng để lọc dựa trên địa chỉ email của giáo viên. Bạn cần chỉ định địa chỉ email của giáo viên khi chạy bài kiểm thử.Trong kiểm thử
GetClassesForTeacher, điểm cuối/teachers/{teacher_sourced_id}/classesđược gọi bằng tham số truy vấnfilter=dùng để lọc dựa trên các lớp đang hoạt động.Trong kiểm thử
GetStudentsForClass, điểm cuốiGET /classes/{class_sourced_id}/students?limit=10000được gọi. Bạn phải trả lại email của học viên trong phản hồi.Trong bài kiểm tra
PutLineItem Create, bạn không bắt buộc phải cung cấp danh mục điểm hoặc giai đoạn chấm điểm khi gọiPUT /lineItems/{line_item_sourced_id}.Trong kiểm thử
PutLineItem Edit, lệnh gọi API không được trả về lỗi nếu bao gồm cả độ dài tiêu đề chỉ định dài. Chương trình kiểm thử này bao gồm tiêu đề bài tập dài hơn 100 ký tự.Trong kiểm thử
PutResult Edit, bạn có thể đặtscorethành một giá trị lớn hơnresultValueMaxđể thể hiện giá trị đóng góp bổ sung.Cần có điểm cuối
DELETE /results/{result_sourced_id}và được kiểm thử trong bài kiểm thửDeleteResult.Không bắt buộc phải có điểm cuối
DELETE /lineItems/{line_item_sourced_id}. Đây là tính năng không bắt buộc và được dùng để dọn dẹp dữ liệu.
Xin lưu ý những thông tin sau về các phần Loại điểm và Giai đoạn chấm điểm:
- Chỉ cần một điểm cuối
GET /categories. Đánh dấu chú thích mà bạn không sử dụng nếu chạy đồng thời tất cả các kiểm thử về tính tuân thủ:/categories?limit=10000/classes/{class_sourced_id}/categories?limit=10000
- Khả năng hỗ trợ giai đoạn chấm điểm được kiểm thử bằng cách truy xuất
term_sourced_idtrong bài kiểm thửGetAllClasses w/ filter.term_sourced_idnày dùng để truy xuất giai đoạn chấm điểm trong thuật ngữ bằng cách gọi điểm cuốiGET terms/{term_sourced_id}/gradingPeriods?limit=10000trong kiểm thửGetGradingPeriodsForTerm.
- Chỉ cần một điểm cuối
Chia sẻ kết quả kiểm tra với nhóm Google Lớp học
Sau khi bạn chạy kiểm thử, một báo cáo đầy đủ kèm theo kết quả của từng lượt kiểm thử sẽ được tạo. Các phép kiểm thử này dùng để xác định xem sản phẩm của bạn có đáp ứng các yêu cầu về tiêu thụ OneRoster 1.1 của Google hay không. Tải xuống hoặc chụp ảnh màn hình của báo cáo đã tạo. Gửi báo cáo và một đường liên kết đến chứng nhận OneRoster 1.1 của sản phẩm đến classroom-sis-external@google.com.
Yêu cầu hỗ trợ
Hãy gửi email đến classroom-sis-external@google.com nếu có câu hỏi hoặc thắc mắc.