Tutorials for IBM App Connect Enterprise

You can use tutorials to improve your skills when you adopt IBM® App Connect Enterprise. Use the tutorials to try out different features of the product.

You can also use the discussion forum to ask questions for support or general topics.

Tutorials Gallery in the IBM App Connect Enterprise Toolkit

To get started with App Connect Enterprise in a practical way, you can use the tutorials that are provided in the Tutorials Gallery of the IBM App Connect Enterprise Toolkit.

You can open the Tutorials Gallery from the Welcome page or the Help menu. The Tutorials Gallery provides access to a set of tutorials that are stored in a GitHub repository, and automatically displays new tutorials when they are added to the GitHub repository.

From the Tutorials Gallery you can download, deploy, and test sample integration solutions. You can then explore the configuration of the solution components to learn how to develop integration solutions of your own.

Screen capture of the page with tutorials

For an example of how to use tutorials, see Get started with IBM App Connect Enterprise. This topic describes how the Transformation using a map in a message flow tutorial demonstrates how to use a Mapping node to transform data by using a map in a message flow.

Exploring the tutorials outside the IBM App Connect Enterprise Toolkit

To explore the App Connect Enterprise tutorials outside the Toolkit, or if you cannot access the tutorials from the Toolkit, you can access the tutorials from the GitHub repository.

Downloading tutorials manually

If you see Java™ connection errors when you try to view or import tutorials in the IBM App Connect Enterprise Toolkit, check the following network-related issues.
  1. A DNS error at your ISP.
  2. Inappropriate firewall restrictions, which cause the Toolkit to be blocked from using network connections, or prevents listening for the port that is used.
  3. The connection is trying to pass through a proxy.
  4. Temporary network issues.
If you continue to have connection problems from within the IBM App Connect Enterprise Toolkit, but you have a web browser connection to GitHub, you can manually download and import tutorials into the Toolkit. You can either see IBM App Connect Enterprise tutorials on Github, or use the following manual procedure.
  1. In your web browser, open the metadata.json file for the App Connect Enterprise Tutorials repository https://raw.githubusercontent.com/ot4i/ace-tutorials/gh-pages/v12/en/repo_metadata.json. Each tutorial is listed by name, with a short description and URLs for details, steps, and an archive file.
  2. To try a tutorial, look for the zipURL (the URL for the tutorial archive file) and stepsURL (the URL for the steps to run the tutorial) values; for example:
    "stepsURL": "https://ot4i.github.io/ace-tutorials/v12/en/#/./tutorials/integration-server-tutorial",
    "zipURL": "https://github.com/ot4i/integration-server-tutorial/releases/download/v3.0/PI_IntegrationServerTutorial.zip",
  3. Use your web browser to download the tutorial archive file from the zipURL location.
  4. In the IBM App Connect Enterprise Toolkit, import the tutorial archive file into the Application Development view by clicking File > Import > Project Interchange.
  5. Use your web browser to open the stepsURL page.
  6. Click the Run tab, then follow the steps to complete the tutorial.