If you want to deploy enterprise integration solutions that you’ve developed in the IBM® App Connect Enterprise Toolkit, without the need to acquire and maintain an IT infrastructure, App Connect on IBM Cloud™ can help. You can import a BAR file that contains all the artifacts that make up your integration solution, then run the contents in an integration server in App Connect on IBM Cloud.

This tutorial provides a basic example of deploying an integration solution to App Connect on IBM Cloud. The example uses the Transformation_Map application built and tested in Get started with IBM App Connect Enterprise. The steps demonstrate a subset of the capabilities for enterprise integration solutions in App Connect on IBM Cloud.

If you can’t find what youwor want, or have comments about this tutorial, please either add comments to the bottom of this page or .

First, find or create everything you need:

  • An App Connect service on IBM Cloud with enterprise integration capabilities; for example, as now provided in the free Lite plan. (For more details, see https://console.bluemix.net/catalog/services/app-connect.)
  • A valid BAR file that you’ve created in the IBM App Connect Enterprise Toolkit. For this example, we are using the Transformation_Map application built and tested in Get started with IBM App Connect Enterprise. That created the BAR file: C:\workspace\Transformation_Map\Transformation_Map.bar

    where C:\workspace is the location of your Toolkit Eclipse workspace directory on the filesystem.

    Tip: If you have not created the BAR file using your App Connect Enterprise Toolkit, you can download the project interchange ZIP file from https://github.com/ot4i, and extract the BAR file from that archive.

    For more about the App Connect Enterprise tutorials on Github, see Tutorials for App Connect Enterprise.


    (Click image to view full size)

Next, deploy and test your BAR file in App Connect on IBM Cloud:

  1. Launch App Connect on IBM Cloud.

    (Click image to view full size)

  2. Click New > Import a BAR file.
  3. Either click the “Import a BAR file” dialog box to select the BAR file from your file system, or drag the BAR file from your file system to the dialog box.
  4. Optional: You can edit the name if you want to (this will be the name of the integration server on the dashboard).
  5. Click Import.

    An integration server is created, and a tile is added to the dashboard to represent it. Initially, you’ll see the status as “Preparing”, which means that the contents of the BAR file are being unpacked onto the integration server. When preparation has finished, the status will show as “Stopped”, indicating that the integration server is ready to be configured and started.

    Tip: If you see a message saying that preparation failed, click Try again in the message to start preparation again.

    (Click image to view full size)

  6. (Optional) You can see a summary of the contents of the integration server by clicking the arrow The arrow icon that allows you to see a summary of the contents of an integration server on the tile.

  7. Examine the default configuration of the integration server, and optionally change values:
    • Open the integration server; for example, by clicking the tile, or by expanding the tile menu () and then clicking Open.
    • Add or edit a description for your integration solution (up to 128 characters).
    • Examine the HTTPS basic authentication, which is turned on by default. Optionally change the authentication settings or turn of basic authentication (see Configuring HTTPS basic authentication).
    • If you want to later view logs for the integration server, create a Logging policy and attach it to the integration server (see Viewing logs for your integration servers in App Connect on IBM Cloud)

    Copy the configuration details that you’ll use to test the integration solution (Transformation_Map.msgflow):

    • Under Transformation_Map.appzip, copy the HTTP Input value
    • From the Basic authentication credentials, copy the User name and password (or the HTTPS basic authentication header if you want to use that instead).
  8. When you’ve completed configuration, return to the App Connect on IBM Cloud dashboard and start the integration server by opening the tile menu and then clicking Start.
  9. Test the integration solution by sending it data using an HTTP client such as cURL. The steps are the same as in Get started with IBM App Connect Enterprise, but in this example the host is an IBM Cloud hostname and by default uses basic authentication, and the data submitted is raw XML from the Transformation_Map\input.xml file. For example, on a Windows computer where you used the App Connect Enterprise Toolkit, complete the following steps:
    1. cd C:\workspace

      where C:\workspace is the location of your Toolkit Eclipse workspace directory on the filesystem, which contains the Transformation_Map files including the input XML file C:\workspace\Transformation_Map\input.xml.

    2. Copy the contents of the input XML file C:\workspace\Transformation_Map\input.xml.
    3. Submit the cURL command to post the data copied from the input XML file:
      curl -X POST http_input -u 'username:password' -d '<?xml version="1.0" encoding="UTF-8"?>
      <SaleEnvelope>'
      ...
      		<CompletionTime>12.00.00</CompletionTime>
      	</Trailer>
      </SaleEnvelope>'
      

      (Enter)

      For example: curl -X POST https://ihavef0l.ace.ibm.com/Transformation_Map -u 'iib:o1B=c4ef' -d '<?xml version="1.0" encoding="UTF-8"?>...'

    The transformed response message should look like this:

    In a command window:

    <SaleEnvelopeA><SaleListA><Statement Style="Full" Type="Monthly"><Customer><Initials>KA</Initials><Name>Braithwaite</Name><Balance>00.50</Balance></Customer><Purchases><Article><Desc>Twister</Desc><Cost>0.48</Cost><Qty>01</Qty></Article><Article><Desc>The Times Newspaper</Desc><Cost>0.32</Cost><Qty>01</Qty></Article></Purchases><Amount Currency="Sterling">0.8</Amount></Statement><Statement Style="Full" Type="Monthly"><Customer><Initials>TJ</Initials><Name>Dunnwin</Name><Balance>81.84</Balance></Customer><Purchases><Article><Desc>The Origin of Species</Desc><Cost>35.74</Cost><Qty>02</Qty></Article><Article><Desc>Microscope</Desc><Cost>57.92</Cost><Qty>01</Qty></Article></Purchases><Amount Currency="Euros">129.41</Amount></Statement></SaleListA></SaleEnvelopeA>
    

    Or formatted, as in a result from Postman:

    <SaleEnvelopeA>
        <SaleListA>
            <Statement Style="Full" Type="Monthly">
                <Customer>
                    <Initials>KA</Initials>
                    <Name>Braithwaite</Name>
                    <Balance>00.50</Balance>
                </Customer>
                <Purchases>
                    <Article>
                        <Desc>Twister</Desc>
                        <Cost>0.48</Cost>
                        <Qty>01</Qty>
                    </Article>
                    <Article>
                        <Desc>The Times Newspaper</Desc>
                        <Cost>0.32</Cost>
                        <Qty>01</Qty>
                    </Article>
                </Purchases>
                <Amount Currency="Sterling">0.8</Amount>
            </Statement>
            <Statement Style="Full" Type="Monthly">
                <Customer>
                    <Initials>TJ</Initials>
                    <Name>Dunnwin</Name>
                    <Balance>81.84</Balance>
                </Customer>
                <Purchases>
                    <Article>
                        <Desc>The Origin of Species</Desc>
                        <Cost>35.74</Cost>
                        <Qty>02</Qty>
                    </Article>
                    <Article>
                        <Desc>Microscope</Desc>
                        <Cost>57.92</Cost>
                        <Qty>01</Qty>
                    </Article>
                </Purchases>
                <Amount Currency="Euros">129.41</Amount>
            </Statement>
        </SaleListA>
    </SaleEnvelopeA>
    

    You have deployed, run, and and tested an enterprise integration solution in IBM App Connect on IBM Cloud.

  10. When your integration server is running, you can view and download logs by opening the integration server and then clicking Download logs or View logs. To view the logs, you have to attach a Logging policy to your integration server (see Viewing logs for your integration servers.)

This tutorial has demonstrated a subset of the capabilities for deploying and running enterprise integration solutions in App Connect on IBM Cloud. If you want to explore more of those capabilities, see Running enterprise integration solutions in App Connect on IBM Cloud.

Join The Discussion

Your email address will not be published. Required fields are marked *