وثائق المسؤول

استخدام تكامل حزمة التكامل لأنظمة معلومات الطالب LIS 2.0 مع Brightspace للأهل وولي الأمر

تأكد من أن لديك إستراتيجية لتعريف sourceId بشكل فريد للأهل/أولياء الأمور في Brightspace، لأن علاقة المستخدم هي تعيين sourceId الفريد بين الأهل/أولياء الأمر والأطفال. عند إرسال طلبات replacePerson لإنشاء مستخدمين، تأكد من إرسال معلومات sourceId للأهل/ولي الأمر في مقطع الوكيل من طلب الأطفال/المتعلمين. يؤدي ذلك إلى إنشاء العلاقة بين الأهل/ولي الأمر والطفل.

تمت إضافة خمسة مكونات إضافية جديدة إلى محول IPSIS LIS 2.0 تساعد على إنشاء علاقة الأهل/ولي الأمر بالطفل وتحديثها وحذفها. يتم إعداد المكونات الإضافية تلقائيًا:

واجهة IReplaceUserHandler ParentPortalUpdateRelationshipHandler
ParentPortalDeleteRelationshipHandler لواجهة IDeleteUserHandler
واجهة IDeleteUserHandler DeleteUserRemoveRelationshipsHandler
واجهة ITranslatePerson PersonRequestAgentsTranslator
واجهة ITranslateReadPersonResponse ReadUserAgentsTranslator

ParentPortalCreateRelationshipHandler

يقوم ParentPortalUpdateRelationshipHandler بإنشاء علاقات بين الوالدين/أولياء الأمر والمتعلّمين (الأطفال) وتحديثها ضمنيًا.

التنفيذ:

D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalUpdateRelationshipHandler,D2L.Integration.ParentPortal.IPSIS

السلوك المتوقع:

يؤدي المعالج المهام الآتية:

• إنشاء علاقات الطفل مع الأهل/ولي الأمر وتحديثها ضمنيًا كما هو محدد في حقل العامل للمتعلّم في طلب استبدال المستخدم.

• مزامنة علاقات المستخدم إذا كان حقل ملحق SynchronizeRelationships متوفرًا. يظل المتعلّم في النظام ولكن تتم إزالة جميع العلاقات.

سلوك الخطأ:

في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.

ملاحظة التكوين:

• يجب وضع هذا بعد كل معالجات الاستبدال.

DeleteUserRemoveRelationshipsHandler

يُستخدم DeleteUserRemoveRelationshipsHandler لإزالة علاقة العامل عند حذف المستخدم.

التنفيذ

D2L.IM.IPSIS.Default.Users.Handlers.DeleteUserRemoveRelationshipsHandler,D2L.IM.IPSIS.Default

السلوك المتوقع:

عند حذف أهل/ولي أمر أو طفل ما، يتم حذف العلاقة.

ملاحظة التكوين:

يجب وضع هذا بعد ParentPortalDeleteRelationshipHandler

ParentPortalDeleteRelationshipHandler

يحذف ParentPortDeleteRelationshipHandler ضمنيًا العلاقات بين الأهل/أولياء الأمر والمتعلمين (الأبناء) (أي عند عدم وجود العلاقة، ستحذف Brightspace العلاقة).

التنفيذ

D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalDeleteRelationshipHandler,D2L.Integration.ParentPortal.IPSIS

السلوك المتوقع:

يؤدي المعالج المهام الآتية:

• حذف العلاقات بين الأهل/ولي الأمر والطفل

سلوك الخطأ:

في حالة وجود مشكلة أثناء المعالجة، سيتم طرح استثناء إلى جانب أكبر قدر ممكن من المعلومات المفصلة.

ملاحظة التكوين:

• يجب وضع هذا قبل كل معالجات الحذف.

PersonRequestAgentsTranslator

PersonRequestAgentsTranslator مطلوب لتعيين معرِّف العامل.

التنفيذ

D2L.IM.IPSIS.LIS.RequestAdapters.PMS.Default.PersonRequestAgentsTranslator,D2L.IM.IPSIS.LIS

السلوك المتوقع:

تعيين العوامل من الطلب وإنشاء علاقات الأهل/ولي الأمر.

ملاحظة التكوين:

ينبغي وضع هذا في نهاية المترجمين.

ReadUserAgentsTranslator

ReadUserAgentsTranslator يُستخدم لاسترداد الأهل وأولياء الأمر المرتبطين بالمستخدم.

التنفيذ:

D2L.IM.IPSIS.LIS.ResultAdapters.PMS.Default.ReadUserAgentsTranslator,D2L.IM.IPSIS.LIS

ملاحظة التكوين:

ينبغي وضع هذا في نهاية المترجمين.

لمحة عن طلب replacePerson

اقتباس من طلب replacePerson الذي يسلط الضوء على مقطع العامل.

<ims:agent>

	<ims:agentType>

		<ims:instanceIdentifier>

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

		</ims:instanceIdentifier>

<ims:instanceVocabulary>http://www.imsglobal.org/lis/pmsv2p0/agenttypevocabularyv1p0</ims:instanceVocabulary&gt;

		<ims:instanceValue>

			<ims:textString>Parent</ims:textString>

		</ims:instanceValue>

	</ims:agentType>

	<ims:agentId>

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

		<ims:textString>parentsourceid</ims:textString>

	</ims:agentId>

</ims:agent>

نوع العامل المدعوم: الأهل أو ولي الأمر