التخطي إلى المحتوى الرئيسي
pdf?stylesheet=default
Blackboard Help

أدوات سطر أوامر ملفات الدورة التدريبية

يمكن أن يستخدم المسؤولون أدوات سطر أوامر "ملفات الدورة التدريبية لـ:

  • إجراء نسخ احتياطي لمحتوى ملفات الدورة التدريبية لدورة تدريبية واحدة أو أكثر باستخدام الأمر backup_course_files.
  • تغيير الدلائل الافتراضية لدورة تدريبية واحدة أو أكثر باستخدام الأمر update-course-directory.
  • تغيير الأذونات الخاصة بدلائل الدورة التدريبية الفردية باستخدام الأمر update-course-permission.
  • تغيير الأذونات الخاصة بدليل /courses باستخدام الأمر update-all-course-hd-permission.
  • نقل المحتوى لدورة تدريبية واحدة أو أكثر إلى ملفات الدورة التدريبية باستخدام الأمر MoveCourseContent.

كيفية إجراء نسخ احتياطي لمحتوى ملفات الدورة التدريبية لدورة تدريبية واحدة

يُمكن الأمر backup_course_files المسؤولين من استخراج ملفات الدورة التدريبية من دورة تدريبية واحدة إلى دليل محدد للنسخ الاحتياطي.

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

  1. من سطر الأوامر، قم بالتغيير إلى الدليل التالي، حيث إن BLACKBOARD هو موقع تثبيت Blackboard Learn:

    بناء جملة UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    بناء جملة Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. من هذا الدليل، اكتب الأمر والعمليات التالية:

    backup_course_files.[sh|bat] COURSE_ID BACKUP_DIRECTORY

    مثال UNIX:

    backup_course_files.sh Course001 /backups

    مثال Windows:

    backup_course_files.bat Course001 c:\backups

كيفية تغيير الدلائل الافتراضية

يُمكن الأمر update-course-directory المسؤولين من تغيير الدلائل الافتراضية لدورة تدريبية واحدة أو أكثر.

  1. من سطر الأوامر، قم بالتغيير إلى الدليل التالي، حيث إن BLACKBOARD هو موقع تثبيت Blackboard Learn:

    بناء جملة UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    بناء جملة Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin
     

  2. من هذا الدليل، اكتب الأمر باستخدام العملية المناسبة:
    • إعادة تعيين الدليل لدورة تدريبية واحدة:
      update-course-directory.[sh|bat] --c COURSE_ID --p COURSE_DIRECTORY
    • إعادة تعيين الدليل لمجموعة من الدورات التدريبية باستخدام مصدر بيانات:
      update-course-directory.[sh|bat] --d DATA_SOURCE_BUID --p COURSE_DIRECTORY
    • إعادة تعيين الدلائل لمجموعة من الدورات التدريبية باستخدام ملف مخزن البيانات:
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
أوصاف العملية
العملية الوصف
--c لتوفير معرف الدورة التدريبية لدورة تدريبية.
--d لتوفير معرف البيانات الفريد UID الدُفعي لمصدر البيانات للحصول على قائمة الدورات التدريبية.
--f لتوفير اسم ملف مخزن البيانات الذي يحتوي على قائمة لكل معرف دورة تدريبية ودليل الدورة التدريبية الهدف الخاص به. على سبيل المثال: courseId1|/courses/Files
courseId2|/institution/Files
يسمح هذا الخيار للمسؤولين بتشغيل العملية في مقابل مجموعة من الدورات التدريبية التي يحددوها في ملف تخزين البيانات. وبشكل أساسي تتألف هذه العملية من خطوتين:
  • إنشاء ملف مخزن البيانات باستخدام قاعدة البيانات.
  • تشغيل سطر الأوامر بملف مخزن البيانات.
ترجع فائدة استخدام ملف مخزن البيانات إلى حصول المسؤولين على سجل للدورات التدريبية تمت محاولة إجراء العملية بناءً عليه.
--p لنقل المحتوى إلى موقع بخلاف دليل الدورة التدريبية الافتراضي، أدخل دليل الدورة التدريبية الهدف.

مثال:

update-course-directory.sh --c Course001 --p /courses/Files
update-course-directory.sh --d DATA_SOURCE_BUID --p /institution/Files
update-course-directory.bat --f c:\feedfile.txt

كيفية تغيير الأذونات الخاصة بدلائل الدورة التدريبية الفردية

يُمكن الأمر update-course-permission المسؤولين من تغيير الأذونات الخاصة بدلائل الدورة التدريبية الفردية.

  1. من سطر الأوامر، قم بالتغيير إلى الدليل التالي، حيث إن BLACKBOARD هو موقع تثبيت Blackboard Learn:

    بناء جملة UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    بناء جملة Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. من هذا الدليل، اكتب الأمر باستخدام العملية المناسبة:
    • تغيير الأذونات الخاصة بدورة تدريبية واحدة:
      update-course-permission.[sh|bat] --c COURSEID --r ROLE --p PERMISSIONS --o OPERATION --e RECURSIVEFLAG
    • تغيير الأذونات لمجموعة من الدورات التدريبية باستخدام مصدر بيانات:
      update-course-permission.[sh|bat] --d DATA_SOURCE_BUID --r ROLE --p PERMISSIONS --o OPERATION
    • تغيير الأذونات لمجموعة من الدورات التدريبية باستخدام ملف مخزن البيانات:
      update-course-permission.[sh|bat] --f FEED_FILE_NAME
    تغيير أوامر الأذونات
    العملية الوصف
    --c لتوفير معرف الدورة التدريبية لدورة تدريبية.
    --d لتوفير معرف البيانات الفريد UID الدُفعي لمصدر البيانات للحصول على قائمة الدورات التدريبية.
    --r لتوفير اسم الدور لتغيير الإذن الخاص به كما تم تعريفه في العمليتين --o و --p.
    --p لتوفير الأذونات المراد إضافتها، أو إزالتها، أو إعادة تعيينها كما تم تعريفها في العملية --o. القيم الصالحة:
    • R: قراءة
    • W: كتابة
    • D: حذف
    • M: إدارة

    يمكن تعريف العديد من الأذونات بواسطة الجمع بين القيم. على سبيل المثال، لتغيير أذونات القراءة والكتابة لأحد الأدوار، استخدم RW.

    --o لتوفير العملية المراد تنفيذها:
    • إضافة: يُضيف الأذونات التي تم تعريفها في العملية --p.
    • إزالة: يُزيل الأذونات التي تم تعريفها في العملية --p.
    • إعادة تعيين: يُعيد تعيين الأذونات التي تم تعريفها في العملية --p.
    --f لتوفير اسم ملف تخزين البيانات الذي يحتوي على قائمة لكل معرف دورة تدريبية، ودور، وأذن وعملية وعلامة تحديث. على سبيل المثال:
    courseId1|Instructor|RDM|add|y
    courseId2|Course Builder|RD|reset|n
    يسمح خيار ملف مخزن البيانات للمسؤولين بتحديد أي مجموعة من الدورات التدريبية يريدون تشغيل العملية في مقابلها داخل أحد الملفات التي يقومون بإنشائها. وبشكل أساسي تتألف هذه العملية من خطوتين:
    • إنشاء ملف مخزن البيانات باستخدام قاعدة البيانات.
    • تشغيل سطر الأوامر بملف مخزن البيانات.

    ترجع فائدة استخدام ملف مخزن البيانات إلى حصول المسؤولين على سجل للدورات التدريبية تمت محاولة إجراء العملية بناءً عليه.

    --e علامة تحديث "y" أو "n"

    y = يتم تكرار تغييرات الإذن على نفس المجلد الرئيسي والمجلدات والملفات الفرعية.

    n= يتم تنفيذ تغييرات الإذن مرة واحدة فقط على مجلد الدورة التدريبية الرئيسي.

     

    update-course-permission.bat --c Test001 --r Instructor --p RWD --o add
    update-course-permission.sh --c Test002 --r Course Builder --p RWDM --o reset
    update-course-permission.bat --c Test003 --r Student --p RW --o remove
    update-course-permission.sh --d DATA_SOURCE_BUID --r Instructor --p RDM --o reset
    update-course-permission.bat --f c:\feedfile.txt

كيفية تغيير الأذونات الخاصة بالدليل /دورات تدريبية

يُمكن الأمر update-all-course-hd-permission المسؤولين من تغيير الأذونات الخاصة بالدليل /courses.

  1. من سطر الأوامر، قم بالتغيير إلى الدليل التالي، حيث إن BLACKBOARD هو موقع تثبيت Blackboard Learn:

    بناء جملة UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    بناء جملة Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin
     

  2. من هذا الدليل، اكتب الأمر باستخدام العملية المناسبة:

    update-all-course-hd-permission.[sh|bat] --r ROLE --p PERMISSIONS --o OPERATION

    تغيير الأذونات في أوامر الدليل /دورات تدريبية
    العملية الوصف
    --r لتوفير اسم الدور لتغيير الإذن الخاص به كما تم تعريفه في العمليتين --o و --p.
    --p لتوفير الأذونات المراد إضافتها، أو إزالتها، أو إعادة تعيينها كما تم تعريفها في العملية --o. القيم الصالحة:
    • R: قراءة
    • W: كتابة
    • D: حذف
    • M: إدارة

    يمكن تعريف العديد من الأذونات بواسطة الجمع بين القيم. على سبيل المثال، لتغيير أذونات القراءة والكتابة لأحد الأدوار، استخدم RW.

    --o لتوفير العملية المراد تنفيذها:
    • إضافة: يُضيف الأذونات التي تم تعريفها في العملية --p.
    • إزالة: يُزيل الأذونات التي تم تعريفها في العملية --p.
    • إعادة تعيين: يُعيد تعيين الأذونات التي تم تعريفها في العملية --p.
    --e

    علامة تحديث "y" أو "n"

    y = يتم تكرار تغييرات الإذن على نفس المجلد الرئيسي والمجلدات والملفات الفرعية.

    n= يتم تنفيذ تغييرات الإذن مرة واحدة فقط على مجلد الدورة التدريبية الرئيسي.

     

    update-all-course-hd-permission.bat --r Instructor --p RWD --e n --o add
    update-all-course-hd-permission.sh --r Course Builder --p RWDM --e y --o reset
    update-all-course-hd-permission.bat --r Student --p RW --e y --o remove

كيفية نقل المحتوى من دورة تدريبية واحدة أو أكثر

عند الترقية من أحد إصدارات Blackboard Learn التي تسبق الإصدار 9.1، يستطيع المسؤولون نقل محتوى الدورة التدريبية الموجودة إلى دليل ملفات الدورة التدريبية للاستفادة من إمكاناته. يُمكن الأمر MoveCourseContent المسؤولين من إجراء نقل دُفعي لمحتوى الدورة التدريبية إلى ملفات الدورة التدريبية. يتم تخزين كل المحتوي الذي تم نقله إلى "ملفات الدورة التدريبية" في مجلد فرعي من الدليل /courses/CourseID. تتم تسمية المجلد الفرعي باستخدام التنسيق التالي: Course_ ID_ImportedContent_DATETIMESTAMP.

في حالة قيام جامعتك بترخيص إدارة المحتوى، يحدد المسؤولون مجلد وجهة واحد في Content Collection حيث سيتم نقل المحتوى كله. تتم تسمية المجلد الفرعي باستخدام التنسيق التالي: Course_ID_ImportedContent_DATETIMESTAMP.

  1. من سطر الأوامر، قم بالتغيير إلى الدليل التالي، حيث إن BLACKBOARD هو موقع تثبيت Blackboard Learn:

    بناء جملة UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    بناء جملة Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. من هذا الدليل، اكتب الأمر باستخدام العملية المناسبة:
    • نقل الملفات لدورة تدريبية واحدة:
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • نقل الملفات لمجموعة من الدورات التدريبية باستخدام دُفعة:
      MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
    • نقل الملفات لمجموعة من الدورات التدريبية باستخدام مصدر بيانات:
      MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
    • نقل الملفات لمجموعة من الدورات التدريبية باستخدام ملف مخزن البيانات:
      MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]
نقل أوامر المحتوى
العملية الوصف
--c لتوفير معرف الدورة التدريبية لدورة تدريبية.
--b لتوفير UID الخاص بالدُفعة للحصول على قائمة الدورات التدريبية.
--d لتوفير معرف البيانات الفريد UID الدُفعي لمصدر البيانات للحصول على قائمة الدورات التدريبية.
--f

لتوفير اسم ملف مخزن البيانات الذي يحتوي على قائمة لكل معرف دورة تدريبية أو UID خاص بالدُفعة ودليل الدورة التدريبية الهدف الخاص به. لا يستخدم ملف مخزن البيانات فاصلاً، ولذا يجب تحديد الرأس كبديل، والذي بدوره يقوم بتوضيح العمود المتوفر من أجل course_id أو batch_uid. على سبيل المثال:

batch_uid
crs_batch-UID

أو

course_id
crs_course-ID

أو

***FileHeader
course_id
crs_course-ID
***FileFooter


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

  • إنشاء ملف مخزن البيانات باستخدام قاعدة البيانات.
  • تشغيل سطر الأوامر بملف مخزن البيانات.

ترجع فائدة استخدام ملف مخزن البيانات إلى حصول المسؤولين على سجل للدورات التدريبية تمت محاولة إجراء العملية بناءً عليه.

--p لنقل المحتوى إلى موقع خلاف دليل الدورة التدريبية الافتراضي، أدخل الدليل الهدف.

 

MoveCourseContent.sh --c Course001
MoveCourseContent.sh --c Course002 --p /institution/Course002<
MoveCourseContent.bat --b BATCH_UID
MoveCourseContent.bat --d DATA_SOURCE_BUID
MoveCourseContent.bat --f c:\feedfile.txt --p c:\institution\All