使用 ALM Robot 导出和导入项目

您可以将多个 ALM 项目并行导出到存档文件夹，也可以将多个 ALM 项目从存档文件夹并行导入到 ALM 数据库。

注释:  

  • 自 ALM 15.5.1 起正式支持此功能。
  • ALM Robot 不支持导出和导入 Lab_Project。

为存档的项目启用校验和

如果要确保在传输或存储过程中不对存档的项目进行任何修改，可以为存档的项目启用校验和。如果启用，则在导出和导入项目时，ALM Robot 会实施校验，如下所示。

  • 导出项目时，该项目将打包为 .qcs 文件。

  • 导入存档的项目时，只能导入 .qcs 文件，ALM Robot 会验证该文件是否有任何修改。如果验证通过，则可以导入项目。如果验证失败，则无法导入项目，因为 ALM Robot 假定存档的项目已被修改。

要为存档的项目启用校验和，请执行以下操作:

  1. 启用 ENABLE_ARCHIVE_CHECKSUM 参数。请参阅 ALM 站点参数。
  2. 将证书上载到 ALM Robot。该证书用于校验和。请参见上载证书。

返回页首

导出项目

要使用 ALM Robot 导出项目，请执行以下操作:

  1. 在“站点管理”中，选择工具 > ALM Robot。将打开 ALM Robot。

  2. 单击 Add Activity，为 ALM Robot 创建一个新活动。将显示“活动设置”页面。

  3. 定义活动设置。

    在向导的 Activity Settings 页面中:

    1. 在“活动名称”框中，输入活动的名称。
    2. 在“类型”框中，选择“导出”。

    3. “存档文件夹”字段是只读的，指示目标项目将导出到 [ARCHIVE_BASE_FOLDER]/archive 文件夹。

      [ARCHIVE_BASE_FOLDER] 取决于 ARCHIVE_BASE_FOLDER 站点参数的值。确保为该参数设置一个值，并且 ALM 服务器具有此文件夹的读写权限。如果未设置该参数，将使用基本存储库路径。

    4. 单击 Next 打开 Projects Selection 页面，以显示可用的项目。

  4. 选择项目。

    在向导的 Projects Selection 页面中:

    1. 从项目和域列表中，选择要包括在活动中的项目。

      您可以选择所有项目，位于特定域中的所有项目，或某一具体项目。

      选择后，单击 将选定项目移动到 Selected Projects & Rank 窗格。

      要从选定列表中删除项目，请选择这些项目，然后单击 将它们从 Selected Projects & Rank 窗格中删除。

      导出后不保留链接项目和模板项目之间的依赖关系。您必须手动链接它们。

    2. 要设置 Selected Projects & Rank 窗格中的顺序，即项目将在升级过程中处理的顺序，请突出显示某一个项目并单击顶部的箭头 在列表中向上或向下移动该项目。

      注释:  

      • 在选择时，模板项目始终排在第一。所有其他项目均按照其显示在“项目树”中的顺序添加到 Selected Projects & Rank 窗格中，但可以根据您需要的优先次序移动。

      • 默认情况下，ALM Robot 最多可以在每个 ALM 节点上同时处理 10 个项目。要更改默认值，请编辑 ROBOT_MAX_TASKS_PER_NODE 站点参数，并根据环境的性能设置此参数，值偏大可能会导致性能下降。

    3. 请注意任何可能的警告消息，它们可能会显示在“选定项目和级别”面板的底部。

    4. 单击 Next 打开 Project Settings 页面。

  5. 定义项目设置。

    自定义导出文件名: 如果要自定义导出文件名，请选中该选项，然后在该选项下方的字段中输入自定义文件名。否则，导出文件将采用以下格式命名: <项目类型>_<用户名>_<导出日期和时间>。<项目类型> 为 ST (对于标准项目) 或 T (对于模板项目)。

    如存在同名文件则替代导出文件名: 使用自定义导出文件名时，此选项控制是否将现有导出文件替换为同名的新导出文件。如果不选中此选项，则 ALM Robot 会保留新的和现有的导出文件。

  6. 查看活动摘要。

    Activity Summary 显示您的活动配置。Activity Tasks 部分显示为您的活动选定的项目以及在“项目设置”页面上对每个项目所做的更改。

  7. 单击 Submit。此时 ALM Robot 开始验证。

    导出文件为 .qcp 或 .qcs 文件，具体取决于您是否启用了校验和。请参见为存档的项目启用校验和。

    如果验证过程成功完成，则开始处理活动。将打开控制面板窗口。请参见ALM Robot 控制面板操作以获取详细信息。

    如果 ALM Robot 在验证选定项目时检测到错误，请修复错误，然后单击 Submit。

返回页首

导入项目

要使用 ALM Robot 导入项目，请执行以下操作:

  1. 在“站点管理”中，选择工具 > ALM Robot。将打开 ALM Robot。

  2. 单击 Add Activity，为 ALM Robot 创建一个新活动。将显示“活动设置”页面。

  3. 定义活动设置。

    在向导的 Activity Settings 页面中:

    1. 在“活动名称”字段中，输入活动的名称。
    2. 在“类型”字段中，选择“导入”。

    3. “存档文件夹”字段是只读的，指示要导入的目标项目现在存档到 [ARCHIVE_BASE_FOLDER]/archive 文件夹。

      [ARCHIVE_BASE_FOLDER] 取决于 ARCHIVE_BASE_FOLDER 站点参数的值。确保为该参数设置一个值，并且 ALM 服务器具有此文件夹的读写权限。如果未设置该参数，将使用基本存储库路径。

    4. 在“数据库”字段中，选择要将目标项目导入到的数据库。

      如果选择 Oracle 数据库，则还应指定默认表空间和临时表空间。

    5. 单击 Next 打开 Projects Selection 页面，以显示可用的项目。

  4. 选择项目。

    在向导的 Projects Selection 页面中:

    1. 从项目和域列表中，选择要包括在活动中的项目。

      项目名称的格式为: <项目名称>_<导出项目的用户名>_<导出项目的日期和时间>。

      如果项目已导出多次，则会列出其所有导出文件。您应当只选择一个导出文件来导入项目。

      如果已为存档的项目禁用校验和，则 .qcp 和 .qcs 项目文件都可供选择。如果启用了校验和，则只能选择 .qcs 项目文件。

      选择后，单击 将选定项目移动到 Selected Projects & Rank 窗格。

      要从选定列表中删除项目，请选择这些项目，然后单击 将它们从 Selected Projects & Rank 窗格中删除。

    2. 要设置 Selected Projects & Rank 窗格中的顺序，即项目将在升级过程中处理的顺序，请突出显示某一个项目并单击顶部的箭头 在列表中向上或向下移动该项目。

      注释:  

      • 在选择时，模板项目始终排在第一。所有其他项目均按照其显示在“项目树”中的顺序添加到 Selected Projects & Rank 窗格中，但可以根据您需要的优先次序移动。

      • 默认情况下，ALM Robot 最多可以在每个 ALM 节点上同时处理 10 个项目。要更改默认值，请编辑 ROBOT_MAX_TASKS_PER_NODE 站点参数，并根据环境的性能设置此参数，值偏大可能会导致性能下降。

    3. 请注意任何可能的警告消息，它们可能会显示在“选定项目和级别”面板的底部。

    4. 单击“下一步”打开“摘要”页面。

  5. 查看活动摘要。

    Activity Summary 显示您的活动配置。Activity Tasks 部分显示为您的活动选定的项目以及在“项目设置”页面上对每个项目所做的更改。

  6. 单击 Submit。此时 ALM Robot 开始验证。

    如果启用校验和，则只能导入具有完整签名的 .qcs 项目文件。有关详细信息，请参见Enable data integrity check for archived projects。

    如果验证过程成功完成，则开始处理活动。将打开控制面板窗口。请参见ALM Robot 控制面板操作以获取详细信息。

    如果 ALM Robot 在验证选定项目时检测到错误，请修复错误，然后单击 Submit。