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

كيفية ارتباط حزمة التكامل لأنظمة معلومات الطالب ببنية مؤسسة Brightspace

OneRoster CSV

يقبل تكامل OneRoster CSV بياناتك في مجموعة من ملفات قيم مفصولة بفواصل (CSV)، التي يتم تحميلها عبر أرشيف zip لملفات CSV.

تتم معالجة تنسيقات الملفات التي ستعمل بها وستتم معالجتها بالترتيب الآتي:

manifest.csv
academicsessions.csv
orgs.csv
courses.csv
classes.csv
users.csv
enrollments.csv

تعيين القيم

يشرح جدول التعيين أدناه كيفية ارتباط أنواع مواد OneRoster ببيئة D2L Brightspace.

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

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

تكامل OneRoster CSV قادر على الإنشاء والتحديث على المستويات المذكورة أعلاه. يجب إدارة أي شيء خارج هذه القائمة خارج هذا التكامل.

يجب أن تتبع اصطلاحات تسمية الوحدة التنظيمية (الاسم/الكود) تلك الموضحة في نظام معلومات الطالب. يمكن أن تقبل Brightspace أكبر عدد ممكن من الوحدات التنظيمية حسب الحاجة، ويمكن إدخال أسماء الوحدات التنظيمية وأكوادها كما هي من خلال ملفات CSV طالما تلبي الأسماء أو الأكواد متطلبات الأحرف غير المسموح بها لـ Brightspace.

البيان
- يجب تضمين البيان مع كل حزمة. يحتوي البيان على الإصدار وقائمة الملفات التي يتم إرسالها إلى Brightspace. كما يحدد الدلتا مقابل المجمّع.
الجلسات الأكاديمية، المؤسسات، المدارس، المقررات التعليمية، الصفوف
يجب إرسالها مرة واحدة على الأقل لتوجيه حزمة التكامل لأنظمة معلومات الطالب إلى الوحدة التنظيمية التي يمكنها التحكم فيها.

ليس عليك سوى إعادة إرسال ملفات الوحدات التنظيمية عندما تحتاج إلى إضافتها أو تحديثها في بنية المؤسسة في بيئة التعلّم.

يمكن لـ OneRoster CSV القيام بما يأتي:
- إنشاء وحدة تنظيمية جديدة إذا لم تكن موجودة
- تعيين إلى وحدة تنظيمية موجودة إذا تم إنشاؤها من مصدر مختلف إلى OneRoster
- تحديث الاسم أو الكود للوحدة التنظيمية الذي يتحكم بها
- قالب المقرر التعليمي: تعيين المدارس الأصل وتحديثها استنادًا إلى كود المدرسة
- مضمون المقرر التعليمي: تعيين المدارس الأصل وتحديثها استنادًا إلى كود المدرسة
- مضمون المقرر التعليمي: تعيين قالب المقرر التعليمي والفصل الدراسي الأصل وتحديثهما استنادًا إلى الكود الأصل
- مضمون المقرر التعليمي: تحديث كل تفاصيل المقرر التعليمي بما في ذلك اسم مضمون المقرر التعليمي
- تحديث أكواد الوحدات التنظيمية
- نسخ محتوى المقرر التعليمي إلى مقرر تعليمي جديد
- حذف وحدة تنظيمية إذا تم إرسال ملف دلتا بالحالة tobedeleted ولم يكن للوحدة التنظيمية أي تسجيلات
لن يقوم OneRoster CSV بما يأتي:
- حذف الوحدات التنظيمية التي تم إنشاؤها يدويًا ما لم يتم تعيينها باستخدام OneRoster CSV
- حذف وحدة تنظيمية إذا كان هناك فروع مرتبطة بها (يجب حذف الفروع أولاً)
- الاحتفاظ بتاريخي البدء أو النهاية لأي نوع من الوحدات التنظيمية
المستخدمون

إنشاء مستخدم جديد
في حال وجود مستخدم يحمل "OrgDefinedID" نفسه أو "Username" نفسه، يمكن تعيينه إلى المستخدم الحالي
تحديث الاسم الأول واسم العائلة وكلمة المرور والبريد الإلكتروني
تحديث الدور على مستوى المؤسسة
تنشيط مستخدم أو إلغاء تنشيطه
تحديث معرِّف الوحدة التنظيمية المحدد أو اسم المستخدم
تسجيل المستخدمين أو إلغاء تسجيلهم من الوحدات التنظيمية العليا

لن يقوم OneRoster CSV بما يأتي:

حذف المستخدمين

التسجيلات

تؤدي معالجة نوع التسجيل إلى تسجيل المستخدمين أو إلغاء تسجيلهم في Brightspace على مستوى مقطع المقرر التعليمي. يجب إرسال التسجيلات عند إجراء تغييرات في نظام المعلومات لتعكس تلك التغييرات بدقة في Brightspace. يجب إرسال طلب إلغاء التسجيل مرة واحدة فقط. ستؤدي إعادة إرسال طلبات إلغاء التسجيل نفسها إلى ظهور تحذيرات في سجل حزمة التكامل لأنظمة معلومات الطالب لديك.

يمكن لـ OneRoster CSV القيام بما يأتي:

تسجيل المستخدمين في مضامين المقررات التعليمية والمقاطع
إلغاء تسجيل المستخدمين من مضامين المقررات التعليمية والمقاطع

يتعذر على OneRoster CSV القيام بما يأتي:

تسجيل المستخدمين على مستويات أخرى للمؤسسة

القيود والافتراضات

إلغاء التسجيلات في الوحدات التنظيمية العليا:

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

الأحرف غير المدعومة:

هذه الأحرف غير مدعومة حاليًا لكود الوحدة التنظيمية: \ : * ? “ ” < > | ‘ # , % &
يمكن أن يأتي كود الوحدة التنظيمية من حقول CSV الآتية:
- الجلسات الأكاديمية: العنوان
- المقررات التعليمية: العنوان أو CourseCode
- الصفوف: العنوان أو ClassCode
- المؤسسات: الاسم أو المعرِّف

اقتطاع الحقول:

يتم اقتطاع كل أكواد الوحدات التنظيمية إلى حد أقصى يبلغ 50 حرفًا.