يجب أن تكون ملفات OneRoster ملفات نصية بتنسيق CSV، مرمزة باستخدام UTF-8. لإنشاء هذه الملفات، قم بالوصول إلى بيانات نظام معلومات الطالب باستخدام أدوات التصدير الخاصة به، وفقًا لتعليمات المورد. اتصل بموفر نظام معلومات الطالب للحصول على إرشادات حول استخراج البيانات بتنسيق OneRoster CSV.
تدعم Brightspace مواصفات OneRoster الإصدار 1.1. يمكن للمسؤولين تحميل حزم متوافقة مع OneRoster 1.1 تحتوي على بيانات لائحة الأسماء المطلوبة، مثل المدارس والصفوف والمستخدمين والتسجيلات، وعرض النتائج في Brightspace.
يدعم OneRoster CSV الملفات الآتية ويعالجها بالترتيب المدرج:
- manifest.csv
- academicsessions.csv
- orgs.csv
- courses.csv
- classes.csv
- users.csv
- enrollments.csv
استخدام ملفات OneRoster CSV
توفر المقاطع الآتية وصفًا عالي المستوى لملفات OneRoster CSV. لمزيد من المعلومات، راجع تعيينات بيانات OneRoster CSV.
استخدام ملف بيان CSV
يجب عليك تضمين ملف بيان مع كل حزمة. يحتوي البيان على الإصدار وقائمة الملفات التي ترسلها إلى Brightspace، كما يوضح ما إذا كانت بيانات لائحة الأسماء تشير إلى أن الحزمة تحتوي على محتوى دلتا (التغييرات فقط منذ التحديث الأخير) أم محتوى مجمَّع (كل الملفات).
استخدام ملفات CSV التي تحتوي على AcademicSessions، والمؤسسات، والمقررات التعليمية، والصفوف
يمكن لتكامل OneRoster CSV إنشاء وتحديث مستويات المؤسسة المدرجة في مقطع فهم تعيين أنواع البيانات بين OneRoster وBrightspace تحت موضوع الاستعداد لتكامل OneRoster. يجب عليك إدارة أي مستويات مؤسسة لا تظهر في القائمة خارج تكامل OneRoster.
اتَّبع اصطلاحات التسمية (الاسم/الكود) المحددة في نظام معلومات الطالب للوحدات التنظيمية. تقبل Brightspace أي عدد من الوحدات التنظيمية، كما يمكنك تضمين الأسماء والأكواد الخاصة بها في ملفات CSV، بشرط أن تمتثل للقيود التي تفرضها Brightspace على الأحرف غير المسموح بها.
قم بإرسال مستويات المؤسسة مرة واحدة على الأقل لتحديد الوحدات التنظيمية التي يمكن لحزمة التكامل لأنظمة معلومات الطالب التحكم فيها. أعد إرسال ملفات الوحدات التنظيمية فقط عندما تحتاج إلى إضافتها أو تحديثها في بنية المؤسسة الخاصة ببيئة التعلّم.
يمكن لـ OneRoster CSV القيام بما يأتي:
- إنشاء وحدة تنظيمية جديدة إذا لم تكن موجودة
- تعيين إلى وحدة تنظيمية موجودة إذا تم إنشاؤها من مصدر مختلف
- تحديث الاسم أو الكود للوحدة التنظيمية الذي يتحكم بها
- قالب المقرر التعليمي: تعيين المدارس الأصل وتحديثها استنادًا إلى كود المدرسة
- مضمون المقرر التعليمي: تعيين المدارس الأصل وتحديثها استنادًا إلى كود المدرسة
- مضمون المقرر التعليمي: تعيين قالب المقرر التعليمي والفصل الدراسي الأصل وتحديثهما استنادًا إلى الكود الأصل
- مضمون المقرر التعليمي: تحديث كل تفاصيل المقرر التعليمي بما في ذلك اسم مضمون المقرر التعليمي
- تحديث أكواد الوحدات التنظيمية
- نسخ محتوى المقرر التعليمي إلى مقرر تعليمي جديد
- حذف وحدة تنظيمية إذا تم إرسال ملف دلتا بالحالة tobedeleted ولم يكن للوحدة التنظيمية أي تسجيلات
يتعذر على OneRoster CSV القيام بما يأتي:
- حذف الوحدات التنظيمية التي تم إنشاؤها يدويًا ما لم يتم تعيينها باستخدام OneRoster CSV
- حذف وحدة تنظيمية إذا كان هناك فروع مرتبطة بها (يجب حذف الفروع أولاً)
استخدام ملف CSV الخاص بالمستخدمين
تؤدي معالجة نوع المستخدم إلى إنشاء المستخدمين أو تحديثهم أو إلغاء تنشيطهم في Brightspace. قم بإرسال بيانات المستخدمين مرة واحدة على الأقل لتوجيه حزمة التكامل لأنظمة معلومات الطالب بشأن ملفات تعريف المستخدمين التي يمكنها إنشاء تسجيلاتها وتحديثها وإدارتها. تقوم Brightspace تلقائيًا بتسجيل المستخدمين في المدرسة.
يمكن لـ OneRoster CSV القيام بما يأتي:
- إنشاء مستخدم جديد
- في حال وجود مستخدم يحمل OrgDefinedID نفسه أو Username نفسه، يمكن تعيينه إلى مستخدم حالي
- تحديث الاسم الأول واسم العائلة وكلمة المرور والبريد الإلكتروني
- تحديث الدور على مستوى المؤسسة
- تنشيط مستخدم أو إلغاء تنشيطه
- تحديث معرِّف الوحدة التنظيمية المحدد أو اسم المستخدم
- تسجيل المستخدمين أو إلغاء تسجيلهم من الوحدات التنظيمية العليا
لا يقوم OneRoster CSV بما يأتي:
استخدام ملف CSV للتسجيلات
تؤدي معالجة نوع التسجيل إلى تسجيل المستخدمين أو إلغاء تسجيلهم في Brightspace على مستوى مقطع المقرر التعليمي. قم بإرسال التسجيلات فقط عند حدوث تغييرات في نظام المعلومات للحفاظ على تحديث Brightspace. قم بإرسال طلب إلغاء التسجيل مرة واحدة فقط، إذ تؤدي إعادة إرساله إلى ظهور تحذيرات في سجل حزمة التكامل لأنظمة معلومات الطالب.
يمكن لـ OneRoster CSV القيام بما يأتي:
- تسجيل المستخدمين وإلغاء تسجيلهم من مضامين المقرر التعليمي والمقاطع
يتعذر على OneRoster CSV القيام بما يأتي:
- تسجيل المستخدمين في مستويات أخرى للمؤسسة (باستثناء استخدام سجل المستخدم كما هو موضح أعلاه)
القيود والافتراضات
إلغاء التسجيلات من الوحدات التنظيمية العليا
يشير مصطلح الوحدة التنظيمية العليا إلى أي وحدة تنظيمية في التسلسل الهرمي موجودة فوق مضمون المقرر التعليمي، مثل المدرسة التي يتم تقديم المقرر التعليمي فيها. عادةً ما يتم تسجيل المستخدمين في كل من مضمون المقرر التعليمي والمدرسة المرتبطة به التي تعمل بوصفها وحدة تنظيمية عليا.
- لتمكين إلغاء التسجيلات باستخدام تكامل OneRoster، من صفحة إدارة حزمة التكامل لأنظمة معلومات الطالب حدد إلغاء تسجيل المستخدمين من مؤسسات نظام معلومات الطالب إذا لم يعودوا مرتبطين بها في نظام معلومات الطالب.
- يتعذر على تكامل OneRoster إلغاء تسجيل المستخدمين من الوحدات التنظيمية العليا التي تم إنشاؤها قبل إصدار يونيو 2024/20.24.6 أو من التسجيلات التي تم إنشاؤها يدويًا في Brightspace.
- قد يقوم المستخدم الذي لديه دور متتالٍ في وحدة تنظيمية عليا بإزالة إمكانية وصوله إلى العديد من الوحدات التنظيمية الفرع.
الأحرف غير المدعومة
يأتي كود الوحدة التنظيمية من حقول CSV الآتية:
- الجلسات الأكاديمية: العنوان
- المقررات التعليمية: العنوان أو courseCode
- الصفوف: العنوان أو classCode
- المؤسسات: الاسم أو المعرِّف
الأحرف الآتية غير مدعومة حاليًا لكود الوحدة التنظيمية:
- \ (الشرطة المائلة للخلف)
- : (النقطتان)
- * (العلامة النجمية)
- ؟ (علامة الاستفهام)
- " " (علامتا الاقتباس المزدوجة)
- < > (علامتا أقل من وأكبر من)
- | (الخط العمودي)
- ‘ (الفاصلة العليا)
- # (علامة الشباك / الجنيه)
- , (الفاصلة)
- % (علامة النسبة المئوية)
- & (علامة العطف)
يتم اقتطاع كل أكواد الوحدات التنظيمية إلى حد أقصى يبلغ 50 حرفًا.
معالجة ملفات CSV
قم بضغط ملفات CSV قبل تحميلها إلى Brightspace. يمكنك تحميل ملف ZIP:
- يدويًا: قم بسحب الملف وإفلاته في إدارة حزمة التكامل لأنظمة معلومات الطالب > واجهة لوحة المعلومات.
- تلقائيًا: قم بتحميل ملف ZIP إلى موقع SFTP الذي تم إعداده في أثناء التكوين الأولي. تفحص Brightspace موقع SFTP كل عشر دقائق.