وثائق المسؤول

فهم متغيرات استبدال المَعلم المخصص لـ LTI

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

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

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

تدعم D2L متغيرات استبدال المعلمات المخصصة الآتية:

‎$User.id
‎$User.username
‎$Person.email.primary
‎$Person.name.full
‎$Person.name.family
‎$Person.name.given
‎$ResourceLink.title
‎$ResourceLink.description
‎$CourseTemplate.sourcedId
‎$CourseTemplate.title
‎$CourseOffering.sourcedId
‎$CourseOffering.title
‎$CourseSection.label
‎$CourseSection.sourcedId
‎$CourseSection.title
$CourseSection.dept
‎$CourseSection.timeFrame.begin
‎$CourseSection.timeFrame.end
‎$Context.id.history
‎$ResourceLink.id.history

تأكد من تعيين متغير التكوين d2l.Tools.Lti.CustomParamSubstitution.IsEnabled إلى "صواب" للسماح للمستخدمين بإضافة أدوات جهات خارجية تتطلب متغيرات استبدال للمعلمات المخصصة.