Tour: Explore an Integration That Sends a Hello World Message

This tour provides a walkthrough of a Hello World integration, including steps to monitor the integration.

To see a similar Hello World integration in your instance, you can install a Hello World recipe. Or, simply review the screenshots and steps below to understand the integration and your workflow. You can also build a Hello World integration from scratch. See Tutorial: Build Your First Integration From Scratch.

Step 1. View the Integration Design

This integration is based on an application integration. It triggers the REST Adapter when you specify the integration name. The integration creates a logging message and sends it to the activity stream for logging.
  1. In the navigation pane, click Design, then Integrations.

    This integration consists of the following:


    This integration consists of a trigger connection, a logger, a mapper, and a return icon.

    • A REST Adapter is configured as a trigger (inbound) connection in the integration. The REST Adapter is configured with a resource endpoint of /input/{Helloworld} and a GET operation. The REST Adapter is configured to receive a message and respond with a message. The REST Adapter is triggered when you specify an integration name on the Configure and run page.

    • A logger action is configured with a concat function that accepts the integration name you specify on the Configure and run page and concatenates it to the message.
      concat('Integration name is :', name)
    • A mapper maps the source value to the target message element.
    • A response is returned.

Step 2. View How to Run the Integration

  1. Hover your cursor over Hello World, then click Activate Activate icon.
  2. Click Activate when prompted.
  3. Wait for the icon to turn green and the word Active to appear in the Status column, indicating that the integration is activated.
  4. Hover your cursor over Hello World, then click Actions icon and select Run. The Configure and run page is displayed. This page is available only for REST Adapter-trigger based integrations and scheduled integrations.
  5. Enter Hello World, and click Run.


    The Configure and run page shows Endpoint Metadata and Track Instances buttons. The Get verb path is shown. In the Request section, the URI Parameters, Headers, Body, cURL, and Integration Properties tabs are shown. The URI Parameters tab is selected. A value of Hello World is entered in the field.

Step 3. View the Movement of Messages Through the Integration

The Activity Stream panel slides open on the Configure and run page. The activity stream shows the status of message processing through the major milestones of the integration.
  1. Expand the logger action to see the message.


    The activity stream shows the message flow. The logger action is expanded to show the message: Integration name is : Hello World.

Step 4. View How to Monitor the Integration

  1. Click the instance ID at the top of the Activity Stream panel. The Instance Details page provides a graphical view of the integration flow. The same Activity Stream panel is also visible on the right.


    The trigger, logger, mapper, and return icon are shown.

  2. Click < to return to the Configure and run page.
  3. Click Track Instances and note that the Hello World integration instance is listed as Succeeded in the Status column.


    The instance is shown in the table with columns for Primary Identifier, Instance Id, Status, Business Identifiers, and Duration.

  4. In the navigation pane, click Observability, then Integrations.

    The message is listed as successfully received and processed without any errors.


    The Integrations page shows a table with columns for Name, Received, Processed, Succeeded, Errored, Aborted, and Last Scheduled By. For this example, one message each has been received, processed, and succeeded.

Learn More About The Features in this Tour