تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceCourseTemplateHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال قوالب المقررات التعليمية.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.CourseTemplates.Handlers.IReplaceCourseTemplateHandler.
توفر قوائم التكوين الآتية نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب:
حزمة التكامل لأنظمة معلومات الطالب، والقالب - قالب المقرر التعليمي
ReplaceCourseTemplateRetainExistingDepartmentHandler
يتحقق ReplaceCourseTemplateRetainExistingDepartmentHandler إذا لم يتم تحديد قسم أصل في الطلب. وإذا كان الأمر كذلك، يحتفظ المعالج بأي أصول قسم موجودة عند تحديث القالب (بدلاً من حذف كل الأصول).
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateRetainExistingDepartmentHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- التحقق لمعرفة ما إذا لم يتم تحديد أصل في الطلب.
- في حالة عدم تحديد أصل، يحاول المعالج الوصول إلى الوحدة التنظيمية الحالية (للتحقق مما إذا كان الطلب هو تحديث).
- إذا كانت الوحدة التنظيمية الحالية صالحة، فلكل أصل في request.CurrentParents، يضيف المعالج الأصل إلى request.UpdatedParents. ولكل أصل في ParentOrgUnits للوحدة التنظيمية الحالية، يضيف المعالج الأصل إلى request.ParentOrgUnits
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تكوين هذا المعالج قبل أي معالجات قراءة، ومن ثم يجب تكوينه أولاً.
ReplaceCourseTemplateReadHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول قراءة معلومات حول قالب المقرر التعليمي من جداول IM.
- في حالة العثور عليها، يحاول قراءة أي تعيينات في Brightspace لقالب المقرر التعليمي.
- في حالة العثور عليها، يحاول القراءة حول قالب المقرر التعليمي من Brightspace.
- يتحقق لمعرفة ما إذا تم تحديد قسم أصل في الطلب. في حالة تحديد قسم أصل، يضيف المعالج الأصل إلى ParentOrgUnits الخاصة بالطلب. في حالة عدم تحديد قسم أصل، يتم تعيين المؤسسة كأصل للطلب (في request.ParentOrgUnits).
- في حالة تحديد أصل ولكنه لا يحتوي على تعيينات IM في قاعدة البيانات، يقوم معالج القراءة بطرح ParentNotFoundException وتتوقف كل عمليات المعالجة للمعالج.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
عادةً ما يكون معالج القراءة هو أول المعالجات، ما لم يتم تكوين ReplaceCourseTemplateRetainExistingDepartmentHandler. وفي هذه الحالة، يجب أن يكون معالج القراءة هو المعالج الثاني.
ReplaceCourseTemplateValidateHandler
الغرض من ReplaceCourseTemplateValidateHandler هو التأكد من توفر الحد الأدنى من المعلومات المطلوبة لمعالجات الإنشاء.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يتحقق معالج التحقق من الصحة للتأكد من تحديد كل من الكود والاسم للطلب. ويجب أن تكون قيم الكود والاسم سلاسل بطول أكبر من 0. إذا كان الكود أو الاسم خاليًا أو فارغًا، يطرح معالج التحقق من الصحة ArgumentNullException وتتوقف كل عمليات المعالجة للمعالج.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن تسبق معالجات القراءة معالج التحقق من الصحة.
- يجب تكوين هذا المعالج ليعمل قبل معالجات الإنشاء.
ReplaceCourseTemplateParentsNoUpdateLMSHandler
عندما تتم معالجة ReplaceTemplateRequest من خلال حزمة التكامل لأنظمة معلومات الطالب، يسترد ReplaceCourseTemplateParentsNoUpdateLMSHandler
وحدات تنظيمية مخصصة أعلى قالب المقرر التعليمي ويحتفظ بهذه العلاقة حتى إذا لم يتم إنشاؤها من خلال حزمة التكامل لأنظمة معلومات الطالب بحيث لا تتم الكتابة فوقها بواسطة عملية التحديث.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateParentsNoUpdate
LMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يقوم المعالج بإحضار جميع الأصول لقالب المقرر التعليمي وتحديث قائمة الأصل
- تنتقل المعالجة إلى المعالج التالي
سلوك الخطأ
- لم يتم طرح أي أخطاء في هذا المعالج
عقدة التكوين
- يجب أن يقع هذا المعالج بعد معالجات القراءة والتحقق من الصحة
- يجب أن يسبق هذا المعالج معالجات الحفظ
ReplaceCourseTemplateDisallowParentChangesIfChildrenExistHandler
يمكن استخدام ReplaceCourseTemplateDisallowParentChangesIfChildrenExistHandler لمنع حذف قسم أصل أو تبديله لأي قالب لديه فروع بالفعل. وفي غياب هذا المعالج، يمكن تحديث الأصول بحرية، ما قد يغير معلومات التسلسل الهرمي للسوابق والتوابع للقالب الحالي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateParentDepartmentValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كان القالب موجودًا بالفعل (استبدال بدلاً من إنشاء):
- في حالة إزالة OrgUnit أصل أو استبدالها، يقوم المعالج بطرح استثناء لمنع تشغيل أي معالجات أخرى.
ملاحظات التكوين
- يجب تكوين هذا المعالج ليعمل بعد معالجات التحقق من الصحة.
- يجب تكوين هذا المعالج ليعمل قبل معالجات الإنشاء.
ReplaceCourseTemplateParentDepartmentValidateHandler
يمكن وضع ReplaceCourseTemplateParentDepartmentValidateHandler في مكانه ليشمل الحالات التي لا يتوفر فيها قسم أصل للقالب.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateParentDepartmentValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتم العثور على قسم أصل، يتحقق المعالج من تعيين IsRequired إلى خطأ في عنصر النموذج، إنشاء مقرر تعليمي > القسم.
- إذا تم تعيينه إلى صحيح، يقوم المعالج بطرح استثناء متغير تكوين غير صالح ويشير إلى إرشادات حول كيفية الحل.
ملاحظات التكوين
- يجب أن يسبق معالج القراءة معالج التحقق من الصحة.
- يجب تكوين معالج التحقق من الصحة لتشغيله قبل معالجات الإنشاء.
ReplaceCourseTemplateCreateLMSHandler
يقوم ReplaceCourseTemplateCreateLMSHandler بإنشاء قالب المقرر التعليمي في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateCreateLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود قوالب مقرر تعليمي في Brightspace مقترنة بالطلب. يؤدي المعالج المهام الآتية:
- إذا لم يتم تحديد قسم أصل، فسيتم تعيين المؤسسة على أنها أصل للقالب الجديد. ويؤدي ذلك إلى حدوث خطأ في حالة عدم تكوين عنصر النموذج لقسم المقرر التعليمي بشكل صحيح. في عناصر النموذج، تأكد من تعيين إشارة IsRequired في إنشاء مقرر تعليمي > القسم إلى خطأ لكي ينجح الإنشاء.
- ينشئ المعالج قالب المقرر التعليمي باستخدام المعلومات التي تم تمريرها في الطلب (ما يؤدي إلى تسجيل تدقيق تلقائي لإنشاء قالب).
- إذا نجحت مهمة الإنشاء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يوضع هذا المعالج بعد أي معالجات تحقق من الصحة.
- يوضع هذا المعالج قبل معالجات إنشاء IM.
ReplaceCourseTemplateCreateIMHandler
ينشئ ReplaceCourseTemplateCreateIMHandler الكيان في جداول IM، بالإضافة إلى تعيين إذا تم تعريفه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateCreateIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود ExternalOrgUnitInfo و/أو تعيين متطابقين في جداول IM. يؤدي المعالج المهام الآتية:
- إنشاء قالب المقرر التعليمي في منصة IM.
- إنشاء إدخالات تسلسل IM الهرمي.
- في حالة وجود OrgUnit في Brightspace مقترنة بالطلب، ينشئ المعالج تعيين قالب المقرر التعليمي الخاص بمنصة IM إلى قالب المقرر التعليمي الخاص بـ Brightspace.
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يوضع هذا المعالج بعد معالج CreateLMS.
- عدم تكوين ReplaceCourseTemplateCreateIMHandler أو ReplaceCourseTemplateSaveIMHandler هو أمر مشروع. من دون إنشاء إدخالات جدول IM، لا تعرف حزمة التكامل لأنظمة معلومات الطالب ما إذا كان القالب موجودًا في Brightspace. يجب تكوين معالج تعيين يقوم بتعيين طلب نظام معلومات الطالب إلى قالب Brightspace ما يسمح بالتحديثات. من دون معالج تعيين، تقوم حزمة التكامل لأنظمة معلومات الطالب دائمًا بإنشاء قالب جديد حتى في حالة وجود قالب مطابق.
ReplaceCourseTemplateSaveLMSHandler
يحفظ ReplaceCourseTemplateSaveLMSHandler أي تغييرات تم إجراؤها على قالب المقرر التعليمي في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateSaveLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة وجود تغييرات سيتم حفظها لقالب المقرر التعليمي في Brightspace. يؤدي المعالج المهام الآتية:
- تحديث قالب المقرر التعليمي في Brightspace (ما يؤدي إلى تسجيل تدقيق تلقائي لتحديث القالب).
- إذا نجح كل شيء، وإذا كان ReplaceRequestStatus! = EntityCreated، يقوم المعالج بتعيين ReplaceRequestStatus = EntityUpdated.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد أي معالجات إنشاء.
ReplaceCourseTemplateSaveIMHandler
يحفظ معالج الحفظ أي تغييرات تم إجراؤها على كيان IM وتعييناته. ويشمل ذلك تحديث معلومات التسلسل الهرمي ونشر التغييرات في جميع السوابق والتوابع للقالب المحدد.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateSaveIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة وجود تغييرات سيتم حفظها للكيان أو التعيينات في جداول IM. يؤدي المعالج المهام الآتية:
- تحديث كيان IM.
- تحديث تسلسل IM الهرمي وتحديث معلومات العلاقة لأي من الأصول والفروع المتأثرة.
- تحديث تعيينات كيان IM.
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityUpdated.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يوضع هذا المعالج بعد معالج SaveLMS.
- عدم تكوين ReplaceCourseTemplateCreateIMHandler أو ReplaceCourseTemplateSaveIMHandler هو أمر مشروع. من دون إنشاء إدخالات جدول IM، لا تعرف حزمة التكامل لأنظمة معلومات الطالب ما إذا كان القالب موجودًا في Brightspace. يجب تكوين معالج تعيين يقوم بتعيين طلب نظام معلومات الطالب إلى قالب Brightspace ما يسمح بالتحديثات. من دون معالج تعيين، تقوم حزمة التكامل لأنظمة معلومات الطالب دائمًا بإنشاء قالب جديد حتى في حالة وجود قالب مطابق.
ReplaceCourseTemplateValidateLMSOrgUnitExistsHandler
يتحقق ReplaceCourseTemplateValidateLMSOrgUnitExistsHandler لمعرفة ما إذا تم حذف الوحدة التنظيمية التي يتوافق معها الطلب في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء أو تم حذف الوحدة التنظيمية من Brightspace)، فسيحاول المعالج الحصول على ExternalOrgUnitInfo للطلب.
- إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أن هذه ليست عملية إنشاء، وتم حذف الوحدة التنظيمية من Brightspace، ويتم طرح UpdateOrgUnitFailedException.
- يتسبب هذا الاستثناء في استجابة خدمة LIS بـ invaliddata. وقد اعتبر هذا أنسب كود استجابة لهذه الحالة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد معالجات القراءة، عادةً كواحد من أوائل معالجات التحقق من الصحة.