このトピックでは、SOAtest テスト ケースを ALM / Quality Center の特定の要件にマッピングする方法について説明します。テスト ケースを要件にマッピングすると、要件のテストは ALM 内のボタンをクリックするだけで簡単に実行できるようになります。Parasoft テスト ケースは ALM 内から実行でき、結果は ALM に報告されます。

ALM は、SOAtest コマンドライン インターフェイス (soatestcli) を使用して SOAtest テスト スイートを実行できます。これを使用して、クライアントのローカル マシンで soatestcli を使用してテストを実行できます。

このセクションの内容:

VAPI-XP テスト タイプの構成とテストの作成

テスト プラン モジュールでのテストの作成

  1. ALM にログインしたら、テスト プラン モジュールを選択します。テスト プラン モジュールでは、自動テストとカスタム スクリプトを設定できます。
  2. テスト プラン ツリーで、[Subject] を選択し、[New Folder] ツールバー ボタンをクリックします。
  3. [New Folder] ダイアログ ボックスで、[Test Folder Name] フィールドにフォルダー名 (たとえば SOAtest) を入力します。
  4. 新しく作成したフォルダーを選択し、上のツールバーから [New Test] アイコンをクリックします。
  5. [Create New Test] ダイアログ ボックスで、[Test Type] メニューの [VAPI-XP-TEST] を選択し、[Test Name] フィールドにテスト名 (たとえば、SOAtest Demo) を入力して、[OK] をクリックします。

  6. [VAPI-XP Wizard] で、スクリプト言語として [JavaScript] を選択し、[Script Name] に SOAtest と入力して、[Finish] をクリックします。
  7. [Test Script ] タブを開きます。VAPI-XP ウィザードからテンプレートが作成されていることに注意してください。
  8. カスタマイズされた SOAtest スクリプト VAPI-XP-SOAtest.js を開きます。
    注意: スクリプトは、デフォルトのインストール場所が c:/Progra~1/Parasoft/SOAtest/[SOAtest version number]/ であると想定しています。スクリプトは、TestAssets プロジェクト内で example.tst というテスト スイートを実行するように構成されています。 
  9. VAPI-XP-SOAtest.js スクリプトをコピーし、テンプレートで置き換えます。
  10. 必要に応じてスクリプトを変更します (詳細については、次のセクションを参照してください)。
  11. スクリプトを保存します。

スクリプトの変更

VAPI-XP-SOAtest.js 統合スクリプトは、テストの [Test Script] タブで使用され、SOAtest にプロジェクト ファイルを実行し、テスト結果を ALM / QC に報告するように指示します。必要に応じて testSuite と workspaceLocation を変更します。

変数の説明

次の表は、スクリプトの動作を設定するために使用できる変数について説明しています。

変数説明例
testConfigurationテスト コンフィギュレーションの名前 (-config CLI 引数と同じ)。var testConfiguration = "builtin://Run Automated Server Tests";
testSuiteワークスペースからの SOAtest プロジェクト ファイルへの相対パス。

var testSuite = "TestAssets/example.tst";

デフォルトでは、スクリプトは TestAssets プロジェクト内の example.tst というテスト スイートを実行するように構成されています。

testName実行するテスト スイート内のテストの名前。(-testName CLI 引数と同じ)。

var testName = "";
(すべてのテストを実行するには、空の文字列 "" のままにします)

dataSourceRow dataSourceName単一のデータ ソース行を使用してテストを実行します (-dataSourceRow および -dataSourceName CLI 引数と同じ)。

var dataSourceRow = "";
var dataSourceName = "";
(すべてのデータ ソース行を使用する場合は、空の文字列 "" のままにします)

environmentテスト中に有効にする環境の名前 (-environment CLI 引数と同じ)。

var environment = "";
(デフォルトのアクティブ環境を使用する場合は、空の文字列 "" のままにします)

dataGroupConfig

テスト実行に含まれる各 .tst ファイル内の各データ グループのアクティブなデータ ソースを指定する XML ファイルへのフル パス。

-dataGroupConfig コマンドライン引数に相当します。

var dataGroupConfig = "C:/configFiles/dataGroupConfig.xml";
environmentConfig

テスト実行に含まれる各 .tst ファイルに使用する環境変数を指定する XML ファイルへのフル パス。

-environmentConfig コマンドライン引数に相当します。

var environmentConfig = "C:/configFiles/environmentConfig.xml";
reportDirレポート ディレクトリの場所。var reportDir = "%TEMP%/parasoft/soatest/reports";
clearReportDirtrue の場合、SOAtest を実行する前にレポート ディレクトリからすべてのファイルを削除します。 var clearReportDir = true;
detailedReportingレポートのレベルを制御します。true の場合、テスト結果には各テスト実行に関する詳細情報が表示されます。false の場合、テストの失敗に関する情報のみがレポートされます。var detailedReporting = true;
SOAtestExeSOAtest のインストール場所にある soatestcli.exe へのフル パス。

var SOAtestExe = "C:/Progra~1/Parasoft/SOAtest/<version>/soatestcli.exe";

workspaceLocation

ワークスペースへのフル パス var workspaceLocation = "C:/Users/name/soatest/workspace";
デフォルトのワークスペースの場所を指定するには、"" を使用します。

var workspaceLocation = "C:/Docume~1/soatest-workspace/";

additionalArgs

追加のコマンド ライン引数を SOAtest に渡します。たとえば、これを "-testName Custom" に設定すると、Custom という名前のテストのみを実行します。テスト スイート全体を実行するには、これを空の文字列 "" のままにします。
var additionalArgs = "";

var additionalArgs = ""-testName Custom";

Test Lab モジュールでのテストの実行

Test Lab モジュールでテストを実行するには、次の操作を行います。

  1. Test Lab モジュールを開きます。
  2. ルート ノードから新しいフォルダーを作成します。
  3. 新しいフォルダーに新しいテスト セットを追加します。
  4. テスト プラン ツリー (一部の ALM バージョンでは、ツールバーの左上にある [Select Tests] をクリックして開きます) から、テスト プランから作成されたテストを見つけて、新しいテスト セットに追加します。

  5. テストが追加されたら、テストを選択して実行します。SOAtest がローカルにインストールされている場合は、[Run All Tests Locally] オプションがオンになっていることを確認してから、[Run All] または [Run] ボタンをクリックします。

テスト結果の理解

テスト実行が完了すると、他のテストと同様に結果の概要と詳細を確認できます。 

テスト実行ごとに、Test Center のステータス列に SOAtest テスト スイートの全体的な成功が表示されます。テスト実行ごとに、SOAtest テスト スイート内で実行された各テストに対応する実行ステップのリストも表示されます。実行ステップのステータス列には、そのテストが成功したか失敗したかが表示されます。

テストに関する詳細情報は、実行ステップの [Description] フィールドで確認できます。このフィールドには次の情報が含まれています。

トラブル シューティング

ALM を使用してテストを実行すると、次のエラー メッセージが表示される場合があります。

エラー メッセージ解決方法
You do not have the required permissions to execute this action (このアクションを実行するために必要な権限がありません)

このエラーは、テスト ラボ モジュールからテストを実行している QC ユーザーが 1 つ以上の権限をオンにしていない場合に、ALM 内からスローされます。SOAtest に同梱されている QC スクリプトでは、スクリプトが特定のタスクを正常に実行するために、特定の権限をオンにする必要があります。

このエラーが表示される場合は、ログインしている QC ユーザーが属するグループに次の権限が設定されていない可能性があります: Status [RUN] (Modify Run > Status [RUN])

Quality Center で QC ユーザーが属するグループの権限を表示/変更するには、次の手順を実行します。

  1. [Tools] > [Customize] を選択します。
  2. [Groups] を選択します。
  3. 左側で、QC ユーザーが属するグループを選択します。
  4. 右側の [Change] ボタンをクリックします。

権限ステータス [RUN] が有効になっていることを確認するには、次の操作を行います。

  1. 右上の歯車アイコンから、[Customize] を選択します。
  2. [Groups and Permissions] を選択します。
  3. QC ユーザーのグループを選択します。
  4. [Permissions] をクリックします。
  5. [TestLab] を選択します。
  6. Run/Update ノードを展開します。
  7. [Status] ネストされたノードを見つけて、Status [RUN] 権限が有効になっていることを確認します。
     
SOAtest XML test results not found! (SOAtest XML テスト結果が見つかりません)xmlReportLocation 変数が正しいことを確認してください。SOAtest には、XML ファイルが書き込まれるフォルダーに対する書き込み権限も必要です。