С помощью средств командной строки для файлов курса администраторы могут выполнять такие операции:

  • создавать резервные копии содержимого раздела файлов курса для одного курса или более с помощью команды 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 Укажите уникальный идентификатор пакета источника данных, чтобы получить список курсов.
--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 Укажите уникальный идентификатор пакета источника данных, чтобы получить список курсов.
    --r Укажите название роли, чтобы изменить ее разрешения, как указано в операциях --o и --p.
    --p Укажите разрешения, которые необходимо добавить, удалить или сбросить, как указано в операции --o. Допустимые значения:
    • R: чтение;
    • W: запись;
    • D: удаление;
    • M: управление.

    Объединением значений можно определить несколько разрешений. Например, чтобы изменить разрешения на чтение и запись для роли, используйте запись RW.
    --o Укажите операцию, которую необходимо выполнить.
    • add: добавляет разрешения, указанные в операции --p.
    • remove: удаляет разрешения, указанные в операции --p.
    • reset: сбрасывает разрешения, указанные в операции --p.
    --f Укажите имя файла-источника, содержащего список идентификаторов всех курсов, ролей, разрешений, операций и флагов рекурсии. Например:
    courseId1|Instructor|RDM|add|y
    courseId2|Course Builder|RD|reset|n
    Эта опция позволяет администраторам указывать в создаваемом ими файле-источнике любую группу курсов, для которых нужно выполнить операцию. По существу это двухступенчатый процесс:
    • создайте файл-источник с помощью базы данных;
    • выполните командную строку для файла-источника.

    Преимущество использования файла-источника для администраторов в том, что они получают запись со всеми курсами, для которых была сделана попытка выполнения операции.
    --e Флаг рекурсии «y» или «n»

    у — изменения разрешений рекурсивно применяются к основной папке курса и ее подпапкам и файлам;

    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

Изменить разрешения для каталога /courses

Команда 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

    Команды для изменения разрешений в каталоге /courses
    Операция Описание
    --r Укажите название роли, чтобы изменить ее разрешения, как указано в операциях --o и --p.
    --p Укажите разрешения, которые необходимо добавить, удалить или сбросить, как указано в операции --o. Допустимые значения:
    • R: чтение;
    • W: запись;
    • D: удаление;
    • M: управление.

    Объединением значений можно определить несколько разрешений. Например, чтобы изменить разрешения на чтение и запись для роли, используйте запись RW.
    --o Укажите операцию, которую необходимо выполнить.
    • add: добавляет разрешения, указанные в операции --p.
    • remove: удаляет разрешения, указанные в операции --p.
    • reset: сбрасывает разрешения, указанные в операции --p.
    --e

    Флаг рекурсии «y» или «n»

    у — изменения разрешений рекурсивно применяются к основной папке курса и ее подпапкам и файлам;

    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специальных возможностей Ally.

Если ваше учреждение имеет лицензию на управление содержимым, администратор может выбрать в коллекции материалов одну папку назначения для перемещения всего содержимого, для имени которой используется формат Course_ID_ImportedContent_DATETIMESTAMPспециальных возможностей Ally.

  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 Укажите пакетный уникальный идентификатор, чтобы получить список курсов.
--d Укажите уникальный идентификатор пакета источника данных, чтобы получить список курсов.
--f

Укажите имя файла-источника, содержащего список идентификаторов всех курсов или уникальных идентификаторов пакетов и каталоги назначения для них. В файле-источнике не используется разделитель, вместо него необходимо указывать верхний колонтитул, который, в свою очередь, определяет, какой столбец соответствует идентификатору курса или уникальному идентификатору пакета. Например:

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