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

  • создавать резервные копии содержимого раздела файлов курса для одного курса или более с помощью команды backup_course_files;
  • изменять папки по умолчанию для одного курса или более с помощью команды update-course-directory;
  • изменять разрешения для каталогов отдельного курса с помощью команды update-course-permission;
  • изменять разрешения для каталога /courses с помощью команды update-all-course-hd-permission;
  • перемещать содержимое одного курса или более с помощью команды MoveCourseContent.

Резервное копирование содержимого файлов одного курса

С помощью команды backup_course_files администраторы могут создать резервную копию файлов курса отдельного курса в выбранном каталоге.

Если ваше учреждение лицензирует управление содержимым, администраторы могут применять эту команду только при условии, что папка курса по умолчанию не изменялась. Администраторы могут использовать поиск потерянного содержимого, чтобы обнаружить файлы, связанные с курсом, который был удален. Подробнее см. в разделе Управление потерянным содержимым.

  1. From a command line, change to the following directory, where BLACKBOARD is the Blackboard Learn installation location:

    Синтаксис 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. From a command line, change to the following directory, where BLACKBOARD is the Blackboard Learn installation location:

    Синтаксис 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: read
    • W: write
    • 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: read
    • W: write
    • 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.

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

  1. From a command line, change to the following directory, where BLACKBOARD is the Blackboard Learn installation location:

    Синтаксис 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