Before You Begin

This 15-minute tutorial shows you how to design, activate, invoke, and monitor your first integration in Oracle Integration Cloud.

What Do You Need?

• An Oracle Integration Cloud subscription or trial subscription.

Create the Adapter Connection

Connections define information about the instances of each configuration you are integrating.

1. Sign in to your Oracle Integration Cloud instance: http://host:port/ic.
2. Click the Got it! button to dismiss any text overlays that are displayed.
3. On the Home page, click Create Connections.
4. In the upper right corner, click Create.
5. Enter REST in the Search field, then click the Search icon.

   

6. Select REST. The Create New Connection dialog is displayed.
7. In the Name field, enter Hello World.
8. From the Role list, select Trigger.

   

9. Click Create.
10. In the Email field, enter an email address to receive email notifications when problems or changes occur in this connection.  Note that a security policy of Basic Authentication is automatically selected. No additional configuration is required.
11. In the upper right corner, click Test. The message Connection Hello World was tested successfully is displayed.
12. Click Save, then click Close.

Create the Integration

Integrations are the main ingredient of Oracle Integration Cloud. When you create your integration, you build on the connections you already created by defining how to process the data for the connections.

1. In the navigation pane on the left, click Integrations.
2. Click the Got it! button to dismiss any text overlays that are displayed.
3. In the upper right corner, click Create.
4. Select Orchestration as the pattern to use. The Create New Integration dialog is displayed.
5. In the What do you want to call your integration? field, enter MyFirstIntegration, then click Create.

   

The integration canvas is displayed. You are now ready to design your first integration.

Design the Integration

1. In the right navigation pane, click Triggers.
2. Click REST, then drag the Hello World connection to the + sign.

   

   The Adapter Endpoint Configuration wizard is displayed.
3. On the Basic Info page, enter the following details, then click Next:

   Field	Description
   What do you want to call your endpoint?	helloWorld
   What is the endpoint's relative resource URI?	/{message}
   What action does the endpoint perform?	GET
   Select any options that you want to configure	Select the following: Add and review parameters for this endpoint Configure this endpoint to receive the response

   

4. On the Request Parameters page, accept all defaults, and click Next.
5. On the Response page, select JSON Sample in the Select the response payload file section.
6. Click <<<inline>>>, and enter the following message in the JSON sample field. 
   { "Message":"message", "Welcome":"Welcome to ICS! You have now designed your first integration!"}
7. Click Ok.
8. In the Select the type of payload with which you want the endpoint to reply section, select JSON, then click Next.

   

9. On the Summary page, review your selections, then click Done.

   

10. In the right navigation pane, click Actions.
11. Drag a Logger action immediately below helloWorld. A + sign is displayed.
12. Place the Logger action inside the + sign. The Create Action dialog is displayed.
13. In the Name field, enter logMessage, then click Create.
14. In the Log section, click Always.
15. In the Logger Message section, click the Edit icon.

    

16. Select the message element in the Source tree and  click the > sign. The syntax /nssrcmpr:execute/nssrcmpr:TemplateParameters/nsmprnumber:message is displayed in the Expression field. 
17. Click the Refresh icon to the right of Expression Summary. The message element is displayed.
18. Click Validate to show a message at the top indicating that the expression is valid, then click Close.

    

19. Click Close to return to the integration canvas.

    

20. Click the Map to helloWorld icon, then click the Edit icon. The mapper is displayed. The mapper enables you to map the source data structure to the target data structure.
21. In the Source section, drag the message element to the Message target element. A green line connecting the two elements is displayed.
    

    

22. In the Target section, click the Welcome element. The Build Mappings page is displayed.
23. Replace -- Drag and Drop or Type value here... with the following text: "Welcome to ICS!!! Echo was successful."
24. Click Save, then click Close to return to the mapper.

    

25. Click Validate. The following message is displayed: Mapping is valid and ready to use.
26. Click Close, then click Apply if prompted to apply your changes before exiting.
27. From the Actions menu in the upper right, select Tracking. Business identifiers enable runtime tracking of messages.

    

28. In the Source section, drag the message element to the first row of the Tracking Field column, then click Save.
    

    

29. View the completed integration.
• A REST Adapter is configured as a trigger (inbound) connection to invoke the integration.
• A logging message is created and logged to the activity stream. A browser response is sent to you.
• A mapper is configured to map the source and target data structures.



30. Click Save, then click Close. Design is now complete.

Activate and Run the Integration

1. In the row for the MyFirstIntegration integration, click the Activate icon, then click Activate when prompted.

   

2. Wait for the icon to turn green, indicating that the integration is activated. The following message is displayed in the green banner at the top of the page: Integration MyFirstIntegration (1.0) was activated successfully.
3. Click the icon immediately to the right of the Activate icon to display a popup message.
4. Click the endpoint URL in the message to access the Endpoint Description page.

https://hostname:port/ic/api/integration/v1/flows/rest/MYFIRSTINTEGRATION/1.0/metadata

5. Copy the endpoint URL that is displayed to a browser and replace {Message} with your message (Invoking my first integration.).

   https://hostname:port/ic/api/integration/v1/flows/rest/MYFIRSTINTEGRATION/1.0/Invoking my first integration.
   

6. View the following response in your browser:

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

Monitor the Integration

You can monitor the results of your invoked integration.

1. In the navigation pane, click the icon, then click Integrations.
2. Click the < arrow to the left of DESIGNER.
3. Click Monitoring.
4. Click Dashboards to show overall system status, including the percentage of successful messages, total number of messages, total number of successful messages, and total number of failed messages. You can also view the activity stream and download diagnostic logs and incident reports.
5. Click Activity Stream to view details about the integration invocation.
6. In the navigation pane, click Tracking and note that the integration is listed as completed.

   

7. In the navigation pane, click Integrations and note the status of the message processed.

   

Congratulations. You have now designed, activated, invoked, and monitored your first integration!

Want to Learn More?

• View a SaaS integration between Oracle Service Cloud (RightNow) and Oracle Sales Cloud