خدمة الإشعارات على المنصة باستخدام LTI 1.3
ينشئ معيار LTI لخدمة الإشعارات على المنصة قناةً جديدة لأدوات التعلّم الخارجية بهدف التواصل خارج جلسة مستخدم نشطة في Brightspace، ما يؤدي إلى تعميق مستوى التكامل الممكن بين أدوات التعلّم الخارجية وD2L Brightspace.
عند التمكين، تتيح خدمة الإشعارات على المنصة لأدوات التعلّم الخارجية تسجيل معالجات الأدوات وتحديثها وحذفها من أجل تلقي الإشعارات وتمكّن إشعار النسخ السياقي من إعلام الأدوات عند نسخ مقرر تعليمي.
نقاط نهاية المعالج لخدمة الإشعارات على المنصة
يمكن للأدوات تسجيل نقاط نهاية المعالج لأنواع إشعارات محددة. واستجابةً لبعض الإجراءات التي يتم تنفيذها داخل Brightspace، سيتم نشر حمولة JWT موقعة على نقطة النهاية المسجَّلة التي تحتوي على بيانات LTI ذات الصلة بنوع الإشعار المحدد.
تمكين خدمة الإشعارات على المنصة
يجب تمكين ملحق خدمة الإشعارات على المنصة حتى تتكامل مع الأداة قبل استخدامها. لا تختلف عملية التمكين عن ملحقات LTI الأخرى المتاحة حاليًا. ويمكن تمكين هذه الخدمة الجديدة من خلال التسجيل الديناميكي أو واجهات برمجة التطبيقات أو من خلال واجهة المستخدم.
يمكنك تمكين خدمة الإشعارات على المنصة عند التسجيل (إدارة قابلية التوسع) والنشر (أدوات التعلّم الخارجية). على إشعار النسخ السياقي أيضًا أن يكون ممكّنًا عند نشر الأداة. يمكّن هذا أدوات التعلّم الخارجية من الاشتراك في إشعارات أحداث إخطار الويب.
لمزيد من المعلومات حول كيفية تمكين خدمة الإشعارات على المنصة وإشعار النسخ السياقي في Brightspace عند التسجيل والنشر، راجع موضوع تسجيل الأداة ونشرها وارتباطاتها.
واجهات برمجة تطبيقات التسجيل والنشر
تتوفر واجهات برمجة تطبيقات التسجيل والنشر لإنشاء عمليات التكامل التي تستخدم خدمة الإشعارات على المنصة وتحديث تلك العمليات. يجب تمكين خدمة الإشعارات على المنصة على مستوى التسجيل ومستوى النشر، ثم يجب تمكين أنواع الإشعارات الفردية على مستوى النشر.
التسجيل الديناميكي
يمكن تمكين خدمة الإشعارات على المنصة من خلال التسجيل الديناميكي. يتم تضمين أنواع الإشعارات التي تدعمها المنصة في مطالبة تكوين المنصة. يجب أن تتهيأ الأدوات لإضافة إشعارات جديدة إلى هذه المطالبة بسبب إضافة مزيد من أنواع الإشعارات إلى هذه الخدمة.
الوظيفة
بمجرد التمكين، تتيح خدمة إشعارات المنصة للأدوات تسجيل المعالج وتحديثه لتلقي الإشعارات.
سيتم إرسال الإشعارات إلى المعالج المسجَّل وفقًا للتعريفات المحددة للإشعارات الموضحة أدناه. يكون كل نوع من أنواع الإشعارات مخصصًا لحالة استخدام واحدة.
واجهة برمجة تطبيقات المعالج
توفر خدمة الإشعارات على المنصة واجهة برمجة تطبيقات لتمكين الأدوات من "الحصول" على قائمة بالمعالجات الموجودة حاليًا لهذا التكامل و"وضع" تحديثات لتلك المعالجات. تتيح واجهة برمجة تطبيقات "وضع" إعداد معالجات جديدة أو تحديث معالجات موجودة أو حذف معالجات. يتم تعريف نقطة نهاية واجهة برمجة التطبيقات في تشغيل LTI ضمن مطالبة خدمة الإشعارات على المنصة، كما أنها تكون بالتنسيق الآتي.
/d2l/api/lti/pns/[version]/handlers/deployment/[DeploymentID]
يتم تنفيذ عملية التحقق الآتية على المعالج المسجَّل. ويجب استيفاء هذه المعايير قبل تسجيل المعالج:
- استخدام عنوان URL لـ https
- صلاحية عنوان URL
- وجود عنوان URL في نطاق تسجيل الأداة أو مطابقته لعنوان URL المسجَّل لإعادة التوجيه.
الإشعارات المدعومة
ترد قائمة بالإشعارات المدعومة في مطالبة التشغيل. يحتوي الإصدار الأول من خدمة الإشعارات على المنصة على إشعار نسخ السياق. يوجد كذلك إشعار اختبار يمكن توفيره عند طلب اختبار التكامل من دون استخدام الأحداث الخاصة بـ Brightspace.
يظهر إشعار الاختبار على النحو الآتي:
"notice_types_supported":[
0:"LtiContextCopyNotice"
إشعار النسخ السياقي
يقوم إشعار النسخ السياقي بإعلام الأداة عند نسخ المقرر التعليمي ضمن قواعد مشاركة النشر الخاصة بالأداة. يتضمن الإشعار معرِّف سياق المقرر التعليمي الأصل ومعرِّف المقرر التعليمي الوجهة. يتم تضمين اسم المقرر التعليمي الوجهة ووصف المقرر كذلك في حال تمكين إعداد أمان معلومات الوحدة التنظيمية لهذا النشر.
لا يجب أن يكون نسخ المقرر التعليمي الأصل مضمنًا في قواعد المشاركة الخاصة بالأداة حتى يتم إرسال إشعار بشأنه. يجب أن يكون معرِّف المقرر التعليمي الوجهة فقط في قواعد المشاركة الخاصة بالأداة.
ينتج عن أي عملية نسخ للمقرر التعليمي (على سبيل المثال، النسخ اليدوي أو المجمع أو من خلال واجهة برمجة التطبيقات) إنشاء حدث نسخ سياقي يتم إرساله إلى الأداة.
تنسيق الرسالة
تتلقى الأدوات حمولة JSON موقعة. تتألف هذه الحمولة من إشعار واحد أو أكثر وتتبع معيار 1Edtech.
|
ملاحظة: لمزيد من المعلومات عن 1Edtech، راجع موضوع موقع 1EdTech. |
يتضمن كل إشعار وقتًا ومعرِّفًا فريدًا. ويتحدد الوقت والمعرِّف بحدث الإشعار (على سبيل المثال، نسخ المقرر التعليمي أو حدث تسليم الواجبات)؛ وتكون معلومات JSON خاصة بوقت إرسال الإشعار، ولا تتعلق بمحتوى الإشعار.
منطق إعادة المحاولة
عمليات إعادة المحاولة غير مدعومة للإصدار الأول من هذه الخدمة. ولا يتطلب المعيار هذه العمليات في الوقت الحالي.
إيقاف الإشعارات
تتوفر الخيارات الآتية لإيقاف إرسال الإشعارات إلى الأداة. يمكن إتمام أول ثلاثة خيارات من خلال Brightspace أو واجهة برمجة التطبيقات أو بواسطة أحد المسؤولين:
- تعطيل نوع الإشعار المحدد عند النشر
- تعطيل خدمة الإشعارات على المنصة عند النشر: يؤدي ذلك إلى تعطيل جميع أنواع الإشعارات لهذا النشر.
- تعطيل خدمة الإشعارات على المنصة عند التسجيل: يؤدي ذلك إلى تعطيل الخدمة وجميع أنواع الإشعارات لجميع عمليات النشر التي تتم خلال هذا التسجيل.
- إزالة معالج (معالجات) الرسالة لتكامل الأداة: لا يمكن تنفيذ هذا الخيار إلا بواسطة الأداة.
تجربة المستخدم
خدمة الإشعارات على المنصة هي خدمة بين المنصة والأداة. ولا تظهر هذه الإشعارات مباشرةً للمتعلّمين أو المعلّمين أو المسؤولين. من خلال تلقي هذه الإشعارات، يمكن للأدوات تحسين مستوى الخدمة المقدمة من خلال عمليات التكامل. وتتمثل الفائدة التي يتلقاها المتعلّمون والمعلّمون والمسؤولون من خلال إشعار النسخ السياقي في محتوى LTI تزيد موثوقيته بعد نسخ المقرر التعليمي. تمكِّن معلومات النسخ السياقي الأدوات من رؤية أحداث نسخ المقرر التعليمي على المنصة، ما يساعد على منع المشاكل المتعلقة بنسخ المقرر التعليمي.