توثيق التكامل

خدمة إدارة اقتران المقطع (SAMS)

تُستخدم هذه الخدمة للتأثير في الاقترانات بين مقاطع نظام معلومات الطالب ومضامين المقررات التعليمية في 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>