يوضح هذا الموضوع الاصطلاحات والمتطلبات الخاصة بتنسيقات ملف D2L Standard CSV.
التنسيقات المقبولة لملفات D2L Standard CSV
فيما يأتي تنسيقات الملفات التي يقبلها D2L Standard CSV:
- الوحدات التنظيمية
- المستخدمون
- التسجيلات
- سمات لوحة معلومات المدير ومجموعات التعلّم
- البيان (مطلوب عند استخدام الإصدار 1.1 أو إصدار أعلى أو D2L Standard CSV)
تنسيق أرشيف Zip لملفات D2L Standard CSV
يجب دمج ملفات CSV في أرشيف zip. اصطلاح التسمية الموصى به لأرشيف zip هو:
- D2LStdCSV-{YYYYmmddHHMMSS}.zip
|
ملاحظة: يمكنك فقط تحميل ملفات بتنسيق .zip (حساسة لحالة الأحرف، الأحرف الصغيرة فقط) إلى SFTP. |
تتم معالجة الملفات بترتيب أبجدي. توصي D2L بترتيب الملفات الفردية في الأرشيف على النحو الآتي:
- المؤسسات
- المستخدمون
- التسجيلات
- السمات
اصطلاحات التسمية الموصى بها لملفات D2L Standard CSV
اصطلاح التسمية الموصى به للملفات الفردية داخل أرشيف .zip هو:
- 01 - أخرى - {YYYYmmddHHMMSS}.csv
- 02-الأقسام - {YYYYmmddHHMMSS}.csv
- 03-الفصول الدراسية - {YYYYmmddHHMMSS}.csv
- 04-القوالب - {YYYYmmddHHMMSS}.csv
- 05-المضامين - {YYYYmmddHHMMSS}.csv
- 06-المقاطع - {YYYYmmddHHMMSS}.csv
- 07-المستخدمون - {YYYYmmddHHMMSS}.csv
- 08-عمليات التسجيل - {YYYYmmddHHMMSS}.csv
- 09-السمات - {YYYYmmddHHMMSS}.csv
- البيان.json
|
ملاحظة: يُستخدم ملف 01 - أخرى CSV لمعالجة الوحدات التنظيمية المخصصة خارج الهيكل التنظيمي القياسي لـ D2L ويتطلب استخدام الإصدار 2.0 من ملف D2L Standard CSV أو إصدارات أحدث. |
القواعد الشائعة لمحتوى ملف CSV
- إن القيم الموجودة في الملف حساسة لحالة الأحرف.
- يتم تمثيل القيمة الفارغة بفاصلتين من دون مسافات بينهما. على سبيل المثال:
- ,, تشير إلى قيمة فارغة
- , , تشير إلى حرف مسافة يتم تحليله كقيمة غير صالحة.
-
يجب أن تحتوي ملفات CSV على رأس (السطر الأول) مطابق تمامًا (حالة الأحرف والفواصل).
- يجب ترميز ملفات CSV باستخدام UTF-8.
- يجب أن تحتوي ملفات CSV على بيانات نظام معلومات الطالب التفاضلية (الدلتا) بدلاً من عمليات إفلات بيانات نظام معلومات الطالب الكاملة.
-
يؤدي إرسال إجراء تحديث في حالة عدم وجود المادة إلى إنشاء طلب. السلوك الشائع هو استخدام الإجراءين "تحديث" و"حذف" فقط.
- يجب تضمين ملفات CSV والبيان في الأرشيف zip.
- البيان مطلوب عند استخدام الإصدار 1.1 أو إصدار أحدث من D2L Standard CSV. البيان هو ملف JSON يعلن عن إصدار D2L Standard CSV الذي تستخدمه. لمزيد من المعلومات، قم بعرض موضوع البيان.
-
كأفضل ممارسة، لا تقم بتضمين معلومات تعريف شخصية (PII)، مثل أرقام التأمين الاجتماعي، في معرِّفات الوحدة التنظيمية المحددة للمستخدمين.
قواعد الوحدات التنظيمية
أنواع الوحدات التنظيمية المدرجة أدناه مدعومة بواسطة D2L Standard CSV:
- الوحدات التنظيمية الأخرى (الوحدات التنظيمية المخصصة خارج بنية المؤسسة القياسية لـ D2L معتمدة في D2L Standard CSV الإصدار 2.0 أو أعلى)
- الأقسام
- الفصول الدراسية
- قوالب المقررات التعليمية
- مضامين المقررات التعليمية
- الأقسام
تؤدي معالجة هذه الوحدات التنظيمية إلى إنشاء بنية المؤسسة في مثيل Brightspace.
القواعد:
- يمكن أن تقبل Brightspace عدد غير محدود من الوحدات التنظيمية حسب الحاجة.
- ويجب إرسال هذه الوحدات التنظيمية مرة واحدة على الأقل لتوجيه D2L Standard CSV إلى الوحدات التنظيمية التي يمكنه التحكم فيها. وبمجرد أن يتحكم التكامل في وحدة تنظيمية، يجب إجراء كل التغييرات المستقبلية على هذه الوحدة التنظيمية من خلال تكامل D2L Standard CSV فقط لضمان الملكية الدقيقة للبيانات.
- في حال إرسال العديد من أنواع الوحدات التنظيمية في ملف CSV واحد، تأكد من الالتزام بالتسلسل الهرمي في الملف (على سبيل المثال، يجب إرسال الأقسام قبل قوالب المقررات التعليمية). سيؤدي عدم إرسال وحدة تنظيمية أصل قبل إنشاء الفرع إلى فشل الوحدة التنظيمية الفرع.
- في حال إرسال علاقات المستخدمين، تأكد من مراعاة التسلسل الهرمي للمدققين و/أو الأهل/أولياء الأمر في الملف (على سبيل المثال، يجب إرسال الأهل/أولياء الأمر قبل المتعلّمين). يؤدي الفشل في القيام بذلك إلى فشل العلاقة.
- يجب أن يتبع اصطلاح التسمية لاسم الوحدة التنظيمية وكودها ذلك الموضح في نظام معلومات الطالب.
- يمكن إدخال أسماء الوحدات التنظيمية وأكوادها كما هي من خلال ملفات CSV إذا كانت الأسماء أو الأكواد تتقيد بمتطلبات Brightspace للأحرف غير المسموح بها وتكون فريدة عبر الوحدات التنظيمية المختلفة.
- تقتصر أكواد الوحدات التنظيمية على 50 حرفًا. إذا كانت أطول، يتم اقتطاع كود الوحدة التنظيمية تلقائيًا إلى 50، وقد يؤدي ذلك إلى تكرار أكواد الوحدة التنظيمية في Brightspace أو فشل إنشاء وحدة تنظيمية.
- ملاحظة: لا تدعم أكواد الوحدات التنظيمية الأحرف الآتية: , : % & # * ؟ < > | \ " ' والمسافات البادئة أو اللاحقة.
يمكن لـ D2L Standard CSV القيام بما يأتي:
- إنشاء وحدة تنظيمية جديدة، إذا لم تكن موجودة.
- التعيين إلى وحدة تنظيمية موجودة إذا تم إنشاؤها بواسطة مصدر مختلف عن D2L Standard CSV وخيار التعيين إلى موجود تم تحديده في التكوين.
- تحديث اسم وحدة تنظيمية يتحكم فيها.
- تعيين وحدات تنظيمية مخصصة وإزالتها كأصول لوحدات تنظيمية مخصصة أخرى، وأقسام، وفصول دراسية، وقوالب المقررات التعليمية، ومضامين المقررات التعليمية، وأقسام لمقررات التعليمية (تنطبق على D2L Standard CSV الإصدار 2.0 أو أعلى).
- قالب المقرر التعليمي: تعيين قسم أصل وتحديثه استنادًا إلى كود القسم.
- مضمون المقرر التعليمي: تعيين قالب مقرر تعليمي أصل وفصل دراسي وتحديثهما استنادًا إلى كود الأصل.
- مضمون المقرر التعليمي: تحديث كل تفاصيل المقرر التعليمي بما في ذلك اسم مضمون المقرر التعليمي وتواريخه. إلغاء تنشيط مضمون المقرر التعليمي.
- مقطع المقرر التعليمي: يؤدي حذف مقطع مقرر تعليمي إلى إلغاء تسجيل المستخدمين تلقائيًا من المقطع المحذوف.
- حذف وحدة تنظيمية يتحكم فيها.
لا يمكن لـ D2L Standard CSV القيام بما يأتي:
- تحديث أكواد الوحدة التنظيمية.
- حذف الوحدات التنظيمية التي تم إنشاؤها يدويًا ما لم يتم تعيينها باستخدام D2L Standard CSV.
- حذف وحدة تنظيمية إذا كانت لديها فروع مرتبطة بها (يجب حذف الفروع أولاً). يحدث استثناء إذا تم إعداد مقاطع للحذف في الواجهة؛ إذ يمكن حذف مضامين المقررات التعليمية إذا كان ثمة مقطع مرتبط بها.
قواعد للمستخدمين
يمكن لسجلات المستخدمين إنشاء مستخدمين أو تحديثهم أو إلغاء تنشيطهم أو حذفهم في Brightspace. يمكن أن يقوم نوع سجل المستخدم أيضًا بإنشاء علاقات الأهل-الطفل أو تحديثها أو حذفها في Brightspace.
قواعد
- يجب إرسال المستخدمين مرة واحدة على الأقل لتوجيه التكامل إلى المستخدمين الذين يمكنه إنشاؤهم وتحديثهم وحذفهم وإدارة تسجيلاتهم.
- الاسم الأول واسم العائلة لا يعتمدان الأحرف الآتية: \ / : * ؟ " < > | @ , ;
- اسم المستخدم ومعرِّف الوحدة التنظيمية المحدد لا يدعمان الأحرف الآتية: / : * ؟ " < > | ' , ;
- عنوان البريد الإلكتروني لا يدعم الأحرف الآتية: ( ) < > [ ] | \ ; : , “
يمكن لـ D2L Standard CSV القيام بالآتي:
- إنشاء مستخدم جديد وتسجيله في المؤسسة.
- تعيين مستخدم إلى مستخدم موجود يحمل معرِّف الوحدة التنظيمية المحدد أو اسم المستخدم نفسه.
- تحديث اسم المستخدم والاسم الأول واسم العائلة وكلمة المرور والبريد الإلكتروني.
- تحديث الاسم الأول المفضل واسم العائلة المفضل (D2L Standard CSV الإصدار 2.0 أو أعلى).
- تحديث اسم العائلة القابل للفرز (D2L Standard CSV الإصدار 2.1 أو أعلى).
- تحديث الضمائر (D2L Standard CSV الإصدار 3.0 أو أعلى).
- كلمة المرور غير مطلوبة ويوصى بعدم إرسالها في حال استخدام تسجيل دخول واحد (SSO).
- تحديث الدور على مستوى المؤسسة.
- تنشيط مستخدم أو إلغاء تنشيطه أو حذفه.
- إنشاء علاقات الطفل مع الأهل/ولي الأمر أو تحديثها أو حذفها لـ Brightspace للأهل وولي الأمر (D2L Standard CSV الإصدار 1.1 أو أعلى).
- تحديث علاقة المدققين-الخاضعين للتدقيق (D2L Standard CSV الإصدار 2.0 أو أعلى).
لا يقوم D2L Standard CSV بما يأتي:
- تحديث معرِّف الوحدة التنظيمية المحدد، ومع ذلك، يمكن القيام بذلك يدويًا في واجهة إدارة حزمة التكامل لأنظمة معلومات الطالب.
- حذف المستخدمين الذين تم إنشاؤهم يدويًا، ما لم يتم تعيينهم باستخدام D2L Standard CSV.
|
ملاحظة: بالنسبة إلى المستخدمين في بلدان مثل هولندا وبلجيكا وسريلانكا، فإن بعض الألقاب (مثل Van der Speigle أو Van Gogh) تحتوي على بادئة واحدة أو أكثر (تُعرف في اللغة الهولندية باسم Tussenvoegsel) تكون جزءًا من اسم العائلة الرسمي. في بعض الحالات، يجب ألا يتضمن اسم العائلة القابل للفرز هذه البادئات. يمكن للمسؤولين الإشارة إلى ما إذا كان اسم العائلة القانوني للمستخدم يختلف عن اسم العائلة القابل للفرز. إذا قام العملاء بتضمين اسم عائلة قابل للفرز، فإن Brightspace تستخدم اسم العائلة القابل للفرز عند ترتيب قوائم المستخدمين أبجديًا. يتوفر اسم العائلة القابل للفرز في D2L Standard CSV الإصدار 2.1 أو أعلى. |
قواعد التسجيلات
تؤدي معالجة سجلات التسجيل إلى تسجيل المستخدمين أو إلغاء تسجيلهم في وحدة تنظيمية محددة في Brightspace.
القواعد:
يجب إرسال سجلات التسجيل عند إجراء تغييرات على نظام المعلومات.
- يجب إرسال طلب إلغاء التسجيل مرة واحدة فقط. وتؤدي إعادة إرسال طلب إلغاء التسجيل نفسه إلى ظهور تحذير في سجل حزمة التكامل لأنظمة معلومات الطالب.
- عند استخدام المقاطع في مضامين المقررات التعليمية، يجب تقديم سجلات التسجيل للمقاطع فقط. يتم تضمين التسجيل في مضمون المقرر التعليمي وتتم معالجته بواسطة حزمة التكامل لأنظمة معلومات الطالب.
- قد يؤدي إرسال سجلات التسجيل لكل من مضامين المقررات التعليمية والمقاطع معًا، مع إرسال طلبات إلغاء التسجيل للمقاطع فقط، إلى إعادة تسجيل المستخدمين بشكل غير صحيح في مضامين المقررات التعليمية أثناء دمج المقررات التعليمية.
يمكن لـ D2L Standard CSV القيام بالآتي:
- تسجيل المستخدمين وإلغاء تسجيلهم في الوحدات التنظيمية (الإصدار 2.0 أو إصدارات أحدث) ومضامين المقررات التعليمية والمقاطع.
- التسجيل وإلغاء التسجيل من مقاطع المقرر التعليمي فقط (الإصدار 1.0 و1.1).
قواعد سمات لوحة معلومات المدير ومجموعات التعلّم
باستخدام D2L Standard CSV، يمكن لسمات لوحة معلومات المدير ومجموعات التعلّم القيام بالآتي:
- إنشاء بنية التقارير المستخدمة ضمن لوحة معلومات المدير.
- السماح بإنشاء قواعد العضوية التلقائية في مجموعات التعلّم.
لا تقوم سمات لوحة معلومات المدير ومجموعات التعلّم عبر D2L Standard CSV بالآتي:
- إنشاء حسابات مستخدمين جديدة.