Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2021.1

...

Notes

  • The form-based views allow you to build the response and parameterize values from a data source.
  • If an operation selector is enabled in the Form Input or Form JSON view, you can use it to select the operation for your response. When you select an operation, the Form Input/JSON view will be populated with appropriate values and UI controls (e.g., radio buttons for booleans, different controls for numbers vs. integers, etc.).
    • In Form Input mode, the operation selector will show all operations for which the associated service definition 1) defines the response as XML and 2) specifies an XML schema.
    • In Form JSON mode, the operation selector will show all operations for which the associated service definition 1) defines the response as JSON and 2) specifies a JSON schema.



  • In Multiple Responses mode, each possible response has its own correlation to the incoming request, static response message, and performance (time) options.

...

  • Transport: Allows you to specify HTTP Headers, JMS message properties, or MQ message fields within the message that will determine whether or not the message is processed by this particular responder. See Transport Correlation for details.
  • Request Body: Allows you to specify XPaths within the message that will determine whether or not the message is processed. See Request Body Correlation for details.
  • HTTP URL Parameters (for RESTful services): Allows you to specify 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). URL parameters can be repeated (you can have the same parameter set to different values). See URL Parameter Correlation for details.
  • HTTP URL Path: Allows you to specify URL paths that will determine whether or not the message is processed. See URL Path Correlation for details.
  • HTTP Methods: Allows you to specify HTTP methods that will determine whether or not the message is processed. See HTTP Method Correlation for details.
  • Custom: Allows you to specify a custom responder correlation that is based on the return value of a custom method written using Java or scripting languages. See Custom Correlation for details.
  • ISO 8583 Correlations: Allows you to specify correlations for ISO 8583 messages. See 2021-09-02_10-58-35_Using ISO 8583 for details. These options are designed specifically for SOAP, Plain XML, and Literal Message Responders.

You can configure one type of correlation, multiple types of correlation, or no correlations. If no correlations are configured, everything in the message will be processed. 

...

Info
titleMatching on Absent/Empty Fields and Parameters

Data source correlations can correlate on the absence of a field in the request. For example, assume you have a  responder that’s configured with data source correlation on a text value of an XML element on the Request Body—but that element is optional.  You can use the same data source to populate the response with parameterized values when the field is absent. To do this, you would set the value of the corresponding field in the data source row as the empty string. Because of the property of XPath function, the empty string would match the case when the XML element is absent and when the XML element is empty. This is also the case for data source correlation for URL Paths and ISO 8583 Messages: to match the absence of the field in the request, you can use the empty string as the value for the corresponding field in the data source row.

URL parameter data correlation works somewhat differently (in order to handle cases where the parameter value is the empty string and where the parameter is altogether absent):

  • To match the case where the URL parameter is present but its value is the empty string, use the empty string as the value for the corresponding field in the data source row.
  • To match the case where the parameter is absent in the request URL, right-click  the corresponding field in the data source row (in the data repository editor) and choose Set field to exclude.

...

Provide the headers for the request values you want to extract and match, then map each to a data source column. The extracted values will be matched with values from the mapped data source columns.

Request ISO 8583 Message

This area applies only to matching values for ISO 8583 messages. Provide the field IDs for the values you want to extract and match, then map each to a data source column. Only messages that contain these ISO 8583 fields and have matching values will correlate.

These options are designed specifically for SOAP, Plain XML, and Literal Message Responders.

Processing Details

When a Message Responder is active, the incoming messages are evaluated through these criteria. The values are then matched against the corresponding data source values (each with its respective column) to find a row that matches the values. 

...

The value specified here will be used to configure URL Paths and URL Parameters correlation settings in both the Responder Correlation and Data Source Correlation tabs.

Image RemovedImage Added

Request Message Template for Assisted XPath Creation

...

  • Performance group: If you’re using performance profiles, you can set or change this responder’s performance group using this control. For details on performance profiles, see Working with Performance Profiles.
  • Think time: Enter the amount of time (in milliseconds) for the message delay you want to emulate (e.g., to emulate a slow service). This time will be added to a) the execution time, which is calculated from the time that the server finishes receiving the request to the time that the sending of the response begins and b)  any additional time specified via performance profiles, which are described in in Working with Performance Profiles. If  If a data source is available, you may also parameterize this value.

...

Specifies whether SOAP 1.1 or 1.2 is used.

ISO 8583 Packager

Allows you to configure packager files for ISO 8583. See Configure an ISO 8583 Message Packager for details. This option is designed specifically for SOAP and Plain XML Message Responders

Outgoing Message Encoding

...