自訂 Rational ClearQuest Test Manager 測試構件的移轉

如果 Rational® ClearQuest® Test Manager 記錄欄位到 Rational Quality Manager 記錄欄位的預設對映不夠,您可以修改對映以符合您的需求。

移轉對映檔案 - migration.cfg

測試構件的對映是透過名稱為 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

例如,在一部安裝 Rational ClearQuest 7.1 的 Windows XP 電腦上,其位置可以是:

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=&quot;Notes&quot;" pre="true"/>
<mapping from="LegacyAcceptanceCriteria" to="myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria extensionDisplayName=&quot;Acceptance Criteria&quot;" pre="true"/>
<mapping from="LegacyPreConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePreCondition extensionDisplayName=&quot;Precondition&quot;" pre="true"/>
<mapping from="LegacyPostConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePostCondition extensionDisplayName=&quot;Postcondition&quot;" 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=&quot;Notes&quot;" pre="true"/>
<mapping from="custom2" to="LegacyCustom2"/>
<mapping from="custom3" to="LegacyCustom3"/>
</field_mapping>

下表說明可包含在對映內的一些其他指引。

表 1.
指引 說明
pre="true" 預先格式化。覆蓋資料,使它不會重新格式化。
file=”true” 指定欄位參照Rational ClearQuest Test Manager 中的外部檔案。
scripttype 僅用於關聯的 Script。

範例 1 - 對映使用者定義的欄位

此範例顯示一個簡單案例,其中Rational ClearQuest Test Manager 中的使用者定義欄位對映到Rational Quality Manager 中的現有欄位。

<mapping from="InternalName" to="dc:title"/>

在此範例中,使用者定義欄位 InternalName 對映到 Rational Quality Manager 中的 title 欄位。

範例 2 - 從參照的構件參照欄位

此範例顯示所參照構件中的欄位如何對映到Rational Quality Manager 中的欄位。

<mapping from="ParentPlan.Headline" to="dc:description"/>

在此範例中,ParentPlan 構件中的 Headine 欄位對映到 Rational Quality Manager 中的 description 欄位。

範例 3 - 將使用者定義的欄位對映到使用者定義的區段

此範例顯示Rational ClearQuest Test Manager 中的使用者定義欄位如何對映到 Rational Quality Manager 中的使用者定義區段。

<mapping from="InternalName" to="myns:InternalName extensionDisplayName=&quot;Internal Name&quot;">

在此範例中,對映仍參照 Rational ClearQuest Test Manager 中的自訂 InternalName 欄位,但現在它對映到Rational Quality Manager 中的一個使用者定義區段,也稱為 InternalName。

Rational Quality Manager 中的使用者定義區段名稱可以是任何不含空格的名稱,但其字首必須為 myns:。

此範例的最後部分 - extensionDisplayName=&quot;Internal Name&quot;" - 指定區段名稱如何出現在Rational Quality Manager 中。

這裡的使用者定義區段名稱 InternalName 將顯示為 Internal Name。Internal Name 必須用引號括住,但因為它要包含在 XML 檔案中,所以必須以跳出版本的引號來取代這些引號,亦即 &quot;。

範例 4 - 取代 Rational ClearQuest Test Manager 中的值

這個範例顯示如何以 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 中其值將被取代的欄位。在第一列中,會以 Rational Quality Manager 中的 com.ibm.rqm.execution.common.state.passed 取代 pass 屬性。在另一方面,如果您想取得對映至 Rational Quality Manager 中之失敗的所有不明測試結果,可將該列變更為 <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>。

範例 5 - 在 migration.cfg 檔中定義種類

您可以將 Rational ClearQuest Test Manage 中的欄位與其值,對映至 Rational Quality Manager 中的種類與值。如果種類不存在,就會建立它。

<attribute from="State" to="category term=&quot;Test&quot; " value="value"/>          

在本例中,State 欄位與其值會對映至名稱為 Test 的種類。此外,也會移轉 State 欄位中的值。



有問題或疑問嗎?請至 Jazz.net 討論區發表。