Loại tệp đính kèm hoạt động

Đây là hướng dẫn thứ năm trong loạt hướng dẫn về tiện ích bổ sung của Lớp học.

Trong hướng dẫn này, bạn sẽ sửa đổi ví dụ trong bước hướng dẫn trước để tạo tệp đính kèm thuộc loại hoạt động. Đây là mọi tệp đính kèm yêu cầu học viên nộp bài, chẳng hạn như câu trả lời bằng văn bản, bài kiểm tra hoặc hiện vật do học viên tạo.

Việc phân biệt giữa tệp đính kèm thuộc loại nội dung và tệp đính kèm thuộc loại hoạt động là rất quan trọng. Tệp đính kèm thuộc loại hoạt động khác với tệp đính kèm thuộc loại nội dung theo những cách sau:

  • Nút "Nộp bài" xuất hiện ở phía trên cùng bên phải của iframe Chế độ xem của học viên.
  • Chúng cung cấp một giá trị nhận dạng riêng biệt cho bài tập của học viên.
  • Thẻ tệp đính kèm của chúng xuất hiện trong giao diện người dùng của công cụ chấm điểm trong Lớp học.
  • Chúng có thể đặt điểm cho bài tập mà chúng thuộc về.

Hãy xem hướng dẫn tiếp theo để biết nội dung thảo luận về việc chấm điểm. Trong quá trình thực hiện hướng dẫn này, bạn sẽ hoàn tất những việc sau:

  • Sửa đổi các yêu cầu tạo tệp đính kèm trước đó đối với API Lớp học để tạo tệp đính kèm thuộc loại hoạt động.
  • Triển khai bộ nhớ liên tục cho bài tập mà học viên đã nộp.
  • Sửa đổi đích Chế độ xem của học viên trước đó để chấp nhận thông tin đầu vào của học viên.
  • Cung cấp một đích để phân phát iframe Xem xét bài tập của học viên.

Sau khi hoàn tất, bạn có thể tạo tệp đính kèm thuộc loại hoạt động trên bài tập thông qua giao diện người dùng của Google Lớp học khi đăng nhập với vai trò giáo viên. Học viên trong lớp cũng có thể hoàn thành hoạt động trong iframe và gửi câu trả lời. Giáo viên có thể xem bài tập mà học viên đã nộp trong giao diện người dùng chấm điểm của Lớp học.

Để phục vụ mục đích của ví dụ này, hãy sử dụng lại mẫu tệp đính kèm trong hướng dẫn trước. Mẫu này hiển thị hình ảnh một địa danh nổi tiếng và chú thích có tên của địa danh đó. Hoạt động này bao gồm việc nhắc học viên cung cấp tên của địa danh.

Sửa đổi yêu cầu tạo tệp đính kèm

Chuyển đến phần mã mà bạn đã tạo tệp đính kèm thuộc loại nội dung trong hướng dẫn trước. Mục chính ở đây là một thực thể của đối tượng AddOnAttachment, trong đó chúng ta đã chỉ định teacherViewUri, studentViewUri và title cho tệp đính kèm.

Mặc dù tất cả tệp đính kèm của tiện ích bổ sung đều yêu cầu 3 trường này, nhưng sự hiện diện hoặc vắng mặt của studentWorkReviewUri sẽ xác định xem tệp đính kèm thuộc loại hoạt động hay loại nội dung. Yêu cầu CREATE có studentWorkReviewUri được điền sẵn sẽ trở thành tệp đính kèm thuộc loại hoạt động, trong khi yêu cầu CREATE không có studentWorkReviewUri sẽ trở thành tệp đính kèm thuộc loại nội dung.

Thay đổi duy nhất cần thực hiện đối với yêu cầu này là điền trường studentWorkReviewUri. Thêm một đích có tên phù hợp vào đây; bạn sẽ triển khai đích này ở bước sau.

Python

Trong ví dụ mà chúng tôi cung cấp, đích này nằm trong phương thức create_attachments trong tệp webapp/attachment_routes.py.

attachment = {
    # Specifies the route for a teacher user.
    "teacherViewUri": {
        "uri":
            flask.url_for(
                "load_activity_attachment",
                _scheme='https',
                _external=True),
    },
    # Specifies the route for a student user.
    "studentViewUri": {
        "uri":
            flask.url_for(
                "load_activity_attachment",
                _scheme='https',
                _external=True)
    },
    # Specifies the route for a teacher user when the attachment is
    # loaded in the Classroom grading view.
    # The presence of this field marks this as an activity-type attachment.
    "studentWorkReviewUri": {
        "uri":
            flask.url_for(
                "view_submission", _scheme='https', _external=True)
    },
    # The title of the attachment.
    "title": f"Attachment {attachment_count}",
}

Thêm bộ nhớ liên tục cho tệp đính kèm thuộc loại nội dung

Ghi lại câu trả lời của học viên cho hoạt động của chúng ta. Bạn có thể tra cứu câu trả lời đó sau khi giáo viên xem bài tập mà học viên đã nộp trong iframe Xem xét bài tập của học viên.

Thiết lập lược đồ cơ sở dữ liệu cho Submission. Ví dụ mà chúng tôi cung cấp yêu cầu học viên nhập tên của địa danh được hiển thị trong hình ảnh. Do đó, Submission chứa các thuộc tính sau:

  • attachment_id: Giá trị nhận dạng riêng biệt cho một tệp đính kèm. Do Lớp học chỉ định và trả về trong phản hồi khi tạo tệp đính kèm.
  • submission_id: Giá trị nhận dạng cho bài tập mà học viên đã nộp. Do Lớp học chỉ định và trả về trong getAddOnContext phản hồi trong Chế độ xem của học viên.
  • student_response: Câu trả lời do học viên cung cấp.

Python

Mở rộng hoạt động triển khai SQLite và flask_sqlalchemy từ các bước trước.

Chuyển đến tệp mà bạn đã xác định các bảng trước đó (models.py nếu bạn đang làm theo ví dụ mà chúng tôi cung cấp). Thêm nội dung sau vào cuối tệp.

# Database model to represent a student submission.
class Submission(db.Model):
    # The attachmentId is the unique identifier for the attachment.
    submission_id = db.Column(db.String(120), primary_key=True)

    # The unique identifier for the student's submission.
    attachment_id = db.Column(db.String(120), primary_key=True)

    # The student's response to the question prompt.
    student_response = db.Column(db.String(120))

Nhập lớp Submission mới vào tệp máy chủ bằng các đích xử lý tệp đính kèm.

Sửa đổi đích Chế độ xem của học viên

Tiếp theo, hãy sửa đổi đích Chế độ xem của học viên trước đó để hiển thị một biểu mẫu nhỏ và chấp nhận thông tin đầu vào của học viên. Bạn có thể sử dụng lại hầu hết mã từ hướng dẫn trước.

Tìm mã máy chủ cung cấp đích cho Chế độ xem của học viên. Đây là đích được chỉ định trong trường studentViewUri khi tạo tệp đính kèm. Thay đổi đầu tiên cần thực hiện là trích xuất submissionId từ phản hồi getAddOnContext.

Python

Trong ví dụ mà chúng tôi cung cấp, đích này nằm trong phương thức load_activity_attachment trong tệp webapp/attachment_routes.py.

# Issue a request to the courseWork.getAddOnContext endpoint
addon_context_response = classroom_service.courses().courseWork(
).getAddOnContext(
    courseId=flask.session["courseId"],
    itemId=flask.session["itemId"]).execute()

# One of studentContext or teacherContext will be populated.
user_context = "student" if addon_context_response.get(
    "studentContext") else "teacher"

# If the user is a student...
if user_context == "student":
    # Extract the submissionId from the studentContext object.
    # This value is provided by Google Classroom.
    flask.session["submissionId"] = addon_context_response.get(
            "studentContext").get("submissionId")

Bạn cũng có thể muốn đưa ra yêu cầu để nhận trạng thái bài tập mà học viên đã nộp . Phản hồi chứa giá trị SubmissionState, cho biết các trạng thái như học viên đã mở tệp đính kèm hay đã nộp bài. Điều này có thể hữu ích nếu bạn muốn không cho phép chỉnh sửa bài tập đã nộp hoặc nếu bạn muốn cung cấp thông tin chi tiết cho giáo viên về tiến trình của học viên:

Python

Trong ví dụ mà chúng tôi cung cấp, đây là phần tiếp theo của phương thức load_activity_attachment ở trên.

# Issue a request to get the status of the student submission.
submission_response = classroom_service.courses().courseWork(
).addOnAttachments().studentSubmissions().get(
    courseId=flask.session["courseId"],
    itemId=flask.session["itemId"],
    attachmentId=flask.session["attachmentId"],
    submissionId=flask.session["submissionId"]).execute()

Cuối cùng, hãy tìm nạp thông tin tệp đính kèm từ cơ sở dữ liệu của chúng tôi và phân phát biểu mẫu nhập. Biểu mẫu trong ví dụ mà chúng tôi cung cấp bao gồm một trường nhập dữ liệu chuỗi và một nút gửi. Hiển thị hình ảnh địa danh và nhắc học viên nhập tên của địa danh đó. Sau khi học viên cung cấp câu trả lời, hãy ghi lại câu trả lời đó trong cơ sở dữ liệu của chúng tôi.

Python

Trong ví dụ mà chúng tôi cung cấp, đây là phần tiếp theo của phương thức load_activity_attachment ở trên.

# Look up the attachment in the database.
attachment = Attachment.query.get(flask.session["attachmentId"])

message_str = f"I see that you're a {user_context}! "
message_str += (
    f"I've loaded the attachment with ID {attachment.attachment_id}. "
    if user_context == "teacher" else
    "Please complete the activity below.")

form = activity_form_builder()

if form.validate_on_submit():
    # Record the student's response in our database.

    # Check if the student has already submitted a response.
    # If so, update the response stored in the database.
    student_submission = Submission.query.get(flask.session["submissionId"])

    if student_submission is not None:
        student_submission.student_response = form.student_response.data
    else:
        # Store the student's response by the submission ID.
        new_submission = Submission(
            submission_id=flask.session["submissionId"],
            attachment_id=flask.session["attachmentId"],
            student_response=form.student_response.data)
        db.session.add(new_submission)

    db.session.commit()

    return flask.render_template(
        "acknowledge-submission.html",
        message="Your response has been recorded. You can close the " \
            "iframe now.",
        instructions="Please Turn In your assignment if you have " \
            "completed all tasks."
    )

# Show the activity.
return flask.render_template(
    "show-activity-attachment.html",
    message=message_str,
    image_filename=attachment.image_filename,
    image_caption=attachment.image_caption,
    user_context=user_context,
    form=form,
    responses=response_strings)

Để phân biệt giữa người dùng, hãy cân nhắc việc tắt chức năng gửi và thay vào đó hiển thị câu trả lời đúng trong Chế độ xem của giáo viên.

Thêm đích cho iframe Xem xét bài tập của học viên

Cuối cùng, hãy thêm một đích để phân phát iframe Xem xét bài tập của học viên. Tên của đích này phải khớp với tên được cung cấp cho studentWorkReviewUri khi tạo tệp đính kèm. Đích này sẽ mở khi giáo viên xem bài tập mà học viên đã nộp trong giao diện người dùng của công cụ chấm điểm trong Lớp học.

Bạn nhận được tham số truy vấn submissionId khi Lớp học mở iframe Xem xét bài tập của học viên. Sử dụng tham số này để truy xuất bài tập của học viên từ cơ sở dữ liệu cục bộ:

Python

Trong ví dụ mà chúng tôi cung cấp, đích này nằm trong tệp webapp/attachment_routes.py.

@app.route("/view-submission")
def view_submission():
    """
    Render a student submission using the show-student-submission.html template.
    """

    # Save the query parameters passed to the iframe in the session, just as we did
    # in previous routes. Abbreviated here for readability.
    add_iframe_query_parameters_to_session(flask.request.args)

    # For the sake of brevity in this example, we'll skip the conditional logic
    # to see if we need to authorize the user as we have done in previous steps.
    # We can assume that the user that reaches this route is a teacher that has
    # already authorized and created an attachment using the add-on.

    # In production, we recommend fully validating the user's authorization at
    # this stage as well.

    # Look up the student's submission in our database.
    student_submission = Submission.query.get(flask.session["submissionId"])

    # Look up the attachment in the database.
    attachment = Attachment.query.get(student_submission.attachment_id)

    # Render the student's response alongside the correct answer.
    return flask.render_template(
        "show-student-submission.html",
        message=f"Loaded submission {student_submission.submission_id} for "\
            f"attachment {attachment.attachment_id}.",
        student_response=student_submission.student_response,
        correct_answer=attachment.image_caption)

Kiểm thử tiện ích bổ sung

Lặp lại các bước Kiểm thử tiện ích bổ sung trong hướng dẫn trước. Bạn phải có một tệp đính kèm mà học viên có thể mở.

Hoàn tất các bước sau để kiểm thử tệp đính kèm hoạt động:

  • Đăng nhập vào Google Lớp học với vai trò một trong những người dùng thử nghiệm học viêntrong cùng một lớp với người dùng thử nghiệm giáo viên.
  • Chuyển đến thẻ Bài tập trên lớp và mở rộng Bài tập kiểm thử.
  • Nhấp vào thẻ tệp đính kèm của tiện ích bổ sung để mở Chế độ xem của học viên và gửi câu trả lời cho hoạt động.
  • Đóng iframe sau khi hoàn tất hoạt động. Bạn có thể nhấp vào nút Nộp bài.

Bạn sẽ không thấy bất kỳ thay đổi nào trong Lớp học sau khi hoàn tất hoạt động. Bây giờ, hãy kiểm thử iframe Xem xét bài tập của học viên:

  • Đăng nhập vào Lớp học với vai trò người dùng thử nghiệm giáo viên.
  • Tìm cột cho bài tập kiểm thử trong thẻ Điểm. Nhấp vào tên bài tập kiểm thử.
  • Tìm thẻ cho người dùng thử nghiệm học viên. Nhấp vào tệp đính kèm trên thẻ.

Xác nhận rằng bài tập đã nộp chính xác xuất hiện cho học viên.

Xin chúc mừng! Bạn đã sẵn sàng chuyển sang bước tiếp theo: đồng bộ hoá điểm của tệp đính kèm.