Maven を使用したテスト

9.2 以降では、テスト製品に付属の Maven プラグインを使用して、Maven ビルドの一部としてテストを実行できます。Apache Maven は、Project Object Model (POM) の概念に基づくソフトウェア・ビルド・ツールです。

始める前に

バージョン 9.2 以降のテスト製品をインストールし、インストール・ロケーションを指す環境変数を設定しておく必要があります。
Linux または MacOS の場合は、製品のインストール・ディレクトリーを指す環境変数 (例: export TEST_WORKBENCH_HOME=/opt/IBM/SDP) を追加します。

Windows の場合、この環境変数は既に定義されています。
バージョン 3.2 以降の Maven をインストールし、M2_HOME インストール・ディレクトリーを指す環境変数をセットアップしておく必要があります。

概要

Maven を使用してテストを自動化するには、pom.xml ファイルを構成し、Maven コマンドを使用してコマンド行からテストを起動する必要があります。ユーザー独自の pom ファイルを使用することも、製品に付属のファイルを使用することもできます。

製品のインストール時に、<製品のインストール・ロケーション>¥SDP¥maven2¥ フォルダーに以下の 3 つのファイルが提供されます。

pomCustomSurefireSample.xml (Windows、Linux、および macOS 用)
pomMojoExecPluginSample_Linux.xml (Linux および MacOS 用)
pomMojoExecPluginSample_Windows.xml (Windows 用)

これらのファイルには、すべてのタイプの依存関係と、テスト・スクリプトの実行に必要な引数が含まれています。Maven を使用してテストを実行する方法は 2 つあります。

方法 1

この方法では、1 つまたは複数のテストを実行できます。ユーザー独自の pom.xml ファイルを使用する場合は、以下の行を編集して、どのテストを実行する必要があるのかを示します。独自のファイルを使用しない場合は、以下のように pomCustomSurefireSample.xml ファイルを使用します。

pomCustomSurefireSample.xml をディレクトリーにコピーします。

ファイルを編集して行を更新し、実行する必要のあるテストの名前とロケーションを入力します。製品が別のドライブまたは別のロケーションにインストールされている場合、あるいはロケーションが変更された場合は、IBMIMShared プラグイン・フォルダーの正しいパスを入力します。 aftsuite 属性には、パラメーター値として aft xml ファイルを入力できます。

<!--test suite="testSources/Test1.testsuite"/-->
	<!--test suite="Test2.testsuite"/-->
	<test suite="C:/Runtimes/runtime-RptMvn/AA/testSources/Test2.testsuite" plugins="C:/Program Files/IBM/IBMIMShared/plugins"/>
	<!--test    schedule="Schedule.testsuite" project="AA" workspace="C:/Runtimes/runtime-RptMvn" plugins="C:/Program Files/IBM/IBMIMShared/plugins"/-->
	<!--test    suite="Test2.testsuite" project="AA" workspace="C:/Runtimes/runtime-RptMvn"/-->
<!--test aftsuite="Test1.xml" project="AA" workspace="C:/Runtimes/runtime-RptMvn" plugins="C:/Program Files/IBM/IBMIMShared/plugins"/-->

Maven を実行して pom ファイル・バージョン・コマンドを更新し、提供されているリポジトリーで現在使用可能なプラグインのバージョンを使用します。
```
mvn versions:update-properties -Dincludes=com.hcl.products.test.it -f pomCustomSurefireSample.xml
```
テストを実行します。
```
mvn clean verify -f pomCustomSurefireSample.xml
```
フェイルセーフ・レポートが、ターゲット・ディレクトリー (特に、実行の画面キャプチャーが含まれる target/failsafe-reports/<ProjectName>/<TestName>_<timestamp>.txt) に生成されます。

方法 2

この方法では、Maven レポートは生成されません。ユーザー独自の pom.xml ファイルを使用する場合は、以下の行をコピーして、パラメーター値を指定します。それ以外の場合は、pomMojoExecPluginSample_Linux.xml または pomMojoExecPluginSample_Windows.xml の各サンプル・ファイルを使用できます。以下は、pomMojoExecPluginSample_Windows.xml サンプル・ファイルを使用した例です。

pomMojoExecPluginSample_Windows.xml をディレクトリーにコピーします。

どのテストを実行するのかを反映するために、ファイルを編集して引数を更新します。製品が別のドライブまたは別のロケーションにインストールされている場合、あるいは IBMIMShared ロケーションが変更された場合は、最後の 2 行を IBMIMShared プラグイン・フォルダーのパスで更新します。

<argument>/C</argument>
                            <argument>${pt-plugin-cmdline}</argument>
                            <argument>-workspace</argument>
                            <argument>C:\Runtimes\runtime-RptMvn</argument>
                            <argument>-project</argument>
                            <argument>AA</argument>
                            <argument>-suite</argument>
                            <argument>Test1.testsuite</argument>
                            <argument>-plugins</argument>
                            <argument>C:/Program Files/IBM/IBMIMShared/plugins</argument>

引数タグの -suite オプションの代わりに -aftsuite オプションを使用して、後続の引数タグに aft xml ファイルをパラメーター値として入力すると、AFT テストを実行できます。例えば、上記のテンプレートでは、<argument>-suite</argument> <argument>Test1.testsuite</argument> を <argument>-aftsuite</argument> <argument>aftfile.xml</argument> に置き換えることができます。

テストを実行します。

Windows の場合:

mvn clean verify -f pomMojoExecPluginSample_Windows.xml

Linux または MacOS の場合:

mvn clean verify -f pomMojoExecPluginSample_Linux.xml