تُستخدم واجهة المكون الإضافي الخاصة بـ IReadUserHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية قراءة المستخدمين.
تنفيذ الواجهة هو D2L.IM.IPSIS.Users.Handlers.IReadUserHandler.
يتم شحن قائمة التكوين الآتية لواجهة ReadUserHandler مع المنتج.
حزمة التكامل لأنظمة معلومات الطالب، والقالب
- ReadUserIMHandler (ترتيب الفرز = 10)
- ReadUserLMSHandler (ترتيب الفرز = 20)
ReadUserIMHandler
يحصل ReadUserIMHandler على التعيين للمستخدم المطلوب.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReadUserIMHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول المعالج الحصول على تعيين المستخدم من sourcedId في طلب SOAP.
- ويتم تخزين هذا التعيين في مادة الطلب التي سيتم استخدامها بواسطة معالجات لاحقة.
سلوك الخطأ
في حالة عدم العثور على تعيين، يتم طرح UserMappingNotFoundException.
ملاحظة التكوين
يجب وضع هذا المعالج قبل معالج قراءة نظام إدارة التعلّم دائمًا.
ReadUserLMSHandler
يحصل ReadUserLMSHandler على مستخدم الوحدة التنظيمية للمستخدم المطلوب.
التنفيذ
D2L.IM.IPSIS.Default.Users.Handlers.ReadUserLMSHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحاول المعالج الحصول على تعيين المستخدم من الطلب. وإذا كان فارغًا، فيتم إرجاع خطأ.
- باستخدام هذا التعيين، يحاول المعالج الحصول على OrgUser المطابق. ويتم إرجاع OrgUser هذا في مادة النتيجة مع التعيين.
سلوك الخطأ
- إذا كان التعيين في الطلب خاليًا، فيقوم المعالج بطرح ArgumentNullException.
- إذا لم يتم العثور على أي مستخدم (أي تم حذفه من نظام إدارة التعلّم ولكن التعيين لا يزال موجودًا)، فيقوم المعالج بطرح UserMappingNotFoundException.
ملاحظة التكوين
يجب وضع هذا المعالج بعد معالج قراءة IM دائمًا.