Configuring the Java HTTP Adapter on the Receiver Channel

Prerequisites

You have launched the PI integration directory for the Java HTTP adapter and have chosen to configure the receiver channel.

Context

You use this procedure to configure the receiver Java HTTP adapter to convert and transmit the XI message to remote applications by sending HTTP POST requests to a specified HTTP URL. You also configure the Java HTTP adapter on the receiver channel to specify the target system details.

Procedure

  1. In the Parameters tab, In the Transport Protocol , select HTTP 1.1 .
  2. Determine how the sender system sends the HTTP request and select one of the options for the message protocol.

    • POST

    • GET

  3. Select the Adapter Engine on the Integration server, or select a non-centrally installed Adapter Engine.
  4. In the Parameters tab, choose the General tab.
  5. In the Addressing mode , select URL Address .
  6. In the Target Host , specify the target host name or IP address
  7. In the Target Port , specify the port number of HTTP service on the target host.
  8. In the Path , specify the destination URL path.
  9. If you want the receiver adapter to transfer data to the target system using a secure connection, select Use SSL .

    If you want to authenticate the client using a client certificate, select Specify Client Certificate and specify details in the Keystore View and Keystore Entry .

  10. Select the type of User Authentication you want to use and specify the corresponding details for the selected authentication.
  11. If there is an intermediate proxy server between the receiver adapter and the receiver system, Choose Use Proxy and enter the HTTP Proxy Host and HTTP Proxy Port . If the proxy server requires authentication, specify the user name and password to access the proxy server.
  12. Determine the type of HTTP message the target system receives from the receiver channel and then perform the following steps.

    For more information, see HTTP Requests Supported by the Java HTTP Adapter .

  13. If the HTTP message from the receiver channel to the target system should be an HTML form submission, choose Set Form and enter the Main Payload Field Name to specify the name of the request parameter whose value contains the XI main payload.
  14. If the HTTP request is a multipart request where one or more different sets of data form the HTTP body, choose Set Multipart .

    If you want the attachments in the request to be delivered to the target system, choose Keep Attachments .

  15. If you want to specify the character encoding or the content type of the HTTP input, choose Specify Content Details and in the Character Encoding , enter the character set of the payload and in the Content Type , enter the content type of the payload.
  16. In the Parameters tab, choose the Advanced tab.
  17. If you want to specify the static header names and the corresponding values, in the Header Fields section enter the Name and Value .
  18. Select the any of the query parameters mentioned below that needs to be sent to the receiver.

    • Sender Party

    • Sender Service

    • Receiver Interface

    • Message ID

    • Quality-of-Service

    • Queue ID

  19. If you want to specify any additional query parameters, choose Additional Query Parameters and enter names and values for the additional query parameters.
  20. If you want to save adapter-specific attributes in the message header of the HTTP message, choose Set Adapter-Specific Message Attributes .

    • If you want to copy the XI dynamic header values into HTTP headers, choose HTTP Header Fields and enter the HTTP header names in the corresponding fields namely HTTP Header Fields (Field 1 (HeaderFieldOne),....,Field 6 (HeaderFieldSix))

    • If you want to copy XI dynamic header values into URL parameters of the HTTP message, choose URL Parameters and enter the HTTP URL parameter names that map to their respective dynamic headers in the corresponding URL parameter field namely URL Parameters (Parameter 1 (URLParamOne),...Parameter6(URLParamSix))

    • If you want to save the HTTP response headers into XI dynamic headers for a synchronous response scenario, choose HTTP Header Fields (Synchronous Response) and enter the HTTP response header names namely HTTP Header Fields (Field 1 (HeaderFieldOne),....,Field 6 (HeaderFieldSix))

    For more information, see Adapter-Specific Message Attributes in the Message Header .

  21. Set the Adapter Status to Active to enable the messages to be exchanged.
  22. Choose Set Additional Parameters and enter the Name and Value .
  23. In the Module tab, you can specify the modules for the adapter.

    For more information, see Adding Modules to the Module Processor .

Results

You have configured the Java HTTP adapter for the receiver channel.