تُستخدم واجهة المكون الإضافي الخاصة بـ IReplaceUserHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية استبدال المستخدمين.
تنفيذ الواجهة هو D2L.IM.IPSIS.Users.Handlers.IReplaceUserHandler.
توفر قائمة التكوين الآتية نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب:
القالب - المستخدم، وحزمة التكامل لأنظمة معلومات الطالب
- ReplaceUserReadIPSISHandler (ترتيب الفرز = 10)
- ReplaceUserReadLMSHandler (ترتيب الفرز = 20)
- ReplaceUserStatusDefaultActiveHandler (ترتيب الفرز = 30)
- ReplaceUserRoleDefaultFirstRoleHandler (ترتيب الفرز = 40)
- ReplaceUserValidateBaseHandler (ترتيب الفرز = 50)
- ReplaceUserCreateLMSHandler (ترتيب الفرز = 60)
- ReplaceUserCreateIPSISHandler (ترتيب الفرز = 70)
- ReplaceUserSaveLMSHandler (ترتيب الفرز = 80)
- ReplaceUserSaveIPSISHandler (ترتيب الفرز = 90)
- ReplaceUserSavePasswordPlainTextHandler (ترتيب الفرز = 100)
- ParentPortalCreateRelationshipHandler
ReplaceUserReadIPSISHandler
يقوم ReplaceUserReadIPSISHandler بتعبئة مادة الطلب بمعلومات من جداول IM المتعلقة بالمستخدم المشار إليه في الطلب.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadIPSISHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كان المستخدم قد تم تسليمه من قبل، فسيحصل هذا المعالج أولاً على أي بيانات موجودة لهذا المستخدم، بما في ذلك التعيين (UserId) من جداول IM.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يقع معالج قراءة حزمة التكامل لأنظمة معلومات الطالب قبل معالج قراءة نظام إدارة التعلّم.
ReplaceUserReadLMSHandler
يقوم ReplaceUserReadLMSHandler بتعبئة مادة الطلب بمعلومات من جداول نظام إدارة التعلّم الخاصة بالمستخدم المشار إليه في الطلب.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كان Userid بنظام إدارة التعلّم متوفرًا، فسيقوم المعالج بقراءة قيم نظام إدارة التعلّم الموجودة لخصائص المستخدم.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يقع معالج قراءة حزمة التكامل لأنظمة معلومات الطالب قبل معالج قراءة نظام إدارة التعلّم.
ReplaceUserStatusDefaultActiveHandler
يقوم ReplaceUserStatusDefaultActiveHandler بتعيين الإعداد الافتراضي لحالة المستخدم إلى "نشط" إذا لم يتم تعيينه سابقًا.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultActiveHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تعيين الحالة إلى "نشط" إذا لم يتم تعيينها سابقًا.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا المعالج قبل معالج التحقق من الصحة.
ReplaceUserValidateBaseHandler
يضمن ReplaceUserValidateBaseHandler تعيين الحد الأدنى من الخصائص المطلوبة للمستخدم. وتشمل هذه الخيارات معرِّف المستخدم واسم المستخدم والدور والحالة.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserValidateBaseHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- التأكد من تعيين القيم الآتية: معرِّف الكيان واسم المستخدم والدور والحالة.
- إذا لم يتم تعيين أي من القيم، فسيتم طرح ArgumentNullException مع تفاصيل القيمة المفقودة. ويقوم المحول بتسجيل رسالة الاستثناء المحددة وإرجاع خطأ عام إلى نظام معلومات الطالب.
- إذا تم تعيين كلمة المرور ليتم تحديثها، وكان نوع التشفير من نوع غير مدعوم، فسيتم طرح InvalidDataException مع تفاصيل نوع التشفير غير المدعوم. ويقوم المحول بتسجيل رسالة الاستثناء المحددة وإرجاع خطأ عام إلى نظام معلومات الطالب.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا المعالج قبل معالج الإنشاء الأول.
ReplaceUserCreateLMSHandler
يقوم ReplaceUserCreateLMSHandler بإنشاء المستخدم في جداول نظام إدارة التعلّم إذا لم يكن موجودًا بها بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- في حال عدم وجود مادة صالحة لمستخدم نظام إدارة التعلّم في الطلب، يقوم المعالج بإنشاء المستخدم في جداول Brightspace (تشغيل تسجيل التدقيق التلقائي).
- إدخال التدقيق لإنشاء مستخدم إذا تم إنشاء المستخدم.
- إذا نجح كل شيء، يقوم المعالج بتعيين ReplaceRequestStatus = EntityCreated.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا المعالج قبل معالج إنشاء حزمة التكامل لأنظمة معلومات الطالب.
ReplaceUserCreateIPSISHandler
يقوم ReplaceUserCreateIPSISHandler بإنشاء المستخدم في جداول IM إذا لم يكن موجودًا بها بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateIPSISHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إنشاء المستخدم في جداول IM إذا لم يكن موجودًا بها بالفعل.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب وضع هذا المعالج بعد معالج إنشاء نظام إدارة التعلّم.
- يجب وضع هذا المعالج قبل معالجات الحفظ.
ReplaceUserSaveLMSHandler
يحفظ ReplaceUserSaveLMSHandler أي تحديثات مطلوبة لنظام إدارة التعلّم.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كانت ثمة أي تحديثات مستخدم لنظام إدارة التعلّم، فسيقوم المعالج بحفظها (تشغيل تسجيل تدقيق تلقائي).
- إذا كانت ثمة مشكلة في الحفظ، فسيتم تعيين الحالة إلى خطأ.
- إذا نجح كل شيء، فسيقوم المعالج بإنشاء مستخدم وتحديثه عند تغيير البيانات وتعيين ReplaceRequestStatus = EntityUpdated.
- تستمر المعالجة إلى المعالج التالي (ليُرجع قيمة صحيحة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا بعد معالجات الإنشاء.
ReplaceUserSaveIPSISHandler
يحفظ ReplaceUserSaveIPSISHandler أي تحديثات مطلوبة في جداول IM.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveIPSISHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كانت ثمة أي تحديثات مستخدم لجداول IM، فسيقوم المعالج بحفظها.
- تنتقل المعالجة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا بعد معالجات الإنشاء.
ReplaceUserSavePasswordPlainTextHandler
يقوم ReplaceUserSavePasswordPlainTextHandler بحفظ كلمة مرور النص العادي إلى نظام إدارة التعلّم.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSavePasswordPlainTextHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كانت ثمة كلمة مرور متوفرة بنص عادي، وتم تعريفها كمحدّثة، فسيحفظ المعالج كلمة المرور إلى نظام إدارة التعلّم. وإذا تم تخزين كلمة المرور بأي نوع تشفير آخر، فلن يقوم المعالج بأي شيء.
- يقوم المعالج بإنشاء إدخال محدّث لتدقيق كلمة المرور.
- يجب تكوين معالج ما لنوع التشفير المحدد.
- إذا تم تحديث كلمة المرور، ولم تكن الحالة EntityCreated، فسيتم تعيين الحالة إلى EntityUpdated.
- المتابعة إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب وضع هذا بعد معالجات الإنشاء.
ReplaceUserRoleDefaultFirstRoleHandler
يعيّن ReplaceUserRoleDefaultFirstRoleHandler الإعداد الافتراضي للدور الأساسي لمستخدم نظام إدارة التعلّم إلى الدور الأول في قائمة الأدوار الواردة في الطلب، إذا لم يتم تعيين دور سابقًا.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultFirstRoleHandler
السلوك المتوقع
إذا لم يتم تعيين دور أساسي، فسيقوم بتعيينه إلى الدور الأول في قائمة أدوار الطلب، والمتابعة إلى المعالج التالي.
إذا لم يتم تعيين دور أساسي وكانت قائمة أدوار الطلب فارغة، فسيتابع هذا المعالج إلى المعالج التالي من دون تحديد دور أساسي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب وضع هذا المعالج قبل معالج التحقق من الصحة.
- يقوم هذا المعالج بتعبئة الدور في مادة طلب حزمة التكامل لأنظمة معلومات الطالب ويتم استخدام هذا الدور عند إنشاء/تحديث مستخدم نظام إدارة التعلّم. يجب تكوين هذا المعالج إذا كان يجب تطبيق دور من الطلب على مستخدمي نظام إدارة التعلّم. ومن دون هذا المعالج، لا يتم استخدام دور (أدوار) الطلب عند إنشاء/تحديث مستخدم نظام إدارة التعلّم.
- عند الاستخدام بالاشتراك مع ReplaceUserRoleDefaultConfigVariableHandler، يجب وضع هذا المعالج قبله إذا كنت ترغب في تعيين الدور الوارد في الطلب كدور المستخدم. وإذا كنت تتوقع عدم وجود معلومات الدور في الطلب، فقم أيضًا بتكوين ReplaceUserRoleDefaultConfigVariableHandler لاتباع هذا المعالج.
ReplaceUserRoleDefaultConfigVariableHandler
يُستخدم ReplaceUserRoleDefaultConfigVariableHandler لتعيين دور استنادًا إلى متغير التكوين d2l.Integrations.IPSIS.DefaultRole إذا لم يتم تعيين دور سابقًا. يتم تعيين متغير التكوين إلى معرِّف دور Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultConfigVariableHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتم تعيين دور أساسي، فسيقوم المعالج بتعيينه إلى الدور الموجود في d2l.Integrations.IPSIS.DefaultRole، ويتابع إلى المعالج التالي.
- إذا تم تعيين دور أساسي، فلن يقوم المعالج بأي شيء وسيتابع إلى المعالج التالي.
سلوك الخطأ
- في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
- إذا لم يتم تكوين متغير التكوين، فسيتم طرح RoleNotFoundException مع الرسالة "لم يتم تعيين دور افتراضي لقيمة التكوين: d2l.Integrations.IPSIS.DefaultRole".
ملاحظات التكوين
- يجب وضع هذا المعالج قبل معالج التحقق من الصحة.
- يقوم هذا المعالج بتعبئة الدور في مادة طلب حزمة التكامل لأنظمة معلومات الطالب ويتم استخدام هذا الدور عند إنشاء/تحديث مستخدم نظام إدارة التعلّم. يجب تكوين هذا المعالج في حالة من حالتين:
- تقوم طلبات الأشخاص في LIS دائمًا باستثناء دور ما. ويلزم وجود دور ما لإنشاء مستخدم في نظام إدارة التعلّم.
- قد تحدد طلبات الأشخاص في LIS أحيانًا، وليس دائمًا، دورًا ما. ويجب تكوين معالج آخر، مثل ReplaceUserRoleDefaultFirstRoleHandler قبل هذا المعالج لتعيين دور مادة طلب حزمة التكامل لأنظمة معلومات الطالب إلى الدور الوارد في الطلب، ومن ثَمَّ التأكد من إنشاء/تحديث المستخدم باستخدام الدور الوارد في الطلب. ومع ذلك، عند عدم وجود دور في الطلب، يقوم هذا المعالج بتعيين دور ما ويضمن إمكانية إنشاء المستخدم بشكل صحيح.
ReplaceUserUsernameFromEmailPrefixHandler
يقوم ReplaceUserUsernameFromEmailPrefixHandler بتعيين اسم المستخدم إلى بادئة عنوان البريد الإلكتروني (قبل علامة @) إذا لم يتم تعيين اسم مستخدم بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUsernameFromEmailPrefixHandler
السلوك المتوقع
إذا لم يتم تعيين اسم مستخدم، وكانت ثمة قيمة في عنوان البريد الإلكتروني، فسيقوم بتعيين اسم المستخدم إلى بادئة عنوان البريد الإلكتروني ويتابع إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادةً قبل التحقق من الصحة.
ReplaceUserUsernameGenerateHandler
يقوم ReplaceUserUsernameGenerateHandler بإنشاء اسم مستخدم باستخدام طريقة إنشاء اسم مستخدم لنظام إدارة التعلّم إذا لم يتم تعيين اسم مستخدم بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameGenerateHandler
السلوك المتوقع
إذا لم يتم تعيين اسم مستخدم، فأنشئ اسم مستخدم باستخدام خوارزمية إنشاء اسم مستخدم منصة التعلّم وتابع إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة كالمعالج الأخير لاسم المستخدم قبل التحقق من الصحة.
ReplaceUserUsernameFromEmailHandler
يقوم ReplaceUserUsernameFromEmailHandler بتعيين اسم المستخدم إلى عنوان البريد الإلكتروني الكامل إذا لم يكن اسم المستخدم معيّنًا بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameFromEmailHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتم تعيين اسم مستخدم، وكانت ثمة قيمة في عنوان البريد الإلكتروني، فسيقوم المعالج بتعيين اسم المستخدم إلى عنوان البريد الإلكتروني.
- ينتقل المعالج إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادةً قبل التحقق من الصحة.
ReplaceUserUsernameNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يقوم بتحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث اسم المستخدم.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserFirstNameNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserFirstNameNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم الأول.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserLastNameNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserLastNameNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الاسم الأخير.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserOrgDefinedIdNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserOrgDefinedIdNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يقوم بتحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث orgdefinedid.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserPasswordNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserPasswordNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يقوم بتحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث كلمة المرور في نظام إدارة التعلّم.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserRoleNoUpdateHandler
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleNoUpdateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تحديث مادة الطلب للإشارة إلى أنه يجب عدم تحديث الدور في نظام إدارة التعلّم.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب وضع هذا المعالج بعد معالج يقوم بتعيين دور Brightspace في الطلب.
- يجب وضع هذا المعالج قبل معالجات الإنشاء/الحفظ.
ReplaceUserMapByUsernameAndOrgDefinedIdHandler
يقوم ReplaceUserMapByUsernameAndOrgDefinedIdHandler بإقران مستخدم نظام معلومات الطالب بمستخدمين موجودين في نظام إدارة التعلّم من خلال مطابقة اسم المستخدم وOrgDefinedId.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameAndOrgDefinedIdHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يكن ثمة تخطيط مستخدم موجود في جداول IM، فسيحاول المعالج العثور على مستخدم في نظام إدارة التعلّم يتطابق مع كل من اسم المستخدم وOrgDefinedId.
- إذا تم العثور على تطابق، فسيقوم المعالج بتحديث مادة الطلب لتضم المستخدم المطابق. وتكون المطابقة، إن وجدت، فريدة دائمًا.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
- إذا كان التعيين موجودًا بالفعل باسم المستخدم نفسه، ولكن لديه sourcedId مختلف، فسيتم طرح DuplicateUsernameException.
- في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج عادة بين معالجات القراءة ومعالجات الإنشاء، حيث يتم تنفيذه إذا فشلت معالجات القراءة في العثور على OrgUser معين فقط.
ReplaceUserMapByUsernameHandler
يقوم ReplaceUserMapByUsernameHandler بإقران مستخدم نظام معلومات الطالب بمستخدمين موجودين في نظام إدارة التعلّم من خلال مطابقة اسم المستخدم.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يكن ثمة تخطيط مستخدم موجود في جداول IM، فسيحاول المعالج العثور على مستخدم في نظام إدارة التعلّم يتطابق من حيث اسم المستخدم.
- إذا تم العثور على تطابق، فسيقوم المعالج بتحديث مادة الطلب لتضم المستخدم المطابق. وتكون المطابقة، إن وجدت، فريدة دائمًا.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
- إذا كان التعيين موجودًا بالفعل باسم المستخدم نفسه، ولكن لديه sourcedId مختلف، فسيتم طرح DuplicateUsernameException.
- في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج عادة بين معالجات القراءة ومعالجات الإنشاء، حيث يتم تنفيذه إذا فشلت معالجات القراءة في العثور على OrgUser معين فقط.
ReplaceUserMapByOrgDefinedIdHandler
يقوم ReplaceUserMapByOrgDefinedIdHandler بإقران مستخدم نظام معلومات الطالب بمستخدمين موجودين في نظام معلومات الطالب من خلال مطابقة OrgDefinedId.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByOrgDefinedIdHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- في حال عدم وجود تعيين مستخدم أو OrgUser في رسالة الطلب، يحاول المعالج العثور على مستخدم في نظام إدارة التعلّم يتطابق من حيث OrgDefinedId.
- إذا تم العثور على تطابق، فسيقوم المعالج بتحديث مادة الطلب لتضم المستخدم المطابق.
- قد يكون ثمة أكثر من تطابق واحد في قاعدة البيانات، ولكن المنصة تُرجع نتيجة واحدة فقط. ويجب عدم استخدام هذا المعالج إلا إذا كان من المتوقع أن يكون OrgDefinedId فريدًا في الوحدة التنظيمية.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
- إذا كان التعيين موجودًا بالفعل باسم المستخدم نفسه، ولكن لديه sourcedId مختلف، فسيتم طرح DuplicateUsernameException.
- في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يتم وضع هذا المعالج عادة بين معالجات القراءة ومعالجات الإنشاء، حيث يتم تنفيذه إذا فشلت معالجات القراءة في العثور على OrgUser معين فقط.
ReplaceUserRequirePasswordChangeOnCreateHandler
يتأكد ReplaceUserRequirePasswordChangeOnCreateHandler من ضرورة تغيير المستخدمين الجدد كلمات المرور الخاصة بهم عند تسجيل الدخول الأول.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRequirePasswordChangeOnCreateHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تعيين العلامة على الطلب الذي تم تمريره إلى معالج الإنشاء الذي يضع علامة على المستخدم على أنه يجب عليه تغيير كلمة المرور عند تسجيل الدخول الأول.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادة قبل معالجات الإنشاء/الحفظ.
ReplaceUserStatusDefaultInactiveHandler
يقوم ReplaceUserStatusDefaultInactiveHandler بتعيين الإعداد الافتراضي للحالة إلى "غير نشط" في حالة عدم توفير حالة.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultInactiveHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- تعيين الحالة إلى "غير نشط" إذا لم يتم تعيينها سابقًا.
- الانتقال إلى المعالج التالي.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يوضع هذا المعالج عادةً قبل التحقق من الصحة.
ReplaceUserVerifyConsistentSourcedIdHandler
يتحقق ReplaceUserVerifyConsistentSourcedIdHandler من أن الطلب لا يحاول إعطاء sourcedId جديد لمستخدم تم تعيينه بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserVerifyConsistentSourcedIdHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يكن الطلب يتضمن D2LOrgUser معيّنًا، فلن يقوم المعالج بأي شيء.
- إذا تم تعيين مستخدم مؤسسة، فسيتحقق المعالج مما إذا كان ثمة أي تعيينات لهذا المستخدم في النظام/المؤسسة الحالية.
- إذا لم يتم تعيينه، فلن يقوم المعالج بأي شيء.
- إذا كانت ثمة تعيينات، فسيقوم المعالج بالتحقق مما إذا كان sourcedId للتعيين الحالي يطابق sourcedId الخاص بالطلب.
- إذا تطابقا، فإن المعالج لا يفعل شيئًا.
- إذا لم تتطابق، فسيقوم المعالج بطرح DuplicatedUsernameException لإعلام نظام معلومات الطالب بأنه يحاول تعيين sourcedId جديد إلى مستخدم موجود.
سلوك الخطأ
إذا كان ثمة تعيين مستخدم موجود بالفعل للمستخدم، ويحتوي على sourcedId مختلف، فسيطرح المعالج استثناءً.
ملاحظة التكوين
يجب وضع هذا المعالج بعد معالج MapBy (مثل ReplaceUserMapByUsernameHandler) للتحقق من أن المستخدم لم يتم تعيينه بالفعل إلى sourcedId مختلف. كما يجب وضعه قبل معالجات الحفظ/الإنشاء.
ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler
يتحقق ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler من أن الطلب لا يحاول إعطاء sourcedId جديد لمستخدم تم تعيينه بالفعل.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يكن الطلب يتضمن D2LOrgUser معيّنًا، فلن يقوم المعالج بأي شيء.
- إذا تم تعيين مستخدم مؤسسة، فسيتحقق المعالج مما إذا كان ثمة أي تعيينات لهذا المستخدم في النظام/المؤسسة الحالية.
- إذا لم يكن ثمة تعيينات، فلن يقوم المعالج بأي شيء.
- إذا كانت ثمة تعيينات، فسيقوم المعالج بالتحقق لمعرفة ما إذا كان sourcedId للتعيين الحالي يطابق sourcedId الخاص بالطلب.
- إذا تطابقا، فإن المعالج لا يفعل شيئًا.
- إذا لم يتطابقا، فسيقوم المعالج بالتحقق لمعرفة ما إذا كان تعيين المستخدم موجودًا بالفعل في النظام المصدر مع sourcedId الخاص بالطلب.
- إذا كان التعيين موجودًا، فسيقوم المعالج بطرح DuplicatedUsernameException لإعلام نظام معلومات الطالب بأنه يحاول تعيين sourcedId جديد إلى مستخدم موجود، وأنه لا يمكن تغيير sourcedId للمستخدم الموجود إلى المعرِّف الجديد بسبب التعارض.
- إذا لم يتطابقا، فسيقوم المعالج بتغيير sourcedId الخاص بالمستخدم في جدول التعيينات إلى المعرِّف الموجود في الطلب ويقوم بتعيين UserMapping الموجود في الطلب إلى التعيين الذي تمت إعادة تسميته الآن.
سلوك الخطأ
إذا كان ثمة تعيين مستخدم موجود بالفعل للمستخدم، ويحتوي على sourcedId مختلف وكان sourcedId المطلوب قيد الاستخدام بالفعل، فسيطرح المعالج استثناءً.
ملاحظة التكوين
يجب وضع هذا المعالج بعد معالج MapBy (مثل ReplaceUserMapByUsernameHandler) ولكن قبل معالجات الحفظ/الإنشاء. ويجب استخدام هذا المعالج بدلاً من ReplaceUserVerifyConsistentSourcedIdHandler.