このタスクについて
構成ファイルには、「品質管理」成果物情報をデータ・ロケーションに関連付けるステートメントが含まれます。 1 つの構成ファイルの各ステートメントには、等号で結ばれた 2 つのサイドがあります。 ステートメントの左側はキーワードで構成されます。 構成の等号の右側に構成されるものとしては、以下の 3 つが考えられます。
- 列またはセルの定義 (D または D4 など)
- リテラル・ストリング ("execution" など)
- 別の成果物への参照 (自己参照) (testscript.description など)
行またはセルを定義するには、以下のように列 ID またはセル ID を配置します。
testscript.dc:title=G
リテラル・ストリングを定義するには、以下のようにストリングを引用符で囲みます。
testscript.steps.type="execution"
自己参照を定義するには、以下のように、前に定義された行の等号の左側にある情報を入れます。
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
注: 自己参照は、別の成果物によって既に使用されているデータを使用する成果物の作成に使用されたり、その別の成果物へのリンクを作成したりします。 自己参照を XLSLink キーワードと共に使用することはできません。
キーワードと特殊なケース
等号の左側に表示されるキーワードは複数あります。 これらのキーワードはすべて「XLS」で始まり、成果物の後のフィールドの代わりとなります。 これらは、以下のように定義されます。
- XLSStartRow は、成果物データを開始する前の行を定義します。
- XLSDelimeter は、次の成果物を示すエレメントを定義します (現在 ¥n のみがサポートされています)。
- XLSLink は、成果物が、ワークシート内で指定されたタイプのすべての成果物にリンクされることを指定します。
- XLSLinkReverse は、リンク XML を成果物に入れるようにエクスポート・ユーティリティーに指示します (リンクを作成するものではありません)。 このキーワードは自己参照リンク専用です。 ある成果物を基にして別の成果物を作成する場合にこのキーワードを
使用します (例えば、requirement.dc:title=testcase.dc:title) が、オリジナルの成果物 (等号の右側の成果物) にリンクが作成される必要があります。 requirement.XLSLinkReverse=true を指定することにより、
メイン成果物にリンクを入れます (自己参照リンクを指定するものではありません)。
- XLSArtifactID は、成果物の外部 ID を指定します。 成果物の外部 ID が指定されていない場合、デフォルトの外部 ID が次のフォーマットを使用して割り当てられます。
Excel file name_Excel worksheet name[_artifact_count].xml
ここで、artifact_count は、単一のスプレッドシート内にある成果物の数です (そのスプレッドシートに複数の成果物が含まれる場合)。 そのスプレッドシートに含まれる成果物が 1 つの場合、この引数は不要です。重要: スプレッドシートに別の成果物と同じ
外部 ID の成果物が含まれる場合、その成果物はスプレッドシートの内容を元に更新されます。 例えば、同じ構成を持つ同じ Excel スプレッドシートを複数回エクスポートすると、
外部 ID
がその都度更新されます。
注意:
値を (セルではなく) ストリングとして指定する際に artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2" を
使用する場合は必ず、ブランク・シートが存在しないように、
また XLSArtifactID を読み取るワークシートの
指定に artifact.XLSWorksheetID が使用されないようにしてください。
同じ Excel ファイルを同じリポジトリーにエクスポートする際に新規成果物を作成するには、次のいずれかのステップを実行します。
- XLSWorksheetID は、処理するワークシートの名前を指定します。 このキーワードにはリテラル・ストリングを使用する必要があります。
注: バージョン 4.0 から、
testcases にリンクされた
testsuite の以下の構文が変更されました。
testsuite.testcases=testcase
は次のように変更されました。
testsuite.XLSLink=testcase
- 以下にいくつかの例を示します。
- testscript.XLSStartRow=7
- testscript.title=B
- testscript.steps.type="execution"
- testscript.steps.description=B
- testscript.steps.title=B
- testscript.steps.name=B
- testscript.steps.expectedResult=F
- testscript.XLSDelimeter=¥n
- testcase.dc:title=C1
- testcase.dc:description=C2
- testcase.XLSLink=testscript
- testcase.XLSArtifactID=D1
- testcase.XLSWorksheetID="test_case_1"
スクリプト・ステップ、カテゴリー、セクション、イメージ・エクスポート、
語句の動的検索、およびスプレッドシート・プロパティーは、特殊なケースです。 1 つのスクリプト・ステップには、ステップごとにいくつかのフィールドが必要です。
1 つのスクリプトには多くのステップが含まれる可能性があるため、すべての行は、ブランク行がない限り単一のステップと見なされます (ブランク行によって次のステップが始まります)。
セクションは特殊なケースです。 セクションの使用を簡素化したり、セクション定義が、別に使用されているピリオド表記の妨げにならないようにしたりするには、
セクション用に特殊なフォーマットを使用します。
セクションを更新するには、次のフォーマットを使用します。
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
この例の構成項目によって、「品質管理」アプリケーションに組み込まれた受け入れ基準セクションが取り込まれます。
- 定義済みセクションの名前または表示名を判別するには、以下のようにします。
- 「品質管理」の定義済みのリソース・セクションを更新します。
- リソースを abbreviate=false を使用した XML として読み取ります。
- XML 文書内でセクション名を使用した要素を見つけます (例えば、com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria)。
- この要素内で extensionDisplayName 属性を見つけます。この属性にはセクション表示名が含まれます (例えば、RQM-KEY-TC-ACCEPT-CRITERIA-TITLE)。
- カスタム・セクションを定義するには、最初のパラメーターを有効な名前で置き換え、2 番目のパラメーターを表示名で置き換えます。
testcase.Section("myns:mysection","my custom section")=C
- カテゴリーを定義するには、category term=category_name.value=category_value フォーマットを使用して以下のようにします。
testcase.category term="Function".value=H
- 1 つの成果物にカスタム属性を追加するには、次のようにします。 1 つのテスト・ケースに 2 つの customAttributes (testcaseCustomAttribute1 および testcaseCustomAttribute1) がある場合は、「品質管理」の Excel Importer を実行する前にこれらの customAttributes (testcaseCustomAttribute1 および testcaseCustomAttribute2) を「品質管理」に作成する必要があります。
.cfg ファイルを以下のように構成できます。
testcase.customAttributes.type="SMALL_STRING" //set
the custom attribute type (the data type).
testcase.customAttributes.identifier=A //put an
identifier into the A column in Excel. identifier は、属性を作成したときの属性名です。 例えば、「name1」という名前で
customerAttribute を作成し、後でそれを「name2」に変更した場合、identifier は、
品質管理サーバー上では「name1」のままです。
カスタム属性 ID を Custom_attribute_number_ に設定し、最初の属性が
Custom_attribute_0_、2 番目の属性が
Custom_attribute_1_ である場合、この identifier は、Excel のセルに入れるときに修正されます。
testcase.customAttributes.name=B //put attribute name in B column
testcase.customAttributes.value=C //put attribute
value in C column 結果は次のようになります。
<customAttributes>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_0_</identifier>
<name>testcaseCustomAttribute1</name>
<value>111111111111111111111111111</value>
</customAttribute>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_1_</identifier>
<name>testcaseCustomAttribute2</name>
<value>3333333333333333333333333</value>
</customAttribute>
</customAttributes>
カスタム属性を含むサンプルは、サンプル・フォルダーの TestCases 001 with custom attributes.xls ファイルおよび TestCases 001 with custom attributes.cfg ファイルにあります。
- 作業中のスプレッドシートのプロパティーにアクセスするには、次の行を使用します。
他に、3 つのプロパティー「Name」、「Full Name」、および「Location」も使用可能です。
プロパティーが設定されていない場合または Excel がプロパティーをサポートしていない場合、プロパティー (「property name」) は空ストリング “” を返します。
関連するサンプル・ファイル .xls および .cfg は、Requirements001 using document properties と呼ばれます。
- Excel からイメージをエクスポートするには、スプレッドシート内のイメージについて以下の特徴を把握しておきます。
Excel のイメージの位置は、そのイメージの左上隅を含むセルで表されます。 1 つのイメージが複数のセルを占有している場合でも、そのイメージをエクスポートするにはイメージの左上隅を含むセルを指定する必要があります。 セルには、無限の数のイメージを含めることができます。 すべてのイメージの左上隅を含むセルを指定すると、すべてのイメージがエクスポートされます。
Excel では、2 つの方法でイメージをエクスポートできます。 最初の方法は、image 関数を使用する方法です。 イメージが関数としてセットアップされ、構成ファイル項目の等号の後に配置されます。 イメージは、セルでも行でも指定できます。 image 関数は、イメージをその割り当て先のリッチ・テキスト・フィールドに挿入します。 この属性がリッチ・テキスト・フィールドを使用しない場合、image 関数は無視されます。 次の image 関数の例を参照してください。
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
2 番目の方法は、attachment 属性を使用する方法です。
- testcase.attachment=C4
- testcase.attachment=C
attachment 属性は、イメージを、リッチ・テキスト・フィールドに挿入せずに、添付として成果物に追加します。
関連するサンプル・ファイル .xls および .cfg ファイルはそれぞれ Test Cases made from scripts with images および Test Cases made from scripts with attachments と呼ばれます。