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

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

يمكن أن ترسل حزمة التكامل لأنظمة معلومات الطالب OneRoster علاقات المستخدمين بين الأهل/ولي الأمر القانوني والطفل إلى Brightspace. لا يتوفر تكامل حزمة التكامل لأنظمة معلومات الطالب OneRoster مع Brightspace للأهل وولي الأمر إلا للعملاء الذين في الولايات المتحدة وكندا وأستراليا وأيرلندا.

في الوقت الحالي، تُعَد الأدوار الآتية فقط ذات صلة بالعلاقة:

الأهل
ولي الأمر
الطالب

سيتم تجاهل كل الأدوار الأخرى.

خطوات إعداد OneRoster

في الصفحة إدارة حزمة التكامل لأنظمة معلومات الطالب، افتح علامة تبويب التكوين.
إذا كان لديك نظام مصدر One Roster 1.1 - CSV، فسيتم عرض بيانات اعتماد SFTP. انسخ المضيف واسم المستخدم وكلمة المرور (يحتاج نظام معلومات الطالب هذه المعلومات لإرسال ملفات CSV إلى Brightspace).
إذا كان لديك OneRoster 1.1 – REST‎، وهو نظام المصدر، فيجب عليك تحديد أسلوب التخويل المفتوح.
1. يتم تحديد التخويل المفتوح 1.0a بشكل افتراضي. وأدخل عنوان URL صالحًا لنقطة النهاية ومفتاح المستهلك وسر المستهلك وحدد أسلوب توقيع التخويل المفتوح.
2. إذا تم تحديد التخويل المفتوح 2، فأدخل هوية العميل وسر العميل الصالحَين.
قم بتعيين دور الأهل أو ولي الأمر في نظام معلومات الطالب إلى دور Brightspace للأهل/أولياء الأمر الخاص بك.
قم بتعيين دور المتعلّم في نظام معلومات الطالب إلى دور Brightspace للمتعلّمين الخاص بك.
تعيين مدرسة مؤسسة نظام معلومات الطالب إلى نوع الوحدة التنظيمية Brightspace.
راجع الإعدادات الأخرى وانقر فوق حفظ.

ملاحظة: استنادًا إلى تنسيق تبادل البيانات لديك، قم بتحميل إما ملف ‎.CSV لإنشاء علاقات الأهل والطفل، أو قم بطلب REST لإنشاء علاقات الأهل/ولي الأمر والطفل. راجع أدناه للحصول على نموذج ملف CSV وطلب REST.

نموذج ملف CSV

sourcedId,status,dateLastModified,enabledUser,orgSourcedIds,role,username,userIds,givenName,familyName,middleName,identifier,email,sms,phone,agentSourcedIds,grades,password
{studentsourceId},active,,TRUE,{orgSourcedIds},student,{learner username},{userId},{learner given Name},{learner family name},,,{learner email},,, "{parentsourceId1}, {parentsourceId2}",,{password}
{parentsourceId1},active,,TRUE,{orgSourcedIds},parent,{parent username},{userIds},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}
{parentsourceId2},active,,TRUE,{orgSourcedIds},parent,{parent username},{userId},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}

طلب REST

لإنشاء علاقات بين الأهل/ولي الأمر والطفل، يجب أن يتضمن طلب إنشاء مستخدم REST معلومات الأهل/ولي الأمر في حقل العامل.

للحصول على معلومات مفصلة حول طلبات REST، راجع قيم تعيين REST أدناه.

نموذج REST JSON مع تحديد العلاقات

بالنسبة إلى المتعلّم:

{
	"users": [{
		"sourcedId": "user1",
		"status": "active",
		"dateLastModified": "2017-06-05T22:15:00.000Z",
		"username": "userone",
		"givenName": "Richard",
		"middleName": "",
		"familyName": "Deckard",
		"role": "student",
		"identifier": "user1",
		"enabledUser": true,
		"grades": [],
		"userIds": [],
		"orgs": [{
			"sourcedId": "District1",
			"href": "https://oneroster.infinitec",
			"type": "org"
		},
		{
			"sourcedId": "School1",
			"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
			"type": "org"
		}],
		"agents": [{
			"sourcedId": "Parent1",
			"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent1",
			"type": "user"
		},
		{
			"sourcedId": "Parent2",
			"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent2",
			"type": "user"
		}]
	}]
}

بالنسبة إلى الأهل/ولي الأمر:

{
	"users": [{
		"sourcedId": "Parent1",
		"status": "active",
		"dateLastModified": "2017-06-05T22:15:00.000Z",
		"username": "Parent1",
		"givenName": "James",
		"middleName": "",
		"familyName": "Deckard",
		"role": "parent",
		"identifier": "Parent1",
		"enabledUser": true,
		"grades": [],
		"userIds": [],
		"orgs": [{
			"sourcedId": "District1",
			"href": "https://oneroster.infinitec",
			"type": "org"
		},
		{
			"sourcedId": "School1",
			"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
			"type": "org"
		}]
	}]
}

قيم تعيين ملف CSV

لإنشاء علاقات الطفل مع الأهل/ولي الأمر، يجب تحديث AgentSourceIds في ملف ‎.CSV الخاص بالمستخدمين لكل من الأهل/أولياء الأمر والمتعلّمين.

الجلسات الأكاديمية

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId			نعم
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
العنوان		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم
النوع			نعم	نوع الوحدة التنظيمية
StartDate			نعم	YYYY-MM-DD
EndDate			نعم	YYYY-MM-DD
ParentSourcedId			شمال	غير مستخدم
SchoolYear			شمال	غير مستخدم

الوحدات التنظيمية

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId			نعم
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
الاسم		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم	إذا كان حقل المعرِّف فارغًا، فيتم نسخ الاسم في كود الوحدة التنظيمية في Brightspace
النوع	وطني، حكومي، محلي، منطقة، مدرسة، قسم		نعم	يعرّف OrgUnitType في Brightspace. http://www.imsglobal.org/oneroster-v11-final-specification#_Toc480452024
المعرِّف		كود الوحدة التنظيمية (إن وجد)	شمال
ParentSourcedId			شمال	يحدد هذا الحقل الوحدة التنظيمية الأصل.

المقررات التعليمية

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId			نعم
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
SchoolYearSourcedId			شمال	غير مستخدم
العنوان		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم	ينشئ قالب مقرر تعليمي في Brightspace. إذا كان حقل ‏CourseCode فارغًا، فيتم نسخ العنوان إلى OrgUnitCode.
CourseCode		كود الوحدة التنظيمية	شمال	إن وُجد
العلامات			شمال	غير مستخدم
OrgSourcedId			نعم	يحدد هذا الحقل الوحدة التنظيمية الأصل.
الموضوعات			شمال	غير مستخدم
SubjectCodes			شمال	غير مستخدم

الصفوف

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId			نعم
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
العنوان		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم	يقوم بإنشاء مقطع ومضمون مقرر تعليمي في Brightspace. إذا كان حقل ‏ClassCode فارغًا، فيتم نسخ العنوان إلى كود الوحدة التنظيمية.
العلامات			شمال	غير مستخدم
CourseSourcedId			نعم	يحدد هذا الحقل الوحدة التنظيمية الأصل
ClassCode		كود الوحدة التنظيمية (إن وجد)	شمال	إن وُجد
ClassType			نعم	غير مستخدم
الموقع			شمال	غير مستخدم
SchoolSourcedId			نعم	غير مستخدم
TermsSourcedIds			شمال	غير مستخدم
الموضوعات			شمال	غير مستخدم
SubjectCodes			شمال	غير مستخدم
الفترات			شمال	غير مستخدم

المستخدمون

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId		OrgDefinedId	نعم	إذا لم تتم تعبئة حقل المعرِّف، فيتم نسخ SourcedId إلى OrgDefinedId.
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
EnabledUser			نعم	غير مستخدم
OrgSourcedIds		عمليات التسجيل في الوحدة التنظيمية العليا (بدور في المؤسسة)	نعم	التسجيل في الوحدات التنظيمية المدرسية
دور	المسؤول، المساعد، ولي الأمر، الوالد، المراقب، القريب، الطالب، المعلّم		نعم	الدور في المؤسسة
اسم المستخدم		اسم المستخدم	نعم
UserIds			شمال	غير مستخدم
GivenName		FirstName	نعم
FamilyName		LastName	نعم
MiddleName		MiddleName	شمال
المعرِّف		OrgDefinedId	شمال	إن وُجد
البريد الإلكتروني		ExternalEmail	شمال
Sms		MobilePhone	شمال
الهاتف		HomePhone	شمال
AgentSourcedIds			شمال	يُستخدم في Brightspace للوالد وولي الأمر. ويؤكد هذا الحقل على علاقة الأصل بالفرع. يجب أن يشير صف الفرع وصف الأصل إلى sourcedIds الخاصة بهما.
العلامات			شمال	غير مستخدم
كلمة المرور		كلمة المرور	شمال

التسجيلات

OneRoster	القيم المدعومة	تعيينات Brightspace	مطلوب	ملاحظات
SourcedId			نعم
الحالة	نشط، tobedeleted		شمال	الحقل مطلوب للملفات في وضع دلتا.
DateLastModified			شمال	الحقل مطلوب للملفات في وضع دلتا. تنسيق التاريخ YYYY-MM-DDTHH:mm:SS.sssZ
UserSourcedId			نعم	المستخدم المراد تسجيله
ClassSourcedId	YYYY-MM-DD		نعم	التسجيل في Brightspace
SchoolSourcedId			شمال	غير مستخدم
دور	المسؤول، المساعد، ولي الأمر، الوالد، المراقب، القريب، الطالب، المعلّم	دور	نعم
أساسي			شمال	غير مستخدم
BeginDate			شمال	YYYY-MM-DD
EndDate			شمال	YYYY-MM-DD

قيم تعيين ملف REST