...

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.

   
   

   

   

   
   
   

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.Customization of HTTP methods grouping criteria is automatically disabled to prevent the creation of groups with mixed methods (e.g., both POST and GET).  

...

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:

SOAtest Example

For an endpoint of http://myserver:9080/MyAsset/MyPath, the following URL Parameters are specified in the 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:

...