ملف OneRoster CSV
وصف
يُمكّن ManageBac+ المسؤولين من استيراد وتصدير المستخدمين والفصول الدراسية والتسجيلات والبيانات ذات الصلة باستخدام نسخة مُخصصة من معيار OneRoster 1.2 . ويمكن الوصول إلى هذه الميزة من خلال الإعدادات > تبادل البيانات ، وتتضمن تقارير التحقق لضمان صحة البيانات قبل استيرادها.
تم تطوير معيار OneRoster وصيانته من قبل اتحاد IMS العالمي للتعلم ، وهو يوفر إطارًا لتبادل البيانات هذا. يمكن الرجوع إلى المورد الذي يصف التنفيذ التقني هنا:
مواصفات ManageBac+ OneRoster 1.2 CSV المخصصة
التصدير
يشير التصدير في ManageBac+ إلى عملية نقل البيانات من النظام إلى تنسيق خارجي، مما يسمح للمستخدمين بمشاركة المعلومات أو نسخها احتياطيًا أو دمجها مع أنظمة أخرى.
لبدء عملية التصدير، انتقل إلى علامة التبويب "تصدير" في مدير تبادل البيانات.
إذا رأيت الخطوة 2 - خيارات الوضع (التصدير المجمع والتصدير الجزئي)، فهذا يعني أن مسؤولاً آخر قد أكمل عملية التصدير بالفعل. حدد طريقة التصدير المطلوبة وانقر على "متابعة التصدير".
تُستخدم خاصيتا التصدير المجمع والتصدير التفاضلي في ManageBac+ لأغراض مختلفة في إدارة البيانات:
- التصدير المجمع : تُصدّر هذه العملية جميع السجلات ذات الصلة دفعة واحدة. وتُستخدم عادةً عند الحاجة إلى مجموعة بيانات كاملة، كما هو الحال أثناء الإعداد الأولي أو عند الانتقال إلى نظام جديد. تضمن هذه الطريقة التقاط جميع البيانات الموجودة ونقلها.
- تصدير التغييرات : تُصدّر هذه العملية السجلات التي طرأت عليها تغييرات منذ آخر عملية تصدير، مثل الإدخالات المُنشأة حديثًا أو المُحدّثة أو المحذوفة. تُساعد هذه العملية في الحفاظ على تحديث البيانات دون نقل مجموعة البيانات بأكملها، مما يجعلها أكثر كفاءةً للمزامنة المستمرة. لا يُمكن إجراء تصدير التغييرات إلا بعد اكتمال عملية التصدير المجمعة.
بمجرد النقر على "المتابعة إلى التصدير"، ستبدأ عملية التصدير في الخلفية وتنقل المستخدم إلى علامة تبويب "سجل التبادل" .
عند اكتمال العملية، حدد موقع آخر عملية تصدير لديك وانقر فوق زر التنزيل (السهم المتجه للأسفل) لاسترداد ملف ZIP.
راجع الملف الذي تم تنزيله. سيحتوي الملف على جميع الكيانات وكيفية تمثيلها في المواصفات المخصصة لـ ManageBac+ .
الاستيراد
لبدء عملية الاستيراد عبر مدير تبادل البيانات ، حدد ملف ZIP الخاص بك في علامة التبويب "استيراد" .
اختر ملف OneRoster ZIP من جهاز الكمبيوتر الخاص بك وقم بتحميله بالنقر فوق حفظ .
أدخل الحقول المطلوبة :
إذا لم يتضمن ملف manifest.csv الخاص بك حقلي source.systemname و source.systemcode ، فسيظهر حقلان أسفل منطقة التحميل لتعبئتهما. لمزيد من التفاصيل، راجع قسم مواصفات الملف > manifest.csv .
إذا كانت هذه القيم موجودة بالفعل في ملف manifest.csv ، فسيتم ملء الحقول مسبقًا ولن تتمكن من إدخالها.
بعد إتمام جميع الإعدادات، انقر على زر " المتابعة مع التحقق" في الأسفل. سيؤدي هذا إلى بدء عملية الاستيراد، والتي ستُجري عمليات التحقق من OneRoster و ManageBac+ في الخلفية.
لا يمكن إجراء سوى عملية استيراد واحدة لقائمة OneRoster في كل مرة.
تحقق من حالة الاستيراد عبر علامة تبويب "سجل التبادل" في الأعلى. بمجرد اكتمال الاستيراد، حدد موقع آخر عملية استيراد، وراجع عمليات التحقق.
ستفتح صفحة تقرير التبادل، وتعرض ملخصًا وجميع ملفات CSV التي تم تحميلها من ملف OneRoster ZIP الخاص بك.
في كل علامة تبويب CSV، سيتم تمييز الأخطاء والتحذيرات بالألوان المناسبة داخل الخلايا التي توجد بها المشكلات.
توجد ثلاث علامات تبويب، وتكون علامة التبويب "غير صالح" هي علامة التبويب الافتراضية المحددة في البداية:
صالح — يحتوي على جميع الصفوف بدون أي تحذيرات أو حالات فشل في التحقق من الصحة
تحذير — يحتوي على جميع الصفوف التي تحتوي على تحذير واحد على الأقل
غير صالح — يحتوي على جميع الصفوف التي تحتوي على صف واحد غير صالح على الأقل
لفهم الرسالة المرتبطة بالتحذير أو الإبطال، انقر لتوسيع معلومات الصف:
التحذيرات هي مشكلات محتملة لا تمنع الاستيراد. يمكن للمسؤولين تجاهلها أو إجراء تعديلات عليها، حسب السياق.
السجلات غير الصالحة لا تفي بالمتطلبات الوظيفية، ولا يمكن إتمام عملية الاستيراد.
بعد معالجة جميع المشكلات التي أدت إلى إبطال الصلاحية، قم بإجراء عملية استيراد جديدة باستخدام ملف ZIP المحدث.
كيانات البيانات
يوضح الجدول أدناه كيفية ارتباط كيانات ManageBac+ المختلفة بكيانات OneRoster 1.2 وملفات CSV، مما يضمن تبادل البيانات بسلاسة مع مراعاة الاختلافات في نماذج البيانات.
| OneRoster 1.2 الكيانات | ManageBac+ | ملف (ملفات) OneRoster CSV |
| المنظمات -> المنطقة | غير متوفر | المنظمات |
| المنظمات -> المدرسة | مدرسة | المنظمات |
| المنظمات -> برنامج خارجي | البرامج | المنظمات |
| الفصول الدراسية -> السنة الدراسية | السنوات الدراسية | الجلسات الأكاديمية |
| الدورات | المجموعات الموضوعية | دورات |
| المقررات الدراسية -> المواد الدراسية | المواضيع | دورات |
| الصفوف الدراسية | الصفوف الدراسية | صفوف |
| المستخدمون، الأدوار -> طالب، البيانات الديموغرافية | طلاب | المستخدمون، الأدوار، البيانات الديموغرافية |
| المستخدمون، الأدوار -> مُعلّم | المعلمون | المستخدمون، الأدوار |
| المستخدمون، الأدوار -> الأصل | آباء | المستخدمون، الأدوار |
| المستخدمون، الأدوار -> المسؤول | المسؤولون | المستخدمون، الأدوار |
| المستخدمون -> الوكلاء | العلاقة بين الوالدين والطفل | المستخدمون |
| التسجيلات | عضويات الصف | التسجيلات |
على سبيل المثال، يتوافق طالب ManageBac+ مع مستخدم OneRoster الذي يحمل دور "طالب". في OneRoster، يتم تعريف المستخدمين والأدوار في ملفي users.csv و roles.csv على التوالي.
يقوم مدير تبادل البيانات بتحديث السجلات المذكورة أعلاه فقط ولا يقوم بتعديل أي بيانات أخرى.
الاستيراد التفاضلي مقابل الاستيراد المجمع
يتمثل أحد الفروق الرئيسية في عملية تبادل البيانات في الفرق بين الاستيراد التفاضلي والاستيراد المجمع .
- دلتا إمبورت :
- يقوم بمطابقة وتحديث سجلات ManageBac+ الموجودة .
- يقوم بإنشاء سجلات جديدة إذا لم تكن موجودة بالفعل.
- لا يُجري أي تغيير على السجلات غير المدرجة في بيانات المصدر .
- الاستيراد بالجملة :
- يقوم بنفس الإجراءات التي يقوم بها استيراد التغييرات (المطابقة والتحديث وإنشاء السجلات).
- بالإضافة إلى ذلك، يقوم بأرشفة أي سجلات نشطة في ManageBac+ غير موجودة في بيانات المصدر.
- على سبيل المثال، إذا كان فصل مثل "IB Biology" نشطًا في ManageBac+ ولكنه غير موجود في بيانات المصدر، فسيتم أرشفته بعد معالجة الاستيراد.
باختصار، لا يقتصر الاستيراد المجمع على إنشاء وتحديث السجلات من البيانات المصدرية فحسب، بل يقوم أيضًا بأرشفة أي سجلات مفقودة منها.
في حالة إجراء عملية استيراد جماعية خلال فترة الانتقال بين السنوات الدراسية ، يرجى ملاحظة أن OneRoster لا يتضمن مجموعات السنوات ، لذلك يجب إدارتها بشكل منفصل.
مطابقة السجلات عند الاستيراد
يستخدم ManageBac+ استراتيجيتين رئيسيتين لمطابقة السجلات من بيانات المصدر مع تلك الموجودة في النظام، وذلك أثناء عمليات الاستيراد الجزئية والجماعية على حد سواء :
- إذا تم استخدام معرف المصدر مسبقًا، فإنه يتطابق مباشرة مع السجل المقابل باستخدام طريقة المطابقة الموضحة في النقطة التالية.
- إذا لم تكن المطابقة بواسطة المعرفات المصدرية متاحة أو كانت هذه هي المرة الأولى التي يتم فيها الالتقاء، فإن الجدول التالي يوضح استراتيجية المطابقة لكل كيان:
| كيان | عمود المصدر (أو) | تمت مطابقته مع (MB) |
| مدرسة | org.types == "school" | تمت مطابقته مع المدرسة الحالية (سجل واحد فقط) |
| برنامج | orgs.sourcedId ، مطابقة على اللاحقة بعد الشرطة السفلية الأولى | مطابق لرمز البرنامج (أي أن abc-dedf_diploma هي شهادة البكالوريا الدولية ) |
| الجلسات الأكاديمية | academicSessions.startDate , academicSessions.endDate | يتم مطابقتها مع تواريخ بداية/نهاية السنة/الفصل الدراسي |
| الدورات | عنوان الدورات | تمت مطابقته مع عنوان مجموعة الموضوع |
| المواضيع | courses.subjects[] | تتم مطابقة كل سلسلة نصية في المصفوفة مع عنوان الموضوع |
| الصفوف الدراسية | classes.classCode | تمت المطابقة مع معرف الفئة |
| المستخدمون | اسم المستخدم | تمت مطابقته مع البريد الإلكتروني للطالب / المعلم / ولي الأمر |
الأسئلة الشائعة
السؤال: ما هو OneRoster ولماذا يستخدم ManageBac+ مواصفات مخصصة له؟
يُعدّ OneRoster معيارًا مُعتمدًا على نطاق واسع، طوّره اتحاد IMS العالمي للتعليم لتوحيد تبادل البيانات التعليمية، مثل معلومات الطلاب وبيانات المقررات الدراسية والتسجيلات، بين الأنظمة المختلفة. يستخدم تطبيق ManageBac+ لـ OneRoster 1.2 معيارًا مُخصصًا، يُشار إليه باسم "لهجة ManageBac+ OneRoster" (MB OR Dialect)، نظرًا لاختلاف نموذج بيانات معيار OneRoster الأساسي عن المتطلبات الوظيفية لـ ManageBac+ . يُمكّن هذا التخصيص ManageBac+ من استيراد وتصدير السجلات بطريقة تتوافق مع بنية بياناته الداخلية وخصائصه.
السؤال: ما هي الملفات التي يتم تضمينها في عملية استيراد/تصدير ManageBac+ OneRoster وأيها إلزامي؟
يتم تبادل بيانات ManageBac+ OneRoster كملف مضغوط يحتوي على ملفات CSV. ملف manifest.csv إلزامي. الملفات التالية اختيارية، ولكن يجب أن تكون موجودة في الملف المضغوط إذا تم تضمين كياناتها المقابلة: academicSessions.csv، orgs.csv، courses.csv، classes.csv، roles.csv، users.csv، enrollments.csv، و demographics.csv. يُرجى ملاحظة أن الملفات الاختيارية الفارغة يجب أن تحتوي على عناوين الأعمدة المطلوبة.
السؤال: ما هي الأعمدة التي يحتاجها كل ملف، وما هي القيم المسموح بها؟
تُقدَّم هذه التفاصيل في المورد الذي يصف التنفيذ التقني، والذي يمكن الرجوع إليه هنا:
مواصفات ManageBac+ OneRoster 1.2 CSV المخصصة
السؤال: ما هي قواعد التحقق من صحة البيانات عند استيراد بيانات OneRoster إلى ManageBac+ ؟
يُطبّق ManageBac+ العديد من عمليات التحقق العامة على جميع ملفات CSV المُستوردة. وتُعرض نتائج هذه العمليات في علامة تبويب سجل تبادل البيانات. لكل كيان مجموعة من عمليات التحقق، وتُقدّم ManageBac+ في المورد الذي يصف التنفيذ التقني، والذي يُمكن الرجوع إليه هنا:
مواصفات ManageBac+ OneRoster 1.2 CSV المخصصة
السؤال: ما هي الاختلافات وحالات عدم التوافق المحتملة عند تبادل البيانات بين ManageBac+ وأنظمة OneRoster 1.2 الأخرى المتوافقة؟
عند تصدير البيانات من ManageBac+ إلى نظام طرف ثالث يدعم معيار OneRoster 1.2، يكون التصدير متوافقًا بشكل عام. يتضمن ManageBac+ أعمدة بيانات وصفية إضافية في ملفات مثل المستخدمين والدورات والفصول الدراسية، والتي يمكن للنظام المُستقبِل تجاهلها عادةً.
مع ذلك، عند استيراد البيانات من نظام طرف ثالث إلى ManageBac+ ، يجب استيفاء متطلبات معينة نظرًا لمواصفات ManageBac+ الخاصة. على سبيل المثال، يجب ربط الفصول الدراسية والدورات التدريبية بمؤسسات ذات نوع محدد (ext:program)، وقد يلزم إضافة أعمدة بيانات وصفية إضافية في ملفات المستخدمين والدورات التدريبية والفصول الدراسية. كما تخضع الجلسات الأكاديمية لمتطلبات جزئية عند الاستيراد.
سؤال: ما الفرق بين تصدير "البيانات المجمعة" وتصدير "البيانات الجزئية" في مدير تبادل البيانات ManageBac+ ؟ تصدير البيانات المجمعة هو تصدير كامل للبيانات المحددة، مما يوفر لقطة شاملة للمعلومات الحالية في ManageBac+ . ويتم تنفيذه عادةً كعملية تصدير أولية. أما تصدير البيانات الجزئية، فيقوم بتصدير التغييرات فقط (الإضافات والتعديلات والحذف) التي طرأت منذ آخر عملية تصدير بيانات مجمعة ناجحة. ولتنفيذ تصدير البيانات الجزئية، يجب أن تكون قد أكملت عملية تصدير بيانات مجمعة واحدة على الأقل مسبقًا.
السؤال: أين أقوم بتحديد اسم النظام المصدر ورمزه عند استيراد ملف OneRoster ZIP إلى ManageBac+ ؟
يتطلب ManageBac+ اسم النظام المصدر ورمز النظام المصدر لتحديد مصدر بيانات OneRoster، خاصةً عند استيراد البيانات من أنظمة معلومات الطلاب المتعددة. إذا لم تكن هذه الحقول موجودةً في ملف manifest.csv، فسيُطلب منك إدخالها يدويًا بعد تحميل ملف ZIP في مدير تبادل البيانات. يجب أن تكون هذه القيم متطابقةً في جميع عمليات الاستيراد من نفس النظام المصدر.
سؤال: لماذا لا يمكنني اختيار طريقة دلتا للتصدير؟
الإجابة: لتفعيل طريقة دلتا، يجب عليك إكمال أول عملية تصدير جماعي. بمجرد إتمام عملية التصدير الجماعي الأولية، ستصبح طريقة دلتا متاحة. تقوم طريقة دلتا بتصدير التغييرات التي طرأت منذ آخر عملية تصدير جماعي كاملة.
السؤال: أين أقوم بتحديد مجموعات السنوات في مواصفات OneRoster المخصصة في ManageBac+ ؟
الإجابة: لا يدعم النظام مجموعات السنوات الدراسية حاليًا، ولكننا ندرس التعاون مع OneRoster لتوفير الإضافات اللازمة لتلبية متطلبات وظائف ManagaBac. يُنصح بإدارة عضوية مجموعات السنوات الدراسية عبر الإعدادات -> قائمة الأعضاء -> العضويات.
السؤال: ماذا تعني الحالة في صفحة سجل التبادل؟
الإجابة: لدى ManageBac+ أربع حالات مختلفة مع التفسيرات التالية:
مُجدول - هذا يعني أن النظام قد جدول عملية الاستيراد بنجاح، وتمت إضافتها إلى قائمة الانتظار للبدء في وقت لاحق. عند بدء العملية، ستنتقل إلى مرحلة المعالجة.
جارٍ المعالجة - هذا يعني أن النظام يعمل حاليًا على مهمة في الخلفية لتصدير أو استيراد بياناتك. هذه حالة مؤقتة وستتغير إلى إحدى الحالات الموضحة أدناه.
فشل - إذا ظهرت هذه الحالة، فهذا يعني أن المهمة التي تتم في الخلفية لم تكتمل. في حال وجود أخطاء في التصدير، يُرجى التواصل مع فريق دعم ManageBac+ ( إرسال طلب ). أما في حال وجود أخطاء في الاستيراد، فانقر على أيقونة العين لفتح صفحة عرض التقرير، وتحقق من أخطاء التحقق، وقم بتصحيحها قبل عملية الاستيراد التالية.
ناجح - هذا يعني أن المهمة قد اكتملت دون أي أخطاء.