NonStop SOAP 4.1 User's Manual

ManualsBrandsHP ManualsServerHP Integrity NonStop H-Series

181

182

183

184

185

186

187

188

189

190

Defining Multiple SOAP Response Selection Criteria

NonStop SOAP 4 enables you to define multiple response messages for each operation in a Web

service based on a multiple response selection criterion. The response selection criterion can be

defined using the following name attributes of the parameter element in the services.xml

configuration file.

• TotalResponse

This element defines the total number of responses that must be considered while selecting a

single response for a given operation. This is a mandatory attribute.

For example, to define two responses for an operation:

• Response(x)

An operation can expect multiple responses for a given request. Each response must mention

the corresponding element name from the WSDL file. In the Response(x) parameter, x is

an integer, and its value varies from 0 to total response -1. Therefore, if the total

response parameter value is 3, there will be three Response(x) parameters with the

following sample syntax:

<parameter name="Response0">Element Name</parameter>

<parameter name="Response1">Element Name 1</parameter>

<parameter name="Response2">Element Name 2</parameter>

This is a mandatory attribute.

• Response(x)_BufferValue

This element defines a buffer value. The buffer value is compared with the response returned

from the service.

This is an optional element. It is mandatory only if the Response(x)_StartIndex and

Response(x)_EndIndex parameters are specified for a response selection criterion.

• Response(x)_ComparisonOp [ eq | gt | lt | ne ]

This element defines the comparison operator that compares the Response(x)_BufferValue

parameter specified with the response buffer [start index : endIndex-1] received from

the service. The values defined for the comparison operator are:

Buffer value must be equal to response[start-index: end-index-1].

Buffer value must be greater than response[start-index: end-index-1].

Buffer value must be less than response[start-index: end-index-1].

Buffer value must not be equal to response[start-index: end-index-1].

This is an optional parameter. If not specified, the default comparison operator used by

NonStop SOAP 4 is eq.

• Response(x)_StartIndex

This element defines the offset in the response buffer for the data to be evaluated using the

ComparisonOP and BufferValue defined for a particular Response.

186 NonStop SOAP 4 Configuration Files