테스트 아티팩트 맵핑은 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"/>
필드 맵핑을 업데이트하려면 원본 또는 대상 속성을 적절하게 설정하여 기존 맵핑을 수정하십시오. 새 맵핑을 추가하려면 기존 맵핑을 복제하여 필요에 맞게 업데이트하십시오. 필드 맵핑을 조정한 후, 마이그레이션 마법사를 다시 실행하여 업데이트된 맵핑 파일을 사용하십시오.
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 아티팩트의 Headine 필드가 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 ClearQuest Test Manager의 값을 Rational Quality 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 Manage의 필드 및 값을 Rational Quality Manager의 카테고리 및 값으로 맵핑할 수 있습니다. 카테고리가 없는 경우 새로 작성됩니다.
<attribute from="State" to="category term="Test" " value="value"/>
이 예제에서 State 필드와 해당 값이 Test 카테고리에 맵핑됩니다. State 필드의 값도 마이그레이션됩니다.