فيما يأتي تنسيقات الملفات التي يقبلها D2L Standard CSV:
- الوحدات التنظيمية
- المستخدمون
- التسجيلات
- سمات لوحة معلومات المدير ومجموعات التعلّم
- البيان (مطلوب عند استخدام الإصدار 1.1 أو إصدار أعلى أو D2L Standard CSV)
يتم تحميل الملفات في أرشيف zip. اصطلاح التسمية الموصى به هو:
- D2LStdCSV-{YYYYmmddHHMMSS}.zip
|
ملاحظة: يُسمح بتحميل ملفات أرشيف .zip فقط (الحساسة لحالة الأحرف وذات الأحرف الصغيرة فقط) إلى SFTP. |
تتم معالجة الملفات بترتيب أبجدي. توصي D2L بإرسال الملفات بالترتيب الآتي:
- المؤسسات
- المستخدمون
- التسجيلات
- السمات
اصطلاحات التسمية الموصى بها لملفات D2L Standard CSV الفردية هي:
- 01-أخرى - {YYYYmmddHHMMSS}.csv
- معالجة الوحدات التنظيمية المخصصة خارج بنية المؤسسة القياسية لـ D2L معتمدة في D2L Standard CSV إصدار 2.0 أو أعلى.
- 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
القواعد الشائعة لمحتوى ملف CSV
- إن القيم الموجودة في الملف حساسة لحالة الأحرف. ستتناول التعليمات بالتفصيل الحرف المطلوب.
- يتم تمثيل القيمة الفارغة بفاصلتين من دون مسافات بينهما. (على سبيل المثال، يشير ,, إلى قيمة فارغة، بينما يشير , , إلى حرف مسافة تم تحليله كقيمة غير صالحة).
- يجب أن تحتوي ملفات CSV على رأس (السطر الأول) مطابق تمامًا (حالة الأحرف والفواصل) للمدرج في <الارتباط إلى الصفحة التي تعرِّف كل ملف بأمثلة>. تحتوي الأسطر اللاحقة في الملف على البيانات المطلوب معالجتها (إنشاؤها، تحديثها، حذفها).
- يجب ترميز ملفات CSV باستخدام UTF-8.
- يجب أن تحتوي ملفات CSV على بيانات نظام معلومات الطالب التفاضلية (الدلتا) بدلاً من عمليات إفلات بيانات نظام معلومات الطالب الكاملة.
- يؤدي إرسال إجراء تحديث في حالة عدم وجود المادة إلى إنشاء طلب. السلوك الشائع هو استخدام إجراءات التحديث أو الحذف فقط.
- يجب تضمين ملفات CSV والبيان في الأرشيف zip.
- البيان مطلوب عند استخدام الإصدار 1.1 أو إصدار أحدث من D2L Standard CSV. البيان هو ملف JSON يعلن عن إصدار D2L Standard CSV الذي تستخدمه. لمزيد من المعلومات، قم بعرض موضوع البيان.
- كأفضل ممارسة، لا تقم بتضمين معلومات تعريف شخصية (PII)، مثل أسماء المستخدمين أو أرقام التأمين الاجتماعي، في معرِّفات الوحدة التنظيمية المحددة (sourcedIds) للمستخدمين.
قواعد لأنواع الوحدات التنظيمية المعتمدة
أنواع الوحدات التنظيمية الآتية مدعومة في التكامل:
- الوحدات التنظيمية الأخرى (الوحدات التنظيمية المخصصة خارج بنية المؤسسة القياسية لـ D2L معتمدة في D2L Standard CSV الإصدار 2.0 أو أعلى)
- الأقسام
- الفصول الدراسية
- قوالب المقررات التعليمية
- مضامين المقررات التعليمية
- المقاطع
يمكن لتكامل D2L Standard CSV إنشاء وحدات تنظيمية وتحديثها وحذفها على المستويات المذكورة أعلاه.
في حال إرسال العديد من أنواع الوحدات التنظيمية في ملف CSV واحد، تأكد من الالتزام بالتسلسل الهرمي في الملف (على سبيل المثال، يجب إرسال الأقسام قبل قوالب المقررات التعليمية). سيؤدي عدم إرسال وحدة تنظيمية أصل قبل إنشاء الفرع إلى فشل الوحدة التنظيمية الفرع.
في حال إرسال علاقات المستخدمين، تأكد من مراعاة التسلسل الهرمي للمدققين و/أو الأهل/أولياء الأمر في الملف (على سبيل المثال، يجب إرسال الأهل/أولياء الأمر قبل المتعلّمين). يؤدي الفشل في القيام بذلك إلى فشل العلاقة.
يجب أن تتبع اصطلاحات تسمية الوحدة التنظيمية (الاسم/الكود) تلك الموضحة في نظام معلومات الطالب. يمكن أن تقبل Brightspace العديد من الوحدات التنظيمية حسب الحاجة، ويمكن إدخال أسماء الوحدات التنظيمية وأكوادها كما هي من خلال ملفات csv إذا كانت الأسماء أو الأكواد تتقيّد بمتطلبات الأحرف غير المسموح بها لـ Brightspace وتكون فريدة عبر الوحدات التنظيمية المختلفة.
تقتصر أكواد الوحدات التنظيمية على 50 حرفًا. إذا كانت أطول، يتم اقتطاع كود الوحدة التنظيمية تلقائيًا إلى 50، وقد يؤدي ذلك إلى تكرار أكواد الوحدة التنظيمية في Brightspace أو فشل إنشاء وحدة تنظيمية.
|
ملاحظة: لا تدعم أكواد الوحدات التنظيمية الأحرف الآتية: , : % & # * ؟ < > | \ " ' والمسافات البادئة أو اللاحقة. |
قواعد لأنواع الوحدات التنظيمية المعتمدة
كما يتم دعم الأقسام والفصول الدراسية وقوالب المقررات التعليمية ومضامين المقررات التعليمية ومقاطع المقررات التعليمية. تؤدي معالجة هذه الوحدات التنظيمية إلى إنشاء بنية المؤسسة في مثيل Brightspace. ويجب إرسالها مرة واحدة على الأقل لتوجيه D2L Standard CSV إلى الوحدات التنظيمية التي يمكنه التحكم فيها. وبمجرد أن يتحكم التكامل في وحدة تنظيمية، يجب إجراء كل التغييرات المستقبلية على هذه الوحدة التنظيمية من خلال تكامل D2L Standard CSV فقط لضمان الملكية الدقيقة للبيانات.
|
تحذير: ينبغي إعادة إرسال وحدات تنظيمية فقط عندما يتم إنشاؤها حديثًا أو تحديثها في نظام معلومات الطالب/نظام معلومات الموارد البشرية. |
يمكن لـ D2L Standard CSV القيام بما يأتي:
- إنشاء وحدة تنظيمية جديدة، إذا لم تكن موجودة.
- التعيين إلى وحدة تنظيمية موجودة إذا تم إنشاؤها بواسطة مصدر مختلف عن D2L Standard CSV وخيار التعيين إلى موجود تم تحديده في التكوين.
- تحديث اسم وحدة تنظيمية يتحكم فيها.
- تعيين وحدات تنظيمية مخصصة وإزالتها كأصول لوحدات تنظيمية مخصصة أخرى، وأقسام، وفصول دراسية، وقوالب المقررات التعليمية، ومضامين المقررات التعليمية، وأقسام لمقررات التعليمية (تنطبق على D2L Standard CSV الإصدار 2.0 أو أعلى).
- قالب المقرر التعليمي: تعيين قسم أصل وتحديثه استنادًا إلى كود القسم.
- مضمون المقرر التعليمي: تعيين قالب مقرر تعليمي أصل وفصل دراسي وتحديثهما استنادًا إلى كود الأصل.
- مضمون المقرر التعليمي: تحديث كل تفاصيل المقرر التعليمي بما في ذلك اسم مضمون المقرر التعليمي وتواريخه. إلغاء تنشيط مضمون المقرر التعليمي.
- مقطع المقرر التعليمي: يؤدي حذف مقطع مقرر تعليمي إلى إلغاء تسجيل المستخدمين تلقائيًا من المقطع المحذوف.
- حذف وحدة تنظيمية يتحكم فيها.
لا يمكن لـ D2L Standard CSV القيام بما يأتي:
- تحديث أكواد الوحدة التنظيمية.
- حذف الوحدات التنظيمية التي تم إنشاؤها يدويًا ما لم يتم تعيينها باستخدام D2L Standard CSV.
- حذف وحدة تنظيمية إذا كانت لديها فروع مرتبطة بها (يجب حذف الفروع أولاً). يحدث استثناء إذا تم إعداد مقاطع للحذف في الواجهة؛ إذ يمكن حذف مضامين المقررات التعليمية إذا كان ثمة مقطع مرتبط بها.
قواعد لأنواع المستخدمين
تؤدي معالجة نوع المستخدم إلى إنشاء المستخدمين في Brightspace أو تحديثهم أو إلغاء تنشيطهم أو حذفهم منها. يمكن أن يقوم نوع المستخدم أيضًا بإنشاء علاقة الأهل-الطفل أو تحديثها أو حذفها في Brightspace (D2L Standard CSV الإصدار 1.1 أو أعلى). يجب إرسال المستخدمين مرة واحدة على الأقل لتوجيه التكامل إلى المستخدمين الذين يمكنه إنشاؤهم أو تحديثهم أو حذفهم والتسجيلات التي يمكنه إدارتها.
|
ملاحظة: الاسم الأول للمستخدم واسم عائلته لا يعتمدان الأحرف الآتية \ / : * ؟ " < > | @ , ; اسم المستخدم ومعرِّف الوحدة التنظيمية المحدد المعرف لا يدعمان الأحرف الآتية: / : * ؟ " < > | ' , ; عنوان البريد الإلكتروني للمستخدمين لا يدعم الأحرف الآتية: ( ) < > [ ] | \ ; : , “ |
يمكن لـ 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. يجب إرسال التسجيلات عند إجراء تغييرات في نظام المعلومات لتعكس تلك التغييرات بدقة في Brightspace. يجب إرسال طلب إلغاء التسجيل مرة واحدة فقط. وتؤدي إعادة إرسال إلغاء التسجيل إلى تسجيل تحذير في سجل حزمة التكامل لأنظمة معلومات الطالب.
يمكن لـ D2L Standard CSV القيام بالآتي:
- تسجيل المستخدمين وإلغاء تسجيلهم في الوحدات التنظيمية (الإصدار 2.0 أو أعلى) أو أقسام المقرر التعليمي فقط (الإصدار 1.0 و1.1).
قواعد سمات لوحة معلومات المدير ومجموعات التعلّم
باستخدام D2L Standard CSV، يمكن لسمات لوحة معلومات المدير ومجموعات التعلّم القيام بالآتي:
- إنشاء بنية التقارير المستخدمة ضمن لوحة معلومات المدير
- توفير سمات للسماح بإنشاء قواعد العضوية التلقائية في مجموعات التعلّم
لا تقوم سمات لوحة معلومات المدير ومجموعات التعلّم عبر D2L Standard CSV بما يلي:
- إنشاء حسابات مستخدمين جديدة.