Start of Content Area

Function documentation Configuring the Receiver Plain HTTP Adapter  Locate the document in its SAP Library structure

Use

The plain HTTP outbound channel is a service provided by the Integration Engine. The system is addressed when technical routing determines a corresponding communication channel for the logical receiver from logical routing. The system sends the payload of the message to an HTTP address using HTTP, without being enhanced with an envelope.

Integration

You configure the adapter on the Parameters tab page during the definition of a communication channel in the Integration Server.

Activities

The plain HTTP adapter gives the receiver system the following specifications:

Transport Protocol

HTTP 1.0

Message Protocol

XI payload in HTTP body

Adapter Engine

Integration Server

Addressing Type

URL Address

HTTP Destination

Specify the target host, service number, and path prefix including query string:

http://<hostname:port>/<path>?<query-string>

You can identify the target host (HTTP port) of a SAP Web Application Server using the ICM monitor.

Host and port of the HTTP proxy (optional if there is a firewall between the plain HTTP adapter and the receiver system)

Authentication data for the receiver system, see also: transaction Display and Maintain RFC Destinations (SM59)

Specify the RFC destination.

Parameters from the Communication Channel for Technical Routing

      Content type (the entry text/XML is expected as default)

Specifies the format that the message contents (the payload) should have.

      (Optional) header fields for the receiver-specific protocol

      Choose Additional Query String Attributes

       Sender party

       Sender service

       Receiver interface

       Message ID

       Quality of service

       Queue ID

The queue ID is only required if the quality of service is EOIO.

      Specifications for payload manipulation

       XML code (default UTF-8)

Specifies the character set.

       URL escaping

Presents the XML in a URL-enabled format. Special characters that could be interpreted as control characters are replaced with escape characters (masked).

       Prolog

Enhances the payload for particular servers (optional, see below).

       Epilog

Enhances the payload for particular servers (optional, see below).

Adapter-Specific Message Attributes

      To evaluate adapter attributes in the message header of the XI message, choose Use Adapter-Specific Message Attributes.

      If you want missing message attributes to trigger an error message, choose Fail If Adapter-Specific Message Attributes Missing. If the indicator is set and the header for adapter-specific message attributes or one of the set attributes is missing from the message, this leads to a system error (red flag).

If you do not set the indicator, and message attributes are missing, the adapter accesses information from the adapter configuration.

      If you want to use an HTTP destination or URL set by the mapping, choose URL or HTTP Destination. (The indicator displayed depends on the Addressing Type you selected above). If you set the indicator, the URL or HTTP destination set dynamically is called by HTTP.

If the message header does not contain the URL or the HTTP destination, and you have set the Fail If Adapter-Specific Message Attributes Missing indicator, the XI message is set to status System Error. If you do not set the indicator, the URL or HTTP destination defined statically in the communication channel is used.

The technical names of the fields are:

       URL: TargetURL

       HTTP Destination: HTTPDest

      If you want to use HTTP header fields, choose Apply HTTP Header Fields and enter the fields in Field 1 to Field 6. The fields are embedded in the HTTP request under the names you enter here.

The technical names of the fields are HeaderFieldOne, .... HeaderFieldSix.

      If you want to use URL parameters, choose Apply URL Parameters and enter the parameters in the fields Parameter 1 to Parameter 6. The parameters are embedded in the HTTP request under the names you enter here.

The technical names of the fields are URLParamOne, …, URLParamSix.

      If you want to save HTTP header fields from the synchronous response in the XI message header, choose HTTP Header Fields (Synchronous Response) and enter the fields in the fields Field 1 to Field 6.

The fields must have the same names as the fields that are also to be sent in the HTTP response.

      The technical names of the fields are HeaderFieldOne,...,HeaderFieldSix.

The attribute namespace for the adapter is http://sap.com/xi/XI/System/HTTP.

 

 

 

 

End of Content Area