অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্ট

ক্লাসরুম অ্যাড-অন ওয়াকথ্রু সিরিজের এটি পঞ্চম ওয়াকথ্রু।

এই ওয়াকথ্রুতে, আপনি একটি অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্ট তৈরি করতে আগের ওয়াকথ্রু ধাপ থেকে উদাহরণটি পরিবর্তন করেন। এগুলি এমন যেকোন সংযুক্তিগুলির জন্য ছাত্র জমা দেওয়ার প্রয়োজন হয়, যেমন একটি লিখিত প্রতিক্রিয়া, কুইজ, বা অন্যান্য ছাত্র-উত্পাদিত শিল্পকর্ম৷

কন্টেন্ট-টাইপ এবং অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্টের মধ্যে পার্থক্য গুরুত্বপূর্ণ। অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্ট কন্টেন্ট-টাইপ থেকে নিম্নলিখিত উপায়ে আলাদা:

  • স্টুডেন্ট ভিউ আইফ্রেমের উপরের ডানদিকে একটি "টার্ন ইন" বোতাম প্রদর্শিত হবে।
  • তারা ছাত্রদের কাজের জন্য একটি অনন্য শনাক্তকারী প্রদান করে।
  • তাদের সংযুক্তি কার্ডটি Classroom grader UI এ প্রদর্শিত হবে।
  • তারা যে অ্যাসাইনমেন্টের জন্য একটি গ্রেড সেট করতে পারে।

গ্রেডিং সম্পর্কে আলোচনার জন্য পরবর্তী ওয়াকথ্রু দেখুন। এই ওয়াকথ্রু চলাকালীন আপনি নিম্নলিখিতগুলি সম্পূর্ণ করবেন:

  • একটি কার্যকলাপ-টাইপ সংযুক্তি তৈরি করতে Classroom API-তে পূর্ববর্তী সংযুক্তি তৈরির অনুরোধগুলি সংশোধন করুন।
  • ছাত্র জমা দেওয়ার জন্য অবিরাম স্টোরেজ প্রয়োগ করুন।
  • স্টুডেন্ট ইনপুট গ্রহণ করতে আগের স্টুডেন্ট ভিউ রুট পরিবর্তন করুন।
  • স্টুডেন্ট ওয়ার্ক রিভিউ iframe পরিবেশন করার জন্য একটি রুট প্রদান করুন।

একবার শেষ হয়ে গেলে, শিক্ষক হিসাবে লগ ইন করার সময় আপনি Google Classroom UI এর মাধ্যমে অ্যাসাইনমেন্টে অ্যাটাচমেন্ট-টাইপ অ্যাটাচমেন্ট তৈরি করতে পারেন। ক্লাসের ছাত্ররাও আইফ্রেমে কার্যকলাপটি সম্পূর্ণ করতে এবং একটি প্রতিক্রিয়া জমা দিতে পারে। শিক্ষক ক্লাসরুম গ্রেডিং UI-তে শিক্ষার্থীর জমা দেওয়া দেখতে পারেন।

এই উদাহরণের উদ্দেশ্যে, পূর্ববর্তী ওয়াকথ্রু থেকে সংযুক্তি টেমপ্লেটটি পুনরায় ব্যবহার করুন যা একটি বিখ্যাত ল্যান্ডমার্কের একটি চিত্র এবং ল্যান্ডমার্কের নামের সাথে একটি ক্যাপশন দেখায়৷ ক্রিয়াকলাপের মধ্যে রয়েছে শিক্ষার্থীকে ল্যান্ডমার্কের নাম প্রদান করতে উদ্বুদ্ধ করা।

সংযুক্তি তৈরির অনুরোধ পরিবর্তন করুন

আপনার কোডের সেই বিভাগে নেভিগেট করুন যেখানে আপনি পূর্ববর্তী ওয়াকথ্রুতে একটি বিষয়বস্তু-টাইপ সংযুক্তি তৈরি করেছেন। এখানে মূল আইটেমটি হল একটি AddOnAttachment অবজেক্টের একটি উদাহরণ, যেখানে আমরা পূর্বে সংযুক্তির জন্য teacherViewUri , studentViewUri , এবং title উল্লেখ করেছি।

যদিও সমস্ত অ্যাড-অন সংযুক্তিগুলির জন্য এই তিনটি ক্ষেত্রের প্রয়োজন হয়, একটি studentWorkReviewUri এর উপস্থিতি বা অনুপস্থিতি নির্ধারণ করে যে সংযুক্তিটি কার্যকলাপ-প্রকার নাকি বিষয়বস্তু-টাইপ। একটি জনবহুল studentWorkReviewUri সাথে একটি CREATE অনুরোধ একটি অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্টে পরিণত হয়, যখন studentWorkReviewUri ছাড়া একটি CREATE অনুরোধ একটি বিষয়বস্তু-টাইপ সংযুক্তিতে পরিণত হয়।

এই অনুরোধটি করার জন্য একমাত্র পরিবর্তন হল studentWorkReviewUri ক্ষেত্রটি পূরণ করা। এখানে একটি উপযুক্ত নামযুক্ত রুট যোগ করুন; আপনি পরবর্তী ধাপে এটি বাস্তবায়ন করুন।

পাইথন

আমাদের প্রদত্ত উদাহরণে, এটি webapp/attachment_routes.py ফাইলে create_attachments পদ্ধতিতে রয়েছে।

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}",
}

বিষয়বস্তু-টাইপ সংযুক্তিগুলির জন্য স্থায়ী সঞ্চয়স্থান যোগ করুন

আমাদের কার্যকলাপে ছাত্রের প্রতিক্রিয়া রেকর্ড করুন। শিক্ষক যখন স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেমে জমাটি দেখেন তখন আপনি পরে এটি দেখতে পারেন।

Submission জন্য একটি ডাটাবেস স্কিমা সেট আপ করুন। আমাদের প্রদত্ত উদাহরণ আশা করে যে শিক্ষার্থীরা একটি ছবিতে দেখানো ল্যান্ডমার্কের নাম লিখবে। একটি Submission তাই নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

  • attachment_id : একটি সংযুক্তির জন্য একটি অনন্য শনাক্তকারী। ক্লাসরুম দ্বারা বরাদ্দ করা হয়েছে এবং একটি সংযুক্তি তৈরি করার সময় প্রতিক্রিয়াতে ফিরে এসেছে৷
  • submission_id : ছাত্র জমা দেওয়ার জন্য একটি শনাক্তকারী। Classroom দ্বারা বরাদ্দ করা হয়েছে এবং Student View-এ getAddOnContext প্রতিক্রিয়াতে ফিরে এসেছে।
  • student_response : শিক্ষার্থীর দেওয়া উত্তর।

পাইথন

পূর্ববর্তী ধাপগুলি থেকে SQLite এবং flask_sqlalchemy বাস্তবায়ন প্রসারিত করুন।

আপনি যে ফাইলটিতে পূর্ববর্তী টেবিলগুলি সংজ্ঞায়িত করেছেন সেখানে নেভিগেট করুন ( যদি আপনি আমাদের প্রদত্ত উদাহরণ অনুসরণ করেন তবে models.py )৷ ফাইলের নীচে নিম্নলিখিত যোগ করুন।

# 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))

আপনার সংযুক্তি হ্যান্ডলিং রুট সহ সার্ভার ফাইলে নতুন Submission ক্লাস আমদানি করুন।

স্টুডেন্ট ভিউ রুট পরিবর্তন করুন

এর পরে, একটি ছোট ফর্ম দেখাতে এবং ছাত্রের কাছ থেকে ইনপুট গ্রহণ করতে পূর্ববর্তী স্টুডেন্ট ভিউ রুটটি পরিবর্তন করুন। আপনি আগের ওয়াকথ্রু থেকে বেশিরভাগ কোড পুনরায় ব্যবহার করতে পারেন।

সার্ভার কোডটি সনাক্ত করুন যা আপনার ছাত্র দর্শনের জন্য রুট প্রদান করে। এটি একটি সংযুক্তি তৈরি করার সময় studentViewUri ক্ষেত্রে নির্দিষ্ট করা রুট। প্রথম পরিবর্তনটি হল getAddOnContext প্রতিক্রিয়া থেকে submissionId বের করা।

পাইথন

আমাদের প্রদত্ত উদাহরণে, এটি webapp/attachment_routes.py ফাইলে load_activity_attachment পদ্ধতিতে রয়েছে।

# 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")

আপনি স্টুডেন্ট জমা দেওয়ার স্ট্যাটাস পেতে একটি অনুরোধ জারি করতে চাইতে পারেন। প্রতিক্রিয়াটিতে একটি SubmissionState মান রয়েছে, যা রাজ্যগুলিকে নির্দেশ করে যেমন শিক্ষার্থী সংযুক্তিটি খুলেছে বা এটি চালু করেছে কিনা৷ আপনি যদি একটি চালু করা জমা দেওয়ার ক্ষেত্রে সম্পাদনাগুলি অস্বীকৃত করতে চান বা আপনি যদি শিক্ষক প্রদান করতে আগ্রহী হন তবে এটি কার্যকর হতে পারে তাদের ছাত্রদের অগ্রগতির অন্তর্দৃষ্টি:

পাইথন

আমাদের প্রদত্ত উদাহরণে, এটি উপরের load_activity_attachment পদ্ধতির ধারাবাহিকতা।

# 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()

অবশেষে, আমাদের ডাটাবেস থেকে সংযুক্তি তথ্য আনুন এবং একটি ইনপুট ফর্ম পরিবেশন করুন। আমাদের প্রদত্ত উদাহরণের ফর্মটিতে একটি স্ট্রিং ইনপুট ক্ষেত্র এবং একটি জমা বোতাম রয়েছে। ল্যান্ডমার্ক চিত্রটি দেখান এবং শিক্ষার্থীকে তার নাম লিখতে বলুন। একবার তারা একটি প্রতিক্রিয়া প্রদান করে, এটি আমাদের ডাটাবেসে রেকর্ড করুন।

পাইথন

আমাদের প্রদত্ত উদাহরণে, এটি উপরের load_activity_attachment পদ্ধতির ধারাবাহিকতা।

# 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)

ব্যবহারকারীদের মধ্যে পার্থক্য করার জন্য, সাবমিট ফাংশন নিষ্ক্রিয় করার কথা বিবেচনা করুন এবং এর পরিবর্তে শিক্ষক ভিউতে সঠিক উত্তর দেখান।

স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেমের জন্য একটি রুট যোগ করুন

অবশেষে, স্টুডেন্ট ওয়ার্ক রিভিউ iframe পরিবেশন করার জন্য একটি রুট যোগ করুন। সংযুক্তি তৈরি করার সময় studentWorkReviewUri এর জন্য প্রদত্ত একটির সাথে এই রুটের নামটি মিলতে হবে। এই রুটটি খোলে যখন শিক্ষক ক্লাসরুম গ্রেডারের UI-তে ছাত্র জমা দেওয়া দেখেন।

ক্লাসরুম স্টুডেন্ট ওয়ার্ক রিভিউ iframe খুললে আপনি submissionId ক্যোয়ারী প্যারামিটার পাবেন। আপনার স্থানীয় ডাটাবেস থেকে ছাত্রের কাজ পুনরুদ্ধার করতে এটি ব্যবহার করুন:

পাইথন

আমাদের প্রদত্ত উদাহরণে, এটি 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)

অ্যাড-অন পরীক্ষা করুন

পূর্ববর্তী ওয়াকথ্রু থেকে অ্যাড-অন ধাপগুলি পরীক্ষাটি পুনরাবৃত্তি করুন। আপনার একটি সংযুক্তি থাকা উচিত যা ছাত্র দ্বারা খোলা যাবে।

কার্যকলাপ সংযুক্তি পরীক্ষা করার জন্য নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  • Google Classroom- এ সাইন ইন করুন আপনার একজন ছাত্র পরীক্ষা ব্যবহারকারী হিসেবে একই ক্লাসে শিক্ষক পরীক্ষা ব্যবহারকারী।
  • ক্লাসওয়ার্ক ট্যাবে নেভিগেট করুন এবং পরীক্ষার অ্যাসাইনমেন্ট প্রসারিত করুন।
  • স্টুডেন্ট ভিউ খুলতে এবং কার্যকলাপের জন্য একটি প্রতিক্রিয়া জমা দিতে অ্যাড-অন সংযুক্তি কার্ডে ক্লিক করুন।
  • কার্যকলাপ শেষ করার পরে iframe বন্ধ করুন। ঐচ্ছিকভাবে, টার্ন ইন বোতামে ক্লিক করুন।

কার্যকলাপ সম্পূর্ণ করার পরে আপনি ক্লাসরুমে কিছু পরিবর্তন দেখতে পাবেন না। এখন স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেম পরীক্ষা করুন:

  • শিক্ষক পরীক্ষা ব্যবহারকারী হিসেবে ক্লাসরুমে সাইন ইন করুন।
  • গ্রেড ট্যাবে আপনার পরীক্ষার অ্যাসাইনমেন্টের জন্য কলাম খুঁজুন। আপনার পরীক্ষার অ্যাসাইনমেন্টের নামে ক্লিক করুন।
  • পরীক্ষার ছাত্র ব্যবহারকারীর জন্য কার্ড খুঁজুন। কার্ডের সংযুক্তিতে ক্লিক করুন।

নিশ্চিত করুন যে শিক্ষার্থীর জন্য সঠিক জমা দেওয়া হয়েছে।

অভিনন্দন! আপনি পরবর্তী ধাপে এগিয়ে যাওয়ার জন্য প্রস্তুত: সংযুক্তি গ্রেড সিঙ্ক করা ।