تُعَد OneRoster هي المواصفات القياسية الصادرة عن IMS Global المصممة للسماح بالمشاركة الآمنة للوائح أسماء الصفوف والبيانات ذات الصلة بين نظام معلومات الطالب وأي نظام آخر. يدعم تنفيذ Brightspace لـOneRoster عملية استيراد جدول البيانات (CSV)، إضافةً إلى عمليات تبادل النظام المباشرة باستخدام واجهات برمجة تطبيقات REST.
يتيح تنفيذ Brightspace لمواصفات OneRoster الإصدار 1.1 للمسؤولين جدولة البيانات التي سيتم سحبها من نظام معلومات الطالب لتعبئة البيانات المطلوبة ذات الصلة بلائحة الأسماء (مثل المدارس والصفوف والمستخدمين والتسجيلات) في Brightspace.
تتضمن واجهة مستخدم OneRoster REST الخاص بحزمة التكامل لأنظمة معلومات الطالب جدولاً يسمح للمسؤولين بتكوين الوقت الذي سيتم فيه سحب البيانات. بالنسبة إلى نظام معلومات الطالب الذي يدعم تمرير العلامات، يمكن للمسؤولين تعيين العلامات التي سيتم إرجاعها مع مزامنة البيانات اليومية أو السماح لعضو هيئة التدريس بإجراء مزامنة يدوية.
قبل تكوين تكامل OneRoster في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب، راجع المعلومات الآتية المتعلقة بالإعداد والتعيينات والتكوين الأساسي الموجودة في هذا الموضوع.
إعداد الأدوار
قبل تكوين تكامل OneRoster في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب، يجب إعداد الأدوار التي تنوي استخدامها. تتوفر الأدوار الآتية في OneRoster:
- المسؤول
- المساعد
- ولي الأمر
- أصل
- المراقب
- القريب
- الطالب
- معلم
- راجع الأدوار التي تم تكوينها في نظام معلومات الطالب.
- إذا كنت ترغب في إرسال أي دور من الأدوار إلى منصة Brightspace، فقم بأحد الإجراءات الآتية:
- تحقق من وجود الأدوار التي تريد تضمينها في منصة Brightspace.
- إذا كانت بعض الأدوار غير موجودة في Brightspace، فقم بإنشائها في أداة الأدوار والأذونات قبل تكوين نظام معلومات الطالب. وللحصول على مزيد من المعلومات، راجع إدارة الأدوار والأذونات.
إعداد أنواع الوحدات التنظيمية
يجب إعداد تعيينات بين أنواع الوحدات التنظيمية في نظام معلومات الطالب وفي Brightspace عند إنشاء تكامل نظام معلومات الطالب. تتوفر أنواع الوحدات التنظيمية الآتية في OneRoster:
- الوطنية
- الحالة
- محلية
- التابعة للمنطقة
- التابعة للمدرسة (إلزامية)
- القسم
- راجع أنواع الوحدات التنظيمية التي تم تكوينها في نظام معلومات الطالب.
- إذا كنت ترغب في إرسال أي نوع من أنواع الوحدات التنظيمية إلى منصة Brightspace، فقم بأحد الإجراءات الآتية:
- تحقق من وجود أنواع الوحدات التنظيمية التي تريد تضمينها في منصة Brightspace.
- إذا كانت بعض أنواع الوحدات التنظيمية غير موجودة في Brightspace، فقم بإنشائها في أداة محرر الوحدة التنظيمية قبل تكوين نظام معلومات الطالب. لمزيد من المعلومات، راجع إنشاء أنواع الوحدات التنظيمية وحذفها.
تعيين أنواع البيانات بين OneRoster وBrightspace
لا تتطابق أنواع مواد OneRoster تمامًا مع تلك الموجودة في Brightspace. يوضح الجدول الآتي علاقة التعيين بين أنواع مواد OneRoster وBrightspace.
|
ملاحظة: قم بإعداد أنواع الوحدات التنظيمية في Brightspace قبل تكوين تكامل OneRoster. لمزيد من المعلومات، راجع إنشاء أنواع الوحدات التنظيمية وحذفها.
أنواع الوحدات التنظيمية هي عادةً أنواع وحدات تنظيمية مخصصة يمكنك تعيينها في أثناء عملية التكوين.
|
| نوع بيانات OneRoster |
نوع بيانات D2L Brightspace |
|---|
| الجلسات الأكاديمية |
الوحدات التنظيمية |
| المؤسسة |
الوحدات التنظيمية |
| المدرسة |
الوحدات التنظيمية |
| مقرر تعليمي |
قالب المقرر التعليمي |
| الصف |
مضمون المقرر التعليمي ومقطع المقرر التعليمي |
| المستخدم |
المستخدم |
| التسجيل |
التسجيل |
| فئات مادة السطر |
فئات العلامات |
| مواد السطر |
مواد سيتم وضع علامة عليها |
| النتائج |
العلامات والدرجات |
|
ملاحظة: أنواع الوحدات التنظيمية هي عادةً أنواع وحدات تنظيمية مخصصة يمكنك تعيينها في أثناء عملية التكوين.
|
مسؤوليات علاقات الأهل/ولي الأمر
|
ملاحظة: هذه المعلومات مخصصة لعملاء الحضانة حتى الثانوية الذين يريدون استخدام Brightspace للأهل وولي الأمر. |
تتحمل مؤسستك مسؤولية الحفاظ على دقة علاقات المستخدمين في نظام معلومات الطلاب. استشر مستشاريك للتأكد من التزامك بسياسات الخصوصية والأمان الخاصة بمؤسستك والقوانين المعمول بها. على سبيل المثال، قد يكون للمؤسسة أو الاختصاص القضائي سياسة أو قانون يحدد أنه عندما يبلغ الطفل 18 عامًا، يجب ألا يتمكن الأهل/الوصي القانوني من الوصول إلى محتوى طفله، ما لم يوافق الطفل على منحه إمكانية الوصول، تجب معالجة هذه الحالة في أثناء إنشاء علاقات الطفل مع الأهل/ولي الأمر وإرسالها إلى Brightspace.
نظرة عامة على تكاملات OneRoster
يوجد نوعان من تكاملات OneRoster، وهما: OneRoster Rest وOneRoster CSV. يوفر هذا المقطع من الموضوع معلومات أساسية حول هذين التكاملين. لمزيد من المعلومات، راجع لمحة عن تكامل OneRoster REST أو لمحة عن تكامل OneRoster CSV
تكامل OneRoster REST: سير العمل الأساسي
تصف الخطوات الآتية التسلسل عالي المستوى لمساعدتك على فهم تكامل OneRoster REST. لمزيد من المعلومات المتعمقة بشأن سير العمل، راجع لمحة عن تكامل OneRoster REST.
- في نظام معلومات الطلاب (SIS) الخاص بمؤسستك، قم بإنشاء عميل OneRoster لـ Brightspace ستستخدمه للوصول إلى نظام معلومات الطالب من خلال Brightspace.
| ملاحظة: تختلف عملية إنشاء هذا الدور حسب نظام معلومات الطالب لديك. لمزيد من المعلومات، استشر ممثل نظام معلومات الطالب. |
- قم بتسجيل بيانات اعتماد OAuth من نظام معلومات الطالب وعنوان URL لنقطة النهاية الخاص بنظام معلومات الطالب. على سبيل المثال، https://www.sis.com/school/api.
| ملاحظة: لا تقم بتضمين ims/oneroster/v1p1 في نهاية عنوان URL. حيث تقوم D2L بذلك داخل خدمة حزمة التكامل لأنظمة معلومات الطالب. |
- أكمل التكوين في Brightspace في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب. لمطابقة السجلات الموجودة مع بيانات OneRoster، حدد الخيارات المناسبة لربط بيانات Brightspace مع مثيلاتها في نظام معلومات الطالب.
- قم بتعيين جدول لتكامل REST للمزامنة مع نظام معلومات الطالب لديك.
بعد حفظ التكامل، يمكنك انتظار التحديث المجدول الآتي، أو يمكنك تشغيل التكامل على الفور باستخدام زر تشغيل التحديث الآن الموجود في صفحة الدفعات.
تكامل OneRoster CSV: سير العمل الأساسي
تصف الخطوات الآتية التسلسل عالي المستوى لمساعدتك على فهم تكامل OneRoster CSV. لمزيد من المعلومات المتعمقة بشأن سير العمل، راجع لمحة عن تكاملات OneRoster CSV
- قم بإنشاء ملف CSV يتضمن المعلومات ذات الصلة بلائحة الأسماء.
- أكمل التكوين الموجود في منطقة إدارة حزمة التكامل لأنظمة معلومات الطالب في بيئة تعلّم Brightspace. لمطابقة السجلات الموجودة مع بيانات OneRoster، حدد الخيارات المناسبة لربط بيانات Brightspace مع مثيلاتها في نظام معلومات الطالب.
- في صفحة الدفعات، اسحب وأفلت أو استعرض ملفًا مضغوطًا من نوع ZIP يحتوي على ملف CSV الذي يتضمن البيانات ذات الصلة بلائحة الأسماء.
تبدأ عملية التكامل الخاصة بك تلقائيًا.
التحقق من تكامل OneRoster
ثمة عدة طرق للتحقق من تكامل OneRoster:
- لتحديد ما إذا كان تكامل REST قد اكتمل، انتقل إلى إدارة حزمة التكامل لأنظمة معلومات الطالب > سجل التدقيق. قم بتحديث الصفحة للتحقق مما إذا كانت كل أنواع السجلات المتوقعة (مثل المستخدم والوحدة التنظيمية وما إلى ذلك) قد تم تشغيلها.
- لتحديد ما إذا كان تكامل CSV قد اكتمل، قم بأحد الإجراءات الآتية
صفحة الدفعات: بعد تحميل ملف CSV المضغوط، يَظهر مؤشر المعالجة في صفحة الدفعات في نظام المصدر. قم بتحديث الصفحة للتأكد من أن المؤشر يُظهر تم الاكتمال.
سجل التدقيق: قم بتحديث سجل التدقيق للتحقق من معالجة جميع أنواع السجلات المتوقعة.
- لتحديد ما إذا كان أي من النوعين مكتملاً، قم بالإجراءات الآتية:
- الوحدات التنظيمية: استخدم محرر الوحدة التنظيمية لمراجعة جميع الوحدات التنظيمية التي تم إنشاؤها وإجراء التحديثات، إذا لزم الأمر.
- المستخدمون: استخدم أداة "المستخدمون" لمراجعة جميع المستخدمين الذين تم إنشاؤهم وإجراء التحديثات، إذا لزم الأمر.
<<<<<<<<<<<<<المسودة تبدأ من هنا
استكشاف أخطاء تكامل OneRoster وإصلاحها
إذا حدث خطأ في أثناء التشغيل الأول من أي نوع من تكامل OneRoster، فحاول إعادة معالجة التكامل.
لإعادة معالجة تكامل CSV:
- في صفحة الدفعات، اسحب ملف CSV المضغوط وأفلته في المنطقة المخصصة مرة أخرى.
- إذا كان ملف CSV المضغوط تالفًا، فقم بإنشاء ملف جديد من نظام معلومات الطالب واسحبه وأفلته في الواجهة لمعالجته مرة أخرى.
لإعادة معالجة تكامل REST:
- في صفحة الدفعات، من زر تشغيل التحديث الآن، حدد أيًا مما يأتي:
- إعادة مزامنة التحديثات - يمكنك تحديد أقرب تاريخ تريد مزامنة التحديثات التي تم إجراؤها على البيانات فقط بدءًا منه. ثم انقر فوق إعادة المزامنة.
- إعادة مزامنة كل سجلات نظام معلومات الطالب - يمكنك سحب جميع البيانات من نظام معلومات الطالب مرة أخرى من دون تقييدات زمنية.
<<<<<<<محتوى مصدر المسودة يبدأ من هنا
قيم تعيين REST
قيم تعيين ملف 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 |