Microsoft Word テスト成果物をエクスポートする際、「品質管理」成果物への XML ファイルのマップ方法を定義するための構成ファイルが必要です。
手順
注: 構成項目の等号の右側には、リテラル・ストリング、テーブル、またはアウトライン定義を含める必要があります。
テーブルは Table( 項目によって示されます。 リストは List( 項目によって示されます。 これらの項目は両方とも、右括弧 ()) で終わる必要があります。
マッピングを作成するには、以下のようにします。
- アウトライン定義の作成: アウトライン・リストの内容定義は、インデント・レベルでも、アスタリスク (*) によって示される単一のワイルドカードでも構成可能です。 インデント・レベルは整数ですが、ワイルドカードは二重引用符で囲む必要があります。 いずれも、コンマの後に特定の段落番号を指定してさらに詳しく定義できます。
以下の例は、エクスポート・ユーティリティーで、ヘッドラインが「1.*.」パターンと一致するアウトラインを検索して
そのアウトラインの最初の段落をテスト・ケース・タイトルにするように指示したものです。
testcase.dc:title=List("1.*.",1)
コンマと番号を省略した場合、アウトライン・レベルの内容全体がタイトル・フィールドに配置されます。
二重引用符なしの整数を使用した場合、エクスポート・ユーティリティーは、その指定されたインデント番号にある内容を使用します。
testcase.dc:title=List(1,1)
- テーブル定義の作成: テーブルは、そのテーブルが存在する番号、または最初のセルの内容によって定義されます。
番号によって定義したテーブルは静的であるため、そのテーブルを使用する各成果物は常に、その番号どおりの的確なテーブルを参照するようになります。 名前指定されたテーブルは動的であり、文書内でテキストと一致する複数のテーブルがある場合は複数の成果物が作成されることを意味します。 テーブルを定義したら、
その後にピリオドとセルまたは列参照を続けて定義する必要があります (Excel のセルまたは列が定義されるのと同様です)。
次の例は、静的テーブルおよび静的セルを定義したものです。
testscript.dc:title=Table(1).B3
動的テーブルは、最初のテーブル・セルのテキスト開始文字と一致します。 マッチング機能では大/小文字の区別がありますが、スペースは無視されます。 次の例は、最初のセルが「Step」で始まるすべてのテーブルから列 B の情報を取り出したものです。
testscript.steps.title=Table("Step").B
- 自己参照リンクの作成: 自己参照を定義するには、以下のように、事前に定義された行の等号の左側にある情報を指定します。
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
ヒント: 自己参照を使用して、別の成果物によって既に使用されているデータを使用した成果物を作成したり、その別の成果物へのリンクを作成したりします。
- キーワードの使用: XLSLink キーワードは、成果物が、文書内で指定されたタイプのすべての成果物にリンクされることを指定します。 次の例では、文書内のすべてのテスト・スクリプトがすべてのテスト・ケースにリンクされます。
testcase.XLSLink=testscript
どのリスト定義で開始および停止するかを指定するには、
DOCStart および
DOCStop キーワードを使用します。 これらのキーワードはリスト・タイプ専用であり、キーワードにストリング・リテラルを含める必要があります。 次の例では、構成項目は 5 番目の項目が見つかった時にリストの処理を開始し、12 番目のリスト項目が見つかった時に処理を停止します。 これらの一致は完全であり、リスト項目 "12.1" では処理は停止されません。
testscript.DOCStart="5."
testscript.DOCStop="12."
- データの変更: 任意のターゲットの定義を Pre() 修飾子内にラップすることができます。
次の例は、結果データを <div> タグおよび <pre> タグ内にラップしたもので、フォーマット情報は保持されます。
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre(Table(1).C)
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre("this is my text")
セクションは、それ自体の使用を簡素化し、またその定義が、他に使用されるピリオド表記の妨げにならないようにする特殊なケースです。
セクションを更新するには、次のフォーマットを使用します。
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
前述の項目によって、「品質管理」アプリケーションに組み込まれた受け入れ基準セクションが取り込まれます。
定義済みセクションの名前または表示名を指定するには、
Excel テスト成果物をエクスポートするための構成ファイルの作成セクションの手順を参照してください。 カスタム・セクションを定義するには、最初のパラメーターを有効な名前で置き換え、2 番目のパラメーターを表示名で置き換えます。
testcase.Section("myns:mysection","my custom section")=Table(1).C
カテゴリーは、
category term=category_name.value=category_value 表記を使用して定義されます。
カテゴリー名は、以下のように二重引用符内に配置されます。
testcase.category term="Function".value=Table(1).H
2 ビット以上のデータを同じフィールドに追加するには、アンパーサンド (
&) 記号を使用します。 データには、複数の項目を混在させることができます。 次の例に、追加されたデータを示します。
testcase.description=”my description:” & Table(1).H & testscript.description
- エクスポートするファイルの文書プロパティーへのアクセス: 次の例に従って Word ファイルの文書プロパティーにアクセスします。
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx に、Microsoft Office に組み込まれた使用可能なプロパティーがあります。
他に、3 つのプロパティー「Name」、「Full Name」、および「Location」も使用可能です。
プロパティーが設定されていない場合または Word がプロパティーをサポートしていない場合、プロパティー (「property name」) は空ストリング “” を返します。
関連するサンプル・ファイル .xls および .cfg は、「Testscript in Tables using Document Properties」と呼ばれます。
例
バージョン 4.0 の場合: リスト内の設計および成果物では、以下の例に示すように、1 つの成果物内に
¥n を指定しなくても、
¥n で区切られることが予期されるようになりました。
1. title
1.1 testcase1 title
1.1.1 testscript1 reference to the testcase1
1.1.1.1 testscript1 step1 title
1.1.1.1.1 testscript1 step1 description
1.1.1.1.2 testscript1 step1 expectresuit
1.1.1.2 testscript1 step2 title
1.1.1.2.1 testscript1 step2 description
1.1.1.2.2 testscript1 step2 expectresuit
1.1.1.3 testscript1 step3 title
1.1.1.3.1 testscript1 step3 description
1.1.1.3.2 testscript1 step3 expectresuit
1.1.1.4 testscript1 step4 title
1.1.1.4.1 testscript1 step4 description
1.1.1.4.2 testscript1 step4 expectresuit
1.2 testcase2 title
1.2.1 testscript2 reference to the testcase2
1.2.1.1 testscript2 step1 title
1.2.1.1.1 testscript2 step1 description
1.2.1.1.2 testscript2 step1 expectresuit
1.2.1.2 testscript2 step2 title
1.2.1.2.1 testscript2 step2 description
1.2.1.2.2 testscript2 step2 expectresuit
1.2.1.3 testscript2 step3 title
1.2.1.3.1 testscript2 step3 description
1.2.1.3.2 testscript2 step3 expectresuit
1.2.1.4 testscript2 step4 title
1.2.1.4.1 testscript2 step4 description
1.2.1.4.2 testscript2 step4 expectresuit
2 つのテスト・ケース・タイトル間のブランク行は、テスト・ケースの区切りを示します。