このセクションでは、 Header Data Bank ツールの構成と適用について説明します。Header Data Bank ツールは、ひとつのメッセージから抽出したヘッダー情報を、他のメッセージのパラメーターとして使用できます。セクションの内容:
Header Data Bank ツールとは
Header Data Bank ツールは、 HTTP ヘッダーや JMS ヘッダー情報を抽出して他のツールで使用できます。 Header Data Bank ツールは、 着信リクエストのヘッダー情報を抽出し、レスポンスのヘッダー情報として使用できます。Header Data Bank ツールは、 HTTP ヘッダーまたは JMS ヘッダーを出力する他のツールに接続できます。HTTP ヘッダーや JMS ヘッダーから情報を抽出し、以降のテストで使用できます。
Header Data Bank ツールの設定
Header Data Bank ツールを設定するには、次の操作を行います。
少なくとも 2 つのテストツールを持つ セット を用意します。
抽出したいデータのあるツールのノードを右クリックし、 (たとえば、着信リクエストや送信レスポンスから値を抽出したい場合、それらのメッセージを処理するメッセージ レスポンダーを選択します)、ショートカットメニューの [出力の追加] をクリックします。
[出力の追加] ウィザードで値の抽出元を指定し (たとえば、レスポンス トランスポート ヘッダー、リクエスト トランスポート ヘッダーなど) 、 [終了] をクリックします。Tool 1 ブランチの下にレスポンス トランスポート ヘッダー > Header Data Bank ノードが表示されます。
- レスポンス トランスポート ヘッダー > Header Data Bank ノードをダブルクリックします。GUI の右側パネルに次の Header Data Bank の設定画面が表示されます。
- 名前: Header Data Bank ツールの名前です。
利用可能なヘッダー: HTTP または JMS トラフィックで利用可能なヘッダーが表示されます。ツールに初めて Header Data Bank ノードを追加したとき、このフィールドは空白です。
抽出/ 変更タブ: 他のメッセージで使用するために抽出/変更するヘッダーを指定します。[抽出] タブでヘッダーを抽出し、 [変更] タブでヘッダーを変更できます。
- Virtualize で Header Data Bank ツールを使用する場合、[ヘッダーの追加] をクリックしてデフォルト ヘッダーを追加します。これらの列に追加された値を選択して [変更] をクリックすると、デフォルトのヘッダー名を変更できます。
SOAtest で Header Data Bank ツールを使用する場合、Header Data Bank ツールを初期化して利用可能なヘッダーを検証するために、メインのテストスイートツリーノードを右クリックし、ショートカットメニューの [Example Configuration を使用したテスト] をクリックします。
ヘッダーを抽出するには [抽出] タブをクリックし、次の操作を行います。
- 利用可能なヘッダーからヘッダー情報を抽出するには、 [利用可能なヘッダー] フィールドで抽出するヘッダーを選択し、 [ヘッダーの追加] をクリックします。
選択したヘッダーが [抽出] タブの [選択されたヘッダー] リストに表示されます。[選択されたヘッダー] リストは次の列から構成されます。- ヘッダー: ヘッダー名を表示します。[ヘッダー] 列のヘッダーをダブルクリックしてヘッダーを編集できます。
カスタム列名: 情報を格納するデータソース列の名前。[書き込み可能なデータソース列] や [変数] を指定しない限り、値は内部データソースとして格納されます。このカスタム列名を指定して、格納されている情報を他のツールから参照できます。たとえば、 MyValue という列名でデータソース列に情報を格納した場合、他のツールから MyValue をパラメーター値として呼び出せます。また、
${My Value}とすれば、リテラルまたは複数のレスポンス ビューで参照できます。
一致するすべての列に書き込む: 列名に任意の文字列を含むすべての列に値を格納します。1 つのメッセージから複数の値を抽出するとき、それぞれの値がすべての一致する列に書き込まれます。対照的に、その上の [書き込み可能なデータソースの列] を選択した場合、値は複数の行にまたがる列に書き込まれます。
変数: 指定された変数の値を保存し、現在のテストスイート (SOAtest) レスポンダー スイートまたはアクション スイート (Virtualize)間で再利用を可能にします。変数は現在の「Virtualizeでの変数の定義」で説明しているように、変数は現在のレスポンダー スイートまたはアクションスイートにすでに追加されている必要があります。 この方法で設定された値は、レスポンダー スイーﾄまたはアクション スイートのプロパティパネルで指定された変数の値で上書きされます。
[利用可能なヘッダー] フィールドにないヘッダーから情報を抽出する場合は、 [ヘッダーの追加] をクリックします。新しいヘッダーが [抽出] タブに追加されます。新しいヘッダーが [抽出] タブの [選択されたヘッダー] リストに追加されます。 デフォルト ヘッダーを抽出するヘッダーの名前に変更するには、ヘッダーを選択して [変更] をクリックします。
- 利用可能なヘッダーからヘッダー情報を抽出するには、 [利用可能なヘッダー] フィールドで抽出するヘッダーを選択し、 [ヘッダーの追加] をクリックします。
ヘッダーを変更するには [変更] タブをクリックし、次の操作を行います。
利用可能なヘッダーのヘッダー情報を変更するには、 [利用可能なヘッダー] フィールドで変更するノードを選択し、 [選択されたノードの追加] をクリックします。
選択したヘッダーが [変更] タブの [選択されたヘッダー] リストに表示されます。[選択されたヘッダー] リストは次の列から構成されます。ヘッダー: ヘッダー名を表示します。[ヘッダー] 列のヘッダーをダブルクリックしてヘッダーを編集できます。
データ ソース列名: 選択されたヘッダーのデータソース列名はツール パネル内のパラメーターとして表示されます。つまり、選択された要素をメッセージの一部として、他のツールで使用できます。
[利用可能なヘッダー] フィールドにないヘッダーを変更する場合は、 [ヘッダーの追加] をクリックします。新しいヘッダーが [変更] タブの [選択されたヘッダー] リストに追加されます。 デフォルトのヘッダー名を変更するには、ヘッダーを選択して [変更] をクリックします。
抽出した情報の使用
抽出した情報の追加や変更が完了したら、それらのデータを使用するヘッダーとプロパティを [ヘッダー] タブから設定します。
[パラメータライズ] を選択し、ドロップダウンから適切なアイテムを選択します。たとえば、「MyVariable」変数に抽出した情報を格納した場合、それを選択します。
