OneRoster (الإصدار 1.2 والمجموعات المتقدمة)
OneRoster معيار دولي لتبادل أدلة المدارس (تصدره 1EdTech): يصف بصيغة موحدة المؤسسات والسنوات الدراسية والمقررات والصفوف والتسجيلات والمستخدمين في المدرسة. ويُستخدم لربط نظام SIS أو ENT أو LMS بأداة أخرى دون إعادة إدخال للبيانات ولا صيغة خاصة.
تتوجه هذه الصفحة إلى إدارة نظم المعلومات في المؤسسة. وهي تصف ما يعرضه Omniscol وما يستهلكه عبر OneRoster، والمصادقة المطلوبة، والإطار الفعلي لكل اتجاه من اتجاهي التبادل.
الإصدارات المدعومة
يدعم Omniscol OneRoster 1.2 Rostering — الأساس (Org وAcademicSession وCourse وClass وEnrollment وUser وDemographics) — إضافة إلى طبقة OR-Groups (Advanced Groups Service)، وهي معيار المجموعات الإضافي الذي يضيف ثلاثة كيانات (Group وGroupMembership وGroupAssociation) فوق الإصدار 1.2.
طبقة OR-Groups معيار قيد النشر. وهي إضافية بحتة على الإصدار 1.2: فالـ Group لا يفعل سوى الإشارة إلى Class / User / Org / AcademicSession من الإصدار 1.2، للقراءة فقط. ومن المعلن أن الإصدار 1.3 من OneRoster سيجعل Class حالة خاصة من Group — وهو توجه يتقارب معه تنفيذ Omniscol أصلًا.
Omniscol منتِجًا (Omniscol ← ENT / LMS)
بصفة المنتِج، يعرض Omniscol دليل المؤسسة للقراءة فقط، عبر واجهة REST API متوافقة مع OneRoster، لكي يقرأه نظام ENT أو LMS.
- يُقدَّم أساس Rostering 1.2 تحت المسار
/ims/oneroster/rostering/v1p2/…(مثل/orgsو/schoolsو/academicSessionsو/coursesو/classesو/enrollmentsو/usersو/teachersو/studentsو/demographics، لكل منها صيغه المتداخلة). - وتُقدَّم طبقة المجموعات تحت المسار
/ims/oneroster/groups/v1p0/…(/groupsو/groupMembershipsو/groupAssociationsوصيغها المتداخلة). - الإطار الافتراضي هو السنة الدراسية الحالية؛ ويتيح أحد المعاملات استهداف سنة أخرى أو تغطية جميع السنوات.
تعكس البيانات التخطيط المجمَّع في Omniscol (الجداول الزمنية المنشورة). والمنتِج للقراءة فقط عن قصد: لا تُعرض أي عملية كتابة (PUT / DELETE) — فالنظام البعيد لا يتحكم في إنشاء الكيانات أو حذفها في Omniscol.
مصادقة المنتِج
نقاط وصول المنتِج محمية بـ OAuth2 بتدفق
client_credentials (رمز من جهاز إلى جهاز، دون مستخدم)،
يصدره خادم OAuth2 الخاص بـ Omniscol. وهي غير مقصورة على
حسابات Premium: يُتحكَّم بالوصول عبر صلاحيات OAuth2 (scopes)، لا عبر
الباقة. وكل صلاحية خاصة بخدمة، ويُعزل الوصول إلى البيانات
الديموغرافية داخل الإصدار 1.2:
| نقاط الوصول | الصلاحيات المقبولة (scopes) |
|---|---|
| Rostering 1.2 (دون البيانات الديموغرافية) | https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.readonly, https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly |
Rostering 1.2 /demographics |
https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly, https://purl.imsglobal.org/spec/or/v1p2/scope/roster-demographics.readonly |
| OR-Groups (الكل) | https://purl.imsglobal.org/spec/or-groups/v1p0/scope/roster-group.readonly |
لا يمنح رمز OR-Groups الوصول إلى أساس Rostering، والعكس صحيح. ولا تُعلَن أي صلاحية كتابة. وتمنح إدارة Omniscol الصلاحيات المميزة عند تسجيل عميل OAuth2؛ ولا يستطيع العميل منحها لنفسه. وتُشرح إدارة عملاء OAuth2 والرموز في صفحة OAuth2 / OIDC (المزوّد)، وكذلك صفحة API Omniscol.
إطار الطلاب تحمله طبقة المجموعات
خيار هيكلي: تُعرض قائمة طلاب صف أو مجموعة عبر OR-Groups (GroupMembership)، لا عبر أساس 1.2 وحده. فالمستهلك الذي يقرأ Rostering 1.2 فقط يحصل على الفهرس (Courses وClasses) وتسجيلات المعلم ← المقرر ودليل المستخدمين، لكنه لا يحصل على انتماء الطلاب. ولمعرفة من في أي صف أو أي مجموعة، يجب على المستهلك تنفيذ طبقة OR-Groups. ويعكس هذا الخيار النموذج الفرنسي: يُسجَّل الطالب في صف أو مجموعة، لا مادة بمادة.
يُعرض المنتِج عبر REST. أما صيغة حزمة CSV الخاصة بـ OneRoster (أرشيف zip بملف لكل نوع من الكيانات) فهي مدعومة من جهة الاستيراد، للمزوّدين الذين يسلّمون دليلهم بملف بدل واجهة API — راجعوا قسم المستهلك أدناه.
Omniscol مستهلكًا (SIS ← Omniscol)
بصفة المستهلك، يستورد Omniscol دليل نظام SIS متوافق مع OneRoster ويطابقه داخل المؤسسة. ويشكّل إعداد الاستهلاك هذا جزءًا من المزامنة مع الأنظمة الخارجية: فهو متاح في حسابات Premium ويُتفق على إطاره بحسب المشروع مع فريق Omniscol (راجعوا المزامنة مع الأنظمة الخارجية).
- وسيلة النقل — إما واجهة REST API الخاصة بالمزوّد (يُعدّ العنوان
الأساسي ويُتبع ترقيم الصفحات القياسي في OneRoster)، مع
مصادقة OAuth2 بتدفق
client_credentialsلدى خادم المزوّد؛ وإما حزمة CSV (أرشيف zip). - الملف التعريفي — يحدد ملف إعداد نطاق القراءة: أساس 1.2 وحده، أو طبقة المجموعات، أو التطابق الفرنسي للتعليم المدرسي. ويمكن استيراد مزوّد يدعم 1.2 فقط، دون خدمة مجموعات، بسلاسة.
- تطبيق خاضع للمراقبة — يتبع الاستيراد المبدأ نفسه الذي تتبعه الموصلات الأخرى: يجلب Omniscol البيانات ثم يطابقها، و يؤكد مسؤول تطبيقها على المؤسسة. أما النظام البعيد فلا يدفع بياناته مباشرة إلى Omniscol أبدًا.
- إعادة استيراد متكررة دون أثر — تُحفظ مطابقات المعرّفات الخارجية، فلا تُنشئ إعادة الاستيراد نسخًا مكررة حتى لو غيّر المزوّد تسمية ما.
الملف الفرنسي (التعليم المدرسي)
يطابق الملف الفرنسي للتعليم المدرسي المفاهيم الفرنسية
مع نموذج OneRoster: القسم (الصف بمعناه
الفعلي) يصبح Group من النوع التنظيمي الرئيسي؛ والمجموعة
تصبح Group للتوزيع التربوي؛ ومجموعة المجموعات
Group عرضيًا؛ والتقسيمات والمحاذاة
تصبح ارتباطات بين المجموعات؛ وإسناد معلم
إلى مقرر يصبح تسجيل
معلم. وتُحمل المعرّفات الوطنية للطالب أو الرقم الوظيفي
في userIds للمستخدم.
المعرّفات والخصوصية
يحمل كل كيان معروض معرّفًا ثابتًا هو sourcedId.
- المعرّفات الهيكلية (المؤسسة والسنة والمقرر والصف والمجموعة) ثابتة وغير قابلة للتغيير من تصدير إلى آخر: يمكن للمستهلك الاعتماد عليها لربط البيانات عبر الزمن.
- معرّف المستخدم مجهول الهوية: فـ Omniscol لا يضع أبدًا معرّفه الاسمي في التبادل. والرمز الذي يوضع في التبادل مشتق بدالة أحادية الاتجاه (HMAC) خاصة بالحساب؛ وتعيد التسجيلات والانتماءات استخدام هذا الرمز دون أن تكشف المعرّف الأصلي.
الحالة
- المنتِج — متاح ويمكن عرضه دون شريك بعيد (يكفي التصدير نفسه). يُقدَّم Rostering 1.2 وطبقة OR-Groups للقراءة فقط، بمصادقة OAuth2.
- المستهلك — إعداد الاستيراد جزء من مزامنة Premium. أما تشغيل مزامنة مباشرة مع نظام SIS فيتوقف على المزوّد، وعند الاقتضاء، على المواعيد الوزارية: ويُتفق عليه عند الطلب، موصلًا بموصل. وليست مزامنة جاهزة للاستخدام فورًا.