Webservice listener

Webservice listener

Webservice listener

The webService listener receives SOAP messages from an internal webserver, with WSDL.

This consumer is a request/response consumer. This means that a response is expected.

When a reply producer is configured, at the end of a flow, the results from the services will be sent back to the webservice invoker.

Also, exceptions that have occured will be sent back to the invoker, instead of being caught by the connect exception handling mechanism.

The URL that’s used by the client (wether a SOAP client, an interface or an external client) always ends with “/”.


 

 In the table below, you will find an explanation about these properties. All attributes with a ‘*’ are mandatory.

Attribute

Description

Name*

By default, we fill this out with the technical ‘tag’, followed by a serial number. Changing the name is optional.

Enabled

Set this value to true, if you want this consumer to be enabled.

Hostname

Hostname used to open the endpoint

Port

Port number. The default is the Jetty port.

Context Path

Path on which to open webservice endpoint

MessagePart

Name of the MessagePart in a ConnectMessage where the content of the file is being stored.

WSDL Location*

Resource location for this Webservices WSDL file. Just drag and drop it from the resources.

Payload Endpoint

Used to extract only the payload of the SOAP message or to return payload and attachments in
separate ConnectMessage parts. The default is true (payload only). Setting to false will deliver the enitre SOAP message.

SOAP Action

Specifies the SOAP Action to which this flow will respond when receiving a request.

Response Timeout

Time in milliseconds to wait before time-out.

Payload Only

Used to extract only the payload of the SOAP message or to return payload and attachments in
separate ConnectMessage parts. The default is true (payload only). Setting to false will deliver the enitre SOAP message

Mapped Request Headers

A comma separated list of headers to be mapped from HTTP request to the ConnectMessage

Mapped Response Headers

A comma separated list of headers to be mapped from the ConnectMessage to the HTTP response

Use SSL Connector

Enabled means to use the SSL Connector for this endpoint. False means to use the Plain Connector for this endpoint

Authentication Realm

Specify the authentication real to be used. For more information, follow this link.

Authentication Scheme

Specify which HTTP Authentication Scheme is allowed

The followin options are available:None

  • BASIC
  • BASIC_JDBC
  • LDAP

For more information, follow this link.

Description

Description of the specific consumer. This is for documentation purposes.

Enable SSL

When you enable SSL, you need to add some extra information. This will look like this:

Attribute

Description

Certificate Alias in Keystore

Set the certificate alias for the selected certificate. Should exist in defined keystore.

Key Password

Password for the certificate key.

Keystore Location

The location of the keystore. Should be a path to the keystore JKS file.

Keystore Password

Password of the keystore.

Advanced options

Attribute Description
Interceptors Reference Selects a bean that implements a Spring WS EndpointInterceptor, or array of EndpointInterceptors

 

Working with WSDLs

You can work with WSDL in different ways. You can add the WSDL location in the field WSDL Location, or you can add your WSDL files to the Resources and select your WSDL from there.

After you have selected your WSDL, you can select the SOAP Action by clicking the icon, behind the SOAP Action field. A dialog will open where you can select the endpoint you need.

Click on to make you selection active. The field will show the selected SOAP action like this: