Run the Sample Integrations

When you provision a new instance of Oracle Integration, the following sample integrations are automatically included. These samples help you get you up and running quickly and show you how easy it is to activate, invoke, and monitor an integration between endpoints.

See the following sections to run and monitor the samples. It is recommended that you run these samples in the following order because several samples build upon one another.

Sample Complexity This Sample Demonstrates How to ... See ...

Echo

None

Use simple logging with a REST Adapter as a trigger in a request-response orchestrated integration.

Run the Echo Sample

Hello World

None

Use simple log and email notification actions with a REST Adapter in an orchestrated integration.

Run the Hello World Sample

Hello World Invoke

Minimal

Call and invoke a simple REST web service in an orchestrated integration. Simple logging is also used.

Run the Hello World Invoke Sample

Hello World Data Map Invoke

Minimal

Call and invoke a simple REST web service using the Map Data integration pattern.

Run the Hello World Data Map Invoke Sample

File Transfer

Medium

Read an opaque file from a "/" directory and write the file to an "/upload" directory in a simple scheduled orchestration. After activating the integration, you go to the Actions menu and select Submit now or Add Schedule to run the scheduled integration.

Run the File Transfer Sample

Incident details from Service Cloud

Medium

Get incident details from the Oracle Service Cloud for an incident ID and send the incident details to the caller as a response.

Run the Incident Details from Service Cloud Sample

Note:

The documentation for running these samples is also available when you click the Information icon for an activated integration and select How to run.
Description of sample_runit.png follows
Description of the illustration sample_runit.png

Run 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. In the navigation pane, click 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/ic/api/integration/v1/flows/rest/ECHO/1.0/{message}

    For example:

    
    https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/ECHO/1.0/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 OIC!!!  Echo was successful.\""
    }

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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. In the navigation pane, click Integrations.

  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

Run 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. In the navigation pane, click 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/ic/api/integration/v1/flows/rest/HELLO_WORLD/1.0/names/{name}
    http://hostname:port/ic/api/integration/v1/flows/rest/HELLO_WORLD/1.0/names/{name}?email={email.address}

    For example:

    https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD/1.0/names/Mark
    
    https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD/1.0/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 OIC!!!\"",
      "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 OIC!  Check your email.\"",
      "Email" : "mark.smith@mycompany.com"
    }
    and you receive a Hello email with the following contents:
    Hello Mark,
    
    Welcome to OIC!

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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. In the navigation pane, click Integrations.

  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

Run the Hello World Invoke Sample

This sample demonstrates how to call and invoke a simple REST web service in an orchestrated integration. The REST Adapter is triggered when you specify a URL. The Hello World REST Adapter you previously used in the Hello World sample is invoked in the integration. The name and email address response are sent to you in JSON format. 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_invoke_integrat.png follows
Description of the illustration sample_invoke_integrat.png

Complexity

Minimal.

Prerequisites

The Hello World sample integration must be activated before configuring the connection in How to Configure.

How to Configure

Before you can activate and run this sample, you must configure the connection and security properties of the Sample Hello World Invoke REST Adapter used in this sample.

  1. In the navigation pane, click Integrations, then click Connections.

  2. Click Sample Hello World Invoke.

  3. Click Configure Connectivity to specify information to connect to the application/endpoint and process requests.

    1. For Connection Type, select Swagger Definition URL.

    2. For Connection URL, enter the following:

      https://hostname:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_INVOKE/1.0/metadata/swagger
    3. Click OK.

  4. Click Configure Security.

    1. Enter the username and password that you used to log in to Oracle Integration, then click OK.

  5. Click Test to test your configuration. A message is displayed that describes the results of the test. If successful, you are ready to activate the integration.

    Connection Sample Hello World Invoke was tested successfully.
  6. Click Save, then click Close.

How To Activate

  1. In the navigation pane, click Integrations.

  2. In the row for the Hello World Invoke 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

Enter one of the following URLs in a browser. You can also access these URLs from the Information icon for this integration.
https://host:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_INVOKE/1.0/info?name={Name}

https://host:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_INVOKE/1.0/info?name={Name}&email={Email Address}
For example:
https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_INVOKE/1.0/info?name=Mark
https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_INVOKE/1.0/info?name=Mark&email=mark.smith@mycompany.com

What Results Do You See

If you specified a name and email, you receive the following response in your browser:

{
  "Hello" : "mark",
  "Message" : "\"Welcome to OIC!  Check your email.\"You have successfully called a REST service!",
  "Email" : "mark.smith@mycompany.com"
}
and you receive a Hello email with the following contents:
Hello Mark,

Welcome to OIC!

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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 Hello World Invoke is listed as completed. Hello World, which was invoked by Hello World Invoke, has also completed.


    Description of sample_invoke_tracking.png follows
    Description of the illustration sample_invoke_tracking.png
  5. In the navigation pane, click Integrations and note that the messages were successfully received and processed without any errors.
    Description of sample_invoke_integrations.png follows
    Description of the illustration sample_invoke_integrations.png

How To View

  1. Click the home icon icon.

  2. In the navigation pane, click Integrations.

  3. Click the Hello World Invoke 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 /info and a GET operation, and retrieves a name and email address. This REST Adapter is triggered when you specify the URL in How to Run.

    • A logging message is created and logged to the activity stream.

    • The Hello World REST Adapter you previously used in the Hello World sample is invoked in the integration. The REST Adapter is configured with a business object of /name/{name}, a GET operation, and a request query parameter of email. The name and email address response are sent to you in JSON format.


    Description of sample_invoke_integrat.png follows
    Description of the illustration sample_invoke_integrat.png

Run the Hello World Data Map Invoke Sample

This sample demonstrates how to call and invoke a simple REST web service using the Map Data integration pattern. The REST Adapter is triggered when you specify a URL. The Hello World Invoke REST Adapter is invoked in the integration. The name and email address response are sent to you in JSON format. 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_data_map_integ.png follows
Description of the illustration sample_data_map_integ.png

Complexity

Minimal.

Prerequisites

The Hello World sample integration must be activated before configuring the connection in How to Configure.

How to Configure

Before you can activate and run this sample, you must configure the connection and security properties of the Sample Hello World Invoke REST Adapter used in this sample.

  1. In the navigation pane, click Integrations, then click Connections.

  2. Click Sample Hello World Invoke.

  3. Click Configure Connectivity to specify information to connect to the application/endpoint and process requests.

    1. For Connection Type, select Swagger Definition URL.

    2. For Connection URL, enter the following:

      https://hostname:port/ic/api/integration/v1/flows/rest/HELLO_WORLD/1.0/metadata/swagger
    3. Click OK.

  4. Click Configure Security.

    1. Enter the username and password that you used to log in to Oracle Integration, then click OK.

  5. Click Test to test your configuration. A message is displayed that describes the results of the test. If successful, you are ready to activate the integration.

    Connection Sample Hello World Invoke was tested successfully.
  6. Click Save, then click Close.

How To Activate

  1. In the navigation pane, click Integrations.

  2. In the row for the Hello World Data Map Invoke 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.

    https://hostname:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_MAP_DATA_INVOKE/1.0/info?name={Name}
    https://hostname:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_MAP_DATA_INVOKE/1.0/info?name={Name}&email={Email Address}

    For example:

    https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_MAP_DATA_INVOKE/1.0/info?name=mark
    https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/HELLO_WORLD_MAP_DATA_INVOKE/1.0/info?name=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 OIC!!!\"You have successfully called a REST service!",
      "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 OIC!  Check your email.\"You have successfully called a REST service!",
      "Email" : "mark.smith@mycompany.com"
    }
    and you receive a Hello email with the following contents:
    Hello mark,
    Welcome to OIC !

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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 Map Data Invoke instance is listed as completed. Hello World, which was invoked by Hello World Map Data Invoke, has also completed.


    Description of sample_map_data_track.png follows
    Description of the illustration sample_map_data_track.png
  5. In the navigation pane, click Integrations and note that the messages were successfully received and processed without any errors.


    Description of sample_data_map_int.png follows
    Description of the illustration sample_data_map_int.png

How To View

  1. Click the home icon icon.

  2. In the navigation pane, click Integrations.

  3. Click the Hello World Data Map Invoke 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 /info and a GET operation, and retrieves a name and email address. 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.

    • The Hello World Invoke REST Adapter is invoked in the integration. The REST Adapter is configured with a business object of /name/{name}, a GET operation, and a request query parameter of email. The name and email address response are sent to you in JSON format.


    Description of sample_data_map_integ.png follows
    Description of the illustration sample_data_map_integ.png

Run the File Transfer Sample

This sample demonstrates how to read an opaque file from a "/" directory and write the file to an "/upload" directory in a scheduled orchestrated integration. An FTP Adapter reads the file from the / directory and another FTP Adapter writes the file to the /upload directory. An assign action is configured to assign variables for the file name and file size. A logging message is created to indicate that the file name has been read. The message is logged to the activity stream for viewing. You also track the integration and monitor message status.
Description of sample_file_trans_int.png follows
Description of the illustration sample_file_trans_int.png

Complexity

Medium.

Prerequisites

None.

How To Activate

  1. In the navigation pane, click Integrations.

  2. In the row for the File Transfer 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 Configure

Before you can activate and run this sample, you must configure the connection and security properties of the Sample FTP connection FTP Adapter used in this sample.

  1. In the navigation pane, click Integrations, then click Connections.

  2. Click Sample FTP connection.

  3. Click Configure Connectivity to specify information to connect to the application/endpoint and process requests.

    1. For FTP Server Host Address, enter speedtest.tele2.net.

    2. For FTP Server Port, enter 21.

    3. Click OK.

  4. Click Configure Security.

    1. For Security Policy, select FTP Server Access Policy.

    2. For Username, enter anonymous.

    3. Enter the same password twice. You can use any password.

    4. Click OK.

  5. Click Test to test your configuration. A message is displayed that describes the results of the test. If successful, you are ready to activate the integration.

    Connection Sample FTP connection was tested successfully.
  6. Click Save, then click Close.

How To Run

  1. From the Actions menu for the integration, select one of the following options:.

    Description of sample_file_run.png follows
    Description of the illustration sample_file_run.png
    • Select Submit Now to run the scheduled integration immediately:

      1. View the following message at the top of the page. You are ready to monitor the results of the file transfer.

        Submit Now request to run integration File Transfer sample (verion_number) was submitted successfully with request id number.
    • Select Add Schedule to schedule a time at which to run the integration:

      The Run File Transfer sample page is displayed.

      1. Accept the default values for Type (Basic) and Frequency (Only Once).

      2. For This schedule runs, click the time and select Modify start date.

      3. Use the Calendar icon to specify a soon-to-occur start time, and click OK.

      4. Click Save, then click Close.

        The Schedule and Future Runs page is displayed.

      5. Click Start Schedule.

        The time at which the integration is scheduled to run is displayed at the bottom of the page.
        Description of sample_file_start_sch.png follows
        Description of the illustration sample_file_start_sch.png

      6. When the scheduled time passes, click the refresh icon. The scheduled integration is no longer listed, indicating that it has run.

      7. Click Close.

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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 scheduled integration. The log indicates the 1 KB file was uploaded to the /upload directory.


    Description of sample_file_act_st.png follows
    Description of the illustration sample_file_act_st.png
  4. In the navigation pane, click Tracking and note that the File Transfer sample integration instance is listed as completed. You can see the filename and file size, which enables you to look for particular files in case of problems.


    Description of sample_file_track.png follows
    Description of the illustration sample_file_track.png
  5. In the navigation pane, click Integrations and note that the message was successfully received and processed without any errors. For this example, Schedule is not defined is displayed because this scheduled integration was invoked with the Submit Now option.


    Description of sample_file_int.png follows
    Description of the illustration sample_file_int.png

How To View

  1. Click the home icon icon.

  2. In the navigation pane, click Integrations.

  3. Click the File Transfer 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:

    • The Schedule icon indicates that this is a scheduled orchestrated integration. The schedule invokes this integration.

    • An FTP Adapter (ReadFile) is configured to read a file in binary mode from the / directory of the server you specified in the Connections page. No schema is defined for this file transfer, so it is treated as an attachment.

    • A logging message is created to indicate that the file name has been read. The message is logged to the activity stream.

    • An assign action is configured to assign variables for the file name and file size. This enables you to track issues based on filename and size.

    • An FTP Adapter (WriteFile) is configured to write a file to the /upload directory on the same server that matches the file name pattern of 1KB%yyMMddHHmmssSS%.zip.

    • A logging message is created to indicate the file name has been uploaded to the /upload directory. The message is logged to the activity stream.


    Description of sample_file_trans_int.png follows
    Description of the illustration sample_file_trans_int.png

Run the Incident Details from Service Cloud Sample

This sample demonstrates how to get incident details from the Oracle Service Cloud for an incident ID and send the incident details to the caller as a response. The REST Adapter is triggered when you specify a URL. The Oracle Service Cloud (RightNow) Adapter is invoked in the integration. The Oracle Service Cloud (RightNow) Adapter is configured to get incident details from the Oracle Service Cloud. The incident response is returned 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_incident_integ.png follows
Description of the illustration sample_incident_integ.png

Complexity

Medium.

Prerequisites

To run this sample, you must first subscribe to Oracle RightNow Cloud and configure an Oracle Service Cloud (RightNow) Adapter connection. After subscribing, you receive the WSDL, username, and password to specify for the Oracle Service Cloud (RightNow) Adapter on the Connections page. See Creating an Oracle Service Cloud (RightNow) Adapter Connection.

How To Activate

  1. In the navigation pane, click Integrations.

  2. In the row for the Incident Details from Service Cloud 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

Enter the following URL in a browser with a valid incident ID value:
https://hostname:port/ic/api/integration/v1/flows/rest/SAMPL_INCID_DETAI_FROM_SERVI_CLO/1.0/incident/12
For example:
https://my_pod.us.company.com:port/ic/api/integration/v1/flows/rest/SAMPL_INCID_DETAI_FROM_SERVI_CLO/1.0/incident/12

What Results Do You See

You receive the following incident details response in your browser from the Oracle Service Cloud:

{
  "IncidentName" : "Survey Feedback",
  "LookupName" : "111206-000001",
  "CreatedTime" : "2011-12-06T22:35:11.000Z",
  "UpdatedTime" : "2011-12-06T22:35:11.000Z"
}

How To Monitor

  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Dashboards.

    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 incident ID.

  4. In the navigation pane, click Tracking and note that the Incident details from Service Cloud integration instance is listed as completed.


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


    Description of sample_incid_int.png follows
    Description of the illustration sample_incid_int.png

How To View

  1. Click the home icon icon.

  2. In the navigation pane, click Integrations.

  3. Click the Incident details from Service Cloud 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 /incident{id} and a GET operation, and retrieves the incident ID. This REST Adapter is triggered when you specify the URL in How to Run.

    • A logging message is created and logged to the activity stream.

    • The Oracle Service Cloud (RightNow) Adapter is invoked in the integration. The adapter is configured with an incident business object and a CRUD Get operation to get incident details from the Oracle Service Cloud. The incident response is returned to you.


    Description of sample_incident_integ.png follows
    Description of the illustration sample_incident_integ.png

Load Newer Versions of the Sample Integrations

When your instance is upgraded, the sample integration versions included with your previous instance version remain untouched and are not automatically updated. Because of this, you do not automatically get any samples that may have been updated to newer versions. To obtain the latest sample integration versions, you must perform the following steps. These steps enable you to load new sample integrations that overwrite previous integration samples with the same name and version. Any sample integrations you may have previously deleted are also reloaded. However, if a sample integration is active or locked, it is not overwritten.

To load newer versions of the sample integrations:

  1. In the navigation pane, click Integrations.

  2. In the upper right corner, click the ? icon.

  3. Select Get Samples.

  4. Click Get.

    The sample integrations are loaded in bulk. A message is displayed indicating that the sample integrations have been loaded successfully. Any active or locked integrations are not loaded.

Note:

Each sample integration is loaded as part of its own package. Therefore, if you delete one of the sample integrations and create a new integration with the same name and version, the integration is not overwritten as long as you do not include it in that package. In the navigation pane, click Integrations > Packages to see the package names associated with each sample integration.