_Adding a Data Source at the Test Suite, Project, or Global Level

リポジトリ データ ソースの設定

Parasoft のデータ リポジトリは、Parasoft メッセージング ツールで使用する、大規模または階層的あるいはその両方であるデータセットを、チームが定義、拡張、確認しやすいように設計されています。リポジトリ データ ソースの設定に関する詳細は、 「大規模で階層的なデータ セットの操作」を参照してください。

CSV ファイル データ ソースの設定

CSV ファイルのデータ ソースを設定するには、次の操作を行います。 

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。

3. [ファイル パス] フィールドに CSV ファイルへのパスを指定します。次の変数を使用できます:
   
   test_suite_loc:  test_suite_loc: .pva ファイルへの相対パスを指定します。例:  ${test_suite_loc}/../files/myCSVFile.csv
   project_loc: プロジェクトへの相対パスを指定します。例: ${project_loc:MyProject}/myCSVFile.csv

   workspace_loc: ワークスペースからの相対パスを指定します。例: ${workspace_loc}/../files/myCSVFile.csv

   

   環境変数を使用することも可能です。「テストで環境変数を使用」および「Virtualize 環境の構成」を参照してください。

4. ファイルで使用している区切り文字と引用符のタイプを指定します。
5. 必要に応じてさらにオプションを変更します。
   • 前後の空白を削除する － 値の先頭および末尾の空白を削除するかどうかを指定します。
   • 1 行目は列名を表す － CSV ファイルの 1 行目を列名とみなすかどうかを指定します。1 行目が列名である場合、フォーム XML ビューの要素には、各値の名前として列名が表示されます。  1 行目が列名ではない場合は、フォーム XML ビューの要素には、各値の名前として "value" が使用されます。
6. データ ソースから列の一覧を参照したい場合、[列の表示] をクリックします。最初の行の値が列のタイトルと見なされます。別の列のタイトルを使用したい場合は、データ ソースの最初の行を更新して [列の表示] ボタンをクリックします。

データベース データ ソースの設定

データベースのデータ ソースを設定するには、次の操作を行います。 詳細については、「JDBC ドライバーの構成」 を参照してください。 

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。[範囲] オプションを有効にして、特定の範囲の行を指定できます (1 ベースのインデックス)。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。すべてのデータベース行がデフォルトで指定されます。
3. ドロップダウン メニューからドライバー クラスを選択し、データベースの接続設定を指定します。一般的なデータベースの接続設定については「JDBC ドライバーの構成」を参照してください。目的のドライバー クラスがドロップダウン メニューに表示されていない場合、[カスタム] を選択します。

データソースの列名を確認するには、[列の表示] をクリックします。

既存の列に対して別の列名を使用するには、データベースの列名を変更してから [列の表示] ボタンをクリックします。

別の列を使用するには、適切な列を取得するよう SQL クエリーを変更してから [列の表示] ボタンをクリックします。 

Excel スプレッドシート データ ソースの設定

Excel スプレッドシートのデータ ソースを設定するには、次の操作を行います。 

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。

3. [ファイル パス] フィールドに Excel ファイルへのパスを指定します。次の変数を使用できます:
   
   test_suite_loc:  test_suite_loc: .pva ファイルへの相対パスを指定します。例:  ${test_suite_loc}/../files/myspreadsheet.xls

project_loc: プロジェクトへの相対パスを指定します。例: ${project_loc:MyProject}/myspreadsheet.xls 

   環境変数を使用することも可能です。 たとえば: ${project_loc:MyProject}/DataSource/${soa_env:XLS_DIR}/myspreadsheet.xls「テストで環境変数を使用」を参照してください。

   「テストで環境変数を使用」 および「Virtualize 環境の構成」を参照してください。

4. [シート] メニューから、指定した Excel ファイル内の使用したいシートを選択します。
5. Excel データ ソースの列のサイズを、行数が最も少ない列のサイズで制限したい場合 (言い換えると、空のセルに遭遇したときデータの処理を停止したい場合)、[最初に検出された空行で処理を停止する] をオンにします。

重要: SOAtest は最初の行の値を列のタイトルと考えます。そうでない場合は、SOAtest でデータ ソース列を識別および選択する際に問題が起こるかもしれません。異なる列のタイトルを使用したい場合は、データ ソースの最初の行を更新し、[列の表示] ボタンをクリックします。 

テーブル データ ソースの設定

内部のテーブル エディターにデータ ソース値を入力または貼り付けで指定するには、次の操作を行います。

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。
3. 列名を指定したい場合 (デフォルトで設定されている A、 B、 C、 D などを使用するより)、[1 行目は列名を表す] をオンにします。
4. テーブルにデータの値を入力または貼り付けで追加します。Excel などの一般的なスプレッドシートからコピーできます。テーブル エディターには、標準的なコピー/切り取り/貼り付けの編集コマンドや、行や列を挿入するコマンドがあります。さらに行を追加するには、下矢印キーまたはスクロールバーの下矢印ボタンを使用します。さらに列を追加するには、右矢印キーまたはスクロールバーの右矢印ボタンを使用します。

複数のデータ ソースを組み合わせた集約データ ソースの設定

他の利用可能なデータ ソース値を 1 つのデータ ソースにまとめることができる集約データ ソースを作成できます。この機能は特に、複数のデータ ソースから値を取得して機能テストを実行する場合に便利です。たとえば、サーバーにリクエストを送信する際に、ユーザーの姓や名などのユーザー情報を持つデータ ソースからデータを送信し、さらにユーザーのログイン名やパスワード情報を持つ別のデータ ソースからもデータを送信したい場合があります。  2 つのデータ ソースを集約データ ソースにまとめると、データ ソースごとにテストを用意する必要がありません。1 個のテスト ケースを作成するだけで済みます。

集約データ ソースとデータ グループの違いについては、 「データ グループと集約データ ソースとは (SOAtest)」 および「データ グループと集約データ ソースとは (Virtualize)」を参照してください。複数のデータ ソースを 1 つの集約データ ソースに集約するには、次の操作を行います。

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。
3. [利用可能] ボックスから任意のデータ ソースを選択し、[追加] をクリックして [選択済み] ボックスに移動します。
   • [利用可能] ボックスは、テスト スイートに追加されたすべてのデータ ソースを表示します。任意のデータ ソースを選択し、[選択済み] ボックスに移動したら、追加されたデータ ソースの列名が [列] ボックスに表示されます。

複数のデータ ソースを切り替えることができる、データ グループ データ ソースの設定

データ グループは、少なくとも 1 つの共通の列がある、多くの 類似したデータ ソースから構成されます。どのデータ グループを適用するかはいつでも選択できます。同じツールに異なるデータ ソースを動的に指定したい場合に特に役立ちます。ツールやデータ ソースを編集する必要なく、実行時に使用するデータ ソースをすぐに切り替えることができます。データ グループを使用するには、共通する列を持つ複数のデータ ソースをまとめてグループ化し、アクティブにするデータ ソースを指定します。

データ グループと集約データ ソースの違いについては、 「データ グループと集約データ ソースとは (SOAtest)」 および「データ グループと集約データ ソースとは (Virtualize)」を参照してください。複数のデータ ソースを 1 つのデータ グループにまとめるには、次の操作を行います。

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。
3. [利用可能] ボックスから任意のデータ ソースを選択し、[追加] をクリックして [選択済み] ボックスに移動します。
   • [利用可能] ボックスは、テスト スイートに追加されたすべてのデータ ソースを表示します。
   • 選択されているデータ ソースと共通の列がないデータ ソースは追加できません。
   • データ ソースを追加することによって、データ ソース間の共通の列が減少する場合は、警告が表示されます。
   • 任意のデータ ソースを選択し、[選択済み] ボックスに追加した後、すべての選択したデータ ソースで共通の列が [列] ボックスに表示されます。

4. [アクティブなデータソース] で、使用するデータ ソースを指定します。グループのアクティブなデータソースは、アクティブな環境に基づいて選択することもできます。[アクティブなデータソース] フィールドに、$ {var_name} 表記を使って環境変数を入力して、実行時に目的の環境を指定できます。コマンドラインまたは UI でのランタイム環境の使用の詳細については、 異なる環境でのテスト構成 および Virtualize 環境の構成 を参照してください。

ファイル データ ソースの設定

ファイル データ ソースを設定するには、次の操作を行います。

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。
3. インポートするファイルまたはそのディレクトリを指定します。指定した場所で利用可能なすべてのファイルがテーブルに表示されます。右クリック オプションで値を切り取り/コピー/貼り付けすることができます。
   • ファイル データ ソースで使用されるファイルをフィルターするには、[ファイル フィルター] フィールドに文字列を入力します。例:
     
     • * = 任意の文字列のワイルド カード
     • *.*= すべてのファイル (これがデフォルトです)
     • *.txt = すべてのテキスト ファイル
     • data* = ファイル名が "data" で始まるすべてのファイル
     • data*.txt = ファイル名が "data" で始まるすべてのテキスト ファイル
     • *data* = ファイル名のどこかに "data" という文字列が含まれるすべてのファイル
4. ファイル データ ソースが使用されるときにインポート ディレクトリにあるすべてのファイルをファイル データ ソースに使用させたい場合は、[最後のインポートに基づき動的にリフレッシュ] オプションを有効にします。  このオプションを有効にしない場合、ファイル データ ソースは、インポート ディレクトリにさらにファイルがあったとしても、ファイル データ ソースのテーブルにリストされたファイルだけを使用します。以下のケースでは、.tst ファイルの移植性を確保するため、このオプションをオンにする必要があります。
   • .tst ファイルを複数のマシンで実行する必要がある場合。
   • .tst ファイルが複数の Load Test ジェネレーターを使用する負荷テストで使用される場合。

実行時、各ファイルのコンテンツがデータソース値として使用されます。

書き込み可能データ ソースの設定

実行時データを抽出して後続のテストで再利用するための書き込み可能なデータソースを構成するには、次の操作を行います。

1. (任意) データ ソースのコンフィギュレーション オプションの [名前] フィールドで、データ ソースのラベルを変更します。
2. [行] コントロールで、使用する行の範囲を指定します。
   • 選択した行だけを使用したい場合は、[範囲] をクリックし、[開始行] と [終了行] フィールドに値を入力して任意の範囲を指定します。たとえば、最初の 10 行だけを使用する場合、[開始行] に 1 を入力し、[終了行] に 10 を入力します。5 行目だけを使用する場合、 [開始行] と [終了行] に 5 を入力します。
3. データソースに書き込む際のモードを指定します。以下のいずれかのオプションを選択します。
   • セットアップテスト モード > 追加: セットアップテストで、既存の値の後に新規データを付け足す場合、このオプションを選択します。これがデフォルト モードです。このモードでは、セットアップテストだけがデータソースに書き込むことができます。
   • 標準テスト モード > 上書き: 標準テスト ( セットアップテスト以外のテスト) で、既存の値を新規の値で上書きする場合、このオプションを選択します。このモードでは、標準テストだけがデータソースに書き込むことができます。
   • 標準テスト モード > 追加: 標準テスト (セットアップ テスト以外のテスト) で、既存の値の後に新規データを付け足す場合、このオプションを選択します。このモードでは、標準テストだけがデータ ソースに書き込むことができます。このオプションを選択した場合、[回数のリセット] 設定も指定できます。[回数のリセット] 設定は、データ ソースが既存のデータをリセット (消去) する方法を指定します。
     • 繰り返しごと: データ ソースが所属するテスト スイートが新しいデータ ソース行の処理を開始するたびにデータ ソースをリセットします。

     • 書き込みアクセスごと: 書き込みアクセスの前に毎回データ ソースをリセットします (1 回の書き込みアクセス内でだけデータを追加します)。

4. 列名を指定したい場合 (デフォルトで設定されている A、 B、 C、 D などを使用するより)、[1 行目は列名を表す] をオンにします。
5. 書き込み可能データ ソースへの値の投入方法を設定します (たとえば、データ バンク ツールから書き込み可能データ ソースに書き込むなど)。
    

たとえば、書き込み可能データ ソースに値を投入する 1 つの方法として、以下があります。

1. ツールの出力として XML Data Bank ツールを追加します。
2. スイートを実行して XML Data Bank にデータ投入します。
3. XML Data Bank の GUI の [選択された XPath] にノードを追加します。
4. XML Data Bank の GUI で、[データ ソース列名] 列の下のエントリをダブルクリックします。[変更] ダイアログが表示されます。
5. GUI 左側で [データ ソース列] を選択し、 右側で [書き込み可能なデータ ソースの列] を選択して格納された値を投入したい列名を指定します。

この例の手順は SOAtest でも良く似ています。

1. テスト スイートに SOAP Client ツールをセットアップ テストとして追加します。セットアップ テストの詳細については「セットアップ テストとティア ダウン テストの追加」を参照してください。
2. SOAP Client セットアップ テストの出力として XML Data Bank ツールを追加します。
3. SOAP Client セットアップ テストを実行して XML Data Bank に値を抽出します。
4. XML Data Bank GUI の [選択された要素] リストにノードを追加します。
5. XML Data Bank の GUI で、[データ ソース列名] 列の下のエントリをダブルクリックします。[変更] ダイアログが表示されます。
6. [変更] ダイアログで [書込み可能データソース列] を選択し、[OK] をクリックします。セットアップ テストを実行すると、書き込み可能データ ソースにデータが書き込まれます。その後、親テスト スイートを実行するたびに、書き込み可能データ ソースが自動的にリセットされます。

Bean ウィザードで Java Bean フィールドからデータ ソースを構成

「Using Interpreted Data Sources」を参照してください。

"1 対多数" データ ソース マッピングの設定

1 つのデータ ソース (たとえばログイン情報を格納したグローバルなデータ ソースなど) の 1 行の値を別のデータ ソースの複数の行と組み合わせて使用できます。それには、次の操作を行います。

1. 書き込み可能なデータ ソースを追加し、「Configuring a Writable Data Source」の説明に従って構成します。この書き込み可能なデータ ベースは、他のデータ ソースとは独立して繰り返し処理を行います。
2. データ ソースに 2 つ以上の「グローバル」パラメーターがある場合、書き込み可能なデータ ソースの 1 つの列を右クリックし、[列の挿入] をクリックします。元のデータ ソース列の名前に合わせて列名を変更します。
3. セットアップ テストとして Extension ツールを追加します (詳細については「セットアップ テストとティア ダウン テストの追加」を参照してください)。このツールは「グローバル」データ ソースへのインターフェイスの役割をします。

4. 「Extension Tool (カスタム スクリプト)」の説明に従って Extension ツールを構成します。アクセスしたい列の名前は "Credentials" データ ソースの "username" および "password" だとした場合、ツールの構成パネルで Credential データ ソースを選択して [データ ソースの使用] をオンにし、次のコードを追加します。

   from soaptest.api import * def getCredentials(input, context): 	username = context.getValue("Credentials", "username") 	password = context.getValue("Credentials", "password") 	return SOAPUtil.getXMLFromString( [ username, password ] )

5. Extension ツールの出力として XML Data Bank ツールを連結します。それには、 Extension ツールを右クリックして [出力の追加] をクリックし、[XML Data Bank] ツールを選択します。
6. テストを 1 回実行して XML Data Bank に値を収集します。
7. XML Data Bank をダブルクリックして構成パネルを開きます。
8. 1 つ目のパラメーターに対応する要素を選択して [追加] をクリックします。
9. [変更] をクリックし、[データ ソース列名] を選択します。
10. [書込み可能データソース列] を選択し、対応する列名を選択します。
11. 2 つ目のパラメーターに対応する要素に対して手順 8 から 10 を繰り返します。