Table of Contents

maxLevel	1

テストスイートのコンフィギュレーションパネルへのアクセス

テストスイートのプロパティをカスタマイズするには、テストケースエクスプローラーでテストスイートのノードをダブルクリックします。

コメント、要件、タスク、欠陥、機能リクエストをテストに関連付ける

テストスイートコンフィギュレーションパネルの [要件および説明] タブでは、テストスイートの特定のテストと要件、タスク、欠陥、機能リクエストを関連付けることができます。

HTML レポートには、テストに関連する成果物が表示されます。たとえば次の図は、テストに関連付けられたコメントが表示されたレポートを表しています。

定義した要件は、構成レポートおよび接続された DTP システム (該当する場合) に表示されます。このレポートは、テスト要件が満たされているかどうかをマネージャーやレビューアーが判断するのに役立ちます。構造レポートの詳細については「テストスイート構成のレポート作成 Creating a Report of the Test Suite Structure」を参照してください。

実行オプションの指定 (テストフローロジック、回帰オプションなど)
Anchor
Specifying Execution Options (Test Flow Logic, Regression Options, etc.)
Specifying Execution Options (Test Flow Logic, Regression Options, etc.)

実行オプションを使用すると、次のような条件をコントロールすることができます。

...

これらのオプションは、[実行オプション] タブで指定します。このタブには [テストの実行]、[テストフローロジック]、[回帰オプション] タブがあります。

テストの実行
Anchor
Test Execution
Test Execution

[実行オプション] タブの [テストの実行] サブタブでは、以下のオプションをカスタマイズできます。

実行モード

このテストスイートの子である個々のテストおよびテストスイートを一度に 1 つ実行するには、[テストを順次実行] を有効にします。

このテストスイートのすべてのテストと子テストスイートを一度に実行するには、[テストを同時実行] を有効にします。テストは同時に実行されます。

テストの関連性

これらのオプションは、データソース行をどのように反復処理するかを指定します。

...

データソースの各行を使用してすべてのテストを実行するには、[グループとしてテストを実行] を有効にします。シナリオの場合はこれがデフォルトです。データソースから 1 行が選択され、その行を使用して各テストおよび子テストスイートが実行されます。すべての子が実行されたら、新しい行が選択され同じプロセスが繰り返されます。[次の場合にシナリオを異常終了: ] オプションは、[グループとしてテストを実行] が有効な場合にアクティブになります (詳細については「次の場合にシナリオを異常終了」を参照)。

このテストスイートに含まれるテストを、このテストスイートの直接の子として実行するには、[このグループの一部としてすべてのサブグループのテストを実行] オプションを有効にします。そして、グループとしてアクションを順に処理します。[次の場合にシナリオを異常終了: ] オプションは、[グループとしてテストを実行] が有効な場合にアクティブになります (詳細については「次の場合にシナリオを異常終了」を参照)。

たとえば、次の図のようなテストスイートがあるとします。

...

Anchor

	abort-scenario-on
	abort-scenario-on

指定の条件でテスト実行を停止するには、[シナリオを中止] を有効にし、[致命的なエラー] または [任意のエラー] をドロップダウンメニューから選択します。前のテストが致命的なエラーとなった場合、[致命的なエラー時にシナリオを中止] チェックボックスをオンにします。このオプションは [テストを順次実行] が有効で [個別にテストを実行可能] が無効の場合にだけ利用できます。このケースは、テストスイート内のテストのセットがお互いに依存し、互いに別々に実行できず、連続して実行する必要があるときに発生します。このオプションが有効で、かつシナリオ内の実行中のテストに致命的なエラーがある場合、シナリオ内の残りのテストは実行されません。このオプションが無効の場合は、たとえ致命的なエラーが発生しても、シナリオ内の残りのテストが実行されます。

拡張オプション

[複数データソースの反復] ドロップダウンメニューからオプションを選択して、「1 つのテストスイートで複数のデータソースが使用されており、テストスイート中のテストが個別に実行可能ではない場合に、どのようにデータソースを繰り返すか」を指定します。すべてのデータソースが同じ数の行を持たない場合、最も小さなデータソースの最終行で反復は停止します。次のオプションが利用可能です。

...

[すべての反復を表示] オプションがオンの場合、すべてのデータソース行の繰り返し (個別に実行可能なテストの実行も含む) がカウントされて表示されます。デフォルト値はオンです。このオプションがオフの場合、個別に実行可能なテストについては、個々のデータソース行の繰り返しは表示されません。つまり、50 行のデータがあるデータソースでテストをパラメータライズした場合、1 回のテスト実行としてレポートされます。結果として、複数のデータソース行でエラーが発生した場合、テスト実行回数よりも多いエラーがレポートされる場合があります。

テストフローロジック
Anchor
Test Flow Logic
Test Flow Logic

SOAtest では、前のテストや、セットアップテスト、またはティアダウンテストが成功したか失敗したかに応じて実行されるテストを作成できます。この機能は、テストスイート内で効率的なワークフローを作成するのに役立ちます。さらに、変数の値に基づくループや if/else 文を作成して、テストスイートのロジックを制御することもできます。

オプションはテストスイートレベル (テストスイート内のすべてのテストにオプションが適用されます) で設定することも、個々のテストに対して設定することもできます。

テストスイートロジックオプション

多くの場合、ある条件を満たすまで、同じ処理を SOAtest で繰り返すのが良いでしょう。それには、テストスイートフローロジックを使用します。

...

while 条件 (変数): 変数の条件を満たすまで、あるアクションを繰り返し実行します。これには、「変数の定義」で説明する変数の設定が必要です。
while 条件 (成功/失敗): テストスイート中の 1 つのテスト (またはすべてのテスト) が (ループ停止条件で設定した内容に応じて) 成功または失敗するまで、あるアクションを繰り返し実行します。このオプションを選択して (たとえばテストが成功するまでループするように設定して)、全体的なループ条件が満たされた場合、失敗のテストが成功としてマークされる点に注意してください。全体的なループ条件が満たされない場合、失敗した個々のテストは失敗としてマークされます。ループ条件が満たされるかどうかに関係なく、どのテストが成功してどのテストが失敗したかはコンソールに表示されます。

...

Info

title	テストフローロジックのチュートリアル

while 条件 (成功/失敗) テストフローロジックを設定する詳細な手順については、「テストの成功/失敗までループする－テストフローロジックの使用」を参照してください。

テスト特有のロジックオプション

個々のテストに対して以下のオプションを指定できます。

...

変数条件: [変数] テーブルに追加された変数の値に応じてテストを実行するかどうかを決定できます (変数の追加についての詳細は、「変数の定義」を参照してください)。変数が追加されない場合、変数条件オプションは利用できません。変数が定義された場合、次のオプションが利用可能です。
- 変数条件ドロップダウン: ドロップダウンリストから任意の変数を選択します。このリストのアイテムは、[変数] テーブルに追加した変数に依存します。
  - 選択した変数が integer 値で定義されている場合、2 つ目のドロップダウンメニューは == (等しい)、 != (等しくない)、 < (小なり)、 > (大なり)、 <= (小なりイコール)、 >= (大なりイコール) が表示されます。さらに、整数を入力するためのテキストフィールドが利用できます。さらに、整数を入力するためのテキストフィールドが利用できます。例:
    
    x != 13 (x は 13 と等しくない) である場合はテストが実行されます。x が 13 と等しい場合、テストは実行されません。
  - 選択した変数が boolean 値で定義されている場合、[true] または [false] ラジオボタンを選択できます。例:
    
    x1 が false の場合、テストは実行されます。x1 が true の場合、テストは実行されません。
遅延時間 (ミリ秒): テストの実行前または実行後に待機する時間を設定します。

回帰オプション
Anchor
Regression Options
Regression Options

[回帰オプション] コントロールオプションを使用すると、回帰テストでどのようにデータソースを使用するかや、回帰コントロールを追加するテストスイートを指定できます。このタブの設定は、Web シナリオテストには適用できないことに注意してください。以下のオプションを指定できます。次のオプションが利用可能です。

...

データソース列名および値を使用: Diff コントロールが生成するデータにデータソースの列名および値を関連付けます。たとえば、SOAP Client のリクエストで A=1、B=2 というデータが使用された場合、Diff コントロールの "A=1, B=2" というラベルが付いたデータと関連付けられるといった風にです。このオプションがオンの場合、データソースに自由に行を追加したり削除したりしても、列名および値が変わらない限り、Diff ツールはデータソースのデータをコントロールのデータと正しく結びつけることができます。データソースの使用についての詳細は、「テストのパラメータライズ (データソース、変数、または他のテストの値を使用)Parameterizing Tests with Data Sources, Variables, or Values from Other Tests」を参照してください。
回帰コントロールロジック: このテーブルを使用して、テストスイート内のどのテストに対して回帰コントロールを作成するかを指定できます。テーブルに入力されたテストごとに、[常にする] または [しない] を選択できます。次回テストスイートの回帰コントロールを更新したとき、この設定に従って回帰コントロールが更新されます。

変数の定義
Anchor
Defining Variables
Defining Variables

[変数] タブで変数を設定し、テストの定義を簡略化したり、柔軟で再利用性の高いテストスイートを作成するために使用できます。変数を追加すると、その変数を使用してテストをパラメータライズできます。

変数とは

変数に特定の値を指定すると、現在のテストスイート全体でその変数を使用して値を参照できます。この方法で、同じ値を複数回入力する必要がなくなります。そして値を変更したい場合は、1 箇所を変更するだけです。

...

テストスイート A で定義されたテスト変数は、テストスイート A、B、C 内のすべてのテストから見えます。一方、B で定義された変数が見えるのはテストスイート B および C だけです。

変数の追加

[追加] をクリックします。
[名前] フィールドに新しい変数を入力します。
[型] ボックスから [Integer]、 [Boolean]、 [String]、または [Data Source] のいずれかを選択します。
ローカルな値を使用するか、親テストスイートの値を使用するかを指定します。
- 親テストスイートの値を使用 (定義済みの場合) - 現在のテストスイートが「参照されている」テストスイートであり、親テストスイートのデータソースから値を取得したい場合、このオプションを選択します。親テストスイートの詳細については「テストスイートの参照を使用」を参照してください。
- ローカル値を使用 - 現在のテストスイートに親テストスイートがあり、親テストスイート内のテストでこの変数に値を設定している場合も、常にここで指定した値を使用するには、このオプションを選択します。データバンクツールまたは Extension ツールの値をリセットした場合、新しい値がここで指定された値よりも優先されます。
(Data Source 型のみ) 適切な値が格納されているデータソースの名前と行を指定します。データソースは親テストスイート (現在のテストスイートを参照するテストスイート) に存在していなければなりません。
[値] フィールドに変数の値を入力します。Data Bank ツールや Extension ツールに再設定されない限り、[ローカル値を使用] を選択すると変数は常に指定した値に設定されます。[親テストスイートの値を使用] を選択した場合、ここで指定された値は、対応する値が親テストスイートで見つからなかった場合にだけ使用されます。
[OK] をクリックします。

変数の使用

変数を追加した後は、以下のような用途に使用できます。

テストフィールドの「パラメータライズ」オプションで使用します。たとえば、title variable 変数の値を使って SOAP Client リクエストの要素を設定したい場合、次のように設定します。
{var_name} 規約によって、テキスト入力フィールド中で参照されます。データソースエディターでは、参照する環境変数に soa_env という接頭辞を付けます。例: ${soa_env:Variable}/calc_values.xlsx
Data Bank ツールから値をリセットします (たとえば、XML Data Bank など。詳細については「データソースウィザードを使用した XML Data Bank ツールの構成」を参照してください)。
Extension ツールから値をリセットします (「スクリプト経由で変数とロジックを設定」の説明を参照)。
「テストフローロジック」で説明しているように、テストロジック条件を定義するのに使用します。

スクリプト経由で変数とロジックを設定
Anchor
Setting Variables and Logic Through Scripting
Setting Variables and Logic Through Scripting

テスト対象のサービスからのレスポンスに応じて、テストスイートロジックおよび変数を変更したいケースがよくあります。Extension ツールを使用すると、変数を設定してテストフローの実行を制御することができます。たとえば、Test 1 が変数 x=3 を返した場合、Test 2 を実行するなどです。

...

たとえば、テストに XML Transformer ツールを追加して特定の値を抽出します。その後、XML Transformer ツールの出力に Extension ツールを連結し、Transformer ツールの値を取得するスクリプトを記述します。最後に、最初のテストから適切な値が返された場合にだけ 2 つ目のテストを実行するよう設定できます。

変数の使用状況のモニタリング
Anchor
Monitoring Variable Usage
Monitoring Variable Usage

実行時に実際に使用された変数を表示するには、コンソールの設定 ([Parasoft] > [設定] > [Parasoft] > [コンソール]) で通常または高冗長レベルを選択します。

...

このような変数の参照は、発生した問題の原因を診断するのに役立ちます。

チュートリアル

変数の使用の詳細な手順については「再利用可能な (モジュラーな) テストスイートの作成」を参照してください。

クライアントオプションの指定

[クライアントオプション] タブは以下のセクションに分かれています。

全般

以下の全般的なテストスイートオプションを設定できます。

タイムアウト (ミリ秒): デフォルト以外の値を使用する場合、ドロップダウンリストから [カスタム] を選択し、時間を入力します。デフォルト値は 30000 です。
送信メッセージのエンコード: すべての SOAP 以外のテストクライアントについて送信メッセージのエンコーディングを選択できます。文字エンコーディングをより柔軟に設定することができます。この設定は Parasoft 設定の [その他] でグローバルに設定することも可能です (「その他の設定 Additional Preference Settings」を参照)。SOAP クライアントの送信メッセージエンコーディングは [SOAP] 設定で設定できます。
Cookie: セッション間で Cookie を消去するには、ドロップダウンメニューから [カスタム] を選択し、[リクエストを送信する前に、既存のクッキーをリセットする] を有効にします。

SOAP

以下の SOAP 関連のテストスイートオプションを設定できます。

エンドポイント: エンドポイントを指定します。テストスイート内のすべてのテストに対して同じエンドポイントを指定する場合、エンドポイントを入力して [すべてのテストにエンドポイントを適用] ボタンをクリックします。
添付ファイルのカプセル化フォーマット: ドロップダウンリストから [カスタム] を選択し、[MIME] または [DIME]、[MTOM Always]、または [MTOM Optional] を選択します。デフォルト値は MIME です。デフォルト値は MIME です。
送信メッセージのエンコード: 送信 SOAP メッセージのエンコーディングを選択できます。文字エンコーディングをより柔軟に設定することができます。この設定は Parasoft 設定の [その他] でグローバルに設定することも可能です (「その他の設定 Additional Preference Settings」を参照)。SOAP クライアント以外の送信メッセージエンコーディングは [全般] 設定で設定できます。
SOAP バージョン: ドロップダウンリストから [カスタム] を選択し、[SOAP 1.1] または [SOAP 1.2] を選択します。デフォルト値は SOAP 1.1 です。
WSDL に従う: ドロップダウンメニューから [カスタム] を選択し、以下のいずれかまたは両方を有効にします。
- リクエストは WSDL に従う: 定義ファイルから値を取得することをツールに強制します。
- SOAP ヘッダーは WSDL に従う: 定義ファイルから SOAP ヘッダーの値だけを取得することをツールに強制します。

ブラウザー再生オプションの指定

[ブラウザー再生オプション] タブはいくつかのセクションに分かれています。

Playback Testing Framework: ブラウザーでの記録と再生に Selenium WebDriver エンジンを使用するか、従来の Parasoft ネイティブドライバーエンジンを使用するかを指定します。詳細については、「About the Selenium WebDriver エンジンEngine」を参照してください。
デフォルトブラウザー再生: このテストの再生に使用するデフォルトのブラウザーを指定します。
サポート対象ブラウザー: 他のブラウザーではこのテストを実行できない場合 (たとえば、ほかのブラウザーでは Web ページの構造が大幅に異なり、それに合わせてシナリオの構成も変える必要がある場合など)、[ここで指定したブラウザーのみ使用] オプションをオンにします。このオプションがオンの場合、異なるブラウザーを使用するよう指定されたテストコンフィギュレーションで実行した場合も、テストは指定されたブラウザーでだけ再生されます。テストコンフィギュレーションの再生設定でここでの指定を上書きする場合は、[任意のブラウザー] を選択します。
例:
- Chrome および Firefox を指定し、[ここで指定したブラウザーのみ使用] をオンにした場合、すべてのブラウザーでテストを実行するよう設定されたテストコンフィギュレーションを実行すると、Chrome および Firefox でだけテストが実行されます。
- Chrome および Firefox を指定し、[任意のブラウザー] をオンにした場合、すべてのブラウザーでテストを実行するよう設定されたテストコンフィギュレーションを実行すると、Chrome、Firefox、Safari および Internet Explorer (利用可能な場合) でテストが実行されます。
表示: テストを再生する際の表示方法を指定します。[デフォルト] を選択した場合、親の設定が継承されます。[カスタム] を選択した場合、[ヘッドレス (非表示)] または [表示] を選択できます。
- [ヘッドレス] モードでは、テストが実行されている様子を見ることはできません (テストの実行中にブラウザーは表示されません)。[ヘッドレス] モードのサポート状況は以下のとおりです。
  - Windows: 完全にサポートされています。
  - Mac: 完全にサポートされています。
  - Linux: Linux 2.4.21-27.0.2 以降のカーネルでサポートされています(Red Hat、Debian、および Mandrake アーキテクチャで検証済み)。
- [表示] モードでは、テストが実行される様子をブラウザーで見ることができ、テストが正しく実行されていることを目視で確認できます。

Info

title	コマンドラインテストからブラウザーを開くには

上記のオプションは、コマンドラインインターフェイスから実行したテストには適用されません。

コマンドラインモード (soatestcli を使用) では、Web シナリオはデフォルトでヘッドレスモードで実行されます。CLI からヘッドレスモードで実行したくない場合は、soatestcli に -browserTestsVisible を指定します (「Testing from the Command Line Interface - soatestcli」の説明を参照)。

認証: 以下のとおり、認証情報を指定できます。

認証の設定

ベーシック、NTLM、ダイジェスト、および Kerberos 認証がサポートされており、このパネルで指定できます。ベーシック、NTLM、およびダイジェスト認証の場合はユーザー名およびパスワードを指定し、Kerberos 認証の場合はサービスプリンシパルを指定します。

...

Page tree

Versions Compared

Old Version 1

New Version Current

Key

テストスイートのコンフィギュレーションパネルへのアクセス

コメント、要件、タスク、欠陥、機能リクエストをテストに関連付ける

関連およびコメントの追加

実行オプションの指定 (テストフローロジック、回帰オプションなど)
Anchor
Specifying Execution Options (Test Flow Logic, Regression Options, etc.)
Specifying Execution Options (Test Flow Logic, Regression Options, etc.)