تُستخدم واجهة ITranslateGroup لترجمة سجل مجموعة LIS إلى OrgUnit في Brightspace.
تنفيذ الواجهة هو D2L.IM.IPSIS.LIS.GMS.ITranslateGroup.
توفر قائمة التكوين الآتية نقطة بداية لأي تنفيذ لـ LIS.
قالب، حزمة التكامل لأنظمة معلومات الطالب
- GroupRequestBaseTranslator (ترتيب الفرز = 10)
- GroupRequestTypeValueIdRequiredTranslator (ترتيب الفرز = 20)
- GroupRequestNameShortDescRequiredTranslator (ترتيب الفرز = 30)
GroupRequestBaseTranslator
يقوم GroupRequestBaseTranslator بتعيين معرِّف المجموعة.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestBaseTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- يعيّن OrgUnitCode وOrgUnitName إلى القيمة المتوفرة في sourcedGUID.sourcedid.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الكود
|
result.Entity.Code
|
groupRecord.sourcedGUID.sourcedId
|
|
الاسم
|
result.Entity.Name
|
groupRecord.sourcedGUID.sourcedId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يجب تكوين هذا المترجم (أو مترجم أساسي بديل) أولاً في قائمة المترجمين.
GroupRequestTypeValueIdRequiredTranslator
يتطلب GroupRequestTypeValueIdRequiredTranslator نوع المجموعة الأولى ويعيّنها باستخدام typeValue الأولى في الطلب.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestTypeValueIdRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- يضيف تعيين OrgUnitType من grouptype typeValue الأولى.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
النوع
|
result.LISGroupType
|
groupRecord.group.groupType.typeValue{0}.id.textString
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- يجب دائمًا تكوين هذا المترجم (أو البديل المخصص).
GroupRequestNameShortDescRequiredTranslator
يتطلب GroupRequestNameShortDescRequiredTranslator الاسم ويقوم بتعيينه استنادًا إلى الوصف المختصر.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تحديث OrgUnitName ليحتوي على القيمة من الوصف المختصر في الطلب.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الاسم
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
GroupRequestNameLongDescRequiredTranslator
يتطلب GroupRequestNameLongDescRequiredTranslator الاسم ويقوم بتعيينه استنادًا إلى الوصف الطويل.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameRequiredLongDescTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تحديث OrgUnitName ليحتوي على القيمة من الوصف الطويل في الطلب.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الاسم
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
GroupRequestNameLongDescOptionalTranslator
يقوم GroupRequestNameLongDescOptionalTranslator بتعيين الاسم استنادًا إلى الوصف الطويل إذا كان موجودًا.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameLongDescOptionalTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تحديث OrgUnitName ليحتوي على القيمة من الوصف الطويل في الطلب إذا كانت موجودة.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الاسم
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
GroupRequestNameShortDescOptionalTranslator
يقوم GroupRequestNameShortDescOptionalTranslator بتعيين الاسم استنادًا إلى الوصف المختصر إذا تم توفيره.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescOptionalTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تحديث OrgUnitName ليحتوي على القيمة من الوصف المختصر في الطلب إذا كانت موجودة.
- تستمر المعالجة إلى المترجم التالي.
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الاسم
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
GroupRequestCreateRecordFromSourcedIdRequiredTranslator
يقوم GroupRequestCreateRecordFromSourcedIdRequiredTranslator بإنشاء سجل مجموعة صالح إذا كان كل ما تم تمريره هو sourcedId.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestCreateRecordFromSourcedIdRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- في حالة عدم وجود سجل مجموعة صالح في الطلب، يقوم المترجم بإنشاء سجل مجموعة وهمي، باستخدام sourcedId لـ shortDescription وتعيين النوع الافتراضي إلى القسم.
- تستمر المعالجة إلى المترجم التالي.
ملاحظة التكوين
هذا المترجم يجب أن يتواجد مباشرة بعد المترجم الأساسي.
GroupRequestTruncateOrgUnitCodeTranslator
يقوم GroupRequestTruncateOrgUnitCodeTranslator باقتطاع كود الوحدة التنظيمية للمادة الناتجة إذا كان الكود أطول من 50 حرفًا. ويتم تعيين الكود المقتطع إلى 50 حرفًا.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.GroupRequestTruncateOrgUnitCodeTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- التحقق لمعرفة ما إذا كان طول Result.entity.Code أكبر من 50 حرفًا. وإذا كان كذلك، فسيتم اقتطاع الكود إلى 50 حرفًا.
- تستمر المعالجة إلى المترجم التالي.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.