このセクションの内容:

この演習では、コマンドラインからテストを実行する方法について説明します。コマンドラインを使用することで、毎晩 (あるいは指定の間隔で) 指定の時間にプロジェクト全体を自動的にテストすることができます。そのため、他の作業を妨げることなく、確実に一貫してテストを実施できます。 

SOAtest のコマンドライン モードを使用すると、Windows または UNIX コマンドライン シェルからテストを実行したり、Ant、Maven、CruiseControl といった自動ビルド ユーティリティから SOAtest を実行することができます。 

次の演習は、soatestcli の使用の基本を示すことを目的としています。

コマンドラインからのテスト スイートの実行

この例では、examples ディレクトリにあるコマンド ラインから SOAtestTutorial.tst を実行します。

1. SOAtest を閉じ、コマンドライン ウィンドウを開きます。
2. SOAtest のインストール ディレクトリに移動します。
3. コマンドライン ウィンドウで、次のコマンドを入力します。

   • Windows:
     soatestcli.exe -config <configuration name> -resource "C:\Location Of SOAtestTutorial.tst (デフォルト ワークスペース)" -report MySampleReport

   • UNIX (Location Of SOAtestTutorial.tst は SOAtest の場所).:
     soatestcli -config <configuration name> -resource "/Location Of SOAtestTutorial.tst (デフォルト ワークスペース)" -report MySampleReport

例:
soatestcli.exe -config “user://Example Configuration” -resource “user://Examples/SOAtestTutorial.tst” -report MySampleReport

ワークスペースの全プロジェクトの実行

ワークスペース中のすべてのプロジェクトを実行するには、 -data オプションを使用します。

soatestcli.exe -data "c:\mySOAtestWorkspace" -showdetails -config "user://Example Configuration" -report "c:\mySOAtestReports"

–data オプションは、Eclipse ワークスペースの場所を指定します。

–showdetails オプションは、テストの進捗に関する詳細な情報を出力します。

–config オプションは、テスト コンフィギュレーションを指定します。

–report オプションは、 HTML レポートを生成します。

ワークスペース中の 1 つのプロジェクトの実行

ワークスペースで個々のプロジェクトを実行するには、テストするプロジェクトを -resource オプションで指定する必要があります。

soatestcli.exe -data “C:\mySOAtestWorkspace” -resource “MyProject” -exclude “MyProject/somebadtesttoskip.tst” -showdetails -config “user://Example Configuration” -report “C:\mySOAtestReports”

-exclude オプションは、テストから除外するファイルを指定します。

設定ファイルの使用

設定ファイルは、レポート設定、DTP 設定、エラー作成者設定などを制御できます。複数のプロジェクトに対して複数の設定ファイルを作成し、-settings オプションを使用して、コマンド ライン テストで使用するファイルを指定できます。

設定ファイルは、単純なテキストファイルでなければなりません。名前と場所の要件はありません。1 つの設定を 1 行で入力します。 

ローカル設定ファイルでパラメーターを指定している場合、このパラメーターは、GUI で指定された関連するパラメーターを上書きします。ローカル設定ファイルでパラメーターを指定していない場合、GUI で指定されたパラメーターが使用されます。

soatestcli.exe -data "c:\mySOAtestWorkspace" -showdetails -config "user://Example Configuration" -report "c:\mySOAtestReports" -publish -settings "c:\mysettings.properties"

以下は設定ファイルのサンプルです (実際の環境に合わせてカスタマイズしなければなりません) :

concerto.reporting=true
dtp.url=http://dtp.server.com:32323
report.dtp.publish=true
concerto.log_as_nightly=true
report.mail.enabled=true
report.mail.server=smtp.server.com
report.mail.domain=server.com
report.mail.subject=My Nightly Tests
[email protected]
report.mail.exclude.developers=false
scope.sourcecontrol=true
scope.local=false
soatest.license.use_network=true
soatest.license.network.url=http://ls.server.com:8443
soatest.license.network.edition=server_edition

コマンドラインからの回帰テストへの環境構成の適用

環境の最大の利点として、SOAtest GUI を開いてホストや URL の設定を変更する必要なく、コマンドラインから同じ回帰スイートを再実行できることがあります。

まず、「異なる環境での回帰テストの実行」 で説明するように環境をセットアップします。 

次に、コマンドラインから以下のようなコマンドを実行します。

soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -environment "Default Calculator Environment"

最後に、次のようなコマンドを使用して環境を切り替えます:
soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -environment "Echo Environment"

2 番目の環境を適用して、同じテスト スイートが実行されます。