توثيق التكامل

تسجيل الأداة ونشرها وارتباطاتها

تسجيل أداة تعلّم خارجية لـ LTI Advantage

يُعدّ التسجيل الخطوة الأولى لدمج أداة مع منصة وإكمال عملية الأمان وعملية تسجيل الدخول الأحادي (SSO) للتكامل.

هام: يمكن أن يكون لأداة التعلّم الخارجية مجال وظيفي واحد فقط مسجل في منصة.

تتعلق المعلومات الآتية بتسجيل الأداة:

معرِّف العميل: المعرِّف المستخدم في مصادقة OAuth2 لتقديم طلبات إلى الخدمات (الأسماء والأدوار، والواجبات والعلامات).
عنوان URL لمجموعة مفاتيح Brightspace: حيث يتم تخزين مفاتيح Brightspace. وتحتاج إليه الأدوات في أثناء التسجيل ويتم استخدامه في أثناء التشغيل (توقع D2L رسالة التشغيل وتتحقق الأداة من صحة توقيع D2L باستخدامه).
عنوان URL للرمز المميز للوصول إلى Brightspace OAuth2: الموقع الذي تذهب إليه الأدوات لاسترداد رموز وصول مميزة جديدة لطلبات خدمة OAuth2.
نقطة نهاية مصادقة OpenId Connect: نقطة النهاية التي ترسل إليها Brightspace استجابة تسجيل الدخول
جمهور OAuth 2 في Brightspace: المستلم المقصود للرمز المميز.
جهة الإصدار: عنوان URL لمثيل Brightspace.

هذا هو رمز المذكرة الورقية والقلم الرصاص المستخدم للملاحظات.

ملاحظة: لتسجيل أداة، تأكد من تعيين أذونات إدارة عمليات تسجيل أداة LTI Advantage وإدارة عمليات نشر أداة LTI Advantage على مستوى المؤسسة.

لتسجيل أداة

من قائمة أدوات المسؤول، انقر فوق إدارة قابلية التوسع.
من علامة التبويب LTI Advantage‎، انقر فوق أداة التسجيل.

الشكل: انقر فوق تسجيل أداة لبدء عملية تسجيل أداة جديدة.
اختر التسجيل الديناميكي أو القياسي، وانقر فوق تسجيل.
- بالنسبة إلى التسجيل القياسي، أكمل الحقول الآتية (* تشير إلى الحقول المطلوبة):
  - الاسم*
  - الوصف
  - المجال*: لا يمكن استخدام المجالات إلا في تسجيل واحد ممكَّن في المرة الواحدة. إذا حاولت تسجيل أداة بمجال قيد الاستخدام بالفعل، فستتم مطالبتك بتعطيل التسجيل الحالي.
  - عناوين URL لإعادة التوجيه*: يجب ألا يكون هناك أكثر من بضعة عناوين URL لإعادة التوجيه. يجب أن تكون عناوين URL لإعادة التوجيه مطابقة تمامًا. ولا يتم دعم الأحرف البديلة.
  - عنوان URL لتسجيل الدخول إلى OpenID Connect‏*
  - عنوان URL للارتباط الهدف
  - عنوان URL لمجموعة المفاتيح: يجب إدخال عنوان URL لمجموعة المفاتيح لإضافة ملحقات.
  - الملحقات: يمكنك التحديد اختياريًا من بين الملحقات الآتية:
    1. خدمات الواجبات والعلامات
    2. الربط لموضوع معيّن
    3. خدمات تزويد الأسماء والأدوار
    4. خدمة الإشعارات على المنصة: يمكنك تمكين خدمة الإشعارات على المنصة أثناء عملية التسجيل. يمكّن هذا أدوات التعلّم الخارجية من الاشتراك في إشعارات أحداث إخطار الويب. عند تمكينها، تسمح خدمة الإشعارات على المنصة لأدوات التعلّم الخارجية بتسجيل معالجات الأدوات وتحديثها وحذفها لتلقي الإشعارات.
      
      الشكل: حدد خدمة الإشعارات على المنصة لتمكين أدوات التعلّم الخارجية من الاشتراك في إشعارات أحداث إخطار الويب.
    5. ملف تعريف مادة النشاط
    6. مراجعة تسليم الواجبات
- بالنسبة إلى التسجيل الديناميكي، أكمل الحقول الآتية:
  - أدخل عنوان URL للتسجيل الديناميكي الذي توفره الأداة. يُعَد السماح للأداة أيضًا بإنشاء النشر باستخدام الارتباطات أمرًا اختياريًا. بمجرد اكتمال سير عمل التسجيل الديناميكي، يتم تعطيل التسجيل بشكل افتراضي وفقًا للمواصفات.
  - يُوصى بمراجعة الملحقات والمعلمات وإعدادات الأمان (في النشر إن أمكن) التي طلبتها الأداة للتأكد من أنها تلبي حالات استخدام مؤسستك. يعيد التسجيل الديناميكي التوجيه إلى نقطة نهاية الأداة في علامة تبويب جديدة. ويمنع ذلك مشكلات ملفات تعريف الارتباط في الموقع نفسه وعبر المواقع.
ضمن الأدوار، اختر إرسال بيانات دور IMS لدور المؤسسة والدور السياقي أو الدور السياقي فقط. إذا تم تحديد خانة الاختيار إرسال دور المؤسسة، فسيتم تضمين دور المؤسسة والدور السياقي في تعيين الدور من تكوين IMS عند تشغيل الأداة. يتم تضمين الدور السياقي للمستخدمين ما لم يتم تعيين إعداد الأمان في عملية النشر إلى مجهول. إذا تمت إزالة خانة الاختيار إرسال دور المؤسسة، فسيتم تضمين الأدوار السياقية فقط.
معلمات الاستبدال: يمكن للمستخدمين الاختيار من قائمة محددة سابقًا للمعلمات التي يتم استبدالها ديناميكيًا بقيمة من نظام إدارة التعلّم عند التشغيل. تدعم Brightspace حاليًا المعلمات الآتية:
- ‎$Context.id.history
- ‎$CourseOffering.sourcedId
- ‎$CourseOffering.title
- ‎$CourseSection.label
- ‎$CourseSection.sourcedId
- ‎$CourseSection.title
- ‎$CourseSection.timeFrame.begin
- ‎$CourseSection.timeFrame.end
- ‎$CourseTemplate.sourcedId
- ‎$CourseTemplate.title
- ‎$Person.address.timezone
- ‎$Person.email.primary
- ‎$Person.name.family
- ‎$Person.name.full
- ‎$Person.name.given
- ‎$Person.sourcedId
- ‎$ResourceLink.available.startDateTime
- ‎$ResourceLink.available.endDateTime
- ‎$ResourceLink.description
- ‎$ResourceLink.id.history
- ‎$ResourceLink.submission.endDateTime
- ‎$ResourceLink.title
- ‎$User.id
- ‎$User.username
المعلمات المخصصة: في الحالات التي تحتاج فيها الأدوات إلى تعريف كل من اسم معلمة مخصصة وقيمتها، يمكن تعريفهما هنا. لا يتم استبدال هذه المعلمات ديناميكيًا ويتم تقييدها بإرسال قيمة ثابتة لكل عملية تشغيل.
انقر فوق تسجيل.

ملاحظة: يتم نقل معلّمات الاستبدال والمعلّمات المخصصة التي تم إنشاؤها على مستوى التسجيل بشكل متتالٍ إلى مستوى النشر والارتباط.

نشر أداة تعلّم خارجية لـ LTI Advantage

تتيح عمليات النشر مشاركة الأدوات المسجّلة في Brightspace مع وحدات تنظيمية معيّنة أو توابع الوحدات التنظيمية الأصل. عند نشر أداة ما، فإنك تحدد الملحقات المتوفرة، بالإضافة إلى كل إعدادات الأمان المنطبقة. تتوفر خانة اختيار للسماح لمسؤولي LTI بتعيين ما إذا كانت كل الارتباطات الموجودة أدنى هذا المستوى معينة تلقائيًا إلى فتح كمورد خارجي.

ملاحظة: لنشر أداة التعلّم الخارجية، تأكد من تعيين أذونات إدارة عمليات تسجيل أداة LTI Advantage وإدارة عمليات نشر أداة LTI Advantage على مستوى المؤسسة ومن تسجيل الأداة.

لنشر أداة تعلّم خارجية

من قائمة أدوات المسؤول، انقر فوق أدوات التعلّم الخارجية.
في علامة التبويب ‏LTI Advantage، انقر فوق عملية نشر جديدة.
الشكل: انقر فوق نشر جديد في علامة التبويب LTI Advantage.
من القائمة المنسدلة الأداة، حدد تسجيل.
أدخل الاسم والوصف.
حدِّد ملحقًا:
- خدمة الإشعارات على المنصة: يمكنك أيضًا تمكين خدمة الإشعارات على المنصة كجزء من عملية النشر، ما يتيح لأدوات التعلّم الخارجية تسجيل معالجات الأدوات وتحديثها وحذفها من أجل تلقي الإشعارات ويمكّن إشعار النسخ السياقي من إعلام الأدوات عند نسخ مقرر تعليمي.
  
  الشكل: حدد خدمة الإشعارات على المنصة وإشعار النسخ السياقي إذا كنت ترغب في تمكين خدمة الإشعارات على المنصة لعملية النشر.
حدد إعدادات الأمان، وإعدادات التكوين المرغوبة.
قم بتعيين أي معلمات استبدال مطلوبة. يمكن للمستخدمين الاختيار من قائمة محددة مسبقًا للمعلّمات التي يتم استبدالها ديناميكيًا بقيمة من Brightspace عند التشغيل. تدعم Brightspace حاليًا المعلمات الآتية:
- ‎$CourseSection.timeFrame.begin
- ‎$CourseSection.timeFrame.end
- ‎$ResourceLink.available.startDateTime
- ‎$ResourceLink.available.endDateTime
- ‎$ResourceLink.submission.endDateTime
تعيين أيّ معلّمات مخصصة مطلوبة: في الحالات التي تحتاج فيها الأدوات إلى تعريف كل من اسم معلّمة مخصصة وقيمتها، يمكن تعريفهما هنا. لا يتم استبدال هذه المعلمات ديناميكيًا ويتم تقييدها بإرسال قيمة ثابتة لكل عملية تشغيل.
حدد إضافة وحدات تنظيمية للتصريح بمشاركة الأداة.
انقر فوق إنشاء عملية نشر.

ملاحظة: يتم نقل معلمات الاستبدال والمعلمات المخصصة التي تقوم بإنشائها على مستوى التسجيل بشكل متتالٍ إلى مستوى النشر والارتباط. بعد إنشاء عملية نشر لهذه الأداة، لن يكون من الممكن تغيير الأداة الخاصة بهذا النشر بعد الآن.

بمجرد نشر الأداة بنجاح، ستتلقى معرِّف نشر. وهو معرِّف عالمي فريد مستند إلى GUID لعملية النشر هذه تحديدًا. ويتم استخدامه كمرجع فريد لعملية نشر الأداة المسجلة هذه تحديدًا، وقد تطلبه الأداة في أثناء الإعداد.

قد تتضمن الأدوات المسجّلة عمليات نشر متعددة. ويمكن أن تكون كل عملية نشر فردية فريدة وتدعم القدرة على استخدام ملحقات LTI وإعدادات الأمان المختلفة لكل عملية نشر. عملية النشر هي ما تشارك أداة التعلّم مع المقررات التعليمية. يمثل زر المشاركة لعمليات النشر إضافة وحدات تنظيمية طريقةَ توفير أداتك الجديدة لمقرراتك التعليمية.

يمكن أيضًا إنشاء معلمات الاستبدال والمعلمات المخصصة على مستوى النشر والتتالي إلى مستوى الارتباط. وإذا تم إنشاء المعلّمات على مستوى التسجيل، فستكون مرئية على مستوى النشر والارتباط، ولكنها ستكون باهتة وغير قابلة للتحرير. وإذا تم إنشاء معلمة على مستوى التسجيل والنشر، فسيتم استخدام معلمة النشر في تشغيل LTI.

إنشاء ارتباط تعلّم خارجي لـ LTI Advantage

عندما تنشئ عملية نشر أداة بنجاح، ستحتاج إلى إنشاء ارتباطات LTI. ويمكن إنشاء الارتباطات لاستخدامها في الوحدة (الوحدات) التنظيمية من عملية النشر، أو المستخدمين الذين لديهم أذونات يمكنهم إنشاء ارتباطات فردية على مستوى المؤسسة التي تم نشر الأداة فيها. وفي الحالات التي تتطلب فيها الأداة إنشاء عدة ارتباطات LTI لكل مقرر تعليمي أو للعديد من المقررات التعليمية، ستوفر الأداة سير عمل الربط لموضوع معيّن لتمكين المستخدمين من إنشاء الارتباطات بسرعة وسهولة.

تُنشئ أغلب التكاملات ارتباطات LTI عبر الربط لموضوع معيّن. وأحيانًا قد تحتاج إلى إنشاء ارتباط LTI يدويًا. ويمكنك إنشاء هذه الارتباطات بالطرق الآتية:

من صفحة النشر الخاصة بأداة تم نشرها حديثًا، انقر فوق عرض الارتباطات.
يمكنك إضافة ارتباطات جديدة مباشرة من صفحة أداة التعلّم الخارجية في مقرر تعليمي ما، ضمن LTI Advantage. العناصر المميزة باللون الأزرق والقابلة للنقر فوقها هي ارتباطات يمكنك تحريرها وهي على مستوى المقرر التعليمي. وتكون أسماء الارتباطات الباهتة ارتباطات تم إنشاؤها على مستوى النشر ولا يمكن تحريرها على مستوى المقرر التعليمي. لاحظ أن الارتباطات التي تم إنشاؤها في الوحدة التنظيمية لن تكون مرئية من مستوى النشر.

ملاحظة: تظهر الارتباطات التي تم إنشاؤها لعملية نشر في كل المقررات التعليمية التي تتم مشاركة عملية النشر فيها. يمكن أيضًا إنشاء معلمات الاستبدال والمعلمات المخصصة على مستوى الارتباط. وإذا تم إنشاء المعلمات أو النشر على مستوى التسجيل أو النشر، فستكون مرئية على مستوى الارتباط، ولكنها ستكون باهتة وغير قابلة للتحرير. وإذا تم إنشاء المعلمة نفسها على مستوى التسجيل والنشر والارتباط، فسيتم استخدام معلمة الارتباط في تشغيل LTI.

<![CDATA[ ]]>

لإنشاء ارتباط LTI

من قائمة أدوات المسؤول، انقر فوق أدوات التعلّم الخارجية.
ضمن علامة التبويب LTI Advantage، حدد عملية نشر موجودة.
قم بالتمرير لأسفل وانقر فوق عرض الارتباطات.
انقر فوق ارتباط جديد.
حدد الحقول الآتية في مقطع إنشاء ارتباط:
1. الاسم: الاسم المطلوب لمحدد المحتوى. الاسم الذي تحدده هنا هو الاسم الذي يظهر في واجهة المستخدم في مناطق أخرى.
2. عنوان URL: عنوان URL لنقطة بدء التشغيل حيث ينتقل المستخدم عند النقر فوق محدد المحتوى.
3. الوصف: وصف اختياري لمساعدة المستخدمين على فهم الأداة.
4. النوع: يقرر النوع المحدد كيفية استخدام هذا الارتباط. وتكون القيمة الافتراضية هي التشغيل الأساسي، ما يعني أن الارتباط لا ينفذ إلا عملية تشغيل LTI المعتادة. للحصول على ربط لموضوع معين، حدد أحد أنواع محددات الربط لموضوع معيّن الآتية التي تدعمها Brightspace:
  - الارتباط السريع ذو الصلة بالربط لموضوع معيّن: يعرض الارتباط كمحدد محتوى في قوائم الارتباطات السريعة لدينا.
  - Insert Stuff ذو الصلة بالربط لموضوع معيّن: يعرض الارتباط كمحدد محتوى في مربع حوار Insert Stuff في محرر Brightspace.
    ملاحظة: المكون الإضافي المستخدم يجب أن يقرره موفر الأداة.
5. العرض والارتفاع: عند تحديد المحتوى، تفتح Brightspace نافذة iFrame تعرض واجهة مستخدم الأداة لاكتشاف المحتوى. تفرض هذه الإعدادات حجم iFrame.
6. معلّمات الاستبدال: يمكنك الاختيار من قائمة محددة سابقًا للمعلّمات التي يتم استبدالها ديناميكيًا بقيمة من Brightspace عند التشغيل. تدعم Brightspace حاليًا المعلمات الآتية:
  - ‎$CourseSection.timeFrame.begin
  - ‎$CourseSection.timeFrame.end
  - ‎$ResourceLink.available.startDateTime
  - ‎$ResourceLink.available.endDateTime
  - ‎$ResourceLink.submission.endDateTime
7. المعلمات المخصصة: في الحالات التي تحتاج فيها الأدوات إلى تعريف كل من اسم معلمة مخصصة وقيمتها، يمكن تعريفهما هنا. لا يتم استبدال هذه المعلمات ديناميكيًا ويتم تقييدها بإرسال قيمة ثابتة لكل عملية تشغيل.
انقر فوق حفظ وإغلاق.

ملاحظة:

ينتج عن مهام سير العمل الآتية ارتباط بالإعداد الافتراضي فتح كمورد خارجي بغض النظر عن إعداد النشر:

تجربة الدروس: إذا تمت إضافة ارتباط من المحتوى > الأنشطة الموجودة > أدوات التعلّم الخارجية.
محرر Brightspace: الارتباطات السريعة التي تم إنشاؤها عبر CIM

تظهر المعلّمات البديلة والمخصصة التي تتم مشاركتها من مستوى التسجيل أو النشر بلون رمادي على مستوى الارتباط وهي غير قابلة للتحرير. إذا تم إنشاء معلمة مكررة على مستوى الارتباط، يتم تضمين تفاصيل معلمة الارتباط في عملية التشغيل.