Oracle by Example brandingCreating an Orchestrated Integration in Oracle Integration Cloud Service

section 0Before You Begin

This tutorial shows you how to create the integration of Oracle Internet of Things (IoT) Cloud Service and Oracle Service Cloud by using Oracle Integration Cloud Service. This tutorial takes approximately 15 minutes to complete.

Background

The integration of Oracle Service Cloud and Oracle IoT Cloud Service defines how to share information between these applications. This integration verifies if an incident for a device in Oracle IoT Cloud Service was already created in Oracle Service Cloud, and then creates an incident if it doesn't exist.

The following image illustrates the integration of Oracle IoT Cloud Service and Oracle Service Cloud using Oracle Integration Cloud Service. This tutorial covers the integration of the two connections created in the previous tutorial.

Service Cloud Integration
Description of the illustration sc_integration.png

What Do You Need?

  • A desktop or laptop computer running Microsoft Windows 8 or later, Apple macOS 10.9 or later, or Linux with a web browser
  • Access to an instance of Oracle Integration Cloud Service
  • Payload file iotcs_payload.json

section 1Create an Orchestrated Integration

  1. In a web browser, enter the URL for your instance of Oracle Integration Cloud Service, enter your user name and password, and click Sign In.
  2. On the Oracle Integration Cloud Service home page, click Integrations.
  3. On the Integrations page, click Create.
  4. In the Create Integration - Select a Style/Pattern dialog box, click Select in the Orchestration box.
  5. In the Create New Integration dialog box, enter IoTRightNowInt in the Integration Name field, leave the Identifier and Version fields with the default values, and then click Create.
    An empty integration appears.
    Adding a trigger connection
    Description of the illustration empty_integration_area.png

section 2Define an Inbound Trigger and an Outbound Invoke

  1. Click Triggers and select REST.
  2. Drag the POCIntTest connection from the Triggers panel to the Start circle in the integration area.
    The Adapter Endpoint Configuration dialog box appears.
  3. On the Basic Info page, enter or select the following values, and click Next:
    • Endpoint Name: fromIoTMessages
    • Endpoint URI: /
    • Endpoint Action: POST
    • Endpoint Payload: Selected
  4. On the Request page, enter or select the following values, and click Next:
    • Payload File: JSON Sample
    • Click Browse and in the File Upload dialog box, select the iotcs_payload.json file and click Open.
    • Payload: JSON
  5. On the Summary page, review your selections and click Done.
    Oracle IoT Cloud Service connection summary
    Description of the illustration iot_connection_summary.png
  6. Click Invokes and select Oracle RightNow.
  7. Drag the RightNowWind connection from the Invokes panel under the fromIoTMessages trigger.
    The Adapter Endpoint Configuration dialog box appears.
  8. On the Basic Info page, enter getListForId in the Endpoint Name field, and click Next.
  9. On the Operations page, select the following values, and click Next:
    • Operation Mode: Single Operation
    • Operation Type: ROQL (operation category) QueryObjects (operation)
      Operation type
      Description of the illustration sc_operation_type.png
    • In the text area, next to Parameters Bindings, enter the query:
       select Incident from Incident where Subject = '&devIdForm' and StatusWithType.Status.ID = 1
  10. On the Summary page, review your selections and click Done.
    Oracle Service Cloud configuration summary
    Description of the illustration sc_connection_summary.png
    The unconfigured getListForId map is created automatically.
    Part of the IoTRightNowInt integration
    Description of the illustration integration_part1.png

more informationWant to Learn More?

Creating Integrations