测试工件的映射可通过名为 migration.cfg 的 XML 文件控制。 对于 Rational ClearQuest 7.0.1,该文件通常安装到以下目录路径中:
CQInstallDir.Rational\ClearQuest\rcp_configuration_701\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_datestamp\data
对于 Rational ClearQuest 7.1 和更新版本,该文件通常安装到用户主目录中:
UserHome\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_datestamp\data
例如,在通过 Windows XP 运行 Rational ClearQuest 7.1 的计算机上,位置可能如下:
C:\Documents and Settings\myname\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_2.0.0.v20091119_1542\data
在 migration.cfg 文件中,对特定工件的映射包含在 <field _mapping> 标记内,而对工件内每个字段的个别映射则在 <mapping> 标记中定义。例如,以下两行 XML 代码表明 Rational ClearQuest Test Manager 中的 TMTestCase 工件将被映射到 Rational Quality Manager 中的 TestCase 工件,并且 TMTestCase 中的 Headline 字段将被映射到 TestCase 中的 title 字段。
<field_mapping type="TMTestCase" target="TestCase" task="Test Cases">
<mapping from="Headline" to="dc:title"/>
要更新字段映射,请使用适当的 from 或 to 属性设置来修改现有映射。 要添加新映射,请复制现有映射并进行相应更新。 调整字段映射之后,请重新运行迁移向导以使用更新的映射文件。
migration.cfg 文件中测试用例的缺省映射显示如下。<?xml version="1.0" encoding="UTF-8"?>
<config>
<!-- TEST CASE -->
<field_mapping type="TMTestCase" target="TestCase" task="Test Cases">
<mapping from="Headline" to="dc:title"/>
<mapping from="Description" to="dc:description"/>
<mapping from="owner.login_name" to="jzalm:owner"/>
<mapping from="State" to="jzalm:state"/>
<mapping from="Notes_Log" to="myns:com.ibm.rqm.planning.editor.section.testCaseNotes extensionDisplayName="Notes"" pre="true"/>
<mapping from="LegacyAcceptanceCriteria" to="myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria extensionDisplayName="Acceptance Criteria"" pre="true"/>
<mapping from="LegacyPreConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePreCondition extensionDisplayName="Precondition"" pre="true"/>
<mapping from="LegacyPostConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePostCondition extensionDisplayName="Postcondition"" pre="true"/>
<mapping from="LegacyCustom1" to="myns:LegacyCustomField" pre="true"/>
<mapping from="LegacyInputs" to="myns:LegacyInputData" pre="true"/>
<mapping from="LegacyPassPoints" to="myns:LegacyPassPoints" pre="true"/>
<mapping from="LegacyFailPoints" to="myns:LegacyFailPoints" pre="true"/>
<mapping from="LegacyDesign" to="myns:LegacyDesign" pre="true"/>
<mapping from="History" to="myns:History" pre="true"/>
<mapping from="DefaultScript" to="testscript" scripttype="DefaultScriptType"/>
<mapping from="ExternalMotivators" to="attachment" file="true"/>
<mapping from="LegacyTotalPoints" to="weight"/>
<mapping from="ConfiguredTestCases.Script" to="testscript" scripttype="ConfiguredTestCases.TestType"/>
<!-- TM "properties" RAProject and Requirements_List are placeholders and can not be renamed -->
<!-- <mapping from="RAProject" to="RAProject"/> -->
<mapping from="Requirements_List" to="requirement"/>
<mapping from="Notes_Log" to="myns:com.ibm.rqm.planning.editor.section.testCaseNotes extensionDisplayName="Notes"" pre="true"/>
<mapping from="custom2" to="LegacyCustom2"/>
<mapping from="custom3" to="LegacyCustom3"/>
</field_mapping>
下表描述了可以包含在映射中的一些其他伪指令。
| 伪指令 | 描述 |
|---|---|
| pre="true" | 预先格式化。合并数据以便不被重新格式化。 |
| file=”true” | 指定此字段引用了 Rational ClearQuest Test Manager 中的一个外部文件。 |
| scripttype | 仅用于关联的脚本。 |
此示例显示了一个简单用例,其中 Rational ClearQuest Test Manager 中用户定义的字段映射到 Rational Quality Manager 中的一个现有字段。
<mapping from="InternalName" to="dc:title"/>
此示例中,名为 InternalName 的用户定义的字段映射到 Rational Quality Manager 中的 title 字段。
此示例显示如何将引用的工件中的字段映射到 Rational Quality Manager 中的字段。
<mapping from="ParentPlan.Headline" to="dc:description"/>
此示例中,ParentPlan 工件中的 Headline 字段映射到 Rational Quality Manager 中的 description 字段。
此示例显示了如何将 Rational ClearQuest Test Manager 中用户定义的字段映射到 Rational Quality Manager 中用户定义的部分。
<mapping from="InternalName" to="myns:InternalName extensionDisplayName="Internal Name"">
此示例中,映射仍将引用 Rational ClearQuest Test Manager 中的定制 InternalName 字段,但现在它将映射到 Rational Quality Manager 中用户定义的部分,也叫做 InternalName。
Rational Quality Manager 中用户定义的部分的名称可以是不带空格的任何名称,并且必须以 myns: 为前缀。
此示例的最后一部分 - extensionDisplayName="Internal Name"" - 指定了部分名称在 Rational Quality Manager 中的显示方式。
此处,用户定义的部分名称 InternalName 将显示为 Internal Name。Internal Name 必须用引号括起,但由于它将包含在 XML 文件中,所以必须用引号的转义版本,即 ",替换引号。
此示例显示了使用 Rational Quality Manager 中的值替换 Rational ClearQuest Test Manager 中的值的方法。
<enum_mapping name="jzalm:state">
<mapping from="pass" to="com.ibm.rqm.execution.common.state.passed"/>
<mapping from="fail" to="com.ibm.rqm.execution.common.state.failed"/>
<mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.inconclusive"/>
<mapping from="error" to="com.ibm.rqm.execution.common.state.inconclusive"/>
<mapping from="Draft" to="com.ibm.rqm.planning.common.new"/>
<mapping from="Approved" to="com.ibm.rqm.planning.common.approved"/>
<mapping from="ForReview" to="com.ibm.rqm.planning.common.underreview"/>
<mapping from="Blocked" to="com.ibm.rqm.planning.common.new"/>
<mapping from="Implemented" to="com.ibm.rqm.planning.common.new"/>
</enum_mapping>
在此示例中,枚举的标记以关键字 enum_mapping 开头,且 name 属性指定了 Rational ClearQuest Test Manager 中要替换其值的字段。在第一行中,pass 属性要替换为 Rational Quality Manager 中的 com.ibm.rqm.execution.common.state.passed。 另一方面,如果想要所有无定论测试结果都映射到 Rational Quality Manager 中的失败,您需要将该行更改为 <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>。
您可将 Rational ClearQuest Test Manager 中的字段和字段的值映射到 Rational Quality Manager 中的类别和值。 如果类别不存在,将创建类别。
<attribute from="State" to="category term="Test" " value="value"/>
在此示例中,State 字段及其值将映射到名为 Test 的类别。同时还将迁移 State 字段中的值。