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

خدمة إدارة تبادل عدد كبير من البيانات (BDEMS)

تُستخدم هذه الخدمة لبدء معالجة التكامل المجمّع لنظام معلومات الطالب وإعداد التقارير عنه.

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

announceBulkDataExchangeasynchronously.
announceFailureBulkDataExchange

العمليات المستدعاة

ignoreBulkDataExchange
cancelBulkDataExchange
reportBulkDataExchange
requestBulkDataExchange

لمحة عن عملية announceBulkDataExchange

يتم استدعاء عملية announceBulkDataExchange من قِبل نظام معلومات الطالب عندما يرغب في بدء عملية تكامل مجمّع. ويؤدي هذا الاستدعاء إلى استجابة فورية من النظام للإشارة إلى ما إذا تم استلام الطلب بنجاح أم لا، وتستمر المعالجة الجماعية بشكل غير متزامن.

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

عند تلقي طلب announceBulkDataExchange لـ LIS، تترجم D2L الطلب باستخدام مترجمي LIS الذين تم تكوينهم لـ ITranslateAnnounceBulkDataExchange لتحويل الطلب إلى تنسيق يمكن لمنصة حزمة التكامل لأنظمة معلومات الطالب فهمه.
بمجرد ترجمة الطلب، تُستخدم معالجات منصة حزمة التكامل لأنظمة معلومات الطالب التي تم تكوينها لـ IBulkFileReadyRequestHandler لتسجيل عدد كبير من الطلبات في حزمة التكامل لأنظمة معلومات الطالب.
يتم بعد ذلك إنشاء استجابة LIS من استجابة المعالج. تتضمن الاستجابة قائمة بخدمات التنفيذ المدعومة باستخدام ITranslateSupportedServices translator الذي تم تكوينه.
تحدث المعالجة الجماعية بشكل غير متزامن بعد تلقي طلب الإعلان والاستجابة له. تنقل خدمات خلفية العمل المجمع الخاصة بحزمة التكامل لأنظمة معلومات الطالب العمل المجمع عبر الخطوات الآتية: يتم استرداد الملفات باستخدام IBulkFileRetriever، ومعالجتها باستخدام IBulkFileProcessor، وإنشاء استجابة باستخدام IBulkSendReportHandler، الذي يستخدم reportBulkDataExchange لإبلاغ نظام معلومات الطالب بالنتائج.

نموذج طلب announceBulkDataExchange

<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

   <SOAP-ENV:Header>

      <imsx_syncRequestHeaderInfo xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <imsx_version>V1.0></imsx_version>

         <imsx_messageIdentifier>1234></imsx_messageIdentifier>

      </imsx_syncRequestHeaderInfo>

   <ims:imsx_epaRequestHeaderInfo xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/></SOAP-ENV:Header>

   <SOAP-ENV:Body>

      <bdems:announceBulkDataExchangeRequest

         xmlns:bdems="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <bdems:transactionId>Test-1234></bdems:transactionId>

         <bdems:bulkBlockManifest>

            <bdems:bulkBlockManifestId>Test-1234</bdems:bulkBlockManifestId>

            <bdems:expiryDate>3000-01-01T00:00:00</bdems:expiryDate>

            <bdems:bulkBlockDataFile>

               <bdems:url>http://localhost://1234-a.xml></bdems:url&gt;

               <bdems:checkSum>00</bdems:checkSum>

               <bdems:totalSize>0</bdems:totalSize>

               <bdems:savePoint>2011-11-28T10:59:35.000000Z></bdems:savePoint>

               <bdems:serviceSet>

                  <bdems:serviceRecord>

                     <bdems:serviceName>pmsv2p0</bdems:serviceName>

                     <bdems:interfaceName>personmanager</bdems:interfaceName>

                     <bdems:operationSet>

                        <bdems:operationName>replacePerson</bdems:operationName>

                        <bdems:operationName>deletePerson</bdems:operationName>

                     </bdems:operationSet>

                  </bdems:serviceRecord>

               </bdems:serviceSet>

            </bdems:bulkBlockDataFile>

            <bdems:bulkBlockDataFile>

               <bdems:url>http://localhost://1234-b.xml></bdems:url&gt;

               <bdems:checkSum>00></bdems:checkSum>

               <bdems:totalSize>0></bdems:totalSize>

               <bdems:savePoint>2011-11-28T10:59:35.000000Z></bdems:savePoint>

               <bdems:serviceSet>

                  <bdems:serviceRecord>

                     <bdems:serviceName>gmsv2p0</bdems:serviceName>

                     <bdems:interfaceName>groupmanager</bdems:interfaceName>

                     <bdems:operationSet>

                        <bdems:operationName>replaceGroup</bdems:operationName>

                     </bdems:operationSet>

                  </bdems:serviceRecord>

               </bdems:serviceSet>

            </bdems:bulkBlockDataFile>

         </bdems:bulkBlockManifest>

      </bdems:announceBulkDataExchangeRequest>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

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

الخاصية	تعيين طلب LIS	مطلوب
JobId	request.bulkBlockManifestId	نعم
Expiry DateTime	request.expiryDate	نعم
RemoteFileUrl(s)	request.bulkBlockDataFile[*].url	نعم
FileSize(s)	request.bulkBlockDataFile[*].totalSize	نعم
CheckSum(s)	request.bulkBlockDataFile[*].checkSum	نعم
نقطة (نقاط) الحفظ	request.bulkBlockDataFile[*].savePoint	نعم
نوع (أنواع) الكيان	request.bulkBlockDataFile[].serviceSet.serviceRecord[].interfaceName	نعم

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Header>

      <h:imsx_syncResponseHeaderInfo

        xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

        xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_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>BDEMS_announceBulkDataExchange_20120304T014745_2593446Z></imsx_messageIdentifier>

         <imsx_statusInfo>

            <imsx_codeMajor>success></imsx_codeMajor>

            <imsx_severity>status></imsx_severity>

            <imsx_description/>

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

      <announceBulkDataExchangeResponse

          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <supportedServices>

            <personInterface>

               <operationName>replacePerson</operationName>

               <operationName>deletePerson</operationName>

            </personInterface>

            <groupInterface>

               <operationName>replaceGroup</operationName>

               <operationName>deleteGroup</operationName>

            </groupInterface>

            <membershipInterface>

               <operationName>replaceMembership</operationName>

               <operationName>deleteMembership</operationName>

            </membershipInterface>

            <templateInterface>

               <operationName>replaceCourseTemplate</operationName>

               <operationName>deleteCourseTemplate</operationName>

            </templateInterface>

            <offeringInterface>

               <operationName>replaceCourseOffering</operationName>

               <operationName>deleteCourseOffering</operationName>

            </offeringInterface>

            <sectionInterface>

               <operationName>replaceCourseSection</operationName>

               <operationName>deleteCourseSection&</operationName>

            </sectionInterface>

            <associationInterface>

               <operationName>replaceSectionAssociation</operationName>

               <operationName>deleteSectionAssociation</operationName>

            </associationInterface>

         </supportedServices>

      </announceBulkDataExchangeResponse>

   </s:Body>

</s:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

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

الخاصية	تعيين استجابة LIS	مطلوب
JobId	request.bulkBlockManifestId	نعم
Expiry DateTime	request.expiryDate	نعم
RemoteFileUrl(s)	request.bulkBlockDataFile[*].url	نعم
FileSize(s)	request.bulkBlockDataFile[*].totalSize	نعم
CheckSum(s)	request.bulkBlockDataFile[*].checkSum	نعم
نقطة (نقاط) الحفظ	request.bulkBlockDataFile[*].savePoint	نعم
نوع (أنواع) الكيان	request.bulkBlockDataFile[].serviceSet.serviceRecord[].interfaceName	نعم

لمحة عن عملية announceFailureBulkDataExchange

تأخذ عملية AnnounceFailureBulkDataExchange طلب فشل الإعلان وتعالجه، وتصبح النتيجة النهائية إخراج النظام المصدر المقابل للطلب من الوضع المجمع، وتعيين حالة السجل المقابل في قاعدة البيانات التي تتضمن جميع المعلومات المطلوبة للعمل المجمع على "ملغى".

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

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

نموذج طلب announceFailureBulkDataExchange

<soapenv:Envelope

    xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

    xmlns:ims1="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

   <soapenv:Header>

      <ims:imsx_epaRequestHeaderInfo>

      </ims:imsx_epaRequestHeaderInfo>

      <ims1:imsx_syncRequestHeaderInfo>

         <ims1:imsx_version>V1.0</ims1:imsx_version>

         <ims1:imsx_messageIdentifier>1234</ims1:imsx_messageIdentifier>

      </ims1:imsx_syncRequestHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims1:announceFailureBulkDataExchangeRequest>

         <ims1:transactionId>Samp-816</ims1:transactionId>

      </ims1:announceFailureBulkDataExchangeRequest>

   </soapenv:Body>

</soapenv:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

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

الخاصية	تعيين طلب LIS	مطلوب
TransactionId	request.transactionId	نعم
كود الفشل	request.FailureReportType.failureCode	لا
وصف الفشل	request.FailureReportType.failureDescription	لا

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Header>

      <h:imsx_syncResponseHeaderInfo

          xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_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>BDEMS_announceFailureBulkDataExchange_20120223T192808_3713232Z</imsx_messageIdentifier>

         <imsx_statusInfo>

            <imsx_codeMajor>success</imsx_codeMajor>

            &ltimsx_severity>status</imsx_severity>

            <imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>

            <imsx_description/>

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

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

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

لمحة عن عملية ignoreBulkDataExchange

يستدعي محول LIS لحزمة التكامل لأنظمة معلومات الطالب عملية IgnoreBulkDataExchange التي ينفذها نظام معلومات الطالب. يتم تنفيذ الاستدعاء داخل معالج ينفذ IBulkCancelRequestHandler ويتم تكوينه لتشغيله عند بدء طلب تجاهل في مكان ما داخل منصة حزمة التكامل لأنظمة معلومات الطالب.

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

عند بدء طلب تجاهل مجمع (عادة عبر واجهة المسؤول)، يستدعي BulkManager المعالج الذي تم تكوينه، والذي ينفذ IBulkCancelRequestHandler. بالنسبة إلى الأنظمة التي تستخدم LIS، يقوم المعالج المسجّل ببدء طلب IgnoreBulkDataExchange إلى نظام معلومات الطالب.

نموذج طلب ignoreBulkDataExchange

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

<s:Header>

<h:imsx_syncRequestHeaderInfo xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0" xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<imsx_version>V1.0</imsx_version>

<imsx_messageIdentifier>1234</imsx_messageIdentifier>

<imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

</h:imsx_syncRequestHeaderInfo>

<h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0" xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

</s:Header>

<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<transactionId>testRequest1</transactionId>

</ignoreBulkDataExchangeRequest>

</s:Body>

</s:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

الخاصية	الوصف
transactionId	المعرِّف الفريد الذي تم تعيينه لهذه العملية من قِبل طلب تبادل البيانات المجمعة السابق لمستهلكي الخدمة.

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

        </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:ignoreBulkDataExchangeResponse>?</ims:ignoreBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

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

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

يتم إنشاء الاستجابة من قِبل موفر الخدمة (مثل Oracle)، ثم يتم إرسالها مرة أخرى إلى D2L استنادًا إلى إرسالنا للطلب أعلاه.

الحقل	عودة	القيمة
imsx_syncResponseHeaderInfo.imsx_version	يُظهر موفر الخدمة "V1.0" بغض النظر عن القيمة التي في رأس الطلب.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	يقوم موفر الخدمة بإعادة كود الحالة الرئيسي كما هو محدد بواسطة IMS.	نجاح- عندما يتم استلام طلب التجاهل بنجاح لدى موفر الخدمة. فشل - عندما لا يتم استلام طلب التجاهل لدى موفر الخدمة.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	يُظهر موفر الخدمة الخطورة كما هي محددة بواسطة IMS.	الحالة
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	يُظهر موفر الخدمة القيمة من imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	يُظهر موفر الخدمة قيمة حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.	نجاح كامل - عندما يتم تأكيد استلام طلب التجاهل بنجاح لدى موفر الخدمة. invalidtransactionid- عندما يكون transactionId الذي تم إرجاعه بواسطة مستهلك الخدمة غير معروف لدى موفر الخدمة. يتم تسجيل حالة خطأ لدى موفر الخدمة ولكن لا يتم إجراء أي معالجة إضافية.

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

لا شيء.

لمحة عن عملية cancelBulkDataExhange

تُستخدم عملية CancelBulkDataExchange لإرسال طلب إلغاء إلى نظام معلومات الطالب.

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

قم بإنشاء طلب وإرساله.
عند إلغاء عمل مجمع، يعتمد مدير التجميع على معالج IBulkCancelRequestHandler الذي تم تكوينه.
بالنسبة إلى الأنظمة التي تستخدم LIS، يقوم المعالج المسجّل ببدء طلب CancelBulkDataExchange إلى نظام معلومات الطالب.

نموذج طلب cancelBulkDataExchange

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"

            xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

    <s:Header>

        <h:imsx_syncRequestHeaderInfo

                       xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                       xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"

                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

            <imsx_version>V1.0</imsx_version>

                        <imsx_messageIdentifier>1234</imsx_messageIdentifier>

                        <imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

        </h:imsx_syncRequestHeaderInfo>

        <h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

                     xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

    </s:Header>

    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

        <cancelBulkDataExchangeRequest xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

            <transactionId>testRequest1</transactionId>

        </cancelBulkDataExchangeRequest>

    </s:Body>

</s:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

الخاصية	الوصف
transactionId	المعرِّف الفريد الذي تم تعيينه لهذه العملية من قِبل طلب تبادل البيانات المجمّعة السابق لمستهلكي الخدمة.

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>?</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:cancelBulkDataExchangeResponse>TargetEndSystem</ims:cancelBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

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

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

يتم إنشاء الاستجابة من قِبل موفر الخدمة (مثل Oracle)، ثم يتم إرسالها مرة أخرى إلى D2L استنادًا إلى إرسال الطلب.

الرأس	عودة	القيمة
imsx_syncResponseHeaderInfo.imsx_version	يُظهر موفر الخدمة "V1.0" بغض النظر عن القيمة التي في رأس الطلب.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	يُظهر موفر الخدمة كود الحالة الرئيسي كما هو محدد بواسطة IMS.	نجاح - عندما يتم استلام طلب التجاهل بنجاح لدى موفر الخدمة. فشل - عندما لا يتم استلام طلب التجاهل لدى موفر الخدمة.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	يُظهر موفر الخدمة الخطورة كما هي محددة بواسطة IMS.	الحالة
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	يُظهر موفر الخدمة القيمة من imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	يُظهر موفر الخدمة قيمة حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.	fullsuccess - عندما يتم استلام طلب التجاهل بنجاح لدى موفر الخدمة. invalidtransactionid - عندما يكون TransactionId الذي أظهره مستهلك الخدمة غير معروف لدى موفر الخدمة. يتم تسجيل حالة خطأ لدى موفر الخدمة ولكن لا يتم إجراء أي معالجة إضافية.

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

لا شيء.

نبذة عن عملية reportBulkDataExchange

لا يدعم محول LIS لحزمة التكامل لأنظمة معلومات الطالب عملية ReportBulkDataExchange، لكنه يستدعي هذه العملية على جانب نظام معلومات الطالب عند اكتمال عملية تبادل عدد كبير من البيانات.

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

قم بمعالجة الطلب وإرساله. عند إكمال عمل مجمع، يعتمد مدير التجميع على معالجات IBulkSendReportHandler التي تم تكوينها. بالنسبة إلى الأنظمة التي تستخدم LIS، يقوم المعالج المسجّل ببدء طلب ReportBulkDataExchange إلى نظام معلومات الطالب.

نموذج طلب reportBulkDataExchange

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"

       xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

        <s:Header>

                <h:imsx_syncRequestHeaderInfo

                          xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                          xmlns:xsd="http://www.w3.org/2001/XMLSchema"

                          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                        <imsx_version>V1.0</imsx_version>

                        <imsx_messageIdentifier>1234</imsx_messageIdentifier>

                        <imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

                </h:imsx_syncRequestHeaderInfo>

                <h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

                      xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

        </s:Header>

        <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

                <reportBulkDataExchangeRequest xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

                        <transactionId>testRequest1</transactionId>

                        <bulkBlockReport>

                                <bulkBlockManifestIdRef>testRequest1</bulkBlockManifestIdRef>

                                <reportSummary>

                                <noofTotalFullSuccess>6</noofTotalFullSuccess>

                                        <noofTotalPartialSuccess>0</noofTotalPartialSuccess>

                                        <noofTotalFailure>1</noofTotalFailure>

                                        <interfaceSummaryReport>

                                                <interfaceName>groupmanager</interfaceName>

                                                <noofFullSuccess>2</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>personmanager</interfaceName>

                                                <noofFullSuccess>0</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>1</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>coursetemplatemanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>courseofferingmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>coursesectionmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>membershipmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                </reportSummary>

                                <transactionReportList>

                                        <transactionReport>

                                                <transactionOpIdentifierRef>Copy3</transactionOpIdentifierRef>

                                                <serviceName>pmsv2p0</serviceName>

                                                <transactionFailStatusVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/transactionfailstatusvocabularyv1p0</transactionFailStatusVocabulary&gt;

                                                <transactionFailStatus>unknownvocabulary</transactionFailStatus>

                                        </transactionReport>

                                </transactionReportList>

                        </bulkBlockReport>

                </reportBulkDataExchangeRequest>

        </s:Body>

</s:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

الخاصية	الوصف
transactionId	transactionId المطابق لطلب الإعلان الذي تم إرساله.
reportSummary	يسرد إجمالي عدد العمليات المضمنة في طلب الإعلان، وحالة كل منها. يحتوي على interfaceSummaryReports.
interfaceSummaryReport	حاوية المعلومات التلخيصية حول معالجة ملفات البيانات المجمعة بواسطة مستهلك الخدمة لواجهة خدمة معينة.
transactionReport	حاوية تقارير الحالة الخاصة بجميع العمليات الموجودة داخل ملف البيانات المجمعة التي لم ينجح مستهلك الخدمة في إتمامها. إذا لم يتم تضمين أي تقارير، فهذا يعني أن طلب announceBulkDataExchange قد اكتمل بنجاح.
reportFailureDetail	حاوية مجموعة التقارير التي تصف العمليات التي أدت إلى إنشاء أكواد حالة فشل.

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:reportBulkDataExchangeResponse>?</ims:reportBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

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

يتم إنشاء الاستجابة من قِبل موفر الخدمة (مثل Oracle)، ثم يتم إرسالها مرة أخرى إلى D2L استنادًا إلى إرسال الطلب.

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

الرأس	عودة	القيمة
imsx_syncResponseHeaderInfo.imsx_version	يُظهر موفر الخدمة "V1.0" بغض النظر عن القيمة التي في رأس الطلب.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	يقوم موفر الخدمة بإعادة كود الحالة الرئيسي كما هو محدد بواسطة IMS.	نجاح - عندما يتم استلام طلب التجاهل بنجاح لدى موفر الخدمة. فشل - عندما لا يتم استلام طلب التجاهل لدى موفر الخدمة.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	يُظهر موفر الخدمة الخطورة كما هي محددة بواسطة IMS.	الحالة
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	يُظهر موفر الخدمة القيمة من imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	يُظهر موفر الخدمة قيمة حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.	fullsuccess - عندما يتم استلام التقرير بنجاح لدى موفر الخدمة وتكون البيانات المتوفرة صالحة. invalidtransactionid - عندما يكون TransactionId الذي أظهره مستهلك الخدمة غير معروف لدى موفر الخدمة. يتم تسجيل حالة خطأ لدى موفر الخدمة ولكن لا يتم إجراء أي معالجة إضافية. incompletedata - عندما يكتشف موفر الخدمة أن جزءًا إلزاميًا من مادة BulkBlockReport مفقود. invaliddata - عندما يكون جزء من مادة BulkBlockReport غير صالح. expireddata - عندما يُظهر expiryDate الخاص بملف البيانات المجمعة أن صلاحية الملف قد انتهت.

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

لا شيء.

لمحة عن عملية requestBulkDataExchange

يستدعي محول IPSIS LIS عملية RequestBulkDataExchange التي ينفذها نظام معلومات الطالب. يُجرى الاستدعاء داخل معالج ينفذ IBulkRequestDataHandler ويتم تكوينه لتشغيله عند بدء طلب في مكان ما داخل منصة حزمة التكامل لأنظمة معلومات الطالب.

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

قم بمعالجة الطلب وإرساله. عند بدء طلب تبادل البيانات المجمعة (عادة عبر واجهة المسؤول)، يستدعي BulkManager المعالج الذي تم تكوينه والذي ينفذ IBulkRequestDataHandler.

نموذج طلب requestBulkDataExchange

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0" xmlns:ims1="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims1:imsx_syncRequestHeaderInfo>

         <ims1:imsx_version>V1.0</ims1:imsx_version>

         <ims1:imsx_messageIdentifier>1234</ims1:imsx_messageIdentifier>

         <ims1:imsx_sendingAgentIdentifier>LIS_TEST_SYSTEM</ims1:imsx_sendingAgentIdentifier>

      </ims1:imsx_syncRequestHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims1:requestBulkDataExchangeRequest>

         <ims1:transactionId>060d01bf-8c5a-4e87-85f5-92a8aca30ef8</ims1:transactionId>

         <ims1:filter>

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

            <ims1:filterRule>

               <ims1:filterTypeVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/filtertypevocabularyv1p0</ims1:filterTypeVocabulary&gt;

               <ims1:filterType>object</ims1:filterType>

               <!--Optional:-->

               <ims1:filterValueVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/filtervalueobjectvocabularyv1p0</ims1:filterValueVocabulary&gt;

               <ims1:filterValue>All</ims1:filterValue>

            </ims1:filterRule>

         </ims1:filter>

      </ims1:requestBulkDataExchangeRequest>

   </soapenv:Body<

</soapenv:Envelope>

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

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

لمزيد من المعلومات، انظر رؤوس الطلب والاستجابة.

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

الخاصية	الوصف
transactionId	المعرِّف الفريد الذي تم تعيينه لهذه العملية من قِبل طلب تبادل البيانات المجمعة السابق لمستهلكي الخدمة.

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:requestBulkDataExchangeResponse>?</ims:requestBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

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

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

يتم إنشاء الاستجابة من قِبل موفر الخدمة (مثل Oracle)، وإرسالها مرة أخرى إلى D2L استنادًا إلى إرسال الطلب.

الرأس	عودة	القيمة
imsx_syncResponseHeaderInfo.imsx_version	يُظهر موفر الخدمة "V1.0" بغض النظر عن القيمة التي في رأس الطلب.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	يقوم موفر الخدمة بإعادة كود الحالة الرئيسي كما هو محدد بواسطة IMS.	نجاح - عندما يتم استلام طلب التجاهل بنجاح لدى موفر الخدمة. فشل - عندما لا يتم استلام طلب التجاهل لدى موفر الخدمة.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	يُظهر موفر الخدمة الخطورة كما هي محددة بواسطة IMS.	الحالة
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	يُظهر موفر الخدمة القيمة من imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	يُظهر موفر الخدمة قيمة حقل كود الحالة الثانوي كما هو محدد بواسطة IMS.	fullsuccess - عندما يتم استلام الطلب بنجاح ويكون الهدف قادرًا على تلبية الطلب. invaliddata - عندما يكون نوع (أنواع) بيانات المادة المحددة غير معروف في موفر الخدمة. savepointerror - عندما يحدث خطأ في معالجة معلومات معرِّف نقطة الحفظ، ما يجعل من المستحيل قراءة المواد الصحيحة من قاعدة البيانات. savepointsyncerror - عندما تكون قيمة مرجع نقطة الحفظ من المصدر متأخرة عن قيمة النظام الهدف. لن تتوفر أي بيانات مزامنة.

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

يتضمن النص الأساسي للاستجابة قائمة بالخدمات المدعومة، التي قد تتضمن أيًا من الآتي:

personInterface.replacePerson
personInterface.deletePerson
groupInterface.replaceGroup
groupInterface.deleteGroup
membershipInterface.replaceMembership
membershipInterface.deleteMembership
templateInterface.replaceCourseTemplate
templateInterface.deleteCourseTemplate
offeringInterface.replaceCourseOffering
offeringInterface.deleteCourseOffering
sectionInterface.replaceCourseSection
sectionInterface.deleteCourseSection
associationInterface.replaceSectionAssocation
associationInterface.deleteSectionAssociation