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

خدمة إدارة الأشخاص (PMS)

تدير هذه الخدمة حسابات مستخدمي Brightspace.

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

deletePerson
replacePerson
readPerson

الأسماء الأولى وأسماء العائلة المفضلة

يمكن للعملاء الذين يستخدمون LIS 2.0 تضمين أسماء المستخدمين المفضلة والحفاظ عليها باستخدام علامات XML في تكامل LIS. تنطبق القواعد الآتية عندما تسمح حزمة التكامل لأنظمة معلومات الطالب لنظام معلومات الطالب بالكتابة فوق الأسماء المفضلة في Brightspace:

إذا كان لـ LIS اسم أول مفضل فارغ لمستخدم لديه اسم أول مفضل في Brightspace، فاحذف الاسم الأول المفضل.
إذا كان لـ LIS اسم عائلة مفضل فارغ لمستخدم لديه اسم عائلة مفضل في Brightspace، فاحذف اسم العائلة المفضل.
إذا كان لـ LIS كتلة اسم مفضلة، وتتضمن اسم العائلة المفضل فقط، فلا تغير الاسم الأول المفضل وقم بتحديث اسم العائلة المفضل.
إذا كان لـ LIS كتلة اسم مفضلة، وتتضمن الاسم الأول المفضل فقط، فلا تغير اسم العائلة المفضل وقم بتحديث الاسم الأول المفضل.
عندما تكون كتلة الاسم المفضلة مفقودة من الطلب، فاحذف الاسم الأول واسم العائلة المفضلين.
إذا كان لـ LIS كتلة اسم مفضلة وكان كلا الاسمين موجودين، فقم بالكتابة فوق الاسم الأول واسم العائلة المفضلين.

لمحة عن عملية deletePerson

تحذف عملية deletePerson المستخدمين من Brightspace.

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

يحصل المحول على معرِّف المستخدم الفريد من حقل sourcedId للطلب.
تقوم المعالجات التي تم تكوينها لـ IDeleteUserHandler بمعالجة الطلب.
يتم إنشاء استجابة LIS من استجابة المعالج.

نموذج طلب deletePerson

				<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
				xmlns:ims="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_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:deletePersonRequest>
				<ims:sourcedId>Demo_User</ims:sourcedId>
				</ims:deletePersonRequest>
				</soapenv:Body>
				</soapenv:Envelope>

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

				<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
				<s:Header>
				<h:imsx_syncResponseHeaderInfo
				xmlns:h="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0"
				xmlns="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_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>PMS_deletePerson_20120120T191434_9913552Z</imsx_messageIdentifier>
				<imsx_statusInfo>
				<imsx_codeMajor>success</imsx_codeMajor>
				<imsx_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/>
				</s:Envelope>

لمحة عن عملية replacePerson

تنشئ عملية replacePerson مستخدمي Brightspace أو تحدثهم.

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

تتم ترجمة الطلب باستخدام مترجمي ITranslatePerson.
تقوم المعالجات التي تم تكوينها لـ IReplaceUserHandler بمعالجة الطلب.
يتم إنشاء استجابة من نتيجة المعالج.

نموذج طلب readPerson

				<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
				xmlns:ims="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0">
				<soapenv:Header>
				<ims:imsx_syncRequestHeaderInfo>
				<ims:imsx_version>1.0</ims:imsx_version>
				<ims:imsx_messageIdentifier>1234567</ims:imsx_messageIdentifier>
				</ims:imsx_syncRequestHeaderInfo>
				</soapenv:Header>
				<soapenv:Body>
				<ims:readPersonRequest>
				<ims:sourcedId>Demo_User</ims:sourcedId>
				</ims:readPersonRequest>
				</soapenv:Body>
				</soapenv:Envelope>