管理员可以使用课程文件命令行工具进行以下操作:

  • 使用 backup_course_files命令备份一个或多个课程的课程文件内容。
  • 使用 update-course-directory命令更改一个或多个课程的默认目录。
  • 使用 update-course-permission命令更改个别课程目录的权限。
  • 使用 update-all-course-hd-permission命令更改 /courses 目录的权限。
  • 使用 MoveCourseContent命令将一个或多个课程的内容移动到课程文件。

备份一个课程的课程文件内容

使用 backup_course_files命令,管理员可以将课程文件从单个课程解压缩到选定的目录,以进行备份。

如果您的机构许可资源管理,则仅在课程的默认目录未更改的情况下管理员可以使用此命令。管理员可以使用现有的孤立搜索来查找与已删除课程相关联的文件。To learn more, see Managing Orphaned Content.

  1. 从命令行中,更改为以下目录,其中 BLACKBOARDBlackboard 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. 从命令行中,更改为以下目录,其中 BLACKBOARDBlackboard 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提供课程的课程 ID。
--d提供数据源批处理 UID 以获得课程列表。
--f提供包含每个课程 ID 及其目标课程目录的列表的馈送文件的名称。例如: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. 从命令行中,更改为以下目录,其中 BLACKBOARDBlackboard 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提供课程的课程 ID。
    --d提供数据源批处理 UID 以获得课程列表。
    --r按照 --o--p 操作中定义的内容,提供更改其权限的角色名称。
    --p按照 --o操作中定义的内容,提供添加、删除或重置的权限。有效值:
    • R:读取
    • W:写入
    • D:删除
    • M:管理

    可以通过将值进行组合来定义多种权限。例如,要更改某个角色的读取和写入权限,请使用RW

    --o提供要执行的操作:
    • add:添加 --p操作中定义的权限。
    • remove:删除 --p操作中定义的权限。
    • reset:重置 --p操作中定义的权限。
    --f提供包含每个课程 ID、角色、权限和操作和递归标记的馈送文件的名称。例如:
    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


更改 /courses 目录的权限

使用 update-all-course-hd-permission命令,管理员可以更改 /courses 目录的权限。

  1. 从命令行中,更改为以下目录,其中 BLACKBOARDBlackboard 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”

    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

如果您的机构许可资源管理,管理员可在资源库中定义单个目标文件夹,以将所有内容都移动到该文件夹。子文件夹将使用以下格式命名:Course_ID_ImportedContent_DATETIMESTAMP

  1. 从命令行中,更改为以下目录,其中 BLACKBOARDBlackboard 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提供课程的课程 ID。
--b提供批处理 UID 以获得课程列表。
--d提供数据源批处理 UID 以获得课程列表。
--f

提供包含每个课程 ID 或批处理 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