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

خدمة إدارة المجموعات (GMS)

تدير هذه الخدمة الوحدات التنظيمية لـ Brightspace بخلاف القوالب والمضامين والمقاطع. ويشمل ذلك الأقسام والفصول الدراسية وأنواع الوحدات التنظيمية المخصصة.

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

deleteGroup
replaceGroup
readGroup

لمحة عن عملية deleteGroup

تحذف deleteGroup الوحدات التنظيمية لـ Brightspace مثل الأقسام والفصول الدراسية.

استخدم deleteCourseTemplate لقوالب المقررات التعليمية واستخدم deleteCourseOffering لمضامين المقررات التعليمية واستخدم deleteCourseSection لمقاطع المقررات التعليمية.

معالجة عملية deleteGroup

يستخدم تنفيذ deleteGroup واحدة من ثلاث واجهات لمعالج حزمة التكامل لأنظمة معلومات الطالب وفقًا لنوع المجموعة التي يتم معالجتها.

‏IDeleteDepartmentHandler - تُستخدم للوحدات التنظيمية ذات نوع الوحدة التنظيمية القياسي للقسم (Department).
IDeleteOtherOrgUnitHandler - تُستخدم للوحدات التنظيمية غير القسم (Department) أو الفصل الدراسي (Semester) أو قالب المقرر التعليمي (CourseTemplate) أو مضمون المقرر التعليمي (CourseOffering) أو المقطع (Section) أو المجموعة (Group).
‏IDeleteSemesterHandler - تُستخدم للوحدات التنظيمية ذات نوع الوحدة التنظيمية القياسي للفصل الدراسي (Semester).

نموذج طلب deleteGroup

				<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:deleteGroupRequest>
				<ims:sourcedId>LIS_Test_Department</ims:sourcedId>
				</ims:deleteGroupRequest>
				</soapenv:Body>
				</soapenv:Envelope>

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

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

لمحة عن عملية replaceGroup

تنشئ replaceGroup الوحدات التنظيمية لـ Brightspace وتحدثها، مثل الأقسام والفصول الدراسية.

استخدم replaceCourseTemplate لقوالب المقررات التعليمية واستخدم replaceCourseOffering لمضامين المقررات التعليمية واستخدم replaceCourseSection لمقاطع المقررات التعليمية.

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

تتلقى Brightspace طلب replaceGroup وتترجمه باستخدام مترجمي LIS الذين تم تكوينهم لـ ITranslateGroup.
تحدد منصة حزمة التكامل لأنظمة معلومات الطالب المعالج الذي يجب استخدامه استنادًا إلى GroupType.
يتم إنشاء استجابة من نتيجة المعالج.

نموذج طلب replaceGroup

				<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:replaceGroupRequest>
				<ims:sourcedId>Demo_Semester</ims:sourcedId>
				<ims:groupRecord>
				<ims:sourcedGUID>
				<ims:sourcedId>Demo_Semester</ims:sourcedId>
				</ims:sourcedGUID>
				<ims:group>
				<ims:description>
				<ims:shortDescription>Demo Semester</ims:shortDescription>
				</ims:description>
				</ims:group>
				</ims:groupRecord>
				</ims:replaceGroupRequest>
				</soapenv:Body>
				</soapenv:Envelope>

نموذج طلب readGroup

				<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:readGroupRequest>
				<ims:sourcedId>LIS_Test_Department</ims:sourcedId>
				</ims:readGroupRequest>
				</soapenv:Body>
				</soapenv:Envelope>