本主题描述从先前版本的 IBM® Rational® Quality Manager
迁移基于工作项的需求时必须完成的步骤。在 Rational Quality Manager V3.0.1 以前,系统在
Rational Quality Manager 中以本地方式管理需求或者在外部需求提供程序(例如
IBM Rational RequisitePro®、IBM Rational DOORS® 或
IBM Rational Requirements Composer)中管理需求。在 V3.0.1 中,不再以本地方式管理需求。如果您正在从
V2 升级,那么必须谨慎地将基于工作项的本地需求迁移到可以随 V3.0.1
一起安装的“需求管理”应用程序。
开始之前
要迁移基于工作项的需求,那么迁移需求的用户必须满足下列先决条件:
- 此用户必须具有有效的“质量专家”许可证。此许可证将授予用户对“质量管理”和“需求管理”项目区域的读写许可权。
- 如果已使用定制属性修改了工作项需求类型,那么此用户还必须具有有效的需求管理分析人员许可证。只能迁移字符串类型的定制属性。为了能够迁移用户定义的字符串类型定制属性,用户必须完成下列步骤:
- 在“质量管理”的“高级属性”中,将允许创建定制属性设置为 true。
- 验证该用户是否“需求管理”项目区域的成员并且其角色是否有权保存和修改工件类型和属性。
- 此用户必须具有 JazzAdmins 存储库组许可权。
- 此用户必须被授予有权在“需求管理”项目区域中创建、更新和删除需求的角色。
- 此用户必须被授予有权在“质量管理”项目区域中修改工作项的角色。
- 如果用户计划迁移基于工作项的需求中的注释,那么必须被赋予有权在“需求管理”项目区域中创建、更新和删除注释的角色。
- “需求管理”应用程序中的所有用户标识都必须与“质量管理”应用程序中的用户标识相匹配。设置此先决条件的原因是,Rational Quality Manager V2 中的需求具有所有者字段和发起方字段,并且这些字段将存储用户标识。迁移这些需求时,需求管理应用程序必须能够识别该用户标识。在缺省情况下,此标识匹配由 Jazz™ Team Server 处理,此产品提供了单一用户数据库供服务器以及所有向该服务器注册的应用程序共享。
您要从中迁移需求的每个质量管理项目区域都必须与需求管理项目区域建立“使用和需求”关联。多个质量管理项目区域可以与单一需求管理项目区域相关联。
另外,“质量管理”应用程序与“需求管理”应用程序之间的集成需要“需求管理”应用程序中定义的两种工件类型:需求类型和测试计划集合类型。迁移过程会修改这些类型。对这些类型的任何手动更新都可能会导致迁移过程和后续集成失败。有关处理工件类型的详细信息,请参阅工件类型。
关于此任务
下表列示迁移所支持的对象和不支持的对象。
表 1. | V3 迁移所支持的对象 |
V3 迁移不支持的对象 |
| Rational Quality Manager V2 需求类型中定义的属性 |
链接和附件 |
| 字符串类型的定制属性 |
非字符串类型的定制属性 |
| 注释 |
复审(核准人和复审者等等) |
| 测试用例与需求之间的关系 |
订户 |
| 测试计划与需求之间的关系(请参阅“注”。) |
历史记录 |
注: 已迁移的需求将成为“需求管理”应用程序中的测试计划集合的组成部分。测试计划集合将链接到测试计划。您在本过程中创建测试计划集合和测试计划。
过程
- 安装 V3 并迁移 V2 数据,如使用升级脚本将 Rational Quality Manager 升级到 3.0.1所述。
- 运行 Jazz Team Server 设置向导并注册应用程序。有关详细信息,请参阅在升级之后配置 Jazz Team Server 以及第一个应用程序。
- 必要时,在“需求管理”客户机中使用“基础”项目模板来创建需求项目,如创建需求项目所述。
- 将质量管理项目区域链接到需求管理项目区域。
要在项目区域之间建立链接,请执行下列操作:
- 设置两个项目区域之间的伙伴关系。有关详细信息,请参阅建立伙伴关系。
- 在这两个项目区域之间添加关联。请参阅创建项目区域。
- 通过将 <JazzInstallDir>/server/conf/rm/fronting.properties
文件中的下列属性设置为 true,将“需求管理”应用程序置于导入方式:
com.ibm.rdm.fronting.server.import.mode=true
执行此步骤后,请重新启动“需求管理”服务器。
- 当质量管理和需求管理应用程序同时运行时,运行 repotools-jazz -refactorRequirements 命令来迁移需求。
要点: 请打开不同的命令行窗口来运行 V2 和 V3 repotools
命令。不同的命令行窗口可以确保 V2 和 V3 命令所使用的环境变量之间没有任何冲突。
此命令每次处理一对质量管理/需求管理项目区域。
-refactorRequirements 命令有许多必需参数。下面是一个命令样本:
repotools-jazz -refactorRequirements adminUserId=admin adminPassword=admin_password projectArea=qm_project_name rmProvider=rm_project_name rmUserId=rm_admin rmPassword=rm_admin_password
有关详细的命令语法,请参阅-refactorRequirements。
- 在迁移完成之后,请重新启动“需求管理”服务器,执行步骤 5 的逆向操作,并通过将
<JazzInstallDir>/server/conf/rm/fronting.properties
文件中的以下属性设置为 false 关闭导入方式:
com.ibm.rdm.fronting.server.import.mode=false