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.

Response Class

Class to specify the return type. The default value is java.lang.String. Advanced

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-.

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. Advanced

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

 

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.