在 Blackboard Learn 中,导出和存档课程有两种不同的目的:

  • 因要在以后重复使用课程资料教授另一组学生而导出课程。
  • 因要保存课程记录而存档课程。

有关根据模版和导出压缩包创建课程(导入课程)的更多信息

导出课程将创建 ZIP 文件格式的课程资源(称为课程压缩包)。可以将课程压缩包导回 Blackboard Learn 中,以创建具有相同内容的新课程。导出课程仅包含课程资源。导出课程不包含任何用户交互,如博客帖子或成绩。

存档课程将创建 ZIP 文件形式的课程资源和用户交互(称为存档压缩包)。可以恢复存档压缩包,但存档压缩包预期不用于再次教授课程,并将恢复所有用户交互。将存档压缩包存储在安全的位置。

请勿解压缩课程或存档压缩包。请勿删除压缩包中的文件或尝试导入压缩包中包含的文件。只有压缩包完整无缺,才能导入或恢复课程。编辑 ZIP 文件后导入或恢复压缩包将导致课程中出现不稳定和不可预知的行为。

可以将旧版 Blackboard Learn 中的课程或存档压缩包导入当前版本。但是,您无法将从新版本中导出的压缩包导入旧版本中。


所需用户权限

若要在导出或存档课程时包括课程压缩包中的课程文件,创建该压缩包的用户必须拥有该课程文件夹的管理权限。

若要在导入或恢复课程时将课程压缩包中的课程文件添加到目标文件夹中,执行该操作的用户必须拥有该课程文件夹的管理权限。

如果您的机构有权访问资源管理,则拥有读取权限的用户可以在执行导入\导出或存档\恢复操作时包含指向课程文件的链接。具有管理权限的用户可以将指向课程文件和课程文件副本本身的链接包含在内。

如果导入或恢复课程的用户没有管理权限,则压缩包的某些内容可能无法成功上传。

导入或恢复压缩包后,指向在创建压缩包时未包含在内的文件的链接将无效。例如,如果课程区链接到某测试,但压缩包不包含测试、调查和题库,则指向该测试的链接在新课程中将无效。

所有课程用户都拥有压缩包中所包含课程文件的读取权限。具有以下角色的用户拥有管理权限:

  • 教师
  • 课程内容构建者
  • 助教

有关创建课程压缩包时所包含的内容的更多信息 


内容类型可用性

在 Blackboard Learn 9.1 SP 4 之前,导出或存档课程时仅可用项包含在课程压缩包中。从 SP 4 之前的环境导入课程压缩包时,不可用的项可能变为可用,因为压缩包中不包含不可用项。Blackboard Learn 无法区分导出过程中忽略的不可用课程工具与旧版本中未出现且默认设置为可用的任何新项目。在 9.1 SP 4 之后的版本中,将在导出压缩包中跟踪和维护在课程级别设为可用和不可用的确切设置。


存档课程

存档压缩包的文件命名结构如下:

ArchiveFile_Course_ID_date/time_stamp.zip

Blackboard Learn 包装格式遵循“IMS 压缩包装规范”,其扩展标准支持 Blackboard Learn 的特定内容类型。要详细了解如何以 Common Cartridge 格式导出课程,请参阅 Common Cartridge 课程压缩包

  1. 管理员面板课程区域中,选择课程
  2. 指向备份操作并选择将课程存档
  3. 源课程 ID 方框中,键入一个有效的课程 ID。如果您不知道确切的课程 ID,请选择浏览以搜索课程。要了解详情,请参阅搜索课程
  4. 包括成绩中心历史记录,请选中课程 ID 后面的复选框。选择此选项会增加文件大小和处理时间。
  5. 文件附件区域中,选择是仅包含指向课程文件的链接,还是包含课程文件内容的链接和副本。

    如果您选择复制链接并包含内容副本,请选择计算大小以确保压缩包大小未超过所显示的压缩包大小上限。要从压缩包中删除文件和文件夹,请选择管理压缩包内容

  6. 选择提交。Blackboard Learn 将创建存档压缩包并向您的 Blackboard Learn 帐户发送电子邮件。此电子邮件包含指向压缩包日志文件内容的链接,并确认已准备好存档压缩包。
  7. 转到您的 Blackboard Learn 电子邮件帐户,并确认已收到确认电子邮件。
  8. 管理员面板课程区域中,选择课程
  9. 搜索已存档的课程。
  10. 打开课程的菜单并选择导出/存档导出/存档页将列出此课程中尚未从 Blackboard Learn 中删除的所有导出或存档压缩包,即使您已下载压缩包。文件名包含压缩包的创建日期和时间。
  11. 打开 ZIP 文件的菜单并选择打开
  12. 打开文件对话框中,依次选择保存文件确定,将存档压缩包下载到您的计算机。
  13. 打开 ZIP 文件的菜单并选择删除,将压缩包从 Blackboard Learn 中永久删除(可选)。

课程资料夹信息包括在存档中且可以恢复,但 SafeAssign 作业未包括在存档中且无法恢复。有关详细信息,请参阅 SafeAssign

存档交叉列出的课程的方法将用于存档父课程。只有父课程有内容,而存档父课程包括子课程。不需要存档子课程,因为它仅包含注册。

已禁用的用户 ID 所进行的禁用注册和注册不包括在存档压缩包内。 不可用的注册或用户包括在内。


导出课程

您可以通过导入已导出的课程来创建新课程。要了解详情,请参阅根据模版和导出压缩包创建课程(导入课程)

Blackboard Learn 包装格式遵循“IMS 压缩包装规范”,其扩展标准支持 Blackboard Learn 的特定内容类型。要详细了解如何以 Common Cartridge 格式导出课程,请参阅创建 Common Cartridge 课程压缩包

  1. 管理员面板课程区域中,选择课程
  2. 指向备份操作并选择导出课程
  3. 源课程 ID 方框中,键入一个有效的课程 ID。如果您不知道确切的课程 ID,请选择浏览以搜索课程。要了解详情,请参阅搜索课程
  4. 选择提交
  5. 导出课程页面,选择是仅包含指向课程文件的链接,还是包含课程文件内容的链接和副本。
    如果您选择复制链接并包含内容副本,请选择计算大小以确保压缩包大小未超过所显示的压缩包大小上限。要从压缩包中删除文件和文件夹,请选择管理压缩包内容
  6. 选择课程资料区域中,选中每个要导出的课程区和工具的复选框。要详细了解每个项目所含的内容,请参阅创建课程
  7. 选择提交

关于恢复课程

恢复课程会将存档压缩包上传到 Blackboard Learn 中,其状态与存档时的状态相同。存档压缩包中包含课程内容(如果您的机构有权访问门户管理,则包含所有课程资料夹)、用户数据和用户互动。

存档压缩包被设计用于提供课程的永久记录。若要保存课程资料,以便今后利用这些资料教授另一组学生,请导出而非归档课程。要了解详情,请参阅根据模版和导出压缩包创建课程(导入课程)

恢复课程后,存档压缩包中指定的设置和选项将替换对新课程有效的默认设置和课程菜单选项。

可能不支持在旧版 Blackboard Learn 中创建的课程压缩包。请参阅您所用版本的版本说明,以了解支持版本的列表。

恢复课程的大小限制

通过用户界面上传的内容默认大小限制为 2.5 GB。若尝试使用此界面上传大于 2.5 GB 的文件,用户将收到错误提示。此限制不适用于 Web 文件夹或共享位置 (WebDAV) 上传。

要上传更大的文件,管理员可以使用命令行来上传文件,或者可以提高 Tomcat 默认大小设置。

要提高最大上传限制,请打开 config/bb-config.properties 并修改上传限制参数。文件大小上传限制与 Tomcat 相关,因此 WebDAV 上传不会出现此问题。由于此设置与 Tomcat 有关,因此要使更改生效,则必须重启此服务。

也可以从“系统管理”面板增加最大上传压缩包大小。选择课程设置 > 默认课程大小限制,然后键入新大小或选择无限制

恢复用户记录

执行恢复操作时,Blackboard Learn 会通过验证用户名和相应的电子邮件地址,来检查用户是否存在于系统中。

如果现有用户名的电子邮件地址与存档压缩包中的电子邮件地址不同,则 Blackboard Learn 会创建一个新用户帐户。新帐户采用相同的用户名并附加一个序列号。

如果与现有用户名及其电子邮件地址相同,则 Blackboard Learn 不会创建新用户。

如果用户帐户已存在,但是该帐户已被禁用,则 Blackboard Learn 会创建新用户帐户。为避免在系统上创建另一个用户,原始用户帐户必须能够启用。

示例:使用用户名为 bb_user 的帐户上传某个存档压缩包。恢复过程会在 Blackboard Learn 中查找具有此用户名的用户。如果系统中存在 bb_user,则该过程就会比较电子邮件地址。如果电子邮件地址匹配,则该过程会对现有用户 (bb_user) 在 course_users 中创建新注册记录。如果电子邮件地址不同,则该过程会创建新用户 (bb_user1)。

作为一项安全注意事项,任何在恢复过程中添加的用户在创建后都只具有其主要的系统角色。次要系统角色将不会包括在内。


恢复课程

  1. 管理员面板课程区域中,选择课程
  2. 搜索课程。要了解详情,请参阅搜索课程
  3. 指向创建课程并选择恢复。下表介绍了可用的字段。[r] 表示必填字段。
    恢复课程可用字段
    现场说明
    目标课程 ID键入新的课程 ID。Blackboard Learn 使用存档压缩包中的数据和设置创建课程。

    课程 ID 可以包含数字、字母、连字符 (-)、下划线 (_) 和句号 (.)。禁止包括空格在内的其他所有字符。

    课程 ID 设置好后,不能进行更改。

    此字段为可搜索字段。

    选择压缩包提供存档压缩包的确切文件位置或选择浏览我的电脑以导航至该文件。
    包含资源库文件的文件夹此字段仅在您的机构有权访问资源管理时显示。

    若要将资源库文件排除在恢复过程之外,请选择课程文件默认目录

    要将资源库文件包含在恢复过程中,请选择选择文件夹。选择浏览以导航至该文件夹。Blackboard Learn 将创建一个子文件夹,并将资源库文件复制到该子文件夹中。

  4. 选择提交

查看导出和存档日志

  1. 管理员面板课程区域中,选择课程
  2. 搜索课程。要了解详情,请参阅搜索课程
  3. 打开课程的菜单并选择导出/存档导出/存档课程页将列出此课程中尚未从 Blackboard Learn 中删除的所有导出或存档压缩包,即使您已下载压缩包。文件名包含压缩包的创建日期和时间。
  4. 打开 ZIP 文件的菜单。
  5. 若要查看内容包的创建日期、时间和状态,请选择查看基本日志
  6. 若要查看内容包的创建日期和时间、状态以及内容包所包含课程资料的列表,请选择查看详细日志

批导出、存档和恢复课程

Blackboard Learn 包含 batch_ImportExport 工具,用于同时处理大量课程的导入/导出和存档/恢复,以及超过默认最大上传限制的文件的导入/恢复。

此工具处理包含课程 ID 及 ZIP 压缩包完整路径的批处理文件。

默认最大上传限制

通过用户界面上传的内容默认大小限制为 2.5 GB。若尝试使用此界面上传大于 2.5 GB 的文件,用户将收到错误提示。此限制不适用于 Web 文件夹或共享位置 (WebDAV) 上传。

要上传更大的文件,管理员可以使用命令行来上传文件,或者可以提高 Tomcat 默认大小设置。

要提高最大上传限制,请打开 config/bb-config.properties 并修改上传限制参数。文件大小上传限制与 Tomcat 相关,因此 WebDAV 上传不会出现此问题。由于此设置与 Tomcat 有关,因此要使更改生效,则必须重启此服务。

也可以从“系统管理”面板增加最大上传压缩包大小。选择课程设置 > 默认课程大小限制,然后键入新大小或选择无限制


创建用于导出/存档及导入/恢复的批处理文件

用于 batch_ImportExport 工具的批处理文件每行只有两个值:课程 ID 和 ZIP 压缩包的完整路径。

  • 执行导出或存档操作时,Blackboard Learn 将使用指定路径和文件名创建 ZIP 压缩包。
  • 执行导入或恢复操作时,指定路径和文件名指向与目标课程 ID 相关联的 ZIP 压缩包。

以下举例说明 batch_ImportExport 工具使用的批处理文件的内容。将批处理文件保存为文本 (TXT) 文件。

示例:导出和存档批处理文件

导出和存档批处理文件仅需要输入指向将存储各个压缩包的目录的路径。不包含压缩包名称。添加压缩包名称会导致错误。

有三种可选布尔标记用于指定包选项。

  • 选项 1:指定对或错,以表明是否存档/导出在课程主目录下找到的课程文件。如果未指定值,默认为对。
  • 选项 2:指定对或错,以表明是否存档/导出评分历史记录。如果未指定值,默认为错。
  • 选项 3:指定对或错,以表明是否存档/导出在课程主目录外找到的课程文件。如果未指定值,默认为错。

HIST101, C:\Course_archives\,true,true,true
HIST201, C:\Course_archives\,true,,true
HIST301, C:\Course_archives\,true,false,true
HIST401, C:\Course_archives\</p>

示例:导入和恢复批处理文件

导入和恢复批处理文件需要输入确切的文件路径,包括压缩包的名称。

HIST101, C:\Course_archives\Archive_File_HIST101.zip
HIST201, C:\Course_archives\Archive_File_HIST201.zip
HIST301, C:\Course_archives\Archive_File_HIST301.zip
HIST401, C:\Course_archives\Archive_File_HIST401.zip
HIST331, C:\Course_archives\Archive_File_HIST331.zip


运行批处理工具

运行导入/导出和存档/恢复功能的批处理工具必须从命令行运行。该工具还必须从 Web/应用服务器运行。命令语法如下所示。

Windows 语法

C:\Blackboard\apps\content-exchange\bin\batch_ImportExport.bat -f path_to_file -l delimiter -t operation -n virtual_hostname -c cartridge_version

使用 cmd.exe打开运行工具的命令行。从 command.exe 运行工具会导致错误。

UNIX 语法

/usr/local/blackboard/apps/content-exchange/bin/batch_ImportExport.sh -f path_to_file -l delimiter -t operation -n virtual_hostname -c cartridge_version

根据 Blackboard Learn 的安装位置不同,指向 Blackboard 目录的确切路径可能会有所不同。

指向 Blackboard 目录的路径
参数说明
path_to_file提供批处理文件的完整路径。
分隔符提供以下任意值:
  • 1:将逗号 (,) 用作分隔符。
  • 2:将分号 (;) 用作分隔符。
  • 3:将制表符用作分隔符。
operation提供以下其中一个区分大小写的值,以指示正在执行的操作:
  • import
  • export
  • restore
  • archive
virtual_hostname工具运行时所在的虚拟安装的名称。如果没有虚拟安装,或没有给出此参数,则工具将在默认虚拟安装中运行。
cartridge_version当您希望导出 Common Cartridge 时,请使用此变量。此标记为可选,如果您正在创建正常的 Blackboard 导出,则此标记可以完全停止。此标记仅在当 Export用于 operation 命令时才有效。如果未提供此选项,则 operation 会将压缩包当作 Learn 压缩包来处理。受支持的常见资料夹版本为 1.0、1.1 和1.2。

馈送文件第四列中可选的对/错参数可用于 batch_ImportExport 操作。此参数仅用于存档操作且控制着压缩包中是否包含成绩中心历史纪录。


为 batch_ImportExport 工具自定义 JVM 堆大小

  1. 打开 batch_ImportExport.batbatch_ImportExport.sh 文件以进行编辑。
  2. 添加 $OPTS%OPTS 参数,以包含定制的 JVM 堆栈大小。语法如下所示。以下示例使用的 JVM 堆栈大小为 6 GB,应对其进行更改,以满足机构的要求。

    Windows 语法

    OPTS="%OPTS -Xmx6g"

    UNIX 语法

    OPTS="$OPTS -Xmx6g"


用于导入和恢复课程的支持路径

下表标识用于导入和恢复从较旧学习管理系统导出或存档的课程的支持路径。经认证的路径由 Blackboard 进行完整测试并支持。可兼容的路径未进行完整测试,但是根据过去的性能应可正常运行。

用于导入和恢复课程的路径不向后兼容。课程可以导入或恢复到较新版本中,但是来自较新版本的课程不能导入或恢复到较早版本中。

用于导入和恢复课程的支持路径
来源支持
Blackboard Learn 9.1 版经认证
Blackboard Learn 9.0 版经认证
Blackboard Academic Suite 8 版经认证
Blackboard Academic Suite 7 版经认证
Blackboard Academic Suite 6 版经认证
Blackboard ML经认证
Blackboard 5.5*经认证
Blackboard 5.0*兼容
CourseInfo 4不支持
Blackboard Vista 和 CE 8.0.5 或更高版本经认证
Blackboard Campus 4.1.7 版经认证
ANGEL LMS 7.3不支持
ANGEL LMS 7.4经认证
ANGEL LMS 8.0经认证

*Blackboard 5 和 Blackboard 5.5 不包含存档和恢复功能。来自这些版本的课程可以导入,但是课程无法在用户数据和互动保持不变的情况下恢复。