توفر حزمة توسيع الأدوات البرمجية للصفحة الرئيسية مجموعة من أدوات النظام البرمجية للصفحة الرئيسية لتوفير تجربة تعلّم مخصصة أكثر لصفحاتك الرئيسية.
مهم: سيتم إيقاف حزمة توسيع الأدوات للصفحة الرئيسية المخصصة المستضافة في سبتمبر 2024/20.24.9. يمكن للعملاء الاستمرار في استخدام الإصدارات المستضافة من الأداة البرمجية حتى ذلك التاريخ، ولكنها لم تعد مدعومة من D2L. يجب على العملاء الذين يستخدمون الإصدارات المستضافة المخصصة من الأدوات البرمجية الترقية إلى الأدوات البرمجية الجديدة لنظام Brightspace.
تتضمن الأدوات البرمجية المخصصة المستضافة التي سيتم استبدالها بالأدوات البرمجية الخاصة بالنظام ما يأتي:
- الأداة البرمجية "جدول المحتويات المرئي"
- الأداة البرمجية "نافذة الترحيب"
- الأداة البرمجية "شريط الصور"
- الأداة البرمجية "جوائز المتعلِّم"
- الأداة البرمجية "الإعلانات المبسطة"
- الأداة البرمجية "بطاقة ملف التعريف الفردية"
- الأداة البرمجية "متصفح المحتوى"
تتضمن الأدوات البرمجية المخصصة المستضافة التي لن يتم دعمها بعد ذلك ما يأتي:
ملاحظة: تُعد الأداة البرمجية "ملفات التعريف المتعددة" جزءًا من حزمة توسيع الأدوات البرمجية للصفحة الرئيسية وستستمر في العمل بشكل طبيعي كأداة برمجية للنظام.
إذا كانت لديك حاليًا أداة برمجية مخصصة مستضافة متوفرة في مثيل Brightspace الخاص بك، فستتم إضافة إصدار جديد من الأدوات البرمجية الجديدة للنظام من الأداة البرمجية نفسها إلى المثيل الخاص بك.
تحقق مما إذا كانت هناك حاجة إلى استبدال الأدوات البرمجية الخاصة بك
إذا كان لديك إذن إنشاء/تحرير الصفحة الرئيسية، يتم عرض رسالة تحذير على كل الأدوات البرمجية المخصصة المستضافة النشطة على الصفحة الرئيسية بالتنسيق الآتي: "الإجراء المطلوب: تحديث الأداة البرمجية: دعم هذه الأداة البرمجية ينتهي. للحصول على المساعدة الآلية لاستبدال هذه الأداة البرمجية، انتقل إلى خدمة دعم HWEP EOL".
الشكل: استخدام خدمة الرسائل في الأداة البرمجية (على سبيل المثال، في الأداة البرمجية "جدول المحتويات المرئي") للانتقال إلى خدمة دعم HWEP EOL.
ملاحظة: يظهر تحذير مماثل أيضًا على صفحة أداة إدارة الصفحة الرئيسية إذا كانت هناك إصدارات مخصصة مستضافة من الأدوات البرمجية النشطة في البيئة. انقر فوق هذا التحذير للانتقال إلى صفحة خدمة الاستبدال التلقائي للأداة البرمجية المخصصة.
من صفحة خدمة الاستبدال التلقائي للأداة البرمجية المخصصة، يمكنك القيام بما يأتي:
- مراجعة قائمة تتضمن كل الأدوات البرمجية المخصصة المستضافة وعدد الصفحات الرئيسية التي تنشط فيها الأداة البرمجية.
- البحث عن المواقع الدقيقة التي تنشط فيها كل أداة برمجية بالنقر فوق رقم في الصف المقابل لعمود الصفحات الرئيسية باستخدام الأدوات البرمجية القديمة.
الشكل: استخدام صفحة خدمة الاستبدال التلقائي للأداة البرمجية المخصصة لتحديد موقع الأدوات البرمجية المخصصة المستضافة أو استبدالها أو إزالتها.
لمزيد من المعلومات عن كيفية تحديد الأدوات البرمجية القديمة التي تستخدمها والتخطيط لإيقاف حزمة توسيع الأدوات البرمجية للصفحة الرئيسية في بيئتك، راجع الترقية من الأدوات البرمجية المستضافة.
ملاحظة: ستتم إضافة وظيفة الاستبدال التلقائية في تاريخ لاحق.
استخدم خدمة استبدال الأداة البرمجية المخصصة المستضافة
تُعَد خدمة استبدال الأداة البرمجية المخصصة المستضافة جزءًا من صفحة الأداة البرمجية المخصصة المستضافة (دعم انتهاء العمر الافتراضي للأدوات البرمجية المخصصة المستضافة). تتيح لك خدمة الاستبدال ما يأتي:
- استبدال جميع مثيلات الأداة البرمجية المخصصة المستضافة بإصدار النظام بشكل مجمع (سيتم ترحيل التكوينات تلقائيًا).
- حذف جميع مثيلات الأداة البرمجية المستضافة المخصصة بشكل مجمع.
جهز موقعك
لدعم الاستبدال السلس للأدوات البرمجية المخصصة المستضافة، ضع في الحسبان ما يأتي:
-
تأكد من عدم تمكّن أي شخص من إضافة أدوات برمجية مخصصة مستضافة إلى الصفحات الرئيسية في أثناء نشاط الخدمة: إما بإخبار الفريق بأن الأدوات البرمجية المخصصة المستضافة لم يعد مسموحًا بها أو تغيير أذونات تحرير الصفحات الرئيسية مؤقتًا للأدوار ذات الصلة.
-
تأكد من أنه بالنسبة إلى كل أداة برمجية مخصصة مستضافة، يتم تمكين الأداة البرمجية للنظام المطابق لمثيلك، وأن الأداة البرمجية للنظام تم تنشيطها لمؤسستك. قدمت D2L تلقائيًا استحقاقات للأداة البرمجية للنظام المكافئة لجميع العملاء الذين يستخدمون الأدوات البرمجية في حزمة توسيع الأدوات البرمجية للصفحة الرئيسية المخصصة المستضافة.
-
خطِّط لتشغيل خدمة استبدال الأداة البرمجية خلال فترة الاستخدام خارج أوقات الذروة. تحتوي الأدوات البرمجية المخصصة المستضافة والأدوات البرمجية الخاصة بالنظام على اختلافات طفيفة قد تشتت المستخدمين إذا تم تغييرها فجأة.
تحذير: عند جدولة فترات عدم الإتاحة، ضع في الحسبان أن الأدوات البرمجية لها مدة تخزين مؤقت تصل إلى دقيقتين. بعد اكتمال الترحيل، قد لا تظهر الأدوات البرمجية فورًا على أنها تم ترحيلها إلا بعد انقضاء فترة الدقيقتين هذه.
شغّل خدمة استبدال الأداة البرمجية المخصصة المستضافة
تحذير: لا يمكن عكس خدمة الاستبدال التلقائي تلقائيًا. الطريقة الوحيدة لاستعادة الإجراءات التي قامت بها خدمة الاستبدال هي التراجع عن التغييرات يدويًا.
لتشغيل خدمة استبدال الأداة البرمجية المخصصة المستضافة
- انتقل إلى صفحة الأداة البرمجية المخصصة المستضافة.
- حدد أداة برمجية تريد استبدالها. لا يمكن تطبيق الخدمة إلا على أداة برمجية مخصصة مستضافة واحدة فقط في المرة الواحدة، ويجب أن تكون هذه الأداة البرمجية في مرحلة انتهاء عمرها الافتراضي. وهذا يشمل جميع الأدوات البرمجية في حزمة توسيع الأدوات البرمجية للصفحة الرئيسية باستثناء الأداة البرمجية "ملفات التعريف المتعددة".
ملاحظة: لا يمكن تشغيل خدمة الاستبدال على الأدوات البرمجية المخصصة المستضافة التي لا تحتوي على عنصر تناظري للأداة البرمجية الخاصة بالنظام. يتضمن ذلك تقويم K12 وتذييل K12.
- انقر فوق استبدال بجانب الأداة البرمجية.
الشكل: النقر فوق استبدال لتشغيل خدمة استبدال الأداة البرمجية المخصصة المستضافة.
يتم تشغيل خدمة الاستبدال كمهمة خلفية على موقع Brightspace.
ملاحظة: إذا حاولت تشغيل خدمة الاستبدال على أداة برمجية بينما تكون قيد التقدم بالفعل للأداة البرمجية نفسها، فإن المحاولة الأخيرة لن تستمر.
يمكنك التنقل بعيدًا عن صفحة الأدوات البرمجية المخصصة المستضافة دون تعطيل خدمة الاستبدال.
عند الانتهاء، ترسل خدمة الاستبدال إشعارًا إلى مقطع تنبيهات التحديث (الممثل في رمز الجرس) الخاص بشريط التنقل الرئيسي الخاص بـ Brightspace. إذا واجهت خدمة الاستبدال مشكلة، فسيتضمن الإشعار رمز خطأ. انقر على الإشعار للانتقال إلى صفحة الأدوات البرمجية المخصصة المستضافة للحصول على تفاصيل حول رمز الخطأ.
راجع قائمة رموز الخطأ الواردة أدناه للحصول على مزيد من المعلومات.
| الكود |
التعريف |
الحل |
|---|
| x001 |
لا تحتوي الأداة البرمجية المخصصة التي تحاول استبدالها على أداة برمجية خاصة بالنظام مكافئة. |
إرسال تذكرة دعم. |
| x002 |
تعذر ترحيل ملفات التكوين المقترنة بهذه الأداة البرمجية. |
إرسال تذكرة دعم. |
| x003 |
حدثت مشكلة في ترحيل تعريف دور أقدم أداة برمجية مخصصة مثبَّتة على مستوى المؤسسة. |
إرسال تذكرة دعم. |
| x004 |
أضاف مستخدم هذه الأداة البرمجية إلى صفحة رئيسية أثناء تشغيل خدمة الاستبدال. |
تشغيل خدمة الاستبدال لهذه الأداة البرمجية المخصصة مرة أخرى. |
| x005 |
تعذر استبدال هذه الأداة البرمجية. |
إرسال تذكرة دعم. |
| x006 |
حدثت مشكلة. العنصر التناظري للأداة البرمجية الخاصة بالنظام لهذه الأداة البرمجية المخصصة غير مؤهل. |
إرسال تذكرة دعم. |
| x007 |
يقوم مستخدم آخر حاليًا بتشغيل عملية الاستبدال لهذه الأداة البرمجية. |
أعِد تشغيل الخدمة مرة أخرى بعد اكتمال التشغيل الحالي (إذا لزم الأمر). |
| x008 |
تعذر ترحيل العناوين المخصصة المقترنة بهذه الأداة البرمجية. |
إرسال تذكرة دعم. |
نظرة عامة على الإجراءات والاعتبارات المتعلقة بخدمة الاستبدال
تأكيد الاستحقاقات وحالة الأداة
تتحقق خدمة الاستبدال من تمكين إصدار النظام للأداة البرمجية للمثيل وتتحقق مما إذا تم تنشيط الأداة البرمجية الخاصة بالنظام في أدوات المؤسسة:
- إذا اكتشفت خدمة الاستبدال أن الأداة البرمجية الخاصة بالنظام غير مُمكّنة على مستوى المثيل، فإنها تخرج وتخطر المستخدم.
- إذا اكتشفت خدمة الاستبدال أن الأداة البرمجية الخاصة بالنظام غير مُمكّنة في أدوات المؤسسة، فإنها تقوم بتنشيط الأداة البرمجية على مستوى المؤسسة وتستمر في العمل.
- إذا لم تكن الأداة البرمجية نشطة في أي وحدة من الوحدات التنظيمية الفرع، فستستمر خدمة الاستبدال كما لو كانت الأداة البرمجية نشطة للوحدة التنظيمية وتستبدل الأداة البرمجية. تظهر الأداة البرمجية المستبدلة غير نشطة على الصفحة الرئيسية حتى يقوم مالك الصفحة الرئيسية بتنشيط الأداة البرمجية للوحدة التنظيمية.
كتالوج جميع الصفحات الرئيسية المتأثرة والمقررات التعليمية
تقوم خدمة الاستبدال بمسح الموقع للبحث عن جميع مثيلات الأداة البرمجية على الصفحات الرئيسية وتحديد جميع المقررات التعليمية التي تستخدم الصفحات الرئيسية مع هذه الأداة البرمجية. في بعض المواقع، قد تُثبَّت الأداة البرمجية عدة مرات عن طريق الخطأ. في هذه الحالات، تحدد الخدمة تثبيت الأداة البرمجية على مستوى المؤسسة مع تاريخ التثبيت الأقدم كإصدار متعارف عليه. في معظم الحالات، تكون التثبيتات الثانوية مطابقة لتثبيت المؤسسة الأصلي، ما يجعل هذه الإستراتيجية غير ضارة. ومع ذلك، هناك حالات خاصة تم تحديدها بواسطة استعلامات قاعدة البيانات، حيث تم تخصيص التثبيتات الثانوية بطريقة ما. ويجب إدارة هذه التثبيتات الثانوية المخصصة يدويًا قبل تشغيل خدمة الاستبدال. وقد تواصلت D2L مباشرة مع هؤلاء العملاء.
ترحيل ملفات التكوين
تحتوي الأدوات البرمجية المخصصة المستضافة على ملف config.txt افتراضي على مستوى المؤسسة. تتحقق خدمة الاستبدال مما إذا كان قد تم ترحيل ملف config.txt الخاص بالمؤسسة إلى بيانات الأداة البرمجية للمؤسسة بالفعل، كما أنها تنفذ الترحيل إذا لم يتم ذلك بعد.
تستخدم الأدوات البرمجية المخصصة المستضافة مزيجًا من ملفات config.txt المخزنة محليًا وبيانات الأداة البرمجية المخزنة عن بُعد لحفظ التكوينات الخاصة لكل تكرار للمقرر التعليمي للأداة البرمجية. يتيح هذا النهج للأداة البرمجية أن تكون فريدة من نوعها في كل مقرر تعليمي.
تستخدم الأدوات البرمجية الخاصة بالنظام بيانات الأداة البرمجية بشكل حصري لتخزين البيانات. ولكي يكون الترحيل ناجحًا، يجب أن تنقل الخدمة البيانات من ملفات config.txt إلى بيانات الأداة البرمجية. باستخدام كتالوج المقررات التعليمية المتأثرة الخاص بها، تقوم خدمة الاستبدال بقراءة البيانات من ملف config.txt لكل مقرر تعليمي ونسخها إلى بيانات الأداة البرمجية الخاصة بذلك المقرر التعليمي.
وفيما يأتي بعض الحالات المحتملة:
- إذا كان ملف config.txt المحلي مطابقًا للبيانات المخزنة بالفعل في بيانات الأداة البرمجية الخاصة بالمؤسسة، فإن التكوين المحلي يُعد مكررًا ولا يتم ترحيله. يمكن إضافة تكوينات مخصصة في المستقبل حسب الحاجة. لا تتم إزالة ملفات config.txt القديمة من نظام الملفات؛ حيث يتم الاحتفاظ بها في الموقع كنسخة احتياطية في حالة فشل خدمة الاستبدال.
- إذا كان ملف config.txt مفقودًا على مستوى المؤسسة، فسيتم ترحيل التكوينات من جميع مستويات المقرر التعليمي.
- إذا كان المقرر التعليمي يحتوي على تكوين موجود في كل من بيانات الأداة البرمجية وملف config.txt، فستحتفظ خدمة الاستبدال بالإصدار في بيانات الأداة البرمجية وتتجاهل بيانات config.txt. وعلى الرغم من أن هذا السيناريو غير محتمل، فإنه قد يحدث إذا تم استخدام كل من إصدار النظام والإصدار المخصص للأداة البرمجية في المقرر التعليمي. وإذا تعذرت قراءة JSON داخل ملف config.txt أو كان الملف نفسه غير قابل للقراءة، فلن يتم ترحيل التكوين. وإذا حدث هذا في حالة التكوين على مستوى المقرر التعليمي، فسترث الأداة البرمجية التكوين المخزن في المؤسسة.
ملاحظة: لا يتم ترحيل تكوينات المقررات التعليمية المُعاد تدويرها.
ترحيل تكوينات الدور
تحتوي جوائز المتعلّم، والإعلانات المبسطة، والأدوات البرمجية "نافذة الترحيب" على تعريفات للدور. وتعريفات الدور هي تعيين بين الأدوار المتاحة في الأداة البرمجية، مثل المتعلم أو الوسيط، والأدوار المحددة داخل Brightspace. بالنسبة إلى الأدوات البرمجية المخصصة المستضافة، يتم تخزين هذه التعريفات كمتغير JavaScript داخل حقل محتوى الأداة البرمجية المخصصة. أما الأدوات البرمجية الخاصة بالنظام، يتم تخزين تعريفات الدور في متغير تكوين خاص بكل أداة برمجية.
ملاحظة: بالنسبة إلى الأدوات البرمجية المخصصة المستضافة، لا يمكن تحديد تعريفات الدور إلا لكل تثبيت أداة برمجية، وليس حسب الوحدة التنظيمية.
فيما يأتي مثال على تعريفات الدور:
var roleDefinitions = {
"المسؤول": [
"D2LAdmin"
],
"الوسيط": [
"D2LAdmin",
,"Super Administrator"
"Instructor"
],
"المعلّم": [],
"المتعلّم": []
};
تقوم خدمة الاستبدال بمسح حقل المحتوى الخاص بالأداة البرمجية، واستخراج تعريف الدور، وحفظه في متغير تكوين المؤسسة المناسب لهذه الأداة البرمجية.
إذا كان كائن JavaScript الذي يحدد تعريف الدور غير صحيح، فلن يتم ترحييل تعريف الدور المقابل.
في الحالات التي يتم فيها تثبيت أداة برمجية عدة مرات على الموقع، تستخدم خدمة الاستبدال تعريفات الدور من تثبيت الأداة البرمجية على مستوى المؤسسة ذات تاريخ التثبيت الأقدم كتعريفات الدور المتعارف عليها للموقع. تم إجراء بحث في قاعدة البيانات لجميع تكوينات الدور للتأكد من عدم وجود مواقع ذات تعريفات دور متباينة عبر عمليات التثبيت المتعددة.
ترحيل عنوان الأداة البرمجية والعناوين المخصصة
تحاول خدمة الاستبدال ترحيل التسمية المخصصة المقترنة بالأداة البرمجية المخصصة المستضافة بما في ذلك اسم الأداة البرمجية المخصصة، وتجاوز اسم الأداة البرمجية المخصصة، وتجاوز اسم الأداة البرمجية للصفحة الرئيسية:
| نوع العنوان |
عنوان UI لـ Brightspace |
الموقع |
التشغيل |
|---|
| حقل "اسم الأداة البرمجية المخصصة" |
 الشكل: حقل الاسم.
|
انقر فوق الرمز "تحرير" الموجود بجانب اسم الأداة البرمجية > خصائص الأداة البرمجية المخصصة > الاسم. |
يتم تطبيق التجاوز في الوحدة التنظيمية حيث تم تثبيت الأداة البرمجية، بشرط عدم وجود تجاوز لاسم الأداة البرمجية المخصصة الموجودة للأداة البرمجية الخاصة بالنظام. وتستخدم خدمة الاستبدال اسم أحدث أداة برمجية تم إنشاؤها. |
| تجاوز اسم الأداة البرمجية المخصصة |
 الشكل: خانات الاختيار "إعدادات الأداة البرمجية" والزر التبادلي "اسم الأداة البرمجية".
|
انقر فوق الرمز "تخصيص" الموجود بجانب اسم الأداة البرمجية > إعدادات الأداة البرمجية > اسم الأداة البرمجية > حدد تخصيص. |
إذا كان هذا التجاوز موجودًا، فسيتم تطبيقه كتجاوز إضافي في الوحدة التنظيمية حيث تم تثبيت الأداة البرمجية. وتستخدم الأداة البرمجية الاسم من التجاوز الذي تم إنشاؤه مؤخرًا. |
| تجاوز اسم الأداة البرمجية للصفحة الرئيسية |
الشكل: خانات الاختيار "إعدادات الأداة البرمجية" والزر التبادلي "اسم الأداة البرمجية".
|
انقر فوق تصميم هذه الأداة البرمجية من أي صفحة رئيسية > إعدادات الأداة البرمجية > اسم الأداة البرمجية > حدد تخصيص. |
إذا كان هذا التجاوز موجودًا، فسيتم تطبيقه بالإضافة إلى الصفحة الرئيسية. تعتمد أداة البرمجية اسم أخر تجاوز تم إنشاؤه مؤخرًا.
ملاحظة: تعطي الأداة البرمجية الأولوية لاستخدام تجاوز اسم الأداة البرمجية للصفحة الرئيسية على أي اسم آخر.
|
استبدال الأداة البرمجية المخصصة المستضافة
جميع الأدوات البرمجية الخاصة بالنظام والأدوات البرمجية المخصصة لها معرّفات فريدة. تتم إضافة الأدوات البرمجية إلى الصفحات الرئيسية بالرجوع إلى هذه المعرّفات. لاستبدال أداة برمجية مخصصة على صفحة رئيسية، تُحدّث خدمة الاستبدال سجل الصفحة الرئيسية لاستخدام معرّف الأداة البرمجية الخاصة بالنظام المقابل. يقوم هذا الإجراء بإزالة الأداة البرمجية المخصصة القديمة وإضافة الأداة البرمجية الخاصة بالنظام. تعمل الأداة البرمجية الخاصة بالنظام المضافة حديثًا بشكل مطابق للأداة البرمجية المخصصة القديمة، حيث تم ترحيل تكوينها وأدوارها سابقًا.
لا يتم تعديل المقررات التعليمية مباشرةً. لا تتأثر المقررات التعليمية الفردية إلا في حالة تحديث الصفحة الرئيسية التي تستخدمها.
إلغاء تثبيت الأداة البرمجية المخصصة المستضافة
في المرحلة النهائية، يتم إلغاء تثبيت الأداة البرمجية من الموقع لمنع استخدامها في المستقبل على الصفحات الرئيسية. داخل قاعدة البيانات، تتم إزالة الأداة البرمجية من قائمة الأدوات البرمجية المخصصة، وحذف جميع المحتوى المخصص المخزن سابقًا في حقل محتوى الأداة البرمجية. وهذا يعادل استخدام وظيفة الحذف في لوحة الأدوات البرمجية المخصصة في صفحة إدارة الأدوات البرمجية.
تحذير: إذا أضاف مستخدم أداة برمجية إلى صفحة رئيسية في أثناء تشغيل خدمة الاستبدال، فستكمل الخدمة عملها ولكنها لن تقوم بإلغاء تثبيت الأداة البرمجية. بدلاً من ذلك، يتم إرسال إشعار إلى المستخدم. في هذه الحالة، يجب إعادة تشغيل خدمة الاستبدال لإزالة الأداة البرمجية التي تمت إضافتها مؤخرًا. راجع مقطع تشغيل خدمة استبدال الأداة البرمجية المخصصة المستضافة.
بمجرد إلغاء تثبيت الأداة البرمجية من الموقع، تصبح غير متوفرة للاستخدام على الصفحات الرئيسية. نظرًا إلى أن خدمة الاستبدال تقوم بتحديث الصفحات الرئيسية وليس المقررات التعليمية، فهذا يعني أن المقررات التعليمية المُعاد تدويرها والمحذوفة وغير النشطة تتأثر أيضًا، على الرغم من عدم توفرها للمستخدمين.