このセクションでは、[パラメータライズされたメッセージを生成] ウィザードの [メッセージ グループ化の確認] ページでグループ化条件をカスタマイズする方法を説明します。
このセクションの内容:

グループ化のカスタマイズ: 概要

グループ化条件をカスタマイズするには、次の操作を行います。

1. [グループ化条件] ダイアログを開きます ( [追加] または [複製] をクリックするか、既存のグループ化条件のエントリをダブルクリックします)。

2. 必要に応じて、生成されるレスポンダー/テスト クライアント/データ セットの名前をカスタマイズします。

   

   

3. [グループ化条件] タブで、必要に応じてグループ化条件を変更します。グループ化条件エントリごとに、以下を組み合わせてグループ化を指定できます。HTTP メソッド、URL パス、URL パラメーター、あるいはリクエスト ボディ。

   グループ化の方法	説明
   HTTP Methods Grouping Configuration	Virtualize: メッセージを処理するかどうかを決定する HTTP メソッドを指定します。  SOAtest: HTTP メソッドでメッセージをグループ化します。メソッドが混在するグループ (たとえば POST と GET など) が作成されるのを防ぐため、HTTP メソッド グループ化条件のカスタマイズは、自動的に無効化されます。
   URL Paths Grouping Configuration	Virtualize: メッセージを処理するかどうかを決定する URL パスを指定します。 SOAtest: URL パスでメッセージをグループ化します。
   URL Parameters Grouping Configuration	Virtualize: メッセージを処理するかどうかを決定する URL パラメーターを指定します。応答条件の構成方法として、「値に関係なく特定のパラメーターを含むすべてのメッセージに一致する応答条件」または「特定の値が設定された特定のパラメーターを含むメッセージにだけ一致する応答条件」を構成できます。正確に一致する URL パラメーターだけがリクエストにある場合に応答条件を適用するかどうかも指定できます。 SOAtest: メッセージを処理するかどうかを決定する URL パラメーターでメッセージをグループ化します。設定された値にかかわらず、特定のパラメーターを持つすべてのメッセージを含めることも、特定のパラメーターに特定の値が設定されているメッセージだけを含めることもできます。また、リクエストが指定された URL パラメーターに完全に一致する (過不足がない) 場合にだけ、メッセージを含める指定を行うこともできます。
   Request Body Grouping Configuration	Virtualize: メッセージを処理するかどうかを決定するメッセージ内の XPath を指定します。  SOAtest: XPath を使用してメッセージをグループ化します。

   検出されたメッセージの詳細を参照するには、[メッセージの詳細] タブを開き、関連するメッセージ ブロックを選択します。
   

HTTP メソッドによるグループ化

HTTP メソッドによるグループ化条件は、 HTTP/HTTPS を介してアクセスされるアセットに適用されます。メソッドが混在するグループ (たとえば POST と GET など) が作成されるのを防ぐため、HTTP メソッド グループ化条件のカスタマイズは、自動的に無効化されます。  

HTTP メソッドの応答条件を構成するには、以下の操作を行います。

1. [応答条件の有効化] を有効にします。
2. 応答条件に使用する HTTP メソッドを指定します。

たとえば、GET、POST、PUT を指定した場合、レスポンダーはメソッド GET、POST、または PUT がある HTTP リクエストに一致します。  CONNECT、DELETE、HEAD などがある HTTP リクエストには一致しません。 

URL パス グループ化の構成

URL パスによるグループ化条件は、 HTTP/HTTPS を介してアクセスされるアセットに適用されます。

URL パスによる応答条件またはグループ化を設定するには、以下の操作を行います。

1. [応答条件の有効化] または [グループ化に使用] を有効にします。

2. 応答条件またはグループ化に使用するパスおよびエンドポイントを指定します。

たとえば、エンドポイントまだは仮想アセットが次のパスでデプロイされるものとします。

http://myserver:9080/MyAsset/MyPath 

また、レスポンダー応答条件として次のパスが指定されているものとします。 

/segment1/segment2/** 

以下の URL はこの応答条件に一致します。

http://myserver:9080/MyAsset/MyPath/segment1/segment2

http://myserver:9080/MyAsset/MyPath/segment1/segment2/

http://myserver:9080/MyAsset/MyPath/segment1/segment2/segment3?param1=value1&m2=value2

以下の URL はこの応答条件に一致しません。

http://myserver:9080/MyAsset/MyPath/segment1/

http://myserver:9080/MyAsset/MyPath/segment3/segment1/segment2

Ant 形式のワイルドカードを使用できます。* は 1 個以上の文字に一致し、** は 1 個以上のディレクトリに一致します。この書式を使用すると、以下のように判断されます。

/**/abc は /abc または /this/that/abc に一致します。

/abc/** は  /abc または /abc/this/that/theother に一致します。

/ab** は /abc/d  に一致しません (1 個のアスタリスク /ab* を使用したかのように解釈されます)。/absolutely には一致します。

/**bc  は /0/abc に一致しません (1 個のアスタリスク /*bc を使用したかのように解釈されます)。/abc には一致します。

例 1: **/service/*

例 2: org/parasoft/virtualize/**

例 3: org/parasoft/**/EM/*

例 4: 同様のパスに対して同じ方法

/v1/orders
/v1/orders/*

URL パラメーターによるグループ化

URL パラメーターによるグループ化条件は、 HTTP/HTTPS を介してアクセスされるアセットに適用されます。パラメーターによる応答条件またはグループ化を設定するには、以下の操作を行います。

1. [応答条件の有効化] または [グループ化に使用] を有効にします。
2. リクエストが指定された URL パラメーターに完全に一致する (過不足がない) 場合にだけ応答条件またはグループ化を適用したい場合、[パラメーターのリストが正確に一致する場合にだけ応答条件に一致する] または [パラメーターのリストが正確に一致する場合にだけグループに含める] を有効にします。オフにした場合、表にあるパラメーターに加えて他のパラメーターを持つリクエストも一致します。このオプションが有効でも無効でも、指定されたパラメーターがすべて揃っていないメッセージは一致しません。
   
   
   
3. [追加] をクリックします。新しいエントリ行が表示されます。
4. [パラメーター名] を入力します。
5. 以下のいずれかの操作を行います。
   1. このパラメーターが特定の値に設定されているメッセージに一致させたい場合: その値を [値] に入力します。
   2. 設定されている値にかかわらず、このパラメーターを含むすべてのメッセージに一致させたい場合: [パラメーター名が存在する場合、常に応答条件に一致する (値にかかわらず)] または [パラメーター名が存在する場合、常にグループに含める (値にかかわらず)] を有効にします。

Virtualize の例

仮想アセットが http://myserver:9080/MyAsset/MyPath というパスにデプロイされ、レスポンダーで次の URL パラメーターが指定されると仮定します。

SOAtest の例

エンドポイントが http://myserver:9080/MyAsset/MyPath であり、グループ化条件として次の URL パラメーターが指定されていると仮定します。

• http://myserver:9080/MyAsset/MyPath?param1=value1&param2=value2
• http://myserver:9080/MyAsset/MyPath?param1=value1&param2=value2&param3=value3
• http://myserver:9080/MyAsset/MyPath?param2=value2&param1=value1&param3=value3

以下の URL は一致しません。

• http://myserver:9080/MyAsset/MyPath?param1=value1&param2=someothervalue1&param3=value3
• http://myserver:9080/MyAsset/MyPath?param1=value1&m3=value3

リクエストボディによるグループ化

リクエストボディの XPath に基づいて、メッセージの応答条件またはグループ化を設定したい場合、以下の操作を行います。

1. [応答条件の有効化] または [グループ化に使用] を有効にします。
2. [編集] をクリックします。[XPath 関数の編集] ダイアログが表示されます。
3. 以下のいずれかの操作を行います。
   • 要素ツリーから要素を選択し、[関数] から関数を選択します。受信リクエスト メッセージのツリー表現が表示される場合は、このオプションを使用します。

   • XPath 式を手動で指定します。ツリー表現が使用できない場合、またはツリーに抽出と評価のための要素または属性が完全に表示されない場合は、このオプションを使用します。応答条件/グループ化のためにサポートされる XPath 表現は、W3C の XPath 1.0 標準に基づきます。

左側のパネルに、リクエストのカテゴリがいくつか表示されている点に注意してください。

• 原型的なリクエスト: トラフィック ファイルの解析中に検出された色々なメッセージ構造を表現するメッセージ。
• このグループのメッセージ: 現在グループ化条件を設定しているメッセージ グループのメッセージ。グループにメッセージがない場合、これは利用できません。
• すべてのメッセージ: トラフィックファイルからのすべてのメッセージ。