تُستخدم واجهة المكون الإضافي الخاصة بـ IDeleteCourseOfferingHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لحذف مضامين المقررات التعليمية من Brightspace.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.CourseOfferings.Handlers.IDeleteCourseOfferingHandler.
توفر قوائم التكوين الآتية نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب:
حزمة التكامل لأنظمة معلومات الطالب، والقالب - مضمون المقرر التعليمي
- DeleteCourseOfferingValidateHandler (ترتيب الفرز = 10)
- DeleteCourseOfferingIMHandler (ترتيب الفرز = 10)
DeleteCourseOfferingValidateHandler
يجب استخدام هذا المعالج دائمًا. يقوم المعالج بإجراء التحقق من صحة الإدخال المطلوب لضمان عمل كافة معالجات الحذف الأخرى بشكل صحيح.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- التحقق من أن معرِّف نظام معلومات الطالب الذي في الطلب يتوافق مع مادة حقيقية في جداول IM.
- التحقق من أن نوع OrgUnit الذي تتوقعه الخدمة يتطابق مع نوع orgUnit الذي في قاعدة البيانات.
- إذا نجحت جميع عمليات التحقق، فإنه يحفظ ExternalOrgUnitInfo في الطلب لتستخدمه المعالجات اللاحقة.
سلوك الخطأ
في حالة فشل أي جزء من عملية التحقق من الصحة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تشغيل معالج التحقق من الصحة أولاً في قائمة المعالجات، قبل أي معالج يقوم بتحديث المعلومات أو حذفها من قاعدة البيانات.
DeleteCourseOfferingIMHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingIMHandler
السلوك المتوقع
إذا كان ثمة شيء يعتمد على مضمون المقرر التعليمي (فروع تسلسل IM الهرمي)، فيجب أن تفشل هذه المعالجة. يؤدي المعالج المهام الآتية:
- الحذف المبدئي لمضمون المقرر التعليمي من جداول حزمة التكامل لأنظمة معلومات الطالب إذا لم يكن ثمة شيء يعتمد على مضمون المقرر التعليمي.
- إزالة كافة علاقات الأصل بتسلسل IM الهرمي لهذا المضمون.
- تعيين حالة النتيجة إلى EntityDeleted.
- تستمر المعالجة إلى المعالج المكوَّن التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تشغيل معالج حذف IM في نهاية قائمة المعالجات.
DeleteCourseOfferingDeleteLEHandler
يتم استخدام هذا المعالج إذا كان السلوك المطلوب هو حذف كل المضامين المعينة لـ Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingDeleteLEHandler
السلوك المتوقع
لكل مضمون مقرر تعليمي معيّن لـ Brightspace، يقوم المعالج بتنفيذ المهام الآتية:
- حذف مضمون المقرر التعليمي (ما يؤدي تلقائيًا إلى إدخال تدقيق).
- وضع علامة على جميع التعيينات في مضمون المقرر التعليمي لـ Brightspace كمحذوفة.
- تعيين حالة النتيجة إلى EntityDeleted.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
- يجب أن يحدث هذا قبل حذف جدول IM (مثال: DeleteCourseOfferingIMHandler).
- لن يتم تكوين هذا المعالج في الوقت نفسه مع DeleteCourseOfferingInactiveLEHandler.
DeleteCourseOfferingCascadeDeleteCourseSectionHandler
يتم استخدام هذا المعالج إذا كان السلوك المطلوب هو نقل حذف مضمون المقرر التعليمي بشكل متتالٍ إلى كافة المقاطع التي تُعد فروعًا لمضمون المقرر التعليمي في جداول IM.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.DeleteCourseOfferingCascadeDeleteCourseSectionHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديد كافة المقاطع التي تُعد فروعًا للمضمون في جداول IM.
- لكل مقطع، يرسل المعالج DeleteCourseSection باستخدام القائمة الحالية للمعالجات لـ IDeleteCourseSectionHandler.
- إذا تم حذف مقطع واحد على الأقل، يقوم المعالج بتغيير حالة النتيجة إلى EntityDelted.
- تستمر المعالجة إلى المعالج المكوَّن التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن يحدث هذا قبل حذف مضمون المقرر التعليمي إما في Brightspace أو جداول IM (أي: DeleteCourseOfferingIMHandler وDeleteCourseOfferingDeleteLEHandler وDeleteCourseOfferingInactiveLEHandler)
- لا يعمل هذا المعالج بشكل صحيح ما لم يتم تكوين معالج DeleteCourseSection مطابق لكل معالج DeleteCourseOffering إضافي تم تكوينه. على سبيل المثال، في حالة استخدام DeleteCourseOfferingCascadeDeleteCourseSectionHandler وDeleteCourseOfferingIMHandler، يجب أيضًا استخدام DeleteCourseSectionIMHandler.