You are on page 1of 15

Oracle Integration Cloud Service

The Designer Portal page shows the four pillars of ICS; Integrations, Connections, Lookups and
Packages.

Integrations: Connect two cloud applications, using available connections, and define
how they interact

Connections: Define connections to the cloud and on-promises applications

Before you can create integrations between cloud applications you need to define the
connections. It is also possible to create SOAP and Messaging Cloud connections out of the box,
but lets look at the connections first.

Connections
At this moment there are almost ten adapters out-of-the-box available:
Oracle ERP CloudConnector
for the Oracle ERP Cloud

Rest AdapterGeneric
Connector for REST APIs

Web Service (Soap)


AdapterGeneric Connector for
Web Services

Eloqua (Marketing
Cloud)Connector for the
Oracle Marketing Cloud

Oracle Messaging Cloud


ServiceConnector for the
Messaging Cloud Service

Oracle HCM CloudConnector


for the Human Capital
Management Cloud

Oracle Sales CloudConnector


for the Oracle Sales Cloud

Oracle RightNowConnector
for the Customer Service
Support Cloud

SalesforceConnector for the


Salesforce CRM (SaaS)

Click on the Connections image on the Developer Portal page to navigate to the list of
connections. By default all connections are listed. A connection can be in one of these three
statuses; draft, in progress or configured. Draft means is is not 100% finished, in progress means
a user is working on it right now, and configured means it is 100% done and the connection test
was successful.

You can look at only connections that are in progress or configured by clicking on the status in
the menu at the left side. If youre looking for specific entries to look at you can search by
entering the name of part of the name in the searchbox. You can use the * character as wildcard.

Each connections displays its name, version and the kind of application it connects to. Each kind
of application has its own image to differentiate itself from one another. Also the status and last
update date and user is shown.

Also if you click on the Connection Details icon a overlay appears with more details like the who
created the connection and when. On each connections some actions can be executed. A
connection can be edited, cloned or deleted. Some connection allow the metadata to be refreshed
like with the RightNow adapter.

Connection can be edited on the fly. If the WSDL url or the credentials change, the settings can
be updated. Lets look at the details of this RightNow connection.

You can assign an email address of an administrator to the connection. This address is used to
send notifications to when problems or changes occur in the connection. On the settings page, for
this adapter, you can configure the connectivity and credentials.

Configure the WSDL of the Right Now Cloud service

Configure the username and password to access the Cloud service with
Before a connection can be used by integrations it needs to be tested first. Click on the Test
button on the top right corner and if the test is successful a green notification, and if it fails a red
notification is displayed.

In a separate article, which will be published in the upcoming week(s), I will go in full details
about creating connections.

Integrations
after defining the connections it is time to create a integration between two cloud connections. At
this moment there are three types for integrations possible:
Map My Data
Drop source and target onto
a blank canvas

Publish to ICS
Connect your source to
send messages to ICS

Subscribe to ICS
Add targets to receive
messages from ICS
Click on the Integrations image on the Developer Portal page to navigate to the list of
integrations.

By default all integrations are listed. An Integration can be in one of these five statuses; draft, in
progress, configured, active or failed activation. Draft means it is not 100% finished, in progress
means a user is working on it right now, configured means it is 100% done, active means a
configured connections was successfully activated, and failed activation is an integration which
had problems during activation.

You can look at only integrations that are in progress, configured, active or failed by clicking on
the status in the menu at the left side.

If youre looking for specific entries to look at you can search by entering the name of part of the
name in the search-box.
You can use the * character as wildcard, for example KV*.

On a integration it is possible to execute a few actions based on its status. A connection can be
viewed, edited, cloned, exported and deleted. Active connections can be deactivated. Some
actions are disabled in certain statuses (e.g. it is not possible to edit an active integration).

When viewing or editing an integration the Integration Canvas is used.

It consist of a source and target adapter connection. Between the adapters you can create
mappings for the request and for the response flow. It is also possible to enrich data by calling a
secondary adapter (callout). This is possible on both the request as response flow just after the
source and target adapter.
Lets have a look at the source adapter and the target adapter. In this example both are Generic
SOAP connections. A Generic SOAP Connection can be created without the creation of a
connection first.

The first step consists of basic information and the choose to define the connection from an
existing schema or in this example a WSDL.

Secondly enter the WSDL URL and choose the Port Type and Operation to use for the incoming
adapter. Besides a source every integration needs a target. In this example this is also a Generic
SOAP connection, it works just like the source SOAP connection, but uses a different UI.

If extra data is needed that is not available in the request or reponse message of an adapter it is
possible to use callouts to a secondary adapter connection.

Because the data type of the request is different than of the response the data needs to be
mapped. Click on the Request Mapping to view, create or edit the mapping. The request mapping
is straight forward. The input is mapped to the only field available.

The response mapping, maps the response from the target adapter to the source adapter. If you
have call-outs the variable data is also available for this mapping. In the response mapping you
can have access to a maximum of four data objects.

To view the XSLT mapping behind it or to create more advanced mappings, click on a target
element name that you want to map. In this detailed view mode you can mapped source fields to
target fields, view the used XSLT syntax and you have the possibility to edit the structure using
Mapping Components.

Mapping Components include functions for conversions, dates and strings, and Operators and
XSL elements like choice, when, and other structures.

Below another example of a integration but this one connects a generic SOAP connection with
the Oracle RightNow adapter. Both the Web Service and RightNow adapter support Faults to be
passed through.

Each adapter has it own kind of connection setup wizard. RightNow supports different operation
modes (single or batch) and types (CRUD or ROQL). The CRUD operation type has four cloud
operations; create, detroy, get and update. The RightNow adapter works with Business Objects
defined in RightNow. It is possible to select multiple Business Objects.

In a separate article, which will be published in the upcoming week(s), I will go in full details
about creating integrations.

You might also like