تُستخدم واجهة المكون الإضافي الخاصة بـ IReadGradesHandler بواسطة محولات حزمة التكامل لأنظمة معلومات الطالب لدعم عملية قراءة العلامات.
تنفيذ الواجهة هو D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
يتم شحن قوائم التكوين الآتية لواجهة ReadGradesHandler مع المنتج. وتُدرَج مع نقطة الامتداد المخصصة لها.
حزمة التكامل لأنظمة معلومات الطالب، والقالب - العلامات
- ReadGradesGradableMappingGetFirstMappingWithGradesHandler (ترتيب الفرز = 10)
- ReadGradesResolveGradeTypeFromCourseSettingHandler (ترتيب الفرز = 20)
- ReadGradesStatusDefaultAllHandler (ترتيب الفرز = 30)
- ReadGradesDisplayTypeDefaultPointsHandler (ترتيب الفرز = 40)
- ReadGradesValidateHandler (ترتيب الفرز = 50)
- ReadGradesGetGradesForSectionMappingHandler (ترتيب الفرز = 60)
- ReadGradesFilterBySISEnrollmentsHandler (ترتيب الفرز = 70)
ReadGradesGradableMappingDefaultToFirstMappingHandler
يمكن تعيين مادة orgUnit واحدة في نظام معلومات الطالب إلى OrgUnits متعددة في Brightspace. على سبيل المثال، يمكن أن يحدث هذا مع المعالجات الافتراضية لأحد المقاطع التي تُعَد جزءًا من اقتران مقطع واحد أو أكثر. عندما يحتوي الإدخال على SISId لـ OrgUnit ولكن لا يوجد تعيين، يجب تحديد تعيين واحد من المجموعة. يقوم معالج التعيين من الافتراضي إلى الأول ببساطة بتحديد التعيين الأول في القائمة التي تم إرجاعها من قاعدة البيانات.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingDefaultToFirstMappingHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كان هناك بالفعل OrgUnitMapping مرفق بالطلب، فلن يقوم المعالج بأي إجراء.
- بخلاف ذلك، إذا لم يكن هناك SisId على الطلب، فسيقوم المعالج بطرح IncompleteRequestException.
- إذا كان SisId موجودًا، فسيبحث المعالج عن تعيينات OrgUnit في قاعدة البيانات.
- وإذا تم إرجاع تعيينات متعددة، فسيحدد المعالج التعيين الأول من القائمة. ويكون هذا الذي يحتوي على أقل معرِّف بشكل عام، ما يعني أنه تم تعيينه أولاً.
- يتم تحديث تعيين مادة الطلب بهذه القيمة. تتوفر هذه المعلومات للمعالجات اللاحقة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
- يجب وضع معالج GradableMapping قبل استرداد العلامات الفعلية من قاعدة البيانات.
- توجد معالجات مخططة تستخدم معايير أخرى لتحديد تعيين، بما في ذلك اختيار التعيين الأول مع علامات أو التعيين المحدد كقابل لوضع علامة عليه. لتجنب حدوث التباس، يجب استخدام معالج GradableMapping واحد فقط في قائمة تكوين معينة.
ReadGradesGradableMappingGetIsGradableMappingHandler
يمكن تعيين مادة orgUnit واحدة في نظام معلومات الطالب إلى OrgUnits متعددة في Brightspace. على سبيل المثال، يمكن أن يحدث هذا مع المعالجات الافتراضية لأحد المقاطع التي تُعَد جزءًا من اقتران مقطع واحد أو أكثر. عندما يحتوي الإدخال على SISId لـ OrgUnit ولكن لا يوجد تعيين، نحتاج إلى تحديد تعيين واحد من المجموعة. يقوم معالج الحصول على تعيين قابل لوضع العلامات عليه باختيار التعيين الأول الذي يتم تمييزه كقابل لوضع العلامات عليه.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetIsGradableMappingHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا كان هناك بالفعل OrgUnitMapping مرفق بالطلب، فلن يقوم المعالج بأي إجراء.
- بخلاف ذلك، إذا لم يكن هناك SisId على الطلب، فسيقوم المعالج بطرح IncompleteRequestException.
- إذا كان SisId موجودًا، فسيبحث المعالج عن تعيينات OrgUnit الخاصة به في قاعدة البيانات.
- إذا تم إرجاع تعيينات متعددة، فسيحدد المعالج التعيين الأول الذي يحمل إشارة قابل لوضع العلامات عليه معيّنة إلى صواب. إذا لم يوجد مثل هذا التعيين، فسيقوم المعالج بطرح NoGradableSectionsException.
- إذا تم ضبط تعيينات متعددة إلى قابل لوضع العلامات عليه، فسيقوم المعالج بطرح MultipleGradableSectionsException.
- يتم تحديث تعيين مادة الطلب بهذه القيمة. تتوفر هذه المعلومات للمعالجات اللاحقة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب وضع معالج GradableMapping قبل استرداد العلامات الفعلية من قاعدة البيانات.
- توجد معالجات تستخدم معايير أخرى لتحديد تعيين، بما في ذلك اختيار التعيين الأول مع علامات أو التعيين الأول فقط بشكل عام. لتجنب حدوث التباس، يجب استخدام معالج GradableMapping واحد فقط في قائمة تكوين معينة.
ReadGradesResolveGradeTypeFromCourseSettingHandler
عند عدم تعيين نوع العلامة (العلامة النهائية المعدَلة/العلامة النهائية المحتسبة) بعد (عبر مترجم أو معالج سابق)، يقوم هذا المعالج بتعيين نوع العلامة استنادًا إلى متغير التكوين ذي الصلة (Grades.Calculation.ReleaseAdjustedGrade).
يقرأ المعالج الإعداد من مضمون المقرر التعليمي وليس المقطع. ويقوم بالحصول على تعيين الوحدة التنظيمية الأصل (مضمون المقرر التعليمي) للوصول إلى متغير التكوين.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesResolveGradeTypeFromCourseSettingHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتم تعيين نوع العلامة بعد، يقوم باسترداد متغير التكوين لـ GradeType. ويتم التحكم فيها من خلال إعداد دفتر العلامات.
- تعيين نوع العلامة (إما العلامة النهائية المحتسبة أو النهائية المعدَلة).
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يحدث معالج ResolveGradeType قبل استرداد العلامات الفعلية من قاعدة البيانات (أي قبل ReadGradesGetGradesForSectionHandler) وبعد تحديد التعيين.
ReadGradesStatusDefaultAllHandler
يقوم هذا المعالج بتعيين حالة العلامة إلى الكل.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultAllHandler
السلوك المتوقع
إذا لم يتم تعيين حالة العلامة بعد، يقوم بتعيين حالة العلامة إلى الكل.
ملاحظات التكوين
- يجب أن يحدث معالج StatusDefault قبل معالج DisplayTypeDefault (النقاط أو الرموز).
- يجب أن يحدث معالج StatusDefault قبل استرداد العلامات الفعلية من قاعدة البيانات (أي قبل ReadGradesGetGradesForSectionMappingHandler).
- يجب عدم استخدام معالج StatusDefault مقترنًا مع أي معالج StatusDefault آخر.
ReadGradesGetGradesForSectionMappingHandler
يقوم ReadGradesGetGradesForSectionMappingHandler باسترداد العلامات من قاعدة البيانات.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGetGradesForSectionMappingHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتطابق معرِّف إدخال نظام معلومات الطالب مع مقطع في جداول IM، فسيقوم المعالج بطرح استثناء.
- بخلاف ذلك، يسترد المعالج العلامات الفعلية من إدارة العلامات، ويتم تصفيتها حسب الخيارات التي تم تعيينها حتى الآن.
- يسترد تسجيلات نظام معلومات الطالب لجميع المستخدمين المسجلين في OrgUnit المحددة من التعيين.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يحدث هذا المعالج بعد أي معالج يقوم بتعيين نوع الطلب أو الحالة أو التعيين، لكن قبل تصفية العلامات.
ReadGradesValidateHandler
يقوم ReadGradesValidateHandler بالتحقق من أنه قد تم تعيين كل الخصائص المطلوبة، وأن orgUnit هي من نوع يدعم العلامات الموجودة في Brightspace.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesValidateHandler
السلوك المتوقع
- إذا لم يتوافق معرِّف إدخال نظام معلومات الطالب مع مقطع من مضمون في جداول IM، فسيقوم المعالج بطرح استثناء.
- بخلاف ذلك، يتحقق المعالج من أن GradeType وGradeStatus في مادة الطلب قد تم تعيينها بواسطة المترجمين و/أو المعالجات السابقة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظة التكوين
يجب أن يحدث هذا المعالج بعد تحديد النوع والحالة، ولكن قبل قراءة العلامات بالفعل من قاعدة البيانات.
ReadGradesMatchGradesToSISEnrolledUsersHandler
يقبل ReadGradesMatchGradesToSISEnrolledUsersHandler قائمة علامات، كما يقوم بإرجاع قائمة علامات مقترنة بـ UserIds الخاصة بنظام معلومات الطالب. يتم حذف أي علامات لا تتطابق مع المستخدمين المسجلين في نظام معلومات الطالب.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesIncludeOnlySISEnrolledUsersHandler
السلوك المتوقع
تقوم إدارة العلامات بإرجاع كل العلامات لـ OrgUnit، ولكن هذه العلامات تتوافق مع UserId الخاص بنظام إدارة التعلّم، وليس UserId الخاص بنظام معلومات الطالب. يحدد هذا المعالج UserId المناسب الخاص بنظام معلومات الطالب لكل علامة، ويرجع مجموعة من أزواج Grade/SISUserId. إذا لم يكن هناك UserId خاص بنظام معلومات الطالب لمستخدم معين، يتم حذف العلامة المقترنة من النتائج.
يؤدي المعالج المهام الآتية:
- استرداد قائمة تسجيلات OrgUnit الحالية.
- بالنسبة إلى كل حالة منهم، يقوم بتحديد UserId الخاص بنظام معلومات الطالب للمستخدم المسجل.
- إيجاد أول IGrade مطابقة لهذا المستخدم، إن وجدت.
- إنشاء مادة جديدة تقوم بتضمين زوجين من IGrade وSISUserId وإرفاقها بالاستجابة.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن يحدث هذا المعالج بعد قراءة العلامات من قاعدة البيانات.
- هذا المعالج ضروري للسماح لنظام معلومات الطالب بمطابقة العلامات مع المستخدمين باستخدام معرِّف يفهمونه. يجب دائمًا تكوين هذا المعالج (أو البديل المخصص).
ReadGradesStatusDefaultReleasedOnlyHandler
يقوم المعالج ReadGradesStatusDefaultReleasedOnlyHandler بتعيين نوع العلامات إلى تم الإصدار.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultReleasedOnlyHandler
السلوك المتوقع
إذا لم يتم تعيين نوع العلامة بعد، يقوم بتعيين نوع العلامة إلى تم الإصدار.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن يحدث معالج StatusDefault قبل معالج DisplayTypeDefault (النقاط أو الرموز).
- يجب أن يحدث معالج StatusDefault قبل استرداد العلامات الفعلية من قاعدة البيانات (أي قبل ReadGradesGetGradesForSectionMappingHandler).
- يجب عدم استخدام معالج StatusDefault مقترنًا مع أي معالج StatusDefault آخر.
ReadGradesGradableMappingGetFirstMappingWithGradesHandler
يقوم ReadGradesGradableMappingGetFirstMappingWithGradesHandler بضبط تعيين الوحدة التنظيمية إلى الأول (يتم فرزه بواسطة معرِّف orgunitmapping) الذي يحتوي على العلامات المتوفرة.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetFirstMappingWithGradesHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- إذا لم يتم ضبط تعيين الوحدة التنظيمية، يقوم المعالج بالحصول على كل تعيينات الوحدة التنظيمية التي تطابق المعرِّف الخارجي ويفرزها بواسطة معرِّف تعيين الوحدة التنظيمية.
- يقوم المعالج بفحص التعيين الأول الذي به علامة تم تمييزها كمتوفرة. يتم سحب العلامات التي تم التحقق منها بناءً على إشارة نوع علامة المضمون ذات الصلة (أي، إذا تم تكوين مضمون المقرر التعليمي الخاص بالمقطع لإصدار FinalAdjusted، فسيتحقق المعالج من العلامات النهائية المعدَلة المتوفرة). متوفرة تعني أن العلامة إما أن يكون لها بسط أكبر من 0، أو أن بها مجموعة رموز. التوفر بشكل أساسي يعني أن العلامة تتضمن قيمة معينة في ذلك المقطع.
- يقوم المعالج بضبط تعيين الوحدة التنظيمية للطلب إلى هذا التعيين.
سلوك الخطأ
- في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
- إذا لم يتم العثور على تعيينات الوحدة التنظيمية، فسيتم طرح OrgUnitMappingNotFoundException.
- إذا لم يتم العثور على علامات لأي من تعيينات الوحدة التنظيمية، فسيتم طرح NoGradableSectionFoundException.
ملاحظات التكوين
- يجب وضع هذا المعالج قبل قراءة العلامات بالفعل من قاعدة البيانات. كما يجب وضعه قبل أي معالج يحتاج إلى معرفة الوحدة التنظيمية التي يعمل عليها (مثل المعالج الذي يحاول قراءة تكوين الوحدة التنظيمية).
- هذا المعالج هو واحد من العديد من المعالجات التي تحدد تعيين الوحدة التنظيمية. يجب ألا يكون هناك أكثر من واحد من هذه المعالجات في التكوين النشط في المرة الواحدة.
ReadGradesDisplayTypeDefaultPointsHandler
يقوم ReadGradesDisplayTypeDefaultPointsHandler بتعيين نوع عرض العلامة إلى نقاط. يؤثر ذلك في العرض في واجهة مستخدم تصدير العلامات، بالإضافة إلى العلامات المرسلة إلى نظام معلومات الطالب.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultPointsHandler
السلوك المتوقع
إذا لم يتم تعيين نوع عرض العلامة بعد، فسيقوم المعالج بتعيين نوع عرض العلامة إلى نقاط.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن يحدث معالج DisplayTypeDefault قبل استرداد العلامات الفعلية من قاعدة البيانات (أي قبل ReadGradesGetGradesForSectionMappingHandler).
- يجب عدم استخدام معالج DisplayTypeDefault هذا مقترنًا مع أي معالج DisplayTypeDefault آخر.
ReadGradesDisplayTypeDefaultSymbolsHandler
يقوم ReadGradesDisplayTypeDefaultSymbolsHandler بتعيين نوع عرض العلامة إلى رموز. يؤثر ذلك في العرض في واجهة مستخدم تصدير العلامات، بالإضافة إلى العلامات المرسلة إلى نظام معلومات الطالب.
التنفيذ
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultSymbolsHandler
السلوك المتوقع
إذا لم يتم تعيين نوع عرض العلامة بعد، فسيقوم المعالج بتعيين نوع عرض العلامة إلى رموز.
سلوك الخطأ
في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.
ملاحظات التكوين
- يجب أن يحدث معالج DisplayTypeDefault قبل استرداد العلامات الفعلية من قاعدة البيانات (أي قبل ReadGradesGetGradesForSectionMappingHandler).
- يجب عدم استخدام معالج DisplayTypeDefault هذا مقترنًا مع أي معالج DisplayTypeDefault آخر.