Integration services (SOAP/HTTP inputs)

IBM Knowledge Center

Learn about integration services that use SOAP/HTTP inputs

Import projects

Click Import and an integration service project called TemperatureConverter will be added to your workspace, and the integration service editor will be opened to show you its contents. Next, click Prepare for an explanation of the different parts of the integration service editor.

Prepare the tutorial

Explore the imported integration service:

  1. In the main pane you will see the integration service editor, which you can reopen by clicking on the integration service Description inside the TemperatureConverter project. The editor has two tabs, one called Service and another called Interface.
  2. If you click on Interface, you will see the two web service operations which have been defined, along with their input and output types. These are called CtoF and FtoC.
  3. If you click back on Service, you will see a link for each operation name defined in the Interface tab, along with links for error handling (named Timeout, Failure and Catch). Click on each of CtoF and FtoC to see the subflow which implements that operation. There is a Mapping node in each one which performs a transformation on the input data, to convert between Celsius and Fahrenheit temperatures.
  4. Finally, click on the SOAP/HTTP Binding link and look at the Properties pane; this will show you properties which apply to all operations, such as the URL prefix and whether https is enabled.

Create an integration server and connect your App Connect Enterprise Toolkit:

  1. Assuming you are using a Windows platform, open an App Connect Enterprise Command Console and start an integration server using the following command:
    IntegrationServer --work-dir C:\TESTSERVER --name TESTSERVER --admin-rest-api 7600 --http-port-number 7800 --console-log
    where C:\TESTSERVER is a folder on your file system that the server will use for its working directory.
  2. In the App Connect Enterprise Toolkit Integration Explorer view, right click the folder and select the menu item . In the connection details panel, specify the Host name to be localhost, the Port to be 7600 and click Finish. This will connect your Toolkit and display the integration server that you started in the last step
  3. Locate TemperatureConverter.bar inside the TemperatureConverter integration service in the Application Development view, and deploy it by dragging and dropping the BAR file on to the integration server in the Integration Explorer view.

Test the integration service to complete the tutorial

Test the TemperatureConverter integration service by sending it data using an HTTP client such as cURL:

  1. cd C:\workspace
    where C:\workspace is the location of your Toolkit Eclipse workspace directory on the filesystem.
    curl -X POST http://localhost:7800/TemperatureConverter/TemperatureConverter -d @.\TemperatureConverter\CtoFrequest.xml
  2. This input message looks like this:
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://TemperatureConverter">
    <soapenv:Body>
    <tem:CtoF><TemperatureInC>0</TemperatureInC></tem:CtoF>
    </soapenv:Body>
    </soapenv:Envelope>
  3. The reply message should look like this:
    <?xml version="1.0" encoding="utf-8"?>
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
    <io:CtoFResponse xmlns:io="http://TemperatureConverter"><TemperatureInF>32</TemperatureInF></io:CtoFResponse>
    </soapenv:Body>
    </soapenv:Envelope>
  4. You can use the provided input file named FtoCrequest.xml to test the integration service's other operation.