Skip to content
DevTest Solutions - 10.4
Documentation powered by DocOps

Request Data Manager Data Protocol

Last update June 20, 2016

The Request Data Manager data protocol lets you alter VSE requests during recording or playback.

On the Data Protocols window, select Request Data Manager for a data protocol. When your recording is complete, the following window opens:

Screenshot of the Request Data Manager data protocol Transactions screen

Fundamentally, this protocol lets you apply a list of actions against a request. You can add the following actions in the ActionList section of the window:

  • Copy
    Copies a piece of data in the request to another part of the request.
  • Move
    Moves a piece of data in the request to another part of the request.
  • Delete
    Deletes (or clears) a piece of data from the request.
  • Keep
    Keeps a piece of data in a request while deleting anything else in that group for the data value.

All actions can be applied to the request operation, any argument, attribute, or metadata entry, or the request body. For example, when virtualizing Java (which ends up with XML documents as arguments), you can move or copy the value of an argument into the request body, so other data protocols can process the argument.

Note: The Keep action is most meaningful for arguments, attributes, and metadata. If you specifically keep a value from one of these three groups, any other value in that group that is not referenced by any action in the list for the data protocol is deleted. If you keep one argument, other arguments are removed unless they were the target of a move or copy. This technique is a good way to remove meaningless arguments.

Each action can also be limited to apply only to requests whose operations match a specified regular expression.

In the recording wizard or the model editor containing a Request Data Manager data protocol, add a Keep or Delete action, or both. Select argument/attribute/meta data and specify a regular expression to match as the name. You must also change the cell that reads named to matches. When the data protocol is run, it keeps or deletes all items in the argument, attribute, or metadata list with a name that matches the pattern. Leaving the operation matching pattern for an action empty affects all requests.

From this list of transactions, double-click a transaction to open a dialog showing the content of the transaction.

Screenshot of the Request Data Manager data protocol Transactions details screen.

Use the Request Data Manager Data Protocol to set JMS and MQ Message Properties

After the recording is finished, use the Request Data Manager window to add the targeted JMS message properties to the request arguments. The JMS message properties can be found under the request Meta Data with a msg. prefix for standard JMS properties, such as correlation ID, and a msg.props. prefix for custom message properties. To copy a property to the request arguments, select argument from the drop-down list:

Screenshot of the Request Data Manager data protocol  Create actions against VSE requests screen.

WebSphere MQ works the same way.

To set the stateful session key instead of an argument, select session key from the drop-down instead.

You can use a single Request Data Manager data protocol to set any number of arguments and the session key simultaneously.

Was this helpful?

Please log in to post comments.