تُستخدم واجهة ITranslateMembership لترجمة سجل عضوية LIS إلى تسجيل Brightspace.
تنفيذ الواجهة هو D2L.IM.IPSIS.LIS.MMS.ITranslateMembership.
توفر قائمة التكوين الآتية نقطة بداية لأي تنفيذ لـ LIS.
قالب، حزمة التكامل لأنظمة معلومات الطالب
- MembershipRequestBaseTranslator (ترتيب الفرز = 10)
- MembershipRequestCollectionRequiredTranslator (ترتيب الفرز = 20)
- MembershipRequestUserPersonRequiredTranslator (ترتيب الفرز = 30)
- MembershipRequestRoleTypeAndStatusRequiredTranslator (ترتيب الفرز = 40)
MembershipRequestBaseTranslator
يقوم MembershipRequestBaseTranslator بتعيين معرِّف التسجيل.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.MMS.Default.MembershipRequestBaseTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين IMEnrollmentId إلى القيمة المتوفرة في sourcedGUID.sourcedid.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
معرِّف رسالة التسجيل
|
result.LISMembershipId
|
membershipRecord.sourcedGUID.sourcedId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يجب تكوين هذا المترجم (أو مترجم أساسي بديل) أولاً في قائمة المترجمين.
MembershipRequestCollectionRequiredTranslator
يتطلب MembershipRequestCollectionRequiredTranslator مجموعة التسجيل ويقوم بتعيينها (عادةً مقطع LIS).
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.MMS.Default.MembershipRequestCollectionRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تتم إضافة collectionSourcedId إلى مادة النتيجة.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
كود المقطع
|
result.Entity.IMOrgUnitIdentifier
|
membershipRecord.membership.collectionSourcedId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
MembershipRequestUserPersonRequiredTranslator
يتطلب MembershipRequestUserPersonRequiredTranslator مستخدمًا ويقوم بتعيينه.
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- إضافة معرِّف الشخص إلى مادة النتيجة.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
UserId
|
result.Entity.IMUserIdentifier
|
membershipRecord.membership.member.personSourcedId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
MembershipRequestRoleTypeAndStatusRequiredTranslator
يتطلب MembershipRequestRoleTypeAndStatusRequiredTranslator كلاً من roleType وحالة ويقوم بتعيينهما.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.MMS.Default.MembershipRequestRoleTypeStatusRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- إضافة الدور والحالة إلى مادة النتيجة.
- يمكن توفير مواد أدوار متعددة، ويتم تمريرها إلى المعالجات كـ IEnumerable.
- إذا كان الدور موجودًا ولكنه يفتقد إما النوع أو الحالة، فسيتم طرح IncompleteRequestException.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
دور
|
result.Entity.Roles{*}.role
|
membershipRecord.membership.member.role{*}.roleType
|
|
حالة التسجيل
|
results.Entity.Roles{*}.status
|
membershipRecord.membership.member.role{*}.status
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestSubRoleAndStatusRequiredTranslator.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestRoleTypeRequiredTranslator.
MembershipRequestSubRoleAndStatusRequiredTranslator
يتطلب المترجم MembershipRequestSubRoleAndStatusRequiredTranslator كلاً من SubRole وحالة ويقوم بتعيينهما.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.MMS.Default.MembershipRequestSubRoleStatusRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- إضافة الدور الفرعي والحالة إلى مادة النتيجة.
- يمكن توفير مواد أدوار فرعية متعددة، ويتم تمريرها إلى المعالجات كـ IEnumerable.
- إذا كان الدور الفرعي موجودًا ولكنه يفتقد إما النوع أو الحالة، فسيتم طرح IncompleteRequestException.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
دور
|
result.Entity.Roles{*}.role
|
membershipRecord.membership.member.role{*}.subRole
|
|
حالة التسجيل
|
results.Entity.Roles{*}.status
|
membershipRecord.membership.member.role{*}.status
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين.
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestRoleTypeAndStatusRequiredTranslator.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestRoleTypeRequiredTranslator.
MembershipRequestRoleTypeRequiredTranslator
MembershipRequestRoleTypeRequiredTranslator يتطلب RoleType ويقوم بتعيينه وتعيين الحالة إذا كانت متوفرة. يجب عدم استخدامه إلا في حالة وجود احتمال بعدم تعيين الحالة.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.MMS.Default.MembershipRequestRoleTypeRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- يضيف المترجم لكل دور نوع الدور إلى مادة النتيجة ويضيف الحالة إذا كانت متوفرة (في حال لم تكن متوفرة سيسجل قيمة خالية).
- يمكن توفير مواد أدوار متعددة، ويتم تمريرها إلى المعالجات كـ IEnumerable.
- إذا كان الدور موجودًا ولكنه يفتقد النوع، فسيتم طرح IncompleteRequestException.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
دور
|
result.Entity.Roles{*}.role
|
membershipRecord.membership.member.role{*}.subRole
|
|
حالة التسجيل
|
results.Entity.Roles{*}.status
|
membershipRecord.membership.member.role{*}.status
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestRoleTypeAndStatusRequiredTranslator.
- لا يتم تكوين هذا المترجم عادةً بواسطة MembershipRequestSubRoleAndStatusRequiredTranslator.