Excel テスト成果物をエクスポートするための構成ファイルの作成

Microsoft Excel テスト成果物をエクスポートする際、「品質管理」成果物への XML ファイルのマップ方法を定義するための構成ファイルが必要です。

このタスクについて

構成ファイルには、「品質管理」成果物情報をデータ・ロケーションに関連付けるステートメントが含まれます。 1 つの構成ファイルの各ステートメントには、等号で結ばれた 2 つのサイドがあります。 ステートメントの左側はキーワードで構成されます。 構成の等号の右側に構成されるものとしては、以下の 3 つが考えられます。
  1. 列またはセルの定義 (D または D4 など)
  2. リテラル・ストリング ("execution" など)
  3. 別の成果物への参照 (自己参照) (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 ファイルを同じリポジトリーにエクスポートする際に新規成果物を作成するには、次のいずれかのステップを実行します。
    • エクスポート操作ごとに XLSArtifactID キーワードを使用して固有の 外部 ID を指定します。
    • エクスポートする度に Excel ファイル名または Excel ワークシート名を変更します。
    • エクスポート・プロセスの開始時に「ファイルにエクスポート」オプションを使用し、XML ファイルの名前を変更して、 その XML ファイルを「品質管理」にインポートします (「品質管理」にログインして、以下のいずれかのコマンドをクリックします)。
      • 「計画」 > 「テスト計画のインポート」
      • 「作成」 > 「テスト・ケースのインポート」
      • 「作成」 > 「テスト・スクリプトのインポート」
      ヒント: 前述の方法は、テスト計画、テスト・ケース、テスト・スクリプトのみをインポートする場合に使用できます。
  • 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
    この例の構成項目によって、「品質管理」アプリケーションに組み込まれた受け入れ基準セクションが取り込まれます。

手順


フィードバック