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