ينفذ محول LIS لحزمة التكامل لأنظمة معلومات الطالب الإصدار 2.0 الخدمات والعمليات الخاصة بـ LIS اللازمة لدعم ملفات تعريف IMS LIS الآتية:
- ملف التعريف الأساسي لـ IMS Global LIS الإصدار 2.0
- ملف تعريف تسلسل المقررات التعليمية الهرمي الكامل لـ IMS Global LIS الإصدار 2.0
- ملف تعريف المقاطع المجمعة لـ IMS Global LIS الإصدار 2.0
تم إجراء كل خدمة تنفذها D2L بوصفها جزءًا من محول LIS الإصدار 2.0 بحيث يمكن تعيين الحقول الموجودة في طلبات LIS إلى حقول D2L استنادًا إلى متطلبات المؤسسة. يتم ذلك من خلال المترجمين القابلين للتكوين والتوسع، ما يؤدي إلى تعيين حقول LIS بفعالية إلى حقول في نظام D2L الأساسي للتعلّم.
يتم توضيح المزيد من التفاصيل حول التعيينات والسلوكيات المتوفرة ضمن عملية خدمة LIS المحددة وتتم زيادة فعالية واجهات المترجمين.
نقاط نهاية خدمة LIS الإصدار 2.0
توجد نقاط نهاية منفصلة لـ HTTP وHTTPS. يجب استخدام نقطة نهاية الخدمة المناسبة لتطبيقك حسب كيفية رؤية الموقع من قِبل خدمات معلومات الإنترنت. إذا تم توفير دعم SSL من خلال موازن التحميل، فقد تحتاج إلى استخدام نقاط نهاية HTTP.
HTTP
|
اسم الخدمة
|
نقطة نهاية الخدمة
|
|
خدمة إدارة تبادل عدد كبير من البيانات (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
خدمة إدارة مضامين المقررات التعليمية (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseOfferingManagementServices.svc
|
|
خدمة إدارة مقاطع المقررات التعليمية (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseSectionManagementServices.svc
|
|
خدمة إدارة قوالب المقرر التعليمي (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseTemplateManagementServices.svc
|
|
خدمة إدارة المجموعات (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/GroupManagementServices.svc
|
|
خدمة إدارة العضوية (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/MembershipManagementServices.svc
|
|
خدمة إدارة النتائج (OMS)
|
d2l/im/ipsis/lis/omsv1p0/ResultManagementServices.svc
|
|
خدمة إدارة الأشخاص (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/PersonManagementServices.svc
|
|
خدمة إدارة اقتران المقطع (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/SectionAssociationManagementServices.svc
|
HTTPS
|
اسم الخدمة
|
نقطة نهاية الخدمة
|
|
خدمة إدارة تبادل عدد كبير من البيانات (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
خدمة إدارة مضامين المقررات التعليمية (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseOfferingManagementServices.svc
|
|
خدمة إدارة مقاطع المقررات التعليمية (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseSectionManagementServices.svc
|
|
خدمة إدارة قوالب المقرر التعليمي (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseTemplateManagementServices.svc
|
|
خدمة إدارة المجموعات (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/GroupManagementServices.svc
|
|
خدمة إدارة العضوية (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/MembershipManagementServices.svc
|
|
خدمة إدارة النتائج (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/ResultManagementServices.svc
|
|
خدمة إدارة الأشخاص (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/PersonManagementServices.svc
|
|
خدمة إدارة اقتران المقطع (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/SectionAssociationManagementServices.svc
|
لغات WSDLS لخدمة LIS الإصدار 2.0
إذا كانت لغة WSDL مطلوبة، فيجب عدم استخدام لغات WSDL الموجودة في نقاط نهاية الخدمة، بل الموجودة في المواقع الآتية:
HTTP
|
خدمة LIS
|
WSDL
|
|
خدمة إدارة تبادل عدد كبير من البيانات (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة مضامين المقررات التعليمية (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة مقاطع المقررات التعليمية (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة قوالب المقرر التعليمي (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة المجموعات (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة العضوية (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة النتائج (OMS)
|
/d2l/im/ipsis/lis/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة الأشخاص (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة اقتران المقطع (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
HTTPS
|
خدمة LIS
|
WSDL
|
|
خدمة إدارة تبادل عدد كبير من البيانات (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة مضامين المقررات التعليمية (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة مقاطع المقررات التعليمية (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة قوالب المقرر التعليمي (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة المجموعات (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة العضوية (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة النتائج (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة الأشخاص (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
خدمة إدارة اقتران المقطع (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
المصادقة
تتطلب خدمات IPSIS LIS الإصدار 2.0 المصادقة عبر أمان WS أو مصادقة HTTP الأساسية، وتستخدم قاعدة بيانات D2L للمصادقة على اسم المستخدم وكلمة المرور. لاستخدام أي من الخدمات، يجب أن يكون معرِّف المستخدم المستخدَم للمصادقة مقترنًا بأحد أنظمة المصدر.
تتعامل الخدمات كلها مع المصادقة من خلال محاولة التحقق من صحة اسم المستخدم وكلمة المرور وفق النظام الأساسي للتعلم. إذا تم توفير اسم مستخدم وكلمة مرور صالحين من النظام الأساسي للتعلم، وكان هناك نظام مصدر نشط لحزمة التكامل لأنظمة معلومات الطالب مقترن بذلك المستخدم، فسيتم الإقرار بأي طلبات لخدمة LIS ومعالجتها.
إذا تم توفير اسم مستخدم وكلمة مرور غير صالحين، أو إذا لم يكن المستخدم مقترنًا بنظام مصدر نشط لحزمة التكامل لأنظمة معلومات الطالب، فسيتم رفض الطلب مع رسالة استجابة مناسبة وفق مواصفات LIS. لأغراض استكشاف الأخطاء وإصلاحها، يمكن تشغيل تسجيل التصحيح للمساعدة على تحديد سبب عدم تنفيذ المصادقة بنجاح.
استقرت المجموعة العاملة على IMS LIS على استخدام أمان WS أو مصادقة Http الأساسية لمصادقة مرسِل طلبات خدمة LIS.
رؤوس الطلبات
تحتوي جميع رؤوس طلبات LIS على الحقول نفسها، وتعالجها D2L كالآتي:
|
الرأس
|
الغرض
|
ملاحظة
|
|
imsx_syncRequestHeaderInfo.imsx_messageIdentifier
|
هذا الرأس مطلوب.
يتم إرجاع معرِّف رسالة الطلب في الاستجابة (imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier) للسماح بإقران الاستجابة بطلب أصلي.
|
لا يرسل كل الموردين قيمة صالحة، لذلك تقوم D2L بمعالجتها في كلتا الحالتين. إذا قاموا بإرسالها، فإن D2L تقوم بإرجاعها في الاستجابة.
|
|
imsx_syncRequestHeaderInfo.imsx_version
|
هذا الرأس مطلوب.
يهدف الإصدار إلى السماح للخدمة بالتأكد من أن النظامين يتوقعان الإصدار نفسه من الخدمة.
|
في هذه المرحلة، لا نفعل أي شيء مع الإصدار الوارد.
|
|
imsx_syncRequestHeaderInfo.imsx_sendingAgentIdentifier
|
هذا الرأس اختياري (مضاف إلى 2012-01-31 WSDL).
يتم استخدام معرِّف عامل الإرسال لتحديد الجهة المرسِلة. بالنسبة إلى الطلبات الصادرة من D2L، تتم تعبئة القيمة باستخدام قيمة اسم نظام المصدر من IM_Sources.
|
لا يرسل كل الموردين هذه القيمة، ولا تستخدمها D2L على الإطلاق للطلبات الواردة. تستخدم D2L معرِّف المستخدم الذي تم استخدامه للمصادقة لتحديد الجهة المرسِلة.
|
رؤوس الاستجابة
تحتوي جميع رؤوس استجابة LIS على الحقول نفسها. تتعامل معها D2L كالآتي:
|
الرأس
|
الإجابة
|
القيمة
|
|
imsx_syncResponseHeaderInfo.imsx_version
|
تقوم D2L بإرجاع "V1.0" بغض النظر عن القيمة التي في رأس الطلب.
|
|
|
imsx_syncResponseHeaderInfo.imsx_messageIdentifier
|
تقوم D2L بإنشاء معرِّف فريد لهذا الرأس وإرجاعه.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor
|
تقوم D2L بإرجاع كود الحالة الرئيسي كما هو محدد بواسطة IMS.
|
فشل - عند وجود مشكلة في معالجة الطلب.
جارٍ المعالجة - عند معالجة الطلب.
نجاح - عندما تتم معالجة الطلب بنجاح.
غير مدعوم - عندما لا يكون هناك تطبيق لطلب LIS، أو عندما لا يكون هناك مترجمون مسجلون للعملية.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity
|
تقوم D2L بإرجاع الخطورة كما هي محددة بواسطة IMS.
|
خطأ - عند حدوث أمر سيئ أو غير متوقع. قد يحتاج نظام الاستدعاء إلى اتخاذ الإجراء المناسب.
الحالة - المعلومات. لا يلزم اتخاذ أي إجراء من قِبل نظام الاستدعاء.
تحذير - عند حدوث أمر غير متوقع. قد يحتاج نظام الاستدعاء إلى اتخاذ الإجراء المناسب.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier
|
تقوم D2L بإرجاع القيمة من imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
إذا لم يتم إرسال معرِّف رسالة في الطلب، فلن يتم تضمين هذا الحقل.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_description
|
تقوم D2L بإرجاع رسالة تحتوي على وصف يمكن للإنسان قراءته لأي رسائل حالة.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldName
|
تقوم D2L بإرجاع اسم حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.
|
TargetEndSystem
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue
|
تقوم D2L بإرجاع قيمة حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.
|
deletefailure - عند وجود مشكلة في معالجة طلب حذف.
fullsuccess - عند معالجة كل شيء بنجاح.
invaliddata - عندما يفتقد الطلب الحقول المطلوبة، ومن ثَم تتعذر متابعة المعالجة.
partialdatastorage - عندما تقوم D2L بحفظ جزء من الطلب إلى قاعدة البيانات بنجاح.
unknownobject - عندما يشير الطلب إلى مادة غير موجودة في حزمة التكامل لأنظمة معلومات الطالب، ومن ثَم لا يمكن أن تتخذ D2L الإجراء المطلوب.
unsupportedLISoperation - عندما لا يكون هناك تطبيق لطلب LIS حاليًا، أو عندما لا يكون هناك مترجمون مسجلون للعملية.
idallocinusefail - عندما يحاول الطلب إعادة استخدام كيان موجود من نوع مختلف أو تغييره (على سبيل المثال، إذا حاول replaceGroupRequest تغيير المعهد إلى فصل دراسي).
|