تُستخدم واجهة المكون الإضافي لـ IReplaceOrgUnitHandler من قِبل محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية الاستبدال لأي عمليات ليست من أنواع OrgUnit القياسية بما في ذلك: الفصول الدراسية والأقسام وقوالب المقررات التعليمية ومضامين المقررات التعليمية ومقاطع المقررات التعليمية. تتضمن الأمثلة: الكليات والحُرم الجامعية.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.OtherOrgUnits.Handlers.IReplaceOrgUnitHandler.
توفر قوائم تكوين القالب - OrgUnit، حزمة التكامل لأنظمة معلومات الطالب نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب.
تُستخدم قائمة المعالجات الآتية كنقطة بداية:
- ReplaceOrgUnitReadHandler (ترتيب الفرز = 10)
- ReplaceOrgUnitValidateHandler (ترتيب الفرز = 20)
- ReplaceOrgUnitCreateLMSHandler (ترتيب الفرز = 30)
- ReplaceOrgUnitCreateIMHandler (ترتيب الفرز = 40)
- ReplaceOrgUnitSaveLMSHandler (ترتيب الفرز = 50)
- ReplaceOrgUnitSaveIMHandler (ترتيب الفرز = 60)
ReplaceOrgUnitReadHandler
يقرأ ReplaceOrgUnitReadHandler كل المعلومات المتعلقة بوحدة OrgUnit الموجودة في جداول نظام إدارة التعلّم أو IM الخاصة بقاعدة البيانات لاستخدامها في معالجات أخرى.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitReadHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- محاولة قراءة معلومات عن OrgUnit من جداول IM.
- يحاول المعالج قراءة أي تعيينات، إن وُجدت، إلى نظام إدارة التعلّم تخص OrgUnit ذات نوع الوحدة التنظيمية الخاص ويحاول القراءة عن OrgUnit من نظام إدارة التعلّم.
- يحاول المعالج قراءة معلومات عن أي OrgUnits أصل مشار إليها من جداول IM.
- إذا لم يتم العثور على شيء، يقوم المعالج بتعيين قائمة الأصل الافتراضية للمؤسسة في الأصل الوحيد.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يسبق معالج القراءة معالجات التحقق من الصحة.
ReplaceOrgUnitValidateHandler
يضمن ReplaceOrgUnitValidateHandler تعيين كود واسم صالحَين لـ OrgUnit.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitValidateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يتحقق معالج التحقق من الصحة للتأكد من تحديد كل من الكود والاسم للطلب. يجب أن تكون هذه القيم سلاسل بطول أكبر من 0.
- إذا كان الكود أو الاسم خاليًا أو فارغًا، يطرح المعالج ArgumentNullException وتتوقف كل عمليات المعالجة للمعالج.
- يقوم معالج التحقق من الصحة أيضًا بالتحقق للتأكد من أن الطلب لا يحاول تغيير النوع (على سبيل المثال، تغيير كلية إلى قسم) لوحدة تنظيمية موجودة.
- إذا كان الطلب يحاول تغيير النوع، يتم طرح InvalidOperationException وتتوقف كل عمليات المعالجة للمعالج.
- إذا نجح كل شيء، تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تكوين معالجات التحقق من الصحة قبل معالج الإنشاء.
ReplaceOrgUnitCreateLMSHandler
يقوم ReplaceOrgUnitCreateLMSHandler بإنشاء OrgUnit في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitCreateLMSHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود OrgUnits في Brightspace مقترنة بالطلب. يؤدي المعالج المهام الآتية:
- إنشاء OrgUnit باستخدام المعلومات التي تم تمريرها في الطلب (تشغيل تسجيل التدقيق "إنشاء {OrgUnitType}" التلقائي).
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- في حالة وجود خطأ، يقوم المعالج بتعيين حالة النتيجة إلى CreateFailed.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- سيوضع هذا المعالج بعد أي من معالجات التحقق من الصحة.
- يجب أن يسبق معالج إنشاء نظام إدارة التعلّم معالج إنشاء IM.
ReplaceOrgUnitCreateIMHandler
ينشئ ReplaceOrgUnitCreateIMHandler الكيان في جداول IM، وينشئ تعيينًا إذا تم تعريفه.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitCreateIMHandler
السلوك المتوقع
لا يعمل هذا المعالج إلا في حالة عدم وجود كيان مطابق في جداول IM. يؤدي المعالج المهام الآتية:
- إنشاء OrgUnit في منصة IM.
- إذا كان ثمة OrgUnit بنظام إدارة التعلّم مقترنة بالطلب، فسيقوم المعالج بإنشاء تعيين OrgUnit لمنصة IM إلى OrgUnit لنظام إدارة التعلّم.
- إذا نجح كل شيء، يقوم المعالج بتعيين حالة النتيجة إلى EntityCreated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج بعد أي معالجات CreateLMS.
ReplaceOrgUnitSaveLMSHandler
يقوم ReplaceOrgUnitSaveLMSHandler بحفظ أي تغييرات تم إجراؤها على OrgUnit الخاصة بنظام إدارة التعلّم.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitSaveLMSHandler
السلوك المتوقع
يعمل هذا المعالج في حال وجود تغييرات في انتظار أن يتم حفظها تخص OrgUnit الخاصة بنظام إدارة التعلّم فقط. يؤدي المعالج المهام الآتية:
- تحديث OrgUnit (تشغيل تسجيل التدقيق التلقائي).
- إذا كان الطلب عبارة عن تحديث، وتم تعديل حقل واحد على الأقل، فسيقوم بتعيين حالة النتيجة إلى EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج بعد أي معالجات إنشاء.
ReplaceOrgUnitSaveIMHandler
يقوم ReplaceOrgUnitSaveIMHandler بحفظ أي تغييرات تم إجراؤها على كيان IM وتعييناتها.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitSaveIMHandler
السلوك المتوقع
يعمل هذا المعالج في حال وجود تغييرات في انتظار أن يتم حفظها للكيان أو التسلسل الهرمي في جداول IM فقط. يؤدي المعالج المهام الآتية:
- تحديث كيان IM في حالة وجود تغييرات معلّقة.
- تحديث علاقات التسلسل الهيكلي لكيان IM إذا تمت إضافة أصول أو إزالتها.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
سيوضع هذا المعالج بعد أي من معالجات SaveLMS.
ReplaceOrgUnitMapByCodeHandler
يقوم ReplaceOrgUnitMapByCodeHandler بإقران OrgUnit بـ LMS موجودة بنظام إدارة التعلّم عن طريق مطابقة OrgUnitCode والنوع.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitMapByCodeHandler
السلوك المتوقع
يجب استخدام هذا المعالج فقط إذا كان من المتوقع أن يكون كود الوحدة التنظيمية فريدًا داخل المؤسسة.
يؤدي المعالج المهام الآتية:
- في حال عدم وجود تعيين OrgUnit، يحاول المعالج العثور على OrgUnit في Brightspace التي تتطابق مع OrgUnitCode وOrgUnitType
- إذا تم العثور على تطابق، يقوم المعالج بتحديث مادة الطلب لتحتوي على orgUnit متطابقة.
- إذا لم يتم العثور على أي تطابقات، فلن يقوم المعالج بأي شيء.
- إذا تم العثور على عدة تطابقات، فسوف يطرح المعالج MultipleOrgUnitsFoundException
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج عادة بين معالجات القراءة ومعالجات الإنشاء، حيث يتم تنفيذه إذا فشلت معالجات القراءة في العثور على OrgUnit معيّنة فقط.
ReplaceOrgUnitNameNoUpdateLMSHandler
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitNoUpdateLMSHandler
السلوك المتوقع
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج قبل أي معالجات SaveLMS.
ReplaceOrgUnitValidateLMSOrgUnitExistsHandler
يتحقق ReplaceOrgUnitValidateLMSOrgUnitExistsHandler من حذف وحدة المؤسسة التي يتوافق الطلب إليها في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.OrgUnits.OtherOrgUnits.Handlers.ReplaceOrgUnitValidateLMSOrgUnitExistsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول المعالج الحصول على الوحدة التنظيمية الحالية.
- إذا لم تكن الوحدة التنظيمية الحالية موجودة (إما أن يكون الطلب هو إنشاء، أو يكون قد تم حذف الوحدة التنظيمية من Brightspace):
- فسيحاول الحصول على ExternalOrgUnitInfo للطلب
- إذا كانت ExternalOrgUnitInfo صالحة، فهذا يعني أنه ليس طلب إنشاء، وأن الوحدة التنظيمية قد تم حذفها من نظام إدارة التعلّم. ومن ثَم، سيقوم بطرح UpdateOrgUnitFailedException.
- سيؤدي هذا الاستثناء إلى استجابة خدمة LIS بـ invaliddata. وقد اعتبر هذا أنسب كود استجابة لهذه الحالة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
سيتم وضع هذا المعالج بعد معالجات القراءة، وعادة كواحد من أول معالجات التحقق من الصحة.