تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceCourseOfferingHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال مضامين المقررات التعليمية.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.CourseOfferings.Handlers.IReplaceCourseOfferingHandler.
يتم شحن قوائم التكوين الآتية لواجهة ReplaceCourseOfferingHandler مع المنتج. وتُدرَج مع نقطة الامتداد المخصصة لها.
حزمة التكامل لأنظمة معلومات الطالب، والقالب - مضمون المقرر التعليمي
- ReplaceCourseOfferingReadHandler (ترتيب الفرز = 10)
- ReplaceCourseOfferingValidateHandler (ترتيب الفرز = 20)
- ReplaceCourseOfferingDisallowParentChangesIfChildrenExistHandler (ترتيب الفرز = 30)
- ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler (ترتيب الفرز = 40)
- ReplaceCourseOfferingCreateLMSHandler (ترتيب الفرز = 50)
- ReplaceCourseOfferingCreateIMHandler (ترتيب الفرز = 60)
- ReplaceCourseOfferingSaveLMSHandler (ترتيب الفرز = 70)
- ReplaceCourseOfferingSaveIMHandler (ترتيب الفرز = 80)
ReplaceCourseOfferingCopyCourseHandler
يقوم ReplaceCourseOfferingCopyCourseHandler بتكوين النظام لنسخ محتوى المقرر التعليمي تلقائيًا من مقرر تعليمي مصدر إلى مضمون مقرر تعليمي تم إنشاؤه حديثًا باستخدام منصة حزمة التكامل لأنظمة معلومات الطالب.
التنفيذ
D2l.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCopyCourseHandler.
السلوك المتوقع
يقوم المعالج بتنفيذ المهام الآتية من خلال البحث عن الوحدة التنظيمية التي تريد نسخ المحتوى منها:
- إذا تم تمكين النسخة الضمنية للمقرر التعليمي من خلال واجهة المستخدم، فسيحاول العثور على الوحدة التنظيمية المراد النسخ منها عن طريق النسخ من قالب أصل أو مضمون مقرر تعليمي مشابه يحتوي على كود OrgUnit مطابق لكود OrgUnit للقالب.
- إذا تم استخدام نسخة المقرر التعليمي الصريحة، فسيبحث عن حقول ملحق "CopyCourseSourceExternalId" أو "CopyCourseParent" أو "CoupCourseSourceOrgUnitId" أو "CopyCourseSourceOrgUnitCode".
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
إذا قمت بتكوين قائمة ReplaceCourseOfferingHandler يدويًا، فضع هذا المعالج في النهاية.
ReplaceCourseOfferingReadHandler
يقرأ ReplaceCourseOfferingReadHandler جميع المعلومات المتعلقة بمضمون المقرر التعليمي الموجود في جداول Brightspace أو جداول IM لقاعدة البيانات التي سيتم استخدامها في معالجات أخرى.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول قراءة معلومات حول مضمون المقرر التعليمي من جداول IM.
- في حالة العثور عليها، يحاول قراءة أي تعيينات في Brightspace لمضمون المقرر التعليمي.
- في حالة العثور عليها، يحاول القراءة حول مضمون المقرر التعليمي من Brightspace.
- يتحقق من تحديد أي من الأصول (فصل دراسي أو قالب أو قسم) في الطلب.
- في حالة تحديده، يحاول المعالج استرداد تفاصيل التعيينات وOrgUnit لكل أصل محدد، ووضعها في request.ParentOrgUnits.
- إذا تم تعيين معرِّف أصل لنظام معلومات الطالب إلى عدة D2L OrgUnits، فسيتم استخدام أول فصل دراسي أو قالب فقط لكل معرِّف لنظام معلومات الطالب.
- إذا تم تحديد أصل ولكنه غير موجود في قاعدة البيانات، فإن DataProvider الأساسي يطرح OrgUnitMappingNotFoundException، الذي يتم التقاطه وتسجيله.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يسبق معالج القراءة معالجات التحقق من الصحة.
ReplaceCourseOfferingValidateHandler
يضمن هذا المعالج تعيين كود واسم صالحين إلى مضمون المقرر التعليمي ووجود قالب صالح.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- التحقق للتأكد من تحديد كود واسم للطلب. يجب أن تكون هذه القيم سلاسل بطول أكبر من 0.
- إذا كان الكود أو الاسم خاليًا أو فارغًا، يطرح المعالج ArgumentNullException وتتوقف كل عمليات المعالجة للمعالج.
- يجب وجود قالب أصل واحد على الأقل في request.ParentOrgUnits. في حالة عدم العثور على أصول قوالب، يتم طرح ParentNotFoundException وتتوقف كل عمليات المعالجة للمعالج.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
ReplaceCourseOfferingDisallowParentChangesIfChildrenExistHandler
يمكن استخدام هذا المعالج لمنع حذف قالب أصل تمت إضافته بواسطة حزمة التكامل لأنظمة معلومات الطالب أو تبديله لأي مضمون يشتمل بالفعل على فروع. وفي غياب هذا المعالج، يمكن تحديث الأصول التي أضافتها حزمة التكامل لأنظمة معلومات الطالب بحرية، ما قد يغير معلومات التسلسل الهرمي للسوابق والتوابع للمضمون الحالي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingParentDepartmentValidateHandler
السلوك المتوقع
- إذا كان المضمون موجودًا بالفعل (استبدال بدلاً من الإنشاء):
- إذا تمت إزالة OrgUnit أصل مضافة بواسطة حزمة التكامل لأنظمة معلومات الطالب أو استبدالها، فسيتم طرح استثناء لمنع تشغيل أي معالجات أخرى.
ملاحظة: ستتم دائمًا إزالة OrgUnits المضافة يدويًا مع وجود هذا المعالج أو من دونه
ملاحظات التكوين
- يجب تكوين هذا المعالج ليعمل بعد معالجات التحقق من الصحة.
- يجب تكوين هذا المعالج ليعمل قبل معالجات الإنشاء.
ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
يقوم هذا المعالج بتحديث قالب المقرر التعليمي الذي هو أصل المضمون حتى يتم تحديد أصول القسم في طلب المضمون.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- قراءة الأقسام المقترنة بالقالب الذي هو أصل مضمون المقرر التعليمي الحالي.
- إذا تم تحديد قسم في المضمون الذي لم يتم تعيينه حاليًا كأصل لقالب المقرر التعليمي، يقوم المعالج بتحديثه وفق ذلك.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
في أي وقت بعد معالجات القراءة.
ReplaceCourseOfferingCreateLMSHandler
ينشئ هذا المعالج مضامين المقررات التعليمية في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCreateLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود مضامين مقررات تعليمية في Brightspace مقترنة بالطلب في كل من جدول IM وجداول نظام إدارة التعلّم. يؤدي المعالج المهام الآتية:
- إنشاء مضمون المقرر التعليمي باستخدام المعلومات التي تم تمريرها في الطلب (ما يؤدي إلى تسجيل التدقيق التلقائي).
- إذا نجحت عملية الإنشاء، فسيقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated وتستمر المعالجة إلى المعالج التالي.
- في حالة وجود خطأ، يقوم المعالج بتعيين ReplaceRequestStatus = CreateFailed وإرجاع القيمة خطأ.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يوضع هذا المعالج بعد أي معالجات تحقق من الصحة.
- يجب أن يسبق معالج إنشاء نظام إدارة التعلّم معالج إنشاء IM.
ReplaceCourseOfferingCreateIMHandler
ينشئ هذا المعالج الكيان في جداول IM، بالإضافة إلى تعيين إذا تم تعريفه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCreateIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود كيان مطابق في جداول IM. يؤدي المعالج المهام الآتية:
- إنشاء مضمون المقرر التعليمي في منصة IM.
- إنشاء تسلسل IM الهرمي.
- في حالة وجود OrgUnit مقترنة بالطلب، ينشئ المعالج تعيين مضمون المقرر التعليمي الخاص بمنصة IM إلى مضمون المقرر التعليمي الخاص بـ Brightspace.
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
ضع هذا المعالج بعد أي معالجات CreateLMS.
ReplaceCourseOfferingSaveLMSHandler
يحفظ ReplaceCourseOfferingSaveLMSHandler أي تغييرات تم إجراؤها على مضمون المقرر التعليمي في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة وجود تغييرات سيتم حفظها لمضمون المقرر التعليمي في Brightspace. يؤدي المعالج المهام الآتية:
- إزالة أي أقسام من ParentOrgUnits الخاصة بالطلب (ستتم إضافتها كأصول للقالب الأصل للمضمون)
- تحديث مضمون المقرر التعليمي (ما يؤدي تسجيل التدقيق التلقائي).
- إذا نجح كل شيء، وإذا كان ReplaceRequestStatus! = EntityCreated، يقوم المعالج بتعيين ReplaceRequestStatus = EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
ضع هذا المعالج بعد أي معالجات إنشاء.
ReplaceCourseOfferingSaveIMHandler
يحفظ ReplaceCourseOfferingSaveIMHandler أي تغييرات تم إجراؤها على مضمون المقرر التعليمي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا إذا كانت هناك تغييرات سيتم حفظها لمضمون المقرر التعليمي. يؤدي المعالج المهام الآتية:
- إزالة أي أقسام من ParentOrgUnits الخاصة بالطلب (تتم إضافتها كأصول للقالب الأصل للمضمون).
- تحديث مضمون المقرر التعليمي (ما يؤدي تسجيل التدقيق التلقائي).
- إذا نجح كل شيء، وإذا كان ReplaceRequestStatus! = EntityCreated، يقوم المعالج بتعيين ReplaceRequestStatus = EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
ضع هذا المعالج بعد أي معالجات إنشاء.
ReplaceCourseOfferingSaveIMHandler
يحفظ معالج الحفظ أي تغييرات تم إجراؤها على كيان IM وتعييناته. ويشمل ذلك تحديث معلومات التسلسل الهرمي ونشر التغييرات في جميع السوابق والتوابع للمضمون المحدد.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingSaveIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة وجود تغييرات سيتم حفظها للكيان أو التعيينات في جداول IM. يؤدي المعالج المهام الآتية:
- تحديث كيان IM.
- تحديث تسلسل IM الهرمي وتحديث معلومات العلاقة لأي من الأصول/الفروع المتأثرة.
- تحديث تعيينات كيان IM.
- إذا نجح كل شيء، يعين ReplaceRequestStatus = EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
ضع هذا المعالج بعد أي معالجات SaveLMS.
ReplaceCourseOfferingNameNoUpdateLMSHandler
يُستخدم ReplaceCourseOfferingNameNoUpdateLMSHandler عندما لا ترغب مؤسسة في تحديث اسم مضمون المقرر التعليمي بعد الإنشاء الأولي. ويُعَد هذا المعالج ضروريًا إذا سمحت مؤسسة للمستخدمين بتحديث أسماء المقرر التعليمي من خلال Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingNameNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
من المتوقع تشغيل هذا المعالج بعد معالجات القراءة، ولكن قبل معالجات الإنشاء.
ReplaceCourseOfferingStatusNoUpdateLMSHandler
يُستخدم هذا المعالج عندما لا ترغب المؤسسة في تحديث الحالة بعد الإنشاء الأولي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingStatusNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الحالة.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
من المتوقع تشغيل هذا المعالج بعد معالجات القراءة، ولكن قبل الإنشاء.
ReplaceCourseOfferingDatesNoUpdateLMSHandler
يُستخدم ReplaceCourseOfferingDatesNoUpdateLMSHandler عندما لا تريد المؤسسة تحديث التواريخ بعد الإنشاء الأولي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingDatesNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث تاريخي البدء والنهاية.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
من المتوقع تشغيل هذا المعالج بعد معالجات القراءة، ولكن قبل معالج الإنشاء.
ReplaceCourseOfferingCodeNoUpdateLMSHandler
يُستخدم ReplaceCourseOfferingCodeNoUpdateLMSHandler عندما لا ترغب مؤسسة في تحديث كود مضمون المقرر التعليمي بعد الإنشاء الأولي. ويُعَد هذا المعالج ضروريًا إذا سمحت مؤسسة للمستخدمين بتحديث أكواد المقرر التعليمي من خلال Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingCodeNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الكود.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
من المتوقع تشغيل هذا المعالج بعد معالجات القراءة، ولكن قبل الإنشاء.
ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
يقوم ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler بتحديث قالب المقرر التعليمي الذي هو أصل المضمون حتى يتم تحديد أصول القسم في طلب المضمون.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingTemplateUpdateDepartmentsLMSHandler
السلوك المتوقع
- قراءة الأقسام (من Brightspace) المقترنة بالقالب الذي هو أصل مضمون المقرر التعليمي الحالي.
- إذا تم تحديد قسم في المضمون الذي لم يتم تعيينه حاليًا كأصل لقالب المقرر التعليمي، يقوم بتحديثه وفق ذلك.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يمكن استخدام هذا المعالج في أي وقت بعد معالجات القراءة.
ReplaceCourseOfferingValidateLMSOrgUnitExistsHandler
يتحقق هذا المعالج لمعرفة ما إذا تم حذف الوحدة التنظيمية التي يتوافق معها الطلب في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseOfferings.Handlers.ReplaceCourseOfferingValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء أو تم حذف الوحدة التنظيمية من Brightspace)، يحاول الحصول على ExternalOrgUnitInfo للطلب.
- إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أن هذه ليست عملية إنشاء، وتم حذف الوحدة التنظيمية من Brightspace. يتم طرح UpdateOrgUnitFailedException.
- يتسبب هذا الاستثناء في استجابة خدمة LIS بـ invaliddata. وقد اعتبر هذا أنسب كود استجابة لهذه الحالة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد معالجات القراءة، عادةً كواحد من أوائل معالجات التحقق من الصحة.