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