تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceSemesterHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال الفصول الدراسية.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.Semesters.Handlers.IReplaceSemesterHandler.
توفر قائمة التكوين الآتية نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب:
القالب - الفصل الدراسي، وحزمة التكامل لأنظمة معلومات الطالب
- ReplaceSemesterReadHandler (ترتيب الفرز = 10)
- ReplaceSemesterValidateHandler (ترتيب الفرز = 20)
- ReplaceSemesterCreateLMSHandler (ترتيب الفرز = 30)
- ReplaceSemesterCreateIMHandler (ترتيب الفرز = 40)
- ReplaceSemesterSaveLMSHandler (ترتيب الفرز = 50)
- ReplaceSemesterSaveIMHandler (ترتيب الفرز = 60)
ReplaceSemesterReadHandler
يقرأ ReplaceSemesterReadHandler كل المعلومات المتعلقة بالفصل الدراسي الموجودة في جداول نظام إدارة التعلّم أو IM الخاصة بقاعدة البيانات لاستخدامها في معالجات أخرى.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- محاولة قراءة معلومات عن الفصل الدراسي من جداول IM. وإذا تم العثور على المعلومات، فسيحاول المعالج قراءة أي تعيينات إلى نظام إدارة التعلّم تخص الفصل الدراسي ويحاول القراءة عن الفصل الدراسي من نظام إدارة التعلّم.
- محاولة قراءة معلومات عن أي وحدات OrgUnits أصل مشار إليها من جداول IM، وإذا لم يتم العثور على أي منها، فسيقوم المعالج بتعيين القائمة الأصل الافتراضية للمؤسسة إلى الأصل الوحيد.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يسبق معالج القراءة معالجات التحقق من الصحة.
ReplaceSemesterValidateHandler
يضمن ReplaceSemesterValidateHandler تعيين كود واسم صالحَين إلى الفصل الدراسي.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterValidateHandler
السلوك المتوقع
يتحقق معالج التحقق من الصحة للتأكد من تحديد كل من الكود والاسم للطلب. يجب أن تكون هذه القيم سلاسل بطول أكبر من 0. يؤدي المعالج المهام الآتية:
- إذا كان الكود أو الاسم خاليًا أو فارغًا، يطرح المعالج ArgumentNullException وتتوقف كل عمليات المعالجة للمعالج.
- يقوم معالج التحقق من الصحة أيضًا بالتحقق للتأكد من أن الطلب لا يحاول تغيير النوع (على سبيل المثال، تغيير كلية إلى قسم) لوحدة تنظيمية موجودة. وإذا كان الطلب يحاول تغيير النوع، فسيتم طرح InvalidOperationException وتتوقف كل عمليات المعالجة الخاصة بالمعالج.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تكوين معالجات التحقق من الصحة قبل معالج الإنشاء.
ReplaceSemesterCreateLMSHandler
يقوم ReplaceSemesterCreateLMSHandler بإنشاء فصل دراسي في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterCreateLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود فصول دراسية في Brightspace مقترنة بالطلب. يؤدي المعالج المهام الآتية:
- إنشاء الفصل الدراسي لنظام إدارة التعلّم باستخدام المعلومات التي تم تمريرها في الطلب (تشغيل تسجيل تدقيق الفصل الدراسي التلقائي).
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- في حالة وجود خطأ، يقوم المعالج بتعيين حالة النتيجة إلى CreateFailed.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب وضع هذا المعالج بعد أي من معالجات التحقق من الصحة.
- يجب أن يسبق معالج إنشاء نظام إدارة التعلّم معالج إنشاء IM.
ReplaceSemesterCreateIMHandler
يقوم ReplaceSemesterCreateIMHandler بإنشاء الكيان في جداول IM، وإنشاء تعيين إذا تم تعريفه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterCreateIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود كيان مطابق في جداول IM. يؤدي المعالج المهام الآتية:
- إنشاء فصل دراسي في منصة IM.
- إذا كان ثمة OrgUnit بنظام إدارة التعلّم مقترنة بالطلب، فسيقوم المعالج بإنشاء تعيين فصل دراسي لمنصة IM إلى الفصل الدراسي لنظام إدارة التعلّم.
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
سيوضع هذا المعالج بعد أي معالج CreateLMS.
ReplaceSemesterSaveLMSHandler
يقوم معالج الحفظ بحفظ أي تغييرات تم إجراؤها على الفصل الدراسي الخاص بنظام إدارة التعلّم.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterSaveLMSHandler
السلوك المتوقع
يعمل هذا المعالج في حالة وجود تغييرات في انتظار أن يتم حفظها تخص فصل دراسي بنظام إدارة التعلّم فقط. يؤدي المعالج المهام الآتية:
- تحديث الفصل الدراسي بنظام إدارة التعلّم (تشغيل تسجيل التدقيق التلقائي).
- إذا كان الطلب عبارة عن تحديث، وتم تعديل حقل واحد على الأقل، فسيقوم المعالج بتعيين حالة النتيجة إلى EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
سيوضع هذا المعالج بعد أي معالج إنشاء.
ReplaceSemesterSaveIMHandler
يحفظ معالج الحفظ أي تغييرات تم إجراؤها على كيان IM وتعييناتها.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semester.Handlers.ReplaceSemesterSaveIMHandler
السلوك المتوقع
يعمل هذا المعالج في حال وجود تغييرات في انتظار أن يتم حفظها للكيان أو التسلسل الهرمي في جداول IM فقط. يؤدي المعالج المهام الآتية:
- تحديث كيان IM في حالة وجود تغييرات معلّقة.
- تحديث علاقات التسلسل الهيكلي لكيان IM إذا تمت إضافة أصول أو إزالتها.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
سيوضع هذا المعالج بعد أي من معالجات SaveLMS.
ReplaceSemesterMapByCodeHandler
يقوم ReplaceSemesterMapByCodeHandler بإقران فصل دراسي بفصل دراسي موجود في نظام إدارة التعلّم من خلال مطابقة OrgUnitCode.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterMapByCodeHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- في حال عدم وجود تعيين فصل دراسي، يحاول المعالج العثور على فصل دراسي في نظام إدارة التعلّم يتطابق من حيث OrgUnitCode.
- إذا تم العثور على تطابق، يقوم المعالج بتحديث مادة الطلب لتحتوي على orgUnit متطابقة. يجب استخدام المعالج فقط إذا كان من المتوقع أن يكون كود الوحدة التنظيمية فريدًا داخل المؤسسة.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج عادة بين معالجات القراءة ومعالجات الإنشاء، حيث لن يتم تنفيذه إلا إذا فشلت معالجات القراءة في العثور على فصل دراسي معيّن.
ReplaceSemesterNameNoUpdateLMSHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا المعالج قبل أي من معالجات SaveLMS.
ReplaceSemesterValidateLMSOrgUnitExistsHandler
يتحقق ReplaceSemesterValidateLMSOrgUnitExistsHandler من حذف وحدة المؤسسة التي يتوافق الطلب إليها في LMS.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Semesters.Handlers.ReplaceSemesterValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء أو تم حذف الوحدة التنظيمية من نظام إدارة التعلّم)، يحاول المعالج الحصول على ExternalOrgUnitInfo للطلب.
- إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أنه ليس طلب إنشاء، وأن الوحدة التنظيمية قد تم حذفها من نظام إدارة التعلّم. يقوم المعالج بطرح UpdateOrgUnitFailedException. يتسبب هذا الاستثناء في استجابة خدمة LIS بـ invaliddata.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد معالجات القراءة، عادةً كواحد من أوائل معالجات التحقق من الصحة.