Page History

...

1. Open the Grouping Criteria dialog (for example, 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.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
   HTTP Methods Grouping Configuration	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 (for example, both POST and GET).
   URL Paths Grouping Configuration	Virtualize: Specifies URL paths that will determine whether or not the message is processed. SOAtest: Groups messages by URL paths.
   URL Parameters Grouping Configuration	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.
   Request Body Grouping Configuration	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.
   

...

The following URLs will match this correlation criteria:

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

The following URLs will NOT match:

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

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

Ant-style wildcards can be used, where * matches one or more characters and ** matches one or more directories. Using this format:

/**/abc matches /abc  or /this/that/abc

/abc/** matches /abc or /abc/this/that/theother

...

1. Enable Enable correlation or Use for grouping.
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 Correlate only when the list of parameters matches exactly or Include only when the list of parameters matches exactly. 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 Add. A new entry row appears.
4. Enter the Parameter Name.
5. Do one of the following:
   1. If you want to match messages where this parameter 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  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:

...

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

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

Note that several categories of requests are shown in the left hand panel:

• Archetypal Requests: A selection of messages that represent the different message structure variations that were detected when analyzing the traffic file.
• Messages in this Group: Messages from the message group whose grouping criteria you are currently configuring. This is not available if the group doesn’t have any messages.
• All Messages: All the messages from the traffic file.

...