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

خدمة إدارة مضامين المقررات التعليمية (COMS)

تُستخدم هذه الخدمة للتأثير في مضامين مقررات D2L التعليمية.

العمليات المنفذة

deleteCourseOffering
replaceCourseOffering
readCourseOffering

لمحة عن عملية deleteCourseOffering

deleteCourseOffering هي العملية المستخدمة لحذف الوحدات التنظيمية في D2L المقترنة بمضامين المقررات التعليمية في LIS.

سير العملية: deleteCourseOffering

عند تلقي طلب deleteCourseOffering لـ LIS، يحصل المحول على المعرِّف الفريد لمضمون المقرر التعليمي من حقل sourcedId للطلب مباشرةً، من دون استخدام مترجم قابل للتوصيل.
بمجرد الحصول على معرِّف مضمون المقرر التعليمي، تُستخدم معالجات منصة حزمة التكامل لأنظمة معلومات الطالب التي تم تكوينها لـ IDeleteCourseOfferingHandler لمعالجة الطلب.
يتم إنشاء استجابة LIS من استجابة المعالج لإكمال العملية.

نموذج طلب deleteCourseOffering

<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:deleteCourseOfferingRequest>

         <ims:sourcedId>Demo_Course_Offering</ims:sourcedId>

      </ims:deleteCourseOfferingRequest>

   </soapenv:Body>

</soapenv:Envelope>

حقول الرأس والنص الأساسي في طلب deleteCourseOffering

حقول رأس الطلب

لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.

حقول النص الأساسي للطلب

يقبل المحول الحقول الآتية في الطلب:

الخاصية	تعيين طلب LIS	مطلوب
الكود	deleteCourseOfferingRequest.sourcedId	نعم

نموذج deleteCourseOfferingResponse

<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>COMS_deleteCourseOffering_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>

حقول الرأس والنص الأساسي في استجابة deleteCourseOffering

حقول رأس الاستجابة

لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.

حقول النص الأساسي للاستجابة

لا يتم إرجاع أي حقول في النص الأساسي للاستجابة.

لمحة عن عملية replaceCourseOffering

إن replaceCourseOffering هي العملية المستخدمة لإنشاء مضامين المقررات التعليمية في Brightspace أو تحديثها.

عند استخدام التكوينات الافتراضية، يمكنك عند النجاح التحقق من أنه قد تم إنشاء مضامين المقررات التعليمية أو تحديثها كما ينبغي من خلال بيئة الإدارة التنظيمية الخاصة بـ Desire2Learn‏ (DOME) في Brightspace أو إدارة المقررات التعليمية أو الأداة البرمجية "مقرراتي التعليمية".

سير العملية: replaceCourseOffering

عند تلقي طلب replaceCourseOffering لـ LIS، تتم ترجمة الطلب باستخدام مترجمي LIS الذين تم تكوينهم لـ ITranslateCourseOffering، والذي يحوّل الطلب إلى تنسيق يمكن لمنصة حزمة التكامل لأنظمة معلومات الطالب فهمه.
بمجرد ترجمة الطلب، تُستخدم معالجات منصة حزمة التكامل لأنظمة معلومات الطالب التي تم تكوينها لـ IReplaceCourseOfferingHandler لمعالجة الطلب.
يتم بعد ذلك إنشاء استجابة LIS من استجابة المعالج لإكمال العملية.

نموذج طلب replaceCourseOffering

<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:replaceCourseOfferingRequest>

         <!--Not Used by D2L-->

         <ims:sourcedId>Demo_Offering</ims:sourcedId>

         <ims:courseOfferingRecord>

            <ims:sourcedGUID>

               <ims:sourcedId>Demo_Offering</ims:sourcedId>

            </ims:sourcedGUID>

            <ims:courseOffering>

               <ims:title>

                  <ims:language>en-US</ims:language>

                  <ims:textString>Demo Offering</ims:textString>

               </ims:title>

               <ims:parentTemplateId>Demo_Template</ims:parentTemplateId>

               <!--Optional:-->

               <ims:status>Active</ims:status>

               <!--Optional:-->

               <ims:academicSession>

                  <ims:language>en-US</ims:language>

                  <ims:textString>Demo_Semester</ims:textString>

               </ims:academicSession>

               <!--Optional:-->

               <ims:org>

                  <!--Optional:-->

                  <ims:orgName>

                     <ims:language>en-US</ims:language>

                     <ims:textString>Demo_Department</ims:textString<

                  </ims:orgName>

               </ims:org>

               <!--Zero or more repetitions:-->

               <ims:timeFrame>

                  <!--Optional:-->

                  <ims:begin>2012-01-01T00:00:00.000000</ims:begin>

                  <!--Optional:-->

                  <ims:end>2012-04-01T00:00:00.000000</ims:end>

               </ims:timeFrame>

            </ims:courseOffering>

         </ims:courseOfferingRecord>

      </ims:replaceCourseOfferingRequest>

   </soapenv:Body>

</soapenv:Envelope>

replaceCourseOffering request header and body fields

حقول رأس الطلب

لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.

حقول النص الأساسي للطلب

يقبل تكوين مترجم القالب الحقول الآتية في الطلب:

الخاصية	تعيين طلب IS	مطلوب
الكود	courseOfferingRecord.sourcedGUID.sourcedId	نعم
الاسم	courseOfferingRecord.courseOffering.title.textString	نعم
TemplateId الأصل	courseOfferingRecord.courseOffering.parentTemplateId	نعم
SemesterId الأصل	courseOfferingRecord.courseOffering.academicSession.textString	لا
DepartmentId الأصل	courseOfferingRecord.courseOffering.org.orgName.textString	لا
تاريخ البدء	courseOfferingRecord.courseOffering.timeframe(0).begin	لا
تاريخ الانتهاء	courseOfferingRecord.courseOffering.timeframe(0).end	لا
الحالة	courseOfferingRecord.courseOffering.status	لا

نموذج استجابة replaceCourseOffering

<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_replaceCourseOffering_20120113T180550_5936594Z</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>

حقول الرأس والنص الأساسي في استجابة replaceCourseOffering

حقول رأس الاستجابة

لمزيد من المعلومات، راجع موضوع استخدام خدمات LIS الإصدار 2.0 > رؤوس الطلب والاستجابة.

حقول النص الأساسي للاستجابة

لا يتم إرجاع أي حقول في النص الأساسي للاستجابة.

لمحة عن readCourseOffering

إن عملية readCourseOffering هي العملية المستخدمة لقراءة معلومات منصة حزمة التكامل لأنظمة معلومات الطالب حول مضامين المقررات التعليمية في LIS.

يقبل محول LIS 2.0 الحقول الآتية في الطلب:

عنصر LIS XML	بيانات D2L	مطلوب
readCourseOfferingRequest.sourcedId	OrgUnitCode	نعم

نموذج طلب readCourseOffering

<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:readCourseOfferingRequest>

			<ims:sourcedId>Demo_Offering</ims:sourcedId>

		</ims:readCourseOfferingRequest>

	</soapenv:Body>

</soapenv:Envelope>

نموذج طلب readCourseOffering

<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_readCourseOffering_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">

      <readCourseOfferingResponse xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">

         <courseOfferingRecord>

            <sourcedGUID>

               <sourcedId<Demo_Offering</sourcedId>

           </sourcedGUID>

            <courseOffering/>

         </courseOfferingRecord>

      </readCourseOfferingResponse>

   </s:Body>

</s:Envelope>