Running the Hello World Sample

This sample demonstrates how to use simple log and email notification actions with a REST Adapter in an orchestrated integration. The REST Adapter is triggered when you specify a URL. A switch activity with two rules is defined. If you provide an email address and name when triggering the REST Adapter, a browser response and email response are sent to you. If you provide only a name when triggering the REST Adapter, only a browser response is sent to you. With either switch rule, a logging message is created and logged to the activity stream for viewing. You also track the integration and monitor message status.

Complexity

None.

Prerequisites

None.

How To Activate

  1. On the Oracle Integration Cloud Service home page, click the Integrations diagram.
    The Integrations diagram for creating and activating integrations

  2. In the row for the Hello World sample, click the Activate icon, then click Activate when prompted.
    Description of sample_activate.png follows
    Description of the illustration sample_activate.png

  3. Wait for the icon to turn green, indicating that it is activated.

How To Run

  1. Enter one of the following URLs in a browser. You can also access these URLs from the Information icon for this integration.

    http://hostname:port/integration/flowapi/rest/HELLO_WORLD/v01/names/{name}
    http://hostname:port/integration/flowapi/rest/HELLO_WORLD/v01/names/{name}?email={email.address}

    For example:

    https://my_pod.us.company.com:port/integration/flowapi/rest/HELLO_WORLD/v01/names/Mark
    
    https://my_pod.us.company.com:port/integration/flowapi/rest/HELLO_WORLD/v01/names/Mark?email=mark.smith@mycompany.com

What Results Do You See

  • If you specified only your name, you receive the following response in your browser:

    {
      "Hello" : "Mark",
      "Message" : "\"Welcome to ICS!!!\"",
      "Email" : "\"Email address was not provided.\""
    }
  • If you specified your name and email address, you receive the following response in your browser:

    {
      "Hello" : "Mark",
      "Message" : "\"Welcome to ICS!  Check your email.\"",
      "Email" : "mark.smith@mycompany.com"
    }
    and you receive a Hello email with the following contents:
    Hello Mark,
    
    Welcome to Oracle Integration Cloud Service!

How To Monitor

  1. In the upper left corner of the page, click the The hamburger menu menu.

  2. In the navigation pane, click the home icon icon, then click the Monitoring diagram.

    By default, the Dashboard page displays overall system status, including the percentage of successful messages, total number of messages, total number of successful messages, and total number of failed messages. Details about currently used connections, currently activated integrations, and scheduled integrations are also provided. You can also view the activity stream and download diagnostic logs and incident reports. From the Integration Health dropdown menu, you can view overall system health and design time metrics.

  3. Click Activity Stream to view details about the invocation.

  4. In the navigation pane, click Tracking and note that the Hello World integration instance is listed as completed.


    Description of smaple_tracking.png follows
    Description of the illustration smaple_tracking.png
  5. In the navigation pane, click Integrations and note that the message was successfully received and processed without any errors.


    Description of sample_mon_integs.png follows
    Description of the illustration sample_mon_integs.png

How To View

  1. Click the home icon icon.

  2. Click the Integrations box.

  3. Click the Hello World integration.

    A read-only version of the integration is displayed for viewing. Because the integration is active, it cannot be edited.

  4. View the flow of the integration:

    • A REST Adapter is configured as a trigger (inbound) connection in the integration. The REST Adapter is configured with a resource endpoint of /names{name} and a GET operation. The REST Adapter is triggered when you specify the URL in How to Run.

    • A switch activity with two rules is defined:

      • If an email address and name are provided in the invocation URL (upper rule), a logging message is created and logged to the activity stream and a notification action is configured with parameters for your name and email address. The message body of the email is also defined in the notification action. A browser response and email response are sent to you.

      • If only a name is provided in the invocation (lower rule), a logging message is created and logged to the activity stream. A browser response is sent to you.


    Description of sample_integration.png follows
    Description of the illustration sample_integration.png