...

Customizing Grouping: Overview

To customize grouping criteria:

1. Open the Grouping Criteria dialog (e.g., by clicking Add or Duplicate, or by double-clicking) an existing grouping criteria entry.

2. If desired, customize the name of the responder/test client and/or data set that will be generated.

   Conditional ContentProduct: (SOAVirt, Virtualize)Product: (SOAVirt, Virtualize)sv-attr:0A010204015A9054C88481D043445E2F0A010204015CF6008A11EEF43AC91334 0A010204015A9054C88802B9600247DF

   
   

   Image Modified

   
   
   

3. In the Grouping Criteria tab, modify the grouping criteria as desired. Each grouping criteria entry can specify grouping by any combination of the following: HTTP Methods, URL Paths, URL Parameters, and/or Request Body.

   Grouping Strategy	Description
   _Customizing HTTP Methods Grouping CriteriaConfiguration	Virtualize: Specifies HTTP methods that will determine whether or not the message is processed.  SOAtest: Groups messages by HTTP methods. Customization of HTTP methods grouping criteria is automatically disabled to prevent the creation of groups with mixed methods (e.g., both POST and GET).
   _Customizing URL Paths Grouping CriteriaConfiguration	Virtualize: Specifies URL paths that will determine whether or not the message is processed. SOAtest: Groups messages by URL paths.
   _Customizing URL Parameters Grouping CriteriaConfiguration	Virtualize: Specifies URL parameters that will determine whether or not the message is processed. You can configure the correlation to match all messages that include specific parameters (no matter what value they are set to), or only match messages where specific parameters are set to specific values. You can also indicate whether a correlation should be applied if the request has the exact URL parameters present—no more and no less. SOAtest: Groups messages by URL parameters that will determine whether or not the message is processed. You can configure the criteria to include all messages that include specific parameters (no matter what value they are set to), or only include messages where specific parameters are set to specific values. You can also indicate whether a message should be included if the request has the exact URL parameters present—no more and no less.
   _Customizing Request Body Grouping CriteriaConfiguration	Virtualize: Specifies XPaths within the message that will determine whether or not the message is processed.  SOAtest: Groups messages using XPaths.

   To see the details of the detected messages, open the Message Details tab and select the related message block.
   
   

HTTP Methods Grouping Configuration

Anchor
HTTP Methods Grouping Configuration HTTP Methods Grouping Configuration

HTTP methods grouping criteria apply to assets that will be accessed over HTTP/HTTPS.

...

To configure the HTTP methods correlation:

1. Select the Enable correlation check box.
2. Specify the HTTP methods you want to use for correlation.
    

Image Modified

For example, if GET, POST, and PUT are checked, the responder will match HTTP requests with the method GET, POST, or PUT.  HTTP requests with CONNECT, DELETE, HEAD, etc. will not match. 

URL Paths Grouping Configuration

Anchor
URL Paths Grouping Configuration URL Paths Grouping Configuration

URL path grouping criteria apply to assets that will be accessed over HTTP/HTTPS.

...

/**bc  DOES NOT match  /0/abc (it is interpreted as if you used a single asterisk /*bc); it does match /abc

Example 1: **/service/*

Example 2: org/parasoft/virtualize/**

Example 3: org/parasoft/**/EM/*

URL Parameters Grouping Configuration

Anchor
URL Parameters Grouping Configuration URL Parameters Grouping Configuration

URL parameter grouping criteria apply to assets that will be accessed over HTTP/HTTPS. To configure the URL parameters correlation or grouping:

1. Enable the Enable correlation or Use for grouping option.
2. If you want the correlation or grouping to be applied only if the request has the exact URL parameters specified in this table—no more and no less—enable the Correlate only when the list of parameters matches exactly or Include only when the list of parameters matches exactly option. Otherwise, any request that contains listed parameters as well as other parameters will match. Whether this option is enabled or disabled, a message that lacks one of the specified parameters will not match.
   
   
   
    
3. Click the Add button. A new entry row displays.
4. Enter the Parameter Name.
5. Do one of the following:
   1. If you want to match messages where this parameters is set a specific value: Enter that value under Value.
   2. If you want to match all messages that include this parameter (no matter what value they are set to): Enable Correlate whenever the parameter name is present (regardless of value) or Include in group  whenever the parameter name is present (regardless of value).

...

...

Virtualize

...

Example

For an asset deployed under the path http://myserver:9080/MyAsset/MyPath, the following URL Parameters are specified in a responder:

...

The following request URLs will match this correlation or grouping criteria:

...

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

Request Body Grouping Configuration

Anchor
Request Body Grouping Configuration Request Body Grouping Configuration

To configure a message correlation or grouping based on XPath function from the request body:

1. Enable the Enable correlation or Use for grouping option.
2. Click the Edit button. An Edit XPath Function dialog displays.
3. Do one of the following:
   • If a tree representation of the incoming request message is displayed, then select Choose an element from the Element tree and select a function from the Function drop-down menu.. Use this option if a tree representation of the incoming request message is displayed.

   • Provide an XPath expression manually. Use this option if If a tree representation is not available—or available or if the tree does not fully display the interesting elements or attributes that are if interest for attributes for extraction and evaluation—then provide an XPath expression manuallyevaluation. The XPath expressions supported for correlation/grouping purposes is based on the standard XPath 1.0 standard by W3C.

...