خدمة الواجبات والعلامات (AGS) هو ملحق LTI. LTI إصدار 1.3 مصمَّم للتعامل مع تفاعلات العلامات المتقدمة بين الأداة والمنصة. ويقوم هذا الملحق بتزويد المطورين بسلسلة من الخدمات الفرعية التي تسمح بإدارة المواد التي سيتم وضع علامة عليها وقيم العلامات داخل Brightspace.
تتكون خدمة الواجبات والعلامات (AGS) من ثلاث خدمات:
- خدمة LineItem
- خدمة النتيجة
- خدمة الدرجات
فهم سلوك العلامات باستخدام AGS
يجب أن يكون المسؤولون على دراية بالاعتبارات الآتية التي تؤثر في سلوك العلامات عند استخدام خدمة الواجبات والعلامات. تُحفظ درجات خدمة الواجبات والعلامات (AGS) فقط عندما يكون الخيار إمكانية وضع علامة عليه في حقل العلامات مفعلاً للمستخدم الذي يتم تقييمه. إذا تم إرسال مادة سيتم وضع علامة عليها إلى مستخدم له دور لا يمكن وضع علامة عليه، فلن تُحفظ العلامة، وستُرسل رسالة خطأ إلى أداة الإرسال.
لضبط سلوكيات الأداة:
- من الصفحة الرئيسية للمؤسسة، حدد أدوات المسؤول.
- ضمن مقطع الأمان، انقر فوق الأدوار والأذونات.
- انقر فوق القائمة مزيد من الإجراءات بجانب الدور الذي تريد تعيين الخيار إمكانية وضع علامات عليه في حقل العلامات له.
- انقر فوق تحرير الإعدادات.
- ضمن خيارات سلوك الأداة، حدد إمكانية وضع علامات عليه في حقل العلامات.
- انقر فوق حفظ وإغلاق.
الشكل: عند تمكين الخيار إمكانية وضع علامات عليه في حقل العلامات، يمكنك تقييم المستخدمين المسجلين مع هذا الدور في أداة العلامات.
يجب أن يكون المسؤولون على علم أيضًا أنه إذا لم يكن يمكن التجاوز قد تم تعيينه لمادة سيتم وضع علامة عليها، وأرسلت أداة إلى دفتر العلامات علامة أعلى من الحد الأقصى المحدد للمادة التي سيتم وضع علامة عليها:
- فسيظهر الحد الأقصى المسموح به للدرجة (ليس أعلى درجة مقدمة) في دفتر العلامات.
- فسيتم تسجيل الدرجة المرسلة من الأداة التي هي أعلى من الحد الأقصى في جدول داخلي للرجوع إليها في المستقبل.
ملاحظة: أدوات LTI وعملاء D2L لا يستطيعون الوصول إلى هذا الجدول الداخلي.
لتشغيل حالة يمكن التجاوز لمادة سيتم وضع علامة عليها أو إيقاف تشغيلها:
- من شريط التنقل الخاص بالمقرر التعليمي، انقر فوق العلامات.
- انقر فوق علامة التبويب إدارة العلامات وحدد المادة التي سيتم وضع علامة عليها.
- ضمن علامة التبويب الخصائص، ضمن وضع العلامات، قم بتأكيد خانة الاختيار يمكن التجاوز أو تحديثها حسب الحالة.
الشكل: الخيار يمكن التجاوز في منطقة وضع العلامات لخصائص المادة التي سيتم وضع علامة عليها.
خدمة LineItem
تُستخدم خدمة LineItem لإدارة المواد التي سيتم وضع علامة عليها لأدوات التعلّم. فهي تمكِّن الأداة من إنشاء المواد التي سيتم وضع علامة عليها التي تمتلكها الأداة نفسها وحذفها والحصول على تفاصيل عنها. توفر هذه الخدمة الإمكانيات التالية:
- LineItems.url: عنوان URL لنقطة النهاية للوصول إلى حاوية LineItem للسياق الحالي
- LineItem.url: عنوان URL لنقطة النهاية للوصول إلى مادة السطر عندما تكون هناك مادة سطر واحدة فقط مقترنة بارتباط المورد؛ وفي حال وجود أكثر من مادة سطر واحدة، يجب أن تكون هذه الخاصية فارغة
يوجد نوعان معرَّفان مختلفان من الوسائط حسب خدمة LineItem :
-
application/vnd.ims.lis.v2.lineitem+json، مع نموذج:
{ "id" : https://lms.example.com/context/2923/lineitems/1, "scoreMaximum" : 60, "label" : "Math 202 Quiz", "resourceId" : "a-9334df-33", "tag" : "grade", "resourceLinkId" : "1g3k4dlk49fk", "startDateTime": "2019-03-06T20:05:02Z", "endDateTime": "2019-04-06T22:05:03Z" }
- application/vnd.ims.lis.v2.lineitemcontainer+json، مع نموذج:
[{ "id": "https://lms.example.com/context/2923/lineitems/1", "scoreMaximum": 60, "label": "Math 202 Quiz", "resourceId": "a-9334df-33", "tag": "grade", "resourceLinkId": "1g3k4dlk49fk", "endDateTime": "2019-04-06T22:05:03Z"}, { "id": "https://lms.example.com/context/2923/lineitems/47", "scoreMaximum": 100, "label": "Week 3 Assignment", "resourceId": "a-9334df-33", "tag": "originality", "resourceLinkId": "1g3k4dlk49fk" }, {"id": "https://lms.example.com/context/2923/lineitems/69", "scoreMaximum": 60, "label": "Week 4 Assignment", "tag": "grade" }]
عند محاولة إجراء طلب "حصول" من نقطة نهاية الحاوية، قد ترغب في تصفية النتائج الآتية:
- resource_link_id: يقوم بإرجاع المواد المقترنة فقط بمعرِّف المورد المحدد الخاص بمنصة الأداة للارتباط الموجود في المحتوى
- source_id: يقوم بإرجاع تلك المواد المقترنة بمعرف مورد الأداة المحدد فقط. يمكن أن تشترك مواد أسطر متعددة في معرِّف المورد نفسه ضمن السياق.
- Tag: يقوم بإرجاع المواد المرتبطة بالعلامة المحددة فقط. يكون سلسلة دائمًا.
- limit: يقوم بتقييد عدد مواد السطر التي يتم إرجاعها. في حالة وجود مزيد من المواد بعد تلك التي تم إرجاعها، يجب تضمين رأس "ارتباط" http على أن يشير عنوان URL إلى الصفحة التالية وتكون قيمة 'rel' "التالي" في الاستجابة. يُقيِّد D2L استدعاءات GET على 200
|
ملاحظة: يوصى باستخدام ارتباط سريع بدلاً من ذلك في حالة LineItem، حيث توجد قيود على مكان عمل تمرير LineItem عند الإضافة عبر Insert Stuff أو من خلال الارتباط السريع الداخلي لمنشئ المقرر التعليمي.
بالنسبة إلى سير عمل منشئ المقرر التعليمي، يسمح النقر فوق الارتباط الموجود في اللوحة للأداة بإرسال المعلومات لإنشاء LineItem.
|
نموذج لمادة سطر جديدة
لإنشاء مادة جديدة سيتم وضع علامة عليها
يجب عليك النشر إلى application/VND.IMS.lis.v2.lineitem إلى LineItems.url. يمكن أن تظهر على النحو الآتي:
{ "scoreMaximum" : 60, "label" : "Math 101 Quiz", "resourceId" : "quiz-2031", "tag" : "math", "startDateTime": "2019-07-07T20:05:02Z", "endDateTime": "2019-07-07T22:05:03Z", }
خدمة النتيجة
تتيح خدمة النتيجة للمستخدمين القدرة على جعل الأداة تستعلِم من المنصة عن القيم الحالية للمواد التي سيتم وضع علامة عليها التي تمتلكها. يمثل مصطلح "النتيجة" نفسه علامة حالية لمادة معينة أو مستخدم محدد. لمزامنة العلامات الجديدة، راجع قسم خدمة الدرجات في هذا الموضوع:
ملاحظة: لا يمكن تغيير النتيجة مباشرةً من خلال هذه الخدمة، لذلك يتم دعم أوامر "GET" فقط.
تُعَد نقطة نهاية الخدمة مسارًا فرعيًا لعنوان URL الخاص بمورد مادة السطر. يحتوي عنوان URL للمورد على المسار الذي تم إلحاقه بـ '/results'. تدعم هذه الخدمة عمليات "GET" فقط وستقوم بإرجاع كل النتائج لمادة السطر. على سبيل المثال: [{ "id": "https://lms.example.com/context/2923/lineitems/1/results/5323497", "scoreOf": "https://lms.example.com/context/2923/lineitems/1", "userId": "5323497", "resultScore": 0.83, "resultMaximum": 1, "comment": "This is exceptional work." }]
يمكن للأدوات تصفية هذه النتائج باستخدام معلمات الاستعلام الآتية:
- user_id: يقوم بتصفية النتائج إلى مستخدم واحد استنادًا إلى معرِّفه.
- Limit: يقوم بتقييد عدد النتائج التي يتم إرجاعها. يُقيِّد D2L النتائج على 200
خدمة الدرجات
تمثل الدرجة قيمة النشاط الذي أكمله المستخدم للتو. يشير مصطلح الدرجة إلى تلك القيمة في وقت إجراء النشاط. تُستخدم خدمة الدرجات من قِبل أداة لنشر أحدث درجة إلى Brightspace. ونظرًا إلى أن Brightspace تنشر الدرجات الجديدة فقط، فإن هذه الخدمة للكتابة فقط. عند الوصول إليها في وقت لاحق، فإن D2L تصل إليها كنتيجة باستخدام خدمة النتيجة، التي تكون للقراءة فقط.
يوجد نوع وسائط واحد فقط يتم تعريفه بهذه الخدمة: application/vnd.ims.lis.v1.score+json. يوضح ما يأتي كيف يمكن أن يظهر نموذج نتيجة: {"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "This is exceptional work.", "activityProgress" : "Completed", "gradingProgress": "FullyGraded", "userId" : "5323497" >}
الطابع الزمني هو قيمة إجبارية تشير إلى وقت تغيير الدرجة، وهو مخصص للاستخدام من خلال المنصة للحماية من تحديثات الدرجات غير المرغوب فيها. تكون قيمة الطابع الزمني وفق معيار ISO 8601 لتاريخ ووقت الخادم، عندما يتم تعديل حالة النتيجة. لحماية البيانات في الماضي، من المتوقع أن تزيد هذه القيمة مع كل طلب.
يشير تقدم النشاط إلى حالة نشاط معين في ذلك الوقت. بينما يقوم IMS بتوثيق العديد من القيم المتوفرة، تتجاهل Brightspace هذه القيم وتعتمد بدلاً من ذلك فقط على قيمة حالة التقدم في وضع العلامات.
العلامات النهائية
يحتوي حقل التقدم في وضع العلامات على العديد من القيم المتوفرة كما وثقها 1EdTech. ومع ذلك، فإن Brightspace تعترف حاليًا فقط بقيمة FullyGraded: تم الانتهاء من عملية وضع العلامات؛ وتُمثل قيمة النتيجة، إن وجدت، العلامة النهائية الحالية. راجع تفاصيل التقدم في وضع العلامات في مستندات IMS الرسمية.
عند التحقق، يتم تضمين العلامات التي تم إنشاؤها من خلال AGS في حساب العلامة النهائية افتراضيًا. عند عدم التحقق، يتم استبعاد الدرجات التي تم إنشاؤها من خلال AGS من حساب العلامة النهائية افتراضيًا.
تعمل وظيفة مزامنة العلامات وفق نموذج "آخر تحديث"، ما يعني أنه إذا قام عضو من هيئة التدريس بتحديث دفتر العلامات في Brightspace ثم قام بإعادة تشغيل المزامنة من الأداة، فستتم الكتابة فوق العلامة. ومع ذلك، يمكنك التحقق من سجل أحداث العلامات لإظهار التغييرات التي تحدث لمادة محددة سيتم وضع علامة عليها.
يمكنك حذف المواد التي سيتم وضع علامة عليها التي تقوم بإنشائها باستخدام LTI Advantage إذا قمت بإرسال أمر حذف لخدمة الواجبات والعلامات (AGS). إذا كان للمادة التي سيتم وضع علامة عليها مجموع درجات، فسيتم حذف مادة سطر AGS، لكن تبقى المادة التي سيتم وضع علامة عليها في Brightspace.
الإنشاء التلقائي لمادة سيتم وضع علامة عليها
يمكن لأدوات LTI 1.3 بشكل اختياري إنشاء علامات تلقائيًا إذا لم يتم إعداد أي منها بالفعل. يتم التحكم في خيار الإنشاء التلقائي لمادة سيتم وضع علامة عليها بواسطة إعداد تكوين نشر LTI Advantage الإنشاء التلقائي للمواد التي سيتم وضع علامة عليها (القيمة الافتراضية هي إيقاف التشغيل).
لتمكين الإنشاء التلقائي لمادة سيتم وضع علامة عليها- من قائمة أدوات المسؤول، انقر فوق أدوات التعلّم الخارجية.
- حدد علامة التبويب LTI Advantage. قم بأحد الإجراءين الآتيين:
- إذا كنت تريد إنشاء عملية نشر جديدة، فانقر فوق عملية نشر جديدة.
- إذا أردت إجراء تغييرات على عملية نشر موجودة، فانقر فوق اسم عملية النشر ذات الصلة في الجدول.
- في منطقة إعدادات التكوين، حدد الإنشاء التلقائي للمواد التي سيتم وضع علامة عليها.
الشكل: إعداد تكوين نشر LTI Advantage الإنشاء التلقائي للمواد التي سيتم وضع علامة عليها قيد التشغيل.
- قم بأحد الإجراءين الآتيين:
- انقر فوق إنشاء عملية نشر (لإنشاء عمليات نشر جديدة).
- انقر فوق حفظ وإغلاق (لتحرير عمليات النشر).
نتيجة لذلك، يتم إنشاء العلامات تلقائيًا في دفتر العلامات بعد تلقي درجة من أداة LTI للمرة الأولى، بغض النظر عما إذا كان هناك اقتران لعلامة بالفعل.
ربط المواضع والعلامات
يقترن كل موضع ارتباط في مقرر تعليمي بالمادة نفسها التي سيتم وضع علامة عليها. ويتم ذلك من خلال جعل لكل موضع للارتباط معرِّف ارتباط المورد نفسه في ذلك المقرر التعليمي. إذا كانت ثمة حاجة إلى مواد سطر إضافية لارتباط معيّن، فيمكن إنشاء ارتباطات إضافية من خلال أدوات التعلّم الخارجية > LTI Advantage، أو إذا كانت الأداة تدعم الربط لموضوع معيّن، فسيكون للمورد المحدد من خلال تشغيل الربط لموضوع معيّن، معرِّف مميز لارتباط مورد LTI واقتران بمادة السطر.
يمكن استخدام AGS لإنشاء علامة مقترنة بارتباط يدويًا من خلال تضمين معرِّف ارتباط المورد الذي تم استلامه من عملية التشغيل، ويمكن القيام بذلك لجميع الارتباطات باستثناء الأدوات البرمجية.
محرر HTML والربط لموضوع معيّن
يمكن إنشاء مواد السطر باستخدام محرر HTML والربط لموضوع معيّن بطريقتين:
- باستخدام الإنشاء التلقائي للعلامات: يتم إنشاء مادة السطر تلقائيًا. تكون العلامة من أصل 100، ويجب إجراء أي تحديثات أخرى على مادة السطر من خلال AGS.
- من خلال AGS: يمكن للأداة استخدام AGS لإنشاء مادة سطر يدويًا. للتأكد من أن العلامة تحتوي على اقتران الارتباط الصحيح، يجب أن تتضمن الأداة ResourceLinkId الذي تم استلامه من عملية التشغيل عند إنشاء مادة السطر.
الحد الأقصى للدرجة
إذا لم يتم تحديد يمكن التجاوز وأرسلت الأداة درجة أعلى من الحد الأقصى المسموح به، فسيتم عرض الحد الأقصى للدرجة في دفتر العلامات وتخزين الدرجة الفعلية المرسلة من الأداة في جدول داخلي، ولن تكون لدى الأدوات والعملاء إمكانية الوصول إلى هذا الجدول.