HTTP gateway

HTTP Gateway

This Service is used to perform an HTTP request. The content of MessagePart-In can be used as POST data or as URL info in a GET request. The response of the HTTP request is placed in MessagePart-Out.

 

In the table below, you will find an explanation of 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 service to be enabled at startup

MessagePart In

Here, you can specify the name of the MessagePart, which will be used as input. The value of this MessagePart becomes the POST data in a POST request or is used in a URL, depending on the definition of the URL parameter.

The default value is msgprt0. Only use this when you are in fact using different names and/or MessageParts.

MessagePart Out

Here, you can specify the name of the MessagePart, which will be used as output for the service method. The response of the HTTP request is put on this MessagePart. The default value is msgprt0.

HTTP Method

Here, you can choose the HTTP method you would like to use: GET, POST, DELETE or PUT. The default value is GET.

URL

The URL location where the HTTP request has to go. A placeholder can be used in the URL (or for the entire URL). The name of this placeholder is {url-placeholder} (NO $-sign!). If the placeholder is used, this placeholder is replaced by the content of MessagePart-In. This allows the URL location to be dynamically determined by the preceding services. The default value is {url-placeholder}.

Encode URI

This is a selection field where you have the possibility to turn the encoding of the URI off (‘true’ or ‘false’). On default this is enabled.

URL From Header

Specify which header to use as URL value.

Time Out

Maximum time in miliseconds to wait on a single request. Default is 0, which means indefinitely.

Response Class

Specify return messagepart type, either TEXT or BYTES. Defaults to 'TEXT'

Mapped Request Headers

Comma separated list of ConnectMessage properties which are mapped to the HTTP Headers.

Mapped Response Headers

Comma separated list of HTTP Headers which are mapped to the ConnectMessage properties.

Non-Standard HTTP Header Prefix

Prefix used for non-standard HTTP Headers. By default this is X-.

Username

Here, you enter the login name for Basic Authentication of NTLM support.

Password

Here, you enter the password for Basic Authentication of NTLM support, belonging to the Username.

Domain

Here, you enter the domain for NTLM support.

Preemptive Authentication

Specify whether to use Preemptive Authentication. By default this is set to false.

Preserve Analyze headers

 

Switch to enable or disable preservation of Analyze headers. The default is set to false.

Use Form URL Encoded

Switch to enable or disable use of application/x-www-form-urlencoded

MessagePart data should be formatted accordingly:

  1. Basic syntax example: key1=value1&key2=value2&keyN=valueN
  2. Json syntax example: {"key1":"value1","key2":"value2","keyN":"valueN"}
  3. XML syntax example: <form><key1>value1</key1><key2>value2</key2><keyN>valueN</keyN></form>
Content Type

Specify which Content-Type to use

Enable Cookie Management

Enables or disables the cookie management settings in the http client. When set to disabled, cookie headers will no longer be managed automatically.

Enable X509 Authentication

Enables or disables X509 authentication. When set to enabled, you must provide an alias to an existing private key in your keystore for authentication.

Client Certificate

Specify which client certificate to use for X509 authentication. You should provide an alias to an existing private key in your keystore for authentication.

Description

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

 

Advanced options

Attribute Description
Custom HTTP Request Factory Here, you can choose an existing HTTP Request Factory Bean. The Bean needs to be known within the corresponding Interface in the Interface Overview.