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

إعداد تكامل OneRoster الإصدار 1.1

تُعَد OneRoster هي المواصفات القياسية الصادرة عن IMS Global المصممة للسماح بالمشاركة الآمنة للوائح أسماء الصفوف والبيانات ذات الصلة بين نظام معلومات الطالب وأي نظام آخر. وتُعَد OneRoster 1.1 بمنزلة ترقية رئيسية لمعيار لوائح الأسماء المتعلق بالمحتوى التعليمي والأدوات والمنصات.

تدعم OneRoster تصدير جداول البيانات (CSV) واستيرادها فضلاً عن عمليات تبادل الأنظمة المباشرة باستخدام واجهة برمجة تطبيقات REST. وتدعم حزمة التكامل لأنظمة معلومات الطالب في منصة Brightspace مواصفات IMS OneRoster الإصدار 1.1، ما يسمح بالمشاركة الآمنة للوائح أسماء الصفوف والبيانات ذات الصلة بين نظام معلومات الطالب (SIS) ومنصة Brightspace. إن منصة Brightspace، بشكل أكثر تحديدًا، هي نظام معتمد من IMS Global حاصل على شهادات التوافق الآتية:

إعداد قائمة الاستيراد المجمع لـ OneRoster v1.1 CSV
إعداد قائمة استيراد دلتا لـ OneRoster v1.1 CSV
إعداد قائمة المستهلكين الأساسية لبيانات OneRoster v1.1 REST

إعداد الأدوار لـ OneRoster

قبل تكوين تكامل OneRoster في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب، يجب إكمال الآتي:

راجع الأدوار التي تم تكوينها في نظام معلومات الطالب والأدوار المطابقة التي تم تعيينها. تتوفر الأدوار الآتية في OneRoster:
- المسؤول
- المساعد
- ولي الأمر
- أصل
- المراقب
- القريب
- الطالب
- معلم
إذا أردت إرسال أي من الأدوار أعلاه إلى منصة Brightspace، فيجب عليك إعداد تعيين عند إنشاء تكامل نظام معلومات الطالب. إذا لم يوجد دور مناسب بالفعل في منصة Brightspace، فقم بإنشاء واحد قبل تكوين تكامل نظام معلومات الطالب.

إعداد أنواع الوحدات التنظيمية

راجع أنواع الوحدات التنظيمية التي تم تكوينها في نظام معلومات الطالب والأدوار المطابقة التي تم تعيينها. تتوفر أنواع الوحدات التنظيمية الآتية في OneRoster:
- الوطنية
- الحالة
- محلية
- التابعة للمنطقة
- التابعة للمدرسة (إلزامية)
- القسم
إذا أردت إرسال أي من أنواع الوحدات التنظيمية أعلاه إلى منصة Brightspace، فيجب عليك إعداد تعيين عند إنشاء تكامل نظام معلومات الطالب، الذي يتم تعيينه إلى أنواع الوحدات التنظيمية في نظام إدارة التعلّم. إذا لم يوجد نوع وحدة تنظيمية مناسب بالفعل في منصة Brightspace، فقم بإنشاء واحد قبل تكوين تكامل نظام معلومات الطالب.

لمحة عن علاقات المستخدمين

ملاحظة: هذه المعلومات مخصصة لعملاء الحضانة حتى الثانوية الذين يريدون استخدام Brightspace للأهل وولي الأمر.

تتحمل مؤسستك مسؤولية الحفاظ على دقة علاقات المستخدمين في نظام معلومات الطلاب. استشر مستشاريك للتأكد من التزامك بسياسات الخصوصية والأمان الخاصة بمؤسستك والقوانين المعمول بها. على سبيل المثال، قد يكون للمؤسسة أو الاختصاص القضائي سياسة أو قانون يحدد أنه عندما يبلغ الطفل 18 عامًا، يجب ألا يتمكن الأهل/الوصي القانوني من الوصول إلى محتوى طفله، ما لم يوافق الطفل على منحه إمكانية الوصول، تجب معالجة هذه الحالة في أثناء إنشاء علاقات الطفل مع الأهل/ولي الأمر وإرسالها إلى Brightspace.

تكوين تكامل نظام معلومات الطالب مع REST

في نظام معلومات الطالب الخاص بمؤسستك، قم بإنشاء عميل OneRoster لمنصة Brightspace يمكنك الاتصال به في نظام معلومات الطالب الخاص بك. ملاحظة: تختلف العملية في هذا الشأن حسب نظام معلومات الطالب لديك. واستشر ممثل نظام معلومات الطالب لديك لمزيد من المعلومات.
قم بتسجيل بيانات اعتماد التخويل المفتوح من نظام معلومات الطالب لديك.
قم بتسجيل عنوان URL الخاص بنقطة نهاية OneRoster لنظام معلومات الطالب لديك. على سبيل المثال، https://www.sis.com/school/api. ملاحظة: لا تقم بتضمين ims/oneroster/v1p1 في نهاية عنوان URL. حيث تقوم D2L بذلك داخل خدمة حزمة التكامل لأنظمة معلومات الطالب.
أكمل التكوين في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب الجديدة.
ومن القائمة المنسدلة تنسيق تبادل البيانات، حدد REST.
ملاحظة: إذا كانت لديك سجلات موجودة تريد مطابقتها مع بيانات OneRoster، فتأكد من أنك تحدد الخيارات المناسبة للأسئلة المتعلقة بربط بيانات منصة Brightspace بنظائرها في نظام معلومات الطالب.
في حقل عمليات التحديث المجدولة، حدد الوقت الذي تريد فيه تحديث تكامل REST تلقائيًا كل يوم.
عند حفظ التكامل، سيبدأ في المعالجة عند حلول وقت التحديث المجدول التالي. وإذا أردت تشغيل التكامل على الفور، في صفحة الدفعات، من زر تشغيل التحديث الآن، فحدد إعادة مزامنة كل سجلات نظام معلومات الطالب.

تكوين تكامل ملف CSV مع نظام معلومات الطالب

قم بإنشاء ملف CSV يتضمن البيانات ذات الصلة بلائحة الأسماء.
أكمل التكوين في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب الجديد (راجع مقطع إدارة حزمة التكامل لأنظمة معلومات الطالب لتكاملات نظام معلومات الطالب الجديدة). ومن القائمة المنسدلة تنسيق تبادل البيانات، حدد سحب ملف CSV وإفلاته.
ملاحظة: إذا كانت لديك سجلات موجودة تريد مطابقتها مع بيانات OneRoster، فتأكد من أنك تحدد الخيارات المناسبة للأسئلة المتعلقة بربط بيانات منصة Brightspace بنظائرها في نظام معلومات الطالب.
في صفحة الدفعات، اسحب وأفلت أو استعرض وحدد ملفًا مضغوطًا من نوع ZIP يحتوي على ملف CSV الذي يتضمن البيانات ذات الصلة بلائحة الأسماء.
تبدأ عملية التكامل الخاصة بك تلقائيًا.

التحقق من تكامل OneRoster

ثمة عدة طرق للتحقق من تكامل OneRoster:

لمعرفة ما إذا كان تكامل REST قد اكتمل، انتقل إلى سجل التدقيق (في واجهة الإدارة الأصلية لحزمة التكامل لأنظمة معلومات الطالب) وقم بتحديث الصفحة للتحقق مما إذا كانت كل أنواع السجلات التي تتوقعها (المستخدم والوحدة التنظيمية وما إلى ذلك) قد تم تشغيلها.
لمعرفة ما إذا كان تكامل ملف CSV قد اكتمل، قم بأحد الإجراءات الآتية:
- عند سحب ملف CSV مضغوط أو إفلاته أو تحديده، يتم عرض مؤشر معالجة على صفحة الدفعات لهذا النظام المصدر. عند الانتهاء، قم بتحديث الصفحة وسيتم تحديث المؤشر لعرض "مكتمل".
- انتقل إلى سجل التدقيق وقم بتحديث الصفحة للتحقق مما إذا كانت كل أنواع السجلات التي تتوقعها (المستخدم والوحدة التنظيمية وما إلى ذلك) قد تم تشغيلها.
لمعرفة ما إذا كان أي نوع من أنواع التكامل قد اكتمل، قم بأي مما يأتي:
- بالنسبة إلى الوحدات التنظيمية، يمكنك استخدام محرر الوحدة التنظيمية لمراجعة جميع الوحدات التنظيمية التي تم إنشاؤها وإجراء التحديثات، إذا لزم الأمر.
- بالنسبة إلى المستخدمين، يمكنك استخدام أداة "المستخدمون" لمراجعة جميع المستخدمين الذين تم إنشاؤهم وإجراء التحديثات، إذا لزم الأمر.

استكشاف أخطاء تكامل OneRoster وإصلاحها

إذا حدث خطأ في أثناء التشغيل الأول من أي نوع من تكامل OneRoster، فحاول إعادة معالجة التكامل.

لإعادة معالجة تكامل CSV:

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

لإعادة معالجة تكامل REST:

في صفحة الدفعات، من زر تشغيل التحديث الآن، حدد أيًا مما يأتي:
- إعادة مزامنة التحديثات - يمكنك تحديد أقرب تاريخ تريد مزامنة التحديثات التي تم إجراؤها على البيانات فقط بدءًا منه. ثم انقر فوق إعادة المزامنة.
- إعادة مزامنة كل سجلات نظام معلومات الطالب - يمكنك سحب جميع البيانات من نظام معلومات الطالب مرة أخرى من دون تقييدات زمنية.

قيم تعيين OneRoster

لا يتم تعيين أنواع مواد OneRoster تمامًا مع تلك الموجودة في منصة Brightspace. يوضح الجدول الآتي كيفية ارتباط قيم OneRoster بالقيم الموجودة في منصة Brightspace.

قيمة OneRoster	قيمة منصة Brightspace
الجلسات الأكاديمية	الوحدات التنظيمية*
الوحدات التنظيمية	الوحدات التنظيمية*
المقررات التعليمية	قوالب المقررات التعليمية
الصفوف	مضمون المقرر التعليمي ومقطع المقرر التعليمي
المستخدمون	المستخدم
التسجيلات	التسجيل

*يعتمد نوع الوحدة التنظيمية الذي يتم تعيين كل مادة إليه على تكوين مقاطع التعيين لتكامل نظام معلومات الطالب في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب.

قيم تعيين REST

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

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

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

OneRoster	القيم المدعومة	منصة Brightspace	مطلوب
SourcedId		تعقب داخلي	نعم
الحالة	نشط، tobedeleted	نشط	نعم
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	تعقب داخلي	نعم
بيانات التعريف		تم التعيين
الاسم		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم
المعرِّف		كود الوحدة التنظيمية (إن وجد)	شمال
StartDate	YYYY-MM-DD	تعقب داخلي	نعم
EndDate	YYYY-MM-DD	تعقب داخلي	نعم
النوع		نوع الوحدة التنظيمية	نعم
أصل		الأصول	شمال
الفروع		تم التعيين

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

OneRoster	القيم المدعومة	منصة Brightspace	مطلوب
SourcedId		تعقب داخلي	نعم
الحالة	نشط، tobedeleted	نشط	نعم
DateLastModified	YYYY-MM-DDTHH:mm:SS.sssZ	تعقب داخلي	نعم
بيانات التعريف		تم التعيين
العنوان		اسم الوحدة التنظيمية وكود الوحدة التنظيمية	نعم
SchoolYear		الأصول	شمال
CourseCode		كود الوحدة التنظيمية (إن وجد)	شمال
العلامات		تم التعيين
الموضوعات		تم التعيين
المؤسسة		الأصول	شمال
StartDate	YYYY-MM-DD	تعقب داخلي
EndDate	YYYY-MM-DD	تعقب داخلي
SubjectCodes		تم التعيين
الموارد		تم التعيين

الصفوف

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

المستخدمون

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

التسجيلات

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

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