تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceDepartmentHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال الأقسام.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.Departments.Handlers.IReplaceDepartmentHandler.
توفر قوائم تكوين حزمة التكامل لأنظمة معلومات الطالب، والقالب - القسم نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب.
تُستخدم قائمة المعالجات الآتية كنقطة بداية:
- ReplaceDepartmentReadHandler (ترتيب الفرز = 10)
- ReplaceDepartmentValidateHandler (ترتيب الفرز = 20)
- ReplaceDepartmentCreateLMSHandler (ترتيب الفرز = 30)
- ReplaceDepartmentCreateIMHandler (ترتيب الفرز = 40)
- ReplaceDepartmentSaveLMSHandler (ترتيب الفرز = 50)
- ReplaceDepartmentSaveIMHandler (ترتيب الفرز = 60)
ReplaceDepartmentReadHandler
يقرأ ReplaceDepartmentReadHandler جميع المعلومات المتعلقة بالقسم الموجودة في جداول نظام إدارة التعلّم أو IM في قاعدة البيانات لاستخدامها في معالجات أخرى.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departmentss.Handlers.ReplaceDepartmentReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول قراءة معلومات حول القسم من جداول IM:
- في حالة العثور عليها، يحاول المعالج قراءة أي تعيينات إلى نظام إدارة التعلّم للقسم.
- في حالة العثور عليها، يحاول المعالج القراءة حول القسم من نظام إدارة التعلّم.
- يحاول قراءة معلومات حول أي OrgUnits أصل مشار إليها من جداول IM.
- إذا لم يتم العثور على شيء، يقوم المعالج بتعيين قائمة الأصل الافتراضية للمؤسسة في الأصل الوحيد.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يسبق معالج القراءة معالجات التحقق من الصحة.
ReplaceDepartmentValidateHandler
يضمن ReplaceDepartmentValidateHandler تعيين كود واسم صالحين للقسم.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يتحقق معالج التحقق من الصحة للتأكد من تحديد كل من الكود والاسم للطلب. ويجب أن تكون قيم الكود والاسم سلاسل بطول أكبر من 0. إذا كان الكود أو الاسم خاليًا أو فارغًا، يطرح المعالج ArgumentNullException وتتوقف كل عمليات المعالجة للمعالج.
- يتحقق معالج التحقق من الصحة أيضًا للتأكد من أن الطلب لا يحاول تغيير النوع (على سبيل المثال، تغيير معهد إلى قسم) لوحدة تنظيمية موجودة.
- إذا كان الطلب يحاول تغيير النوع، يتم طرح InvalidOperationException وتتوقف كل عمليات المعالجة للمعالج.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تكوين معالجات التحقق من الصحة قبل معالج الإنشاء.
ReplaceDepartmentParentsNoUpdateLMSHandler
يقوم ReplaceDepartmentParentsNoUpdateLMSHandler باسترداد أصول الوحدة التنظيمية التي تم إنشاؤها يدويًا في نظام إدارة التعلّم ويحتفظ بالعلاقة بحيث لا تتم الكتابة فوقها بواسطة عملية التحديث هذه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentParentsNoUpdateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إحضار جميع الأصول للقسم وتحديث قائمة الأصل.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
لم يتم طرح أي أخطاء لهذا المترجم.
ملاحظة التكوين
- يجب أن يقع هذا المعالج بعد معالجات القراءة والتحقق من الصحة.
- يجب أن يسبق هذا المعالج معالجات الحفظ.
- ترتيب الفرز الموصى به = 3.
ReplaceDepartmentCreateLMSHandler
يقوم ReplaceDepartmentCreateLMSHandler بإنشاء القسم في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentCreateLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود أقسام في Brightspace مقترنة بالطلب. يؤدي المعالج المهام الآتية:
- إنشاء قسم في Brightspace باستخدام المعلومات التي تم تمريرها في الطلب (ما يؤدي إلى تسجيل التدقيق التلقائي).
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- في حالة وجود خطأ، يقوم المعالج بتعيين حالة النتيجة إلى CreateFailed.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة في المعالجة، يتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة المتاحة.
ملاحظات التكوين
- يوضع هذا المعالج بعد أي معالجات تحقق من الصحة.
- يجب أن يسبق معالج إنشاء نظام إدارة التعلّم معالج إنشاء IM.
ReplaceDepartmentCreateIMHandler
ينشئ ReplaceDepartmentCreateIMHandler الكيان في جداول IM، وينشئ تعيينًا إذا تم تعريفه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentCreateIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود كيان مطابق في جداول IM. يؤدي المعالج المهام الآتية:
- إنشاء القسم في منصة IM.
- إذا كان ثمة OrgUnit بنظام إدارة التعلّم مقترنة بالطلب، فسيقوم المعالج بإنشاء تعيين قسم منصة IM إلى قسم نظام إدارة التعلّم.
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة في المعالجة، يتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة المتاحة.
ملاحظة التكوين
سيوضع هذا المعالج بعد أي من معالجات CreateLMS.
ReplaceDepartmentSaveLMSHandler
يحفظ ReplaceDepartmentSaveLMSHandler أي تغييرات تم إجراؤها على قسم في Brightspace.
التنفيذ
لا يعمل هذا المعالج إلا في حالة وجود تغييرات سيتم حفظها لقسم في Brightspace. يؤدي المعالج المهام الآتية:
- تحديث القسم في Brightspace (ما يؤدي إلى تسجيل التدقيق التلقائي).
- إذا كان الطلب هو تحديث، وتم تعديل حقل واحد على الأقل، يقوم المعالج بتعيين حالة النتيجة إلى EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد أي معالجات إنشاء.
ReplaceDepartmentSaveIMHandler
يحفظ ReplaceDepartmentSaveIMHandler أي تغييرات تم إجراؤها على كيان IM وتعييناته.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentSaveIMHandler
السلوك المتوقع
لا يعمل المعالج إلا في حالة وجود تغييرات سيتم حفظها للكيان أو التسلسل الهرمي في جداول IM. يؤدي المعالج المهام الآتية:
- تحديث كيان IM في حالة وجود تغييرات معلّقة.
- تحديث علاقات التسلسل الهرمي لكيان IM إذا تمت إضافة أصول أو إزالتها.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد أي معالجات SaveLMS.
ReplaceDepartmentMapByCodeHandler
يربط هذا المعالج بين قسم وقسم موجود في Brightspace من خلال مطابقة OrgUnitCode.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentMapByCodeHandler
السلوك المتوقع
يجب استخدام هذا المعالج فقط إذا كان من المتوقع أن يكون كود الوحدة التنظيمية فريدًا داخل المؤسسة. يؤدي المعالج المهام الآتية:
- إذا لم يكن هناك تعيين للقسم، فسيحاول المعالج العثور على قسم في Brightspace يتطابق مع OrgUnitCode.
- إذا تم العثور على تطابق، يقوم المعالج بتحديث مادة الطلب لتحتوي على orgUnit متطابقة.
- إذا لم يتم العثور على تطابق، فلن يقوم المعالج بأي شيء.
- إذا تم العثور على تطابقات متعددة، يقوم المعالج بطرح MultipleOrgUnitsFoundException ما يؤدي إلى إرجاع خطأ.
- يجب استخدام المعالج فقط إذا كان من المتوقع أن يكون كود الوحدة التنظيمية فريدًا داخل المؤسسة.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادةً بين معالجات القراءة ومعالجات الإنشاء، وفي هذه الحالة يتم تشغيله فقط إذا فشلت معالجات القراءة في العثور على قسم معين.
ReplaceDepartmentNameNoUpdateLMSHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentCreateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج قبل أي معالجات SaveLMS.
ReplaceDepartmentValidateLMSOrgUnitExistsHandler
يتحقق ReplaceDepartmentValidateLMSOrgUnitExistsHandler لمعرفة ما إذا تم حذف الوحدة التنظيمية التي يتوافق معها الطلب في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.Departments.Handlers.ReplaceDepartmentValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء أو تم حذف الوحدة التنظيمية من Brightspace)، فسيحاول المعالج الحصول على ExternalOrgUnitInfo للطلب.
- إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أن هذه ليست عملية إنشاء، وتم حذف الوحدة التنظيمية من Brightspace. يتم طرح UpdateOrgUnitFailedException.
- سيؤدي هذا الاستثناء إلى استجابة خدمة LIS بـ invaliddata. وقد اعتبر هذا أنسب كود استجابة لهذه الحالة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد معالجات القراءة، عادةً كواحد من أوائل معالجات التحقق من الصحة.