تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceEnrollmentHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال التسجيلات.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
يتم شحن قوائم التكوين الآتية لواجهة ReplaceEnrollmentHandler مع المنتج. وتُدرَج مع نقطة الامتداد المخصصة لها.
حزمة التكامل لأنظمة معلومات الطالب، والقالب - التسجيلات
- ReplaceEnrollmentReadIMHandler (ترتيب الفرز = 10)
- ReplaceEnrollmentStatusDefaultActiveHandler (ترتيب الفرز = 20)
- ReplaceEnrollmentValidateSectionHandler (ترتيب الفرز = 30)
- ReplaceEnrollmentCreateIMEnrollmentHandler (ترتيب الفرز = 40)
- ReplaceEnrollmentSaveIMEnrollmentHandler (ترتيب الفرز = 50)
- ReplaceEnrollmentEnrollLMSOfferingHandler (ترتيب الفرز = 60)
- ReplaceEnrollmentEnrollLMSGroupSectionHandler (ترتيب الفرز = 70)
- ReplaceEnrollmentUnenrollLMSGroupSectionHandler (ترتيب الفرز = 80)
- ReplaceEnrollmentUnenrollLMSOfferingHandler (ترتيب الفرز = 90)
الخلفية، والقالب - الخلفية
- ReplaceEnrollmentUnenrollLMSGroupSectionHandler (ترتيب الفرز = 10)
- ReplaceEnrollmentEnrollLMSGroupSectionHandler (ترتيب الفرز = 20)
- ReplaceEnrollmentUnenrollLMSOfferingHandler (ترتيب الفرز = 30)
- ReplaceEnrollmentEnrollLMSOfferingHandler (ترتيب الفرز = 40)
ReplaceEnrollmentReadIMHandler
من المتوقع أن يحصل ReplaceEnrollmentReadIMHandler على جميع المعلومات ذات الصلة من قاعدة البيانات من جداول IM.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentReadIMHandler
السلوك المتوقع
بالنسبة إلى Brightspace، فإن التسجيل هو ببساطة ارتباط بين OrgUnit ومستخدم ودور. ويتوقع معالج ReadIM أن يتم تمريره في معرفات نظام معلومات الطالب لكل من هذه الكيانات، التي يستخدمها للبحث عن مواد الدور والمستخدم وOrgUnit المقترنة في كل من جداول IM ونظام إدارة التعلّم.
يؤدي المعالج المهام الآتية:
- قراءة IExternalOrgUnitInfo لـ OrgUnit المحددة الخاصة بنظام معلومات الطالب. تفشل العملية مع طرح استثناء إذا لم يتم العثور على ExternalOrgUnitInfo (إلزامي).
- قراءة تعيين الدور لدور نظام معلومات الطالب المحدد، وتحديد الأول إذا تم تمرير أكثر من واحد. تفشل العملية مع طرح استثناء إذا لم يتم العثور على تعيين الدور (إلزامي).
- قراءة تعيين المستخدم لمستخدم نظام معلومات الطالب المحدد. تفشل العملية مع طرح استثناء إذا لم يتم العثور على تعيين المستخدم (إلزامي)
- إذا كان هذا تحديث لتسجيل موجود في نظام معلومات الطالب، يقرأ المعالج IEnrollmentMapping. في حالة عدم العثور على تعيين التسجيل، يقوم الطلب بإنشاء تعيين جديد.
- في حالة العثور على تعيين التسجيل، يتحقق المعالج من أن المستخدم الموجود في الطلب يطابق المستخدم في التسجيل الموجود.
- قراءة IOrgUnitMappings في حالة وجود أي منها. وإذا لم يتم العثور على تعيين OrgUnit، يقوم المعالج بتسجيل رسالة ويستمر. قد تكون هناك حالات استخدام صالحة حيث نقوم بتحديث جداول IM فقط.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
عادةً ما يتم تكوين معالج القراءة أولاً في القائمة.
ReplaceEnrollmentValidateSectionHandler
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentValidateSectionHandler
السلوك المتوقع
السلوك المتوقع لهذا المعالج هو التحقق من أن طلب التسجيل الحالي مخصص لمقطع أو مجموعة مقرر تعليمي.
سلوك الخطأ
إذا لم يكن التسجيل لمقطع أو مجموعة مقرر تعليمي، يتم طرح InvalidOrgUnitTypeException.
ملاحظة التكوين
يجب تكوين هذا المعالج قبل معالج ReplaceEnrollmentCreateIMEnrollmentHandler.
ReplaceEnrollmentKeepLMSCreatedEnrollmentsOnUnenrollValidateHandler
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentKeepLMSCreatedEnrollmentsOnUnenrollValidateHandler
السلوك المتوقع
يتمثل السلوك المتوقع لهذا المعالج في التحقق من أن طلب التسجيل الحالي يتوافق مع سجل تسجيل نشأ من طلب نظام معلومات الطالب (وليس تسجيلاً يدويًا لـ Brightspace).
سلوك الخطأ
إذا كان سجل التسجيل قد نشأ في Brightspace (على سبيل المثال، تم تسجيل المستخدم في البداية يدويًا في Brightspace، ثم أرسل نظام معلومات الطالب replaceMembership لنفس المستخدم والوحدة التنظيمية)، يقوم المعالج بطرح UserManuallyEnrolledInLMSException.
ملاحظة التكوين
يجب تكوين هذا المعالج قبل ReplaceEnrollmentCreateIMEnrollmentHandler، ولكن بعد ReplaceEnrollmentReadIMHandler.
ReplaceEnrollmentCreateIMEnrollmentHandler
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentCreateIMEnrollmentHandler
السلوك المتوقع
السلوك المتوقع لهذا المعالج هو إنشاء سجلات التسجيل في جداول قاعدة بيانات IM إذا لم تكن موجودة بالفعل. لكل مادة تسجيل في قائمة الإنشاء في الطلب، إذا لم يكن هناك تعيين IM، يتم تحديث IM_ENROLLMENTS.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب تكوين هذا المعالج بعد معالجات القراءة والتحقق من الصحة.
ReplaceEnrollmentEnrollLMSGroupSectionHandler
يقوم ReplaceEnrollmentEnrollLMSGroupSectionHandler بتسجيل المستخدمين في المقاطع أو المجموعات التي تم تعيينها في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSGroupSectionHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- بالنسبة إلى كل مادة تسجيل نشطة في قائمة التسجيلات المراد تحديثها، إذا لم يكن المستخدم مسجلاً بعد في المقطع/المجموعة، يقوم المعالج بتسجيل المستخدم (ما يؤدي تلقائيًا إلى إدخال تدقيق).
- إذا كان المستخدم مسجلاً بالفعل في المقطع/المجموعة بدور مختلف، يقوم المعالج بإلغاء تسجيل المستخدم وإعادة تسجيله بالدور الجديد (ما يؤدي تلقائيًا إلى إدخال تدقيق).
- إذا كان المستخدم مسجلاً بالفعل في المقطع/المجموعة بالدور نفسه، فلن يقوم المعالج بأي إجراء.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب تكوين هذا المعالج بعد معالج SaveIM.
- يجب تكوين هذا المعالج قبل معالجات LMSOffering الخاصة بالتسجيل وإلغاء التسجيل.
- يجب ألا يتم تكوين هذا المعالج في الوقت نفسه مع ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler.
ReplaceEnrollmentEnrollLMSOfferingHandler
يسجل ReplaceEnrollmentEnrollLMSOfferingHandler المستخدمين في المضامين في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSOfferingHandler
السلوك المتوقع
يؤدي المعالج الخيارات الآتية:
- بالنسبة إلى كل مادة تسجيل نشطة في قائمة التسجيلات المراد تحديثها، إذا لم يكن المستخدم مسجلاً بعد في المضمون، يقوم المعالج بتسجيل المستخدم في مضمون المقرر التعليمي (ما يؤدي إلى إنشاء إدخال تدقيق تلقائيًا).
- إذا كان المستخدم مسجلاً بالفعل في المضمون بدور مختلف، يقوم المعالج بإلغاء تسجيل المستخدم وإعادة تسجيله بالدور الجديد (ما يؤدي تلقائيًا إلى إدخال تدقيق).
- إذا كان المستخدم مسجلاً بالفعل في المضمون بالدور نفسه، فلن يقوم المعالج بأي إجراء.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب تكوين هذا المعالج بعد معالج EnrollLMSGroupSection.
- يجب ألا يتم تكوين هذا المعالج في الوقت نفسه مع ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler.
ReplaceEnrollmentSaveIMEnrollmentHandler
يقوم ReplaceEnrollmentSaveIMEnrollmentHandler بحفظ أي تغييرات في التسجيل في جداول IM، بما في ذلك الحالة والدور. كما أنه ينشئ قائمة بالتسجيلات التي تحتاج إلى تحديث.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentSaveIMEnrollmentHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث الدور والحالة نشط/غير نشط لتسجيل IM الحالي وحفظ التغييرات في قاعدة البيانات إذا اختلف أي شيء عن قيمته الأصلية.
- إنشاء قائمة بالتسجيلات التي تحتاج إلى تحديث. قد يتم تعيين تسجيل IM فردي إلى تسجيلات متعددة إذا لم تكن OrgUnitMappings فردية.
- تنتقل المعالجة إلى المعالج التالي المتوفر.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
- يجب أن يحدث هذا المعالج بعد معالج CreateIMEnrollment.
- يجب أن يحدث هذا المعالج قبل معالجات نظام إدارة التعلّم الخاصة بالتسجيل وإلغاء التسجيل.
ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler
يقوم ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler بإنشاء التسجيل أو تحديثه في المقطع/المجموعة، ولكنه لن يقوم بتحديث الدور إذا كان هناك دور بالفعل. يسجل هذا المعالج المستخدمين في مقاطع أو مجموعات في Brightspace إذا لم يكونوا مسجلين بالفعل. وهو لا يغير التسجيلات الموجودة.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSGroupSectionRoleNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- لكل مادة تسجيل نشطة في قائمة التسجيلات المراد تحديثها، يقوم المعالج بتسجيل المستخدم في مقطع أو مجموعة في Brightspace (ما يؤدي إلى إنشاء إدخال تدقيق تلقائيًا).
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب تكوين هذا المعالج بعد معالج SaveIMEnrollment.
- يجب تكوين هذا المعالج قبل معالج EnrollLMSOffering.
- يجب ألا يتم تكوين هذا المعالج في الوقت نفسه مع ReplaceEnrollmentEnrollLMSGroupSectionHandler.
ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler
يقوم ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler بإنشاء التسجيل أو تحديثه في مضمون المقرر التعليمي، ولكنه لن يقوم بتحديث الدور إذا كان هناك دور بالفعل. لا يقوم المعالج بتغيير التسجيلات الموجودة.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentEnrollLMSOfferingRoleNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- لكل مادة تسجيل نشطة في قائمة التسجيلات المراد تحديثها، يقوم المعالج بتسجيل المستخدم في مضمون المقرر التعليمي (ما يؤدي إلى إنشاء إدخال تدقيق تلقائيًا).
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
- يجب تكوين هذا المعالج بعد معالج EnrollLMSGroupSection.
- يجب ألا يتم تكوين هذا المعالج في الوقت نفسه مع ReplaceEnrollmentEnrollLMSOfferingHandler.
ReplaceEnrollmentStatusDefaultActiveHandler
يقوم ReplaceEnrollmentStatusDefaultActiveHandler بتعيين حالة التسجيل بشكل افتراضي إلى نشطة إذا كانت خالية.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentStatusDefaultActiveHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كانت الحالة خالية حاليًا، فإن المعالج يقوم بتعيين الحالة إلى نشطة.
- وإلا، يتم تخطي هذا المعالج ولا يغير الحالة الحالية.
سيناريوهات الأخطاء
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب تكوين هذا المعالج بعد معالج القراءة.
- يجب تكوين هذا المعالج قبل معالجات CreateIM وSaveIM.
ReplaceEnrollmentStatusDefaultInactiveHandler
يقوم هذا المعالج بتعيين حالة التسجيل بشكل افتراضي إلى غير نشطة إذا كانت خالية.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentStatusDefaultInactiveHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كانت الحالة خالية حاليًا، فإن المعالج يقوم بتعيين الحالة إلى غير نشطة.
- وإلا، يتم تخطي هذا المعالج ولا يغير الحالة الحالية.
ملاحظات التكوين
- يجب تكوين هذا المعالج بعد معالج القراءة.
- يجب تكوين هذا المعالج قبل معالجات CreateIM وSaveIM.
ReplaceEnrollmentUnenrollLMSGroupSectionHandler
يقوم ReplaceEnrollmentUnenrollLMSGroupSectionHandler بإزالة التسجيلات من مجموعات ومقاطع Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentUnenrollLMSGroupSectionHandler
السلوك المتوقع
يقوم هذا المعالج بإلغاء تسجيل المستخدمين من المقاطع إذا لم يعد من المفترض أن يكونوا مسجّلين. يؤدي المعالج المهام الآتية:
- بالنسبة إلى كل مادة تسجيل غير نشطة في قائمة التسجيلات المراد تحديثها، إذا كانت OrgUnit مقطع مقرر تعليمي لنظام إدارة التعلّم أو مجموعة في نظام إدارة التعلّم، فإن المعالج يقوم بإلغاء تسجيل المستخدم من المقطع أو المجموعة، المعالج (ما يؤدي تلقائيًا إلى إدخال تدقيق) وتعيين RequestStatus = EntityDeleted.
- وإلا، يقوم المعالج بالتخطي والمتابعة إلى التسجيل التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يحدث UnenrollLMSGroupSection بعد التحقق من الصحة وقبل UnenrollLMSOffering.
ReplaceEnrollmentUnenrollLMSOfferingHandler
يقوم ReplaceEnrollmentUnenrollLMSOfferingHandler بإزالة التسجيلات من مضامين Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Enrollments.Handlers.ReplaceEnrollmentUnenrollLMSOfferingHandler
السلوك المتوقع
يقوم هذا المعالج بإلغاء تسجيل المستخدمين من المضامين في Brightspace إذا لم يعد من المفترض أن يكونوا مسجّلين. ولا يقوم بإلغاء تسجيل المستخدمين من المضامين إلا إذا لم يعودوا مسجّلين في أي مقاطع في المضمون.
يؤدي المعالج المهام الآتية:
- بالنسبة إلى كل مادة تسجيل في قائمة الحذف، إذا لم يعد التسجيل نشطًا، ولم يكن المستخدم مسجلاً في أي مقاطع أخرى في المضمون نفسه، فإن المعالج يقوم بإلغاء تسجيل المستخدم من مضمون المقرر التعليمي (ما يؤدي تلقائيًا إلى إدخال تدقيق) وتعيين RequestStatus = EntityDeleted.
- وإلا، يقوم المعالج بالتخطي والمتابعة إلى التسجيل التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يحدث UnenrollLMSOffering بعد معالج UnenrollLMSGroupSection.