تُستخدم هذه الخدمة للتأثير في الاقترانات بين مقاطع نظام معلومات الطالب ومضامين المقررات التعليمية في Brightspace.
العمليات المنفذة
- deleteSectionAssociation
- replaceSectionAssociation
- readSectionAssociation
لمحة عن عملية deleteSectionAssociation
تُستخدم عملية deleteSectionAssociation لحذف الوحدات التنظيمية في Brightspace المرتبطة باقترانات مقاطع LIS.
سير العملية: deleteSectionAssociation
- عند تلقي طلب deleteSectionAssociation لـ LIS، يحصل المحول على المعرِّف الفريد لاقتران المقطع من حقل sourcedId للطلب مباشرةً، من دون استخدام مترجم قابل للتوصيل.
- بمجرد الحصول على معرِّف مقطع المقرر التعليمي، تقوم معالجات منصة حزمة التكامل لأنظمة معلومات الطالب التي تم تكوينها لـ IDeleteSectionAssociationHandler بمعالجة الطلب.
- يتم بعد ذلك إنشاء استجابة LIS من استجابة المعالج.
نموذج طلب deleteSectionAssociation
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:deleteSectionAssociationRequest>
<ims:sourcedId>Demo_Section_Assocation</ims:sourcedId>
</ims:deleteSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
حقول الرأس والنص الأساسي في طلب deleteSectionAssociation
حقول رأس الطلب
لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.
حقول النص الأساسي للطلب
يقبل المحول الحقول الآتية في الطلب:
الخاصية
|
تعيين طلب LIS
|
مطلوب
|
الكود
|
deleteSectionAssociationRequest.sourcedId
|
نعم
|
نموذج استجابة deleteSectionAssociation
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>CSMS_deleteCourseSection_20120104T232203_8033886Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>status</imsx_severity>
<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>fullsuccess</imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Envelope>
حقول الرأس والنص الأساسي في استجابة deleteSectionAssociation
حقول رأس الاستجابة
لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.
حقول النص الأساسي للاستجابة
لا يتم إرجاع أي حقول في النص الأساسي للاستجابة.
لمحة عن عملية replaceSectionAssociation
تُستخدم عملية replaceSectionAssociation لإنشاء مضامين المقررات التعليمية في Brightspace والمقاطع/المجموعات المقترنة بها أو تحديثها حسب طلبات اقتران مقاطع LIS.
عند استخدام التكوينات الافتراضية، يمكنك عند النجاح التحقق من صحة اقتران المقطع الذي تم إنشاؤه أو تحديثه باستخدام بيئة الإدارة التنظيمية الخاصة بـ Desire2Learn (DOME) في "إدارة المقررات التعليمية" في Brightspace أو الأداة البرمجية "مقرراتي التعليمية".
سير العملية: replaceSectionAssociation
- عند تلقي طلب replaceSectionAssociation لـ LIS، تترجم Brightspace الطلب باستخدام مترجمي LIS الذين تم تكوينهم لـ ITranslateSectionAssociation لتحويل الطلب إلى تنسيق يمكن لمنصة حزمة التكامل لأنظمة معلومات الطالب فهمه.
- بمجرد ترجمة الطلب، تُستخدم معالجات منصة حزمة التكامل لأنظمة معلومات الطالب التي تم تكوينها لـ IReplaceSectionAssociationHandler لمعالجة الطلب.
- يتم إنشاء استجابة LIS من استجابة المعالج.
ملاحظة: إذا تم تكوين ReplaceSectionAssociationDatesFromAllSectionsHandler (يتم تكوينه تلقائيًا لـ LIS 2.0)، فسيُستخدم أقدم تاريخ بدء وأحدث تاريخ نهاية للمقرر التعليمي.
نموذج طلب replaceSectionAssociation
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:replaceSectionAssociationRequest>
<!--Not Used by D2L-->
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
<ims:sectionAssociationRecord>
<ims:sourcedGUID>
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
</ims:sourcedGUID>
<ims:sectionAssociation>
<!--Optional:-->
<ims:title>
<ims:language>en-US</ims:language>
<ims:textString>Demo Section Association</ims:textString>
</ims:title>
<!--Optional:-->
<ims:status>Active</ims:status>
<!--Optional:-->
<ims:courseSectionIdList>
<!--1 or more repetitions:-->
<ims:courseSectionId>Demo_Section_01</ims:courseSectionId>
</ims:courseSectionIdList>
</ims:sectionAssociation>
</ims:sectionAssociationRecord>
</ims:replaceSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
حقول الرأس والنص الأساسي في طلب replaceSectionAssociation
حقول رأس الطلب
لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.
حقول النص الأساسي للطلب
يقبل تكوين مترجم القالب الحقول الآتية في الطلب:
الخاصية
|
تعيين طلب LIS
|
مطلوب
|
كود اقتران المقطع
|
sectionAssociationRecord.sourcedGUID.sourcedId
|
نعم
|
اسم اقتران المقطع
|
sectionAssociationRecord.sourcedGUID.sourcedId
|
نعم
|
اسم اقتران المقطع
|
sectionAssociationRecord.sectionAssociation.title.textString
|
لا
|
معرِّفات المقطع
|
sectionAssociationRecord.sectionAssociation.courseSectionIdList{*}.CourseSectionId
|
نعم
|
الحالة
|
sectionAssociationRecord.sectionAssociation.status
|
لا
|
نموذج استجابة replaceSectionAssociation
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>CMS_replaceSectionAssociation_20120419T002302_0384880Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>warning</imsx_severity>
<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
<imsx_description/>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>partialdatastorage</imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Envelope>
حقول الرأس والنص الأساسي في استجابة replaceSectionAssociation
حقول رأس الاستجابة
لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.
حقول النص الأساسي للاستجابة
لا يتم إرجاع أي حقول في النص الأساسي للاستجابة.
نموذج طلب readSectionAssociation
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>MessageId_774290</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:readSectionAssociationRequest>
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
</ims:readSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
نموذج استجابة readSectionAssociation
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo xmlns:h="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>CMS_readSectionAssociation_20120803T145419_1122428Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>warning</imsx_severity>
<imsx_messageRefIdentifier>MessageId_774290</imsx_messageRefIdentifier>
<imsx_description/>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>partialdatastorage</imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<readSectionAssociationResponse xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<sectionAssociationRecord>
<sourcedGUID>
<sourcedId>Demo_Section_Association</sourcedId>
</sourcedGUID>
<sectionAssociation/>
</sectionAssociationRecord>
</readSectionAssociationResponse>
</s:Body>
</s:Envelope>