Running the Echo Sample

This sample demonstrates how to use simple logging with a REST Adapter as a trigger in a request-response orchestrated integration. The REST Adapter is triggered when you specify a URL. A browser response is sent to you. A logging message is created and logged to the activity stream for viewing. You also track the integration and monitor message status.
Description of sample_echo_integrat.png follows
Description of the illustration sample_echo_integrat.png

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 Echo 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 the following URL in a browser. You can also copy this URL from the Information icon for this sample.

    
    https://hostname:port/integration/flowapi/rest/ECHO/v01/{message}

    For example:

    
    https://my_pod.us.company.com:port/integration/flowapi/rest/ECHO/v01/Invoking my first integration.

What Results Do You See

  • You receive the following response in your browser:

    {
      "Message" : "Invoking my first integration.",
      "Welcome" : "\"Welcome to ICS!!!  Echo was successful.\""
    }

How To Monitor

  1. In the upper left corner, click the hamburger menu.

    hamburger menu being clicked
  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 integration is listed as completed.

    Description of sample_echo_tracking.png follows
    Description of the illustration sample_echo_tracking.png
  5. In the navigation pane, click Integrations and note the status of the message processed.


    Description of sample_echo_integrations.png follows
    Description of the illustration sample_echo_integrations.png

How To View

  1. Click the home icon icon.

  2. Click the Integrations box.

  3. Click the Echo 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 /{message} and a GET operation. The REST Adapter is triggered when you specify the URL in How to Run.

    • A logging message is created and logged to the activity stream. A browser response is sent to you.


    Description of sample_echo_integrat.png follows
    Description of the illustration sample_echo_integrat.png