تُستخدم واجهة ITranslateCourseSection لترجمة مقطع مقرر تعليمي خاص بـ LIS إلى مقطع مقرر تعليمي لحزمة التكامل لأنظمة معلومات الطالب.
تنفيذ الواجهة هو D2L.IM.IPSIS.LIS.CMS.ITranslateCourseSection.
توفر قائمة تكوين القوالب الآتية نقطة بداية لأي تنفيذ لـ LIS:
حزمة التكامل لأنظمة معلومات الطالب، افتراضي
- CourseSectionRequestBaseTranslator (ترتيب الفرز = 10)
- CourseSectionRequestParentOfferingIdRequiredTranslator (ترتيب الفرز = 20)
- CourseSectionRequestNameRequiredTranslator (ترتيب الفرز = 30)
- CourseSectionRequestDepartmentRequiredTranslator (ترتيب الفرز = 40)
- CourseSectionRequestSemesterOptionalTranslator (ترتيب الفرز = 50)
- CourseSectionRequestStartDateEndDateRequiredTranslator (ترتيب الفرز = 60)
- CourseSectionRequestStatusOptionalTranslator (ترتيب الفرز = 70)
CourseSectionRequestBaseTranslator
يحصل CourseSectionRequestBaseTranslator على المعرِّف الفريد لمقطع المقرر التعليمي من الطلب.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestBaseTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- يعيّن OrgUnitCode وOrgUnitName إلى القيمة المتوفرة في sourcedGUID.sourcedid.
- تستمر المعالجة إلى المترجم التالي.
الكيان
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الكود
|
result.Entity.Code
|
courseSectionRecord.sourcedGUID.sourcedId
|
|
الاسم
|
result.Entity.Name
|
courseSectionRecord.sourcedGUID.sourcedId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
يجب تكوين هذا المترجم (أو مترجم أساسي بديل) أولاً في قائمة المترجمين.
CourseSectionRequestParentOfferingIdRequiredTranslator
يتطلب CourseSectionRequestParentOfferingIdRequiredTranslator معرِّف أصل مضمون المقرر التعليمي ويقوم بتعيينه.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestParentOfferingIdRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين ParentOfferingId الخاص بالنتيجة ليحتوي على القيمة الواردة من ParentOfferingId في الطلب.
- تستمر المعالجة إلى المترجم التالي.
ParentOfferingId
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
OfferingId الأصل
|
result.ParentOfferingId
|
courseSectionRecord.courseSection.parentOfferingId
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestNameRequiredTranslator
يتطلب CourseSectionRequestNameRequirdTranslator اسم المقطع ويقوم بتعيينه.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestNameRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تحديث OrgUnitName ليحتوي على القيمة المأخوذة من العنوان الموجودة في الطلب.
- تستمر المعالجة إلى المترجم التالي.
الكيان
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الاسم
|
result.Entity.Name
|
courseSectionRecord.courseSection.title
|
سلوك الخطأ
في حالة وجود مشكلة في المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestDepartmentRequiredTranslator
يتطلب CourseSectionRequestDepartmentRequiredTranslator معرِّف القسم ويقوم بتعيينه.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestDepartmentRequiredTranslator
السلوك المتوقع
يكمل المترجم المهام الآتية:
- تعيين ParentDepartmentId الخاص بالنتيجة ليحتوي على القيمة الواردة من org.orgName في الطلب.
- تستمر المعالجة إلى المترجم التالي.
ParentDepartmentID
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
DepartmentId الأصل
|
result.ParentDepartmentId
|
courseSectionRecord.courseSection.org.orgName
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestSemesterOptionalTranslator
يقوم CourseSectionRequestSemesterOptionalTranslator بتعيين معرِّف الفصل الدراسي.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestSemesterOptionalTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين ParentSemesterId الخاص بالنتيجة ليحتوي على القيمة الواردة من academicSession في الطلب (إن توفرت).
- تستمر المعالجة إلى المترجم التالي.
ParentSemeseterId
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
SemesterId الأصل
|
result.ParentSemesterId
|
courseSectionRecord.courseSection.academicSession
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestStartDateEndDateOptionalTranslator
يقوم CourseSectionRequestStartDateEndDateOptionalTranslator بتعيين تاريخ بدء المقطع وانتهائه.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateOptionalTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين تواريخ البدء والنهاية في OrgUnit لتحتوي على القيم المأخوذة من timeFrame.begin الأول وtimeFrame.end في الطلب.
- تستمر المعالجة إلى المترجم التالي.
الكيان
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
تاريخ البدء
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
تاريخ الانتهاء
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- لا يمكن تكوين هذا المترجم باستخدام CourseSectionRequestStartDateEndRequiredTranslator.
CourseSectionRequestStartDateEndDateRequiredTranslator
يتطلب CourseSectionRequestStartDateEndDateRequirTranslator تواريخ البدء والنهاية لمقطع المقرر التعليمي ويقوم بتعيينها.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateRequiredTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين تواريخ البدء والنهاية في OrgUnit لتحتوي على القيم المأخوذة من timeFrame.begin الأول وtimeFrame.end في الطلب.
- تستمر المعالجة إلى المترجم التالي.
الكيان
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
تاريخ البدء
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
تاريخ الانتهاء
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظات التكوين
- يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
- لا يمكن تكوين هذا المترجم باستخدام CourseSectionRequestStartDateEndDateOptionalTranslator.
CourseSectionRequestStatusOptionalTranslator
يقوم CourseSectionRequestStatusOptionalTranslator بتعيين حالة المقطع.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStatusOptionalTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- تعيين خاصية IsActive في OrgUnit لتحتوي على القيمة المأخوذة من الحالة في الطلب، إذا تم تعيين خاصية courseSectionRecord.courseSection.status.
- وإذا لم تتوفر الحالة، فستعود القيمة إلى القيمة الافتراضية الخالية لأن الحقل بيان منطقي قابل للبيانات الفارغة.
- إذا توفرت الحالة، ولكن لم يتم العثور على القيمة في القاموس (عبر VococabManager)، فسيتم تعيين القيمة إلى خطأ.
- تستمر المعالجة إلى المترجم التالي.
الكيان
|
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LIS
|
|
الحالة
|
result.Entity.IsActive
|
courseSectionRecord.courseSection.status
|
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestTruncateOrgUnitCodeTranslator
يقوم CourseSecuritionRequestTruncOrgUnitCodeTranslator باقتطاع كود الوحدات التنظيمية لمادة النتيجة إذا كان الكود أطول من 50 حرفًا. ويتم تعيين الكود المقتطع إلى 50 حرفًا.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestTruncateOrgUnitCodeTranslator
السلوك المتوقع
يؤدي المترجم المهام الآتية:
- التحقق لمعرفة ما إذا كان طول Result.entity.Code أكبر من 50 حرفًا. وإذا كان كذلك، فسيتم اقتطاع الكود إلى 50 حرفًا.
- تستمر المعالجة إلى المترجم التالي.
ملاحظة التكوين
يمكن وضع هذا المترجم في أي مكان بعد المترجم الأساسي.
CourseSectionRequestCreateParentsTranslator
الوحدات التنظيمية للأحكام التلقائية CourseSectionRequestCreateParentsTranslator، التي هي مضامين المقررات التعليمية والقوالب والأقسام من طلب مقطع النظام الأساسي المتكامل للتعلّم Ellucian.
التنفيذ
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestCreateParentsTranslator
السلوك المتوقع
عند تلقي طلب مقطع من النظام الأساسي المتكامل للتعلّم Ellucian، فإنه يقوم بتشغيل الأنشطة الآتية في منصة Brightspace:
- إنشاء/تحديث قسم استنادًا إلى التعيينات أدناه
- إنشاء/تحديث قالب مقرر تعليمي بناءً على التعيينات أدناه
- إنشاء/تحديث مضمون مقرر تعليمي استنادًا إلى التعيينات أدناه
- إنشاء/تحديث مقطع استنادًا إلى الطلب
بالإضافة إلى ذلك، يتم جعل الوحدات التنظيمية أصلاً من جديد إذا ظهر أصل جديد بهيكل تنظيمي مختلف.
الكيان
الخاصية
|
عنصر نتيجة الترجمة
|
تعيين طلب LS
|
| المعرِّف: |
result.Entity.id |
courseSectionRecord.sourceGUID.sourceId |
| العنوان |
result.Entity.title |
courseSectionRecord.courseSection.title.textString |
| التسمية |
|
courseSectionRecord.courseSection.label.textString |
| الأصل |
|
courseSectionRecord.courseSection.parentOfferingId |
| القسم |
|
courseSectionRecord.courseSection.org.orgName.textString |
| المصطلح |
|
courseSectionRecord.courseSection.academicSession.textString |
| departmentId |
|
courseSectionRecord.courseSection.org.id.textString |
| startDate |
|
courseSectionRecord.courseSection.timeFrame.begin |
| endDate |
|
courseSectionRecord.courseSection.timeFrame.end |
| الحالة |
result.Entity.status |
courseSectionRecord.courseSection.status |
سلوك الخطأ
في حالة وجود مشكلة في أثناء المعالجة، سيتم طرح IncompleteRequestException. وينتج عن ذلك:
- تعليق جميع عمليات المعالجة الإضافية.
- رأس استجابة LIS يحتوي على:
- CodeMajor = فشل.
- الخطورة = الحالة.
- CodeMinor = invaliddata.
إذا فشل طلب مقطع المقرر التعليمي، فلن تتم إزالة الوحدات التنظيمية الأصل.
ملاحظات التكوين
تُوصي D2L بترتيب التكوين الآتي عند استخدام هذا المترجم:
- CourseSectionRequestBaseTranslator
- CourseSectionRequestNameRequiredTranslator
- CourseSectionRequestCreateParentsTranslator
- CourseSectionRequestStartDateEndDateOptionalTranslator