تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceCourseSectionHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال مقاطع المقررات التعليمية.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.CourseSections.Handlers.IReplaceCourseSectionHandler.
توفر قوائم تكوين حزمة التكامل لأنظمة معلومات الطالب، والقالب - المقاطع، والقالب - المجموعات نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب.
تُستخدم قائمة المعالجات الآتية كنقطة بداية عندما تريد استخدام مقاطع المقررات التعليمية في Brightspace لمقاطع نظام معلومات الطالب:
- ReplaceCourseSectionReadHandler (ترتيب الفرز = 10)
- ReplaceCourseSectionStatusDefaultActiveHandler (ترتيب الفرز = 20)
- ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler (ترتيب الفرز = 30)
- ReplaceCourseSectionValidateBaseHandler (ترتيب الفرز = 40)
- ReplaceCourseSectionValidateParentOfferingExistsHandler (ترتيب الفرز = 50)
- ReplaceCourseSectionCreateLMSSectionHandler (ترتيب الفرز = 60)
- ReplaceCourseSectionCreateIMSectionHandler (ترتيب الفرز = 70)
- ReplaceCourseSectionSaveLMSSectionHandler (ترتيب الفرز = 80)
- ReplaceCourseSectionSaveIMHandler (ترتيب الفرز = 90)
تُستخدم قائمة المعالجات الآتية كنقطة بداية عندما تريد استخدام مجموعات Brightspace لمقاطع نظام معلومات الطالب:
- ReplaceCourseSectionReadHandler (ترتيب الفرز = 10)
- ReplaceCourseSectionStatusDefaultActiveHandler (ترتيب الفرز = 20)
- ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler (ترتيب الفرز = 30)
- ReplaceCourseSectionValidateBaseHandler (ترتيب الفرز = 40)
- ReplaceCourseSectionValidateParentOfferingExistsHandler (ترتيب الفرز = 50)
- ReplaceCourseSectionCreateLMSGroupHandler (ترتيب الفرز = 60)
- ReplaceCourseSectionCreateIMSectionHandler (ترتيب الفرز = 70)
- ReplaceCourseSectionSaveLMSGroupHandler (ترتيب الفرز = 80)
- ReplaceCourseSectionSaveIMHandler (ترتيب الفرز = 90)
ReplaceCourseSectionReadHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول قراءة معلومات حول مقطع المقرر التعليمي من جداول IM.
- في حالة العثور عليها، يحاول المعالج قراءة أي تعيينات في Brightspace لمقطع المقرر التعليمي ويحاول القراءة حول مقطع المقرر التعليمي من Brightspace.
- لكل وحدة تنظيمية أصل محددة في الطلب، يقرأ المعالج المعلومات من Brightspace ويضيفها إلى قائمة OrgUnits الأصل. إذا لم تكن لدى الأصل تعيينات إلى Brightspace، يطرح المعالج ParentNotFoundException.
- تنتقل المعالجة إلى المعالج التالي.
ReplaceCourseSectionStatusDefaultActiveHandler
التنفيذ
ReplaceCourseSectionStatusDefaultActiveHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تعيين حالة مادة مقطع المقرر التعليمي إلى نشط إذا لم تكن لها قيمة بالفعل.
- تنتقل المعالجة إلى المعالج التالي.
ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionParentDepartmentParentSemesterDefaultNoneHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إزالة القسم الأصل و/أو الفصل الدراسي الأصل من الطلب.
- إزالة ParentOrgUnits إذا تم تعيين أي منهم في المحول. لا تُستخدم هذه القيم في التنفيذ الافتراضي.
- تنتقل المعالجة إلى المعالج التالي.
ReplaceCourseSectionValidateBaseHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionValidateBaseHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- التحقق للتأكد من تحديد قيمة كل من الكود والاسم للطلب. يجب أن تكون هذه القيم سلاسل بطول أكبر من 0. إذا كان الكود أو الاسم خاليًا أو فارغًا، يقوم معالج التحقق من الصحة بطرح ArgumentNullException.
- إذا كان المقطع موجودًا بالفعل في جداول IM، يتحقق المعالج من أي OrgUnits أصل محددة في الطلب موجودة بالفعل كأصول في تسلسل IM الهرمي. إذا جرت محاولة لإضافة أصل للمقطع أو استبداله، فسيتم طرح استثناء. رسالة الخطأ هي: يتعذر تغيير المضمون الأصل لمقطع المقرر التعليمي بالمعرِّف {id}. هذا السلوك غير مدعوم.
- تنتقل المعالجة إلى المعالج التالي.
ReplaceCourseSectionValidateParentOfferingExistsHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionValidateParentOfferingExistsHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- التحقق للتأكد من وجود المضمون الأصل المحدد في كل من OrgUnit الخاصة بـ Brightspace وOrgUnit الخاصة بحزمة التكامل لأنظمة معلومات الطالب.
- إذا كان هناك اقتران بين الاثنين، فإن المعالج يضمن صحة الاقتران.
- إذا فشلت أي من عمليات التحقق، يقوم معالج التحقق من الصحة بطرح ParentNotFoundException. يتم التقاط الاستثناء وتسجيله ومعالجته في المدير.
- تستمر المعالجة إلى المعالج التالي.
ReplaceCourseSectionNameNoUpdateLMSHandler
يُستخدم ReplaceCourseSectionNameNoUpdateLMSHandler لمنع تحديثات اسم مجموعة/مقطع Brightspace بعد الإنشاء الأولي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionNameNoUpdateLMSHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم.
- تستمر المعالجة إلى المعالج التالي.
ملاحظة التكوين
هذا المعالج هو معالج مصمم ليتم تكوينه قبل إنشاء نظام إدارة التعلّم ومعالجات حفظ نظام إدارة التعلّم.
ReplaceCourseSectionCreateLMSSectionHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateLMSSectionHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا إذا لم يكن المقطع موجودًا بعد في كل من جداول IM وBrightspace. يقوم المعالج بتنفيذ الإجراءات الآتية:
- إنشاء مقطع المقرر التعليمي باستخدام المعلومات التي تم تمريرها في الطلب (ما يؤدي إلى إدخال التدقيق إنشاء مقطع).
- إذا تم إنشاء نظام إدارة التعلّم بنجاح، ينشئ المعالج إدخال تدقيق مقطع المقرر التعليمي الذي تم إنشاؤه، الذي يشير إلى معرِّف مقطع المقرر التعليمي.
- إذا لم ينجح الإنشاء، يقوم المعالج بتعيين ReplaceRequestStatus = CreateFailed وتتوقف كل عمليات المعالجة للمعالج (ليُرجع قيمة خطأ).
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated وتستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
ReplaceCourseSectionCreateIMSectionHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateIMSectionHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- إنشاء OrgUnit خاصة بحزمة التكامل لأنظمة معلومات الطالب إذا لم تكن موجودة بالفعل.
- إضافة تسلسل IM الهرمي المناسب.
- لكل وحدة تنظيمية تم تعيينه إليها، ينشئ المعالج تعيين حزمة التكامل لأنظمة معلومات الطالب إذا لم يكن موجودًا بالفعل. إذا نجح ذلك، يقوم المعالج بتعيين ReplaceRequestStatus إلى EntityCreated، وإرجاع قيمة صحيحة. إذا حدث فشل، يتم تعيين ReplaceRequestStatus إلى CreateFailed، ويُرجع المعالج قيمة خطأ.
- تستمر المعالجة إلى المعالج التالي.
ReplaceCourseSectionSaveLMSSectionHandler
يحفظ ReplaceCourseSectionSaveLMSSectionHandler التغييرات في كل مقاطع Brightspace المعيّنة (صفر أو أكثر) إذا لزم الأمر.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveLMSSectionHandler
السلوك المتوقع
لكل مقطع معيّن، إذا كان هناك أي تحديثات يجب إجراؤها، يقوم المعالج بتنفيذ الإجراءات التالية:
- تحديث المقطع (ما يؤدي إلى إدخال التدقيق تحديث المقطع).
- تحديث خصائص OrgUnit في Brightspace ولكنه لا يغير أصول المقطع.
- إذا تم تحديث نظام إدارة التعلّم بنجاح، ينشئ المعالج إدخال تدقيق مقطع المقرر التعليمي المحدّث، الذي يشير إلى SectionId الخاص بالمقرر التعليمي.
- إذا لم ينجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = CreateFailed وتتوقف كل عمليات المعالجة للمعالج (ليُرجع قيمة خطأ).
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated وتستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
ReplaceCourseSectionSaveIMHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveIMHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- حفظ أي تغييرات في مقطع المقرر التعليمي الخاص بحزمة التكامل لأنظمة معلومات الطالب والاقترانات إذا لزم الأمر.
- حفظ أي تغييرات في تسلسل IM الهرمي.
ReplaceCourseSectionCreateLMSGroupHandler
يُستخدم ReplaceCourseSectionCreateLMSGroupHandler عندما ترغب مؤسسة في إنشاء مجموعات بدلاً من المقاطع في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionCreateLMSGroupHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا إذا لم تكن المجموعة موجودة بعد في كل من جدول IM وBrightspace. يقوم المعالج بتنفيذ الإجراءات الآتية:
- يحصل على القيمة في d2l.integration.IPSIS.GroupCategory. إذا لم يتم تعيين القيمة، يطرح المعالج InvalidConfigurationVariableException.
- إذا لم تكن فئة المجموعة التي تطابق الاسم في d2l.integration.IPSIS.GroupCategory موجودة، ينشئ المعالج فئة مجموعة باسم ووصف من متغير التكوين (ما يؤدي إلى إدخال تدقيق إنشاء المجموعة).
- إذا لم ينجح إنشاء فئة المجموعة، يطرح المعالج استثناء مع إشارة واضحة إلى المشكلة ومعرِّف المقطع.
- ينشئ مجموعة المقرر التعليمي مع فئة المجموعة أعلاه باستخدام المعلومات التي تم تمريرها في الطلب.
- إذا تم إنشاء نظام إدارة التعلّم بنجاح، ينشئ المعالج إدخال تدقيق مجموعة المقرر التعليمي التي تم إنشاؤها، الذي يشير إلى معرِّف مجموعة المقرر التعليمي.
- إذا لم ينجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = CreateFailed وتتوقف كل عمليات المعالجة للمعالج (ليُرجع قيمة خطأ).
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated، وتستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
ملاحظة التكوين
يحل هذا المعالج محل ReplaceCourseSectionCreateLMSSectionHandler في قائمة المكونات الإضافية الافتراضية.
ReplaceCourseSectionSaveLMSGroupHandler
يُستخدم ReplaceCourseSectionSaveLMSGroupHandler عندما ترغب مؤسسة في إنشاء مجموعات بدلاً من المقاطع في نظام إدارة التعلّم.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionSaveLMSGroupHandler
السلوك المتوقع
لكل مجموعة في Brightspace تم تعيينها، إذا كانت هناك أي تحديثات يجب إجراؤها، يقوم المعالج بتنفيذ الإجراءات الآتية:
- تحديث المجموعة (ما يؤدي إلى إدخال تدقيق تحديث المجموعة) وتحديث خصائص OrgUnit في Brightspace، ولكنه لا يغير أصول المجموعة.
- إذا تم تحديث نظام إدارة التعلّم بنجاح، ينشئ المعالج إدخال تدقيق مجموعة المقرر التعليمي المحدثة، الذي يشير إلى معرِّف مجموعة المقرر التعليمي.
- إذا لم ينجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = CreateFailed وتتوقف كل عمليات المعالجة للمعالج (ليُرجع قيمة خطأ).
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated وتستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
ملاحظة التكوين
يحل هذا المعالج محل ReplaceCourseSectionSaveLMSSectionHandler في قائمة المكونات الإضافية الافتراضية.
ReplaceCourseSectionValidateLMSOrgUnitExistsHandler
يتحقق ReplaceCourseSectionValidateLMSOrgUnitExistsHandler من حذف الوحدة التنظيمية التي يتوافق معها الطلب في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء أو تم حذف الوحدة التنظيمية من Brightspace)، فسيحاول المعالج الحصول على ExternalOrgUnitInfo للطلب. إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أن هذه ليست عملية إنشاء، وتم حذف الوحدة التنظيمية من Brightspace، ويتم طرح UpdateOrgUnitFailedException. يتسبب هذا الاستثناء في استجابة خدمة LIS بـ invaliddata. وقد اعتبر هذا أنسب كود استجابة لهذه الحالة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد معالجات القراءة، عادةً كواحد من أوائل معالجات التحقق من الصحة.
ReplaceCourseSectionBuildParentHierarchyRequiredHandler
يقوم ReplaceCourseSectionBuildParentHierarchyRequiredHandler بإنشاء مضمون أصل وقالب للمقطع إذا لم يتم تمرير أي منهما في الطلب.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseSections.Handlers.ReplaceCourseSectionBuildParentHierarchyRequiredHandler
السلوك المتوقع
يقوم المعالج بتنفيذ الإجراءات الآتية:
- التحقق لمعرفة ما إذا تم تحديد مضمون أصل في الطلب.
- إذا لم يكن الأمر كذلك، ينشئ المعالج مضمون أصل وقالب أصل، وكلاهما له نفس الاسم والكود مثل المقطع.
- إرجاع القيمة إلى صحيحة.
سلوك الخطأ
إذا كانت هناك مشكلة في إنشاء القالب أو المضمون، يتم طرح CreateOrgUnitFailedException.
ملاحظة التكوين
يجب وضع هذا المعالج قبل أي معالجات تحقق من الصحة، عادة بعد معالج القراءة مباشرة.