تعرض واجهات برمجة تطبيقات Brightspace الوظائف للسماح للمستخدمين بترحيل ارتباطات Legacy 1.1 إلى Advantage 1.3. تقوم واجهة برمجة التطبيقات هذه بترحيل ارتباط واحد في كل مرة، وهو أكثر فائدة للارتباطات على مستوى المؤسسة التي تتم مشاركتها مع مقررات دراسية متعددة.
يتم إنشاء ارتباطات LTI 1.1 على مستوى المؤسسة في الصفحة الرئيسية للمثيل. انتقل إلى أدوات المسؤول (أيقونة الترس) > أدوات التعلم الخارجية > إدارة روابط الأدوات (القديمة)
الشكل: انتقل إلى إدارة روابط الأدوات (القديمة) لبدء عملية الترحيل.
يتم العثور على روابط مستوى المؤسسة التي تمت مشاركتها مع المقررات الدراسية داخل المقرر الدراسي. انتقل إلى مسؤول الدورة > أدوات التعلم الخارجية > إدارة روابط الأدوات (القديمة). تظهر هذه في عنوان كعناصر واجهة مستخدم غير قابلة للتفاعل.
الشكل: يمكنك عرض الروابط على مستوى المؤسسة في الجدول. تظهر هذه في عنوان عمود.
لترحيل الارتباط، تحتاج إلى DeploymentID وLinkID ومعرف موفر الأداة اختياريا. يمكن العثور على هذه المعلومات في مجموعات البيانات وواجهات برمجة التطبيقات التالية:
ترجع واجهة برمجة تطبيقات GET هذه قائمة بجميع ارتباطات LTI 1.1 التي تنتمي إلى وحدة تنظيمية:
- الحصول على / d2l / api / le/(الإصدار)/ LTI / رابط /(orgUnitId)/
انسخ LtiLinkId للرابط الذي تريد ترحيله.
الشكل: حدد وانسخ قيمة LtiLinkId.
استخدم واجهة برمجة تطبيقات GET هذه للحصول على DeploymentID لنشر LTI 1.3 Advantage حيث تريد ترحيل هذا الارتباط 1.1:
- الحصول على / d2l / api / le/(الإصدار)/ltiadvantage/النشر/
الشكل: حدد وانسخ DeploymentID واسم توزيع LTI 1.3 Advantage.
يمكنك الآن بدء عملية الترحيل. استخدم واجهة برمجة التطبيقات هذه:
https://docs.valence.desire2learn.com/res/ltiadvantage.html#post--d2l-api-le-(version)-ltiadvantage-migration-links-(linkId)
- POST /d2l/api/le/(الإصدار)/ltiadvantage/الهجرة/الروابط/(معرف الرابط)
يجب أن يحتوي نص واجهة برمجة التطبيقات هذه على المعلومات التالية:
{
"DeploymentId": "GUID من النشر",
"ToolProviderId": <strong>صِفْر</strong>
<strong>}</strong>
للتحقق من نجاح واجهة برمجة التطبيقات هذه، قم بتشغيل واجهة برمجة تطبيقات الحصول على الروابط مرة أخرى، ويجب ألا يظهر الرابط الذي تم ترحيله في هذه القائمة. يظهر هذا الارتباط الذي تم ترحيله الآن في واجهة المستخدم. يمكن العثور على هذا من خلال الانتقال إلى أدوات المسؤول (أيقونة الترس) > أدوات التعلم الخارجية > نشر ميزة LTI، ثم حدد النشر الخاص بك، وانقر فوق عرض الروابط.
من المهم التحقق من أن الرابط الذي تم ترحيله يعمل بعد الترحيل. ضع هذا الرابط في المحتوى وقم بتشغيل هذا الرابط. يتطلب ذلك معرفة كيفية عمل الأداة لضمان نجاح الإطلاق.
