1 Oracle Integration Cloud Service – Use Case

Oracle Integration Cloud Service - Use Case

Load Exchange Rates in Oracle ERP Cloud

Introduction
An integration between different applications is one of the challenges for today’s developers. More
and more companies need to integrate their on premise and cloud applications. Such an integration
can be difficult and time consuming however using the right platform and tool can offer a lot of
benefit. Oracle Integration Cloud Service (ICS) is an integration platform and tool that makes
integrations more easy to implement with a shorter period of time.

This article describes how to use ICS to automatically load currency exchange rates in Oracle ERP
Cloud.

Business Use Case: Load Exchange Rates

Oracle ERP Cloud is an enterprise-wide SaaS suite that supports your financial, purchasing, project
and supply chain business processes. The suite runs on an Oracle technology stack in Oracle’s cloud
centres. Oracle ERP Cloud is accessible through both public and private cloud implementation.

The financial module supports different currency conversion rate types, allowing your business to
maintain different conversion rates between currencies for the same period.

The customer’s business case was to automate the load of exchange rates.

Challenges
Currently there are 2 options which oracle ERP supports.

1. The daily rates are entered manually using a spreadsheet as webadi.

2. Or load a spreadsheet manually and run a schedule job.

To overcome the manual process, we use the Integration solution provided by Oracle. Using Oracle
ICS we automate currency exchange rates with Oracle ERP in daily basis.

In ICS you can make easily connections to any system without knowing the technical details.
Adapters are provided for this, ICS delivers a lot of adapters for different applications or systems
2 Oracle Integration Cloud Service – Use Case

like ERP cloud, EBS, SOAP, FTP servers, … The figure below are the different adapters available in
ICS.

ICS has a Monitoring option to monitor the integration you built. The dashboard displays all the
messages and the success rate, at the left you can see the agents and the tracking tab can be used
to track a field or parameter in an integration. An Activity Stream or diagnostic logs can be
downloaded on the right.
3 Oracle Integration Cloud Service – Use Case

Creating the Integration

The first step is to make a connection with source and destination.

We have used a source here as REST connection to get the current rates from an API.

Let’s make a Rest connection

Configure ERP Cloud Connection

Again choose new connection in the connections tab. Select the ERP cloud adapter and give the
connection a specific name. Use the WSDL of the Company’s ERP Cloud for ERP Services Catalog
WSDL URL in the connection Properties, the ERP Events Catalog URL is optional. Choose ‘Username
Password Token’ as security policy and specify a user account name/password (to access ERP cloud)
for the security Username/Password. Now test the connection.
4 Oracle Integration Cloud Service – Use Case

Create Integration
The connections are configured, now we can implement the integration: it is triggered via a
Schedule process which will call a rest service to get the currency details,then maps the response
data into a request for bulk upload in ERP cloud, and leverages the ERP Cloud connection to upload
the currency rates.
To make a new integration: go to Integrations in the home tab and select new integration. There
are 4 possible integration patterns but in this case a simple Basic Map Data integration pattern can
be used because the integration maps incoming data from the EBS connection to invoke an ERP
Cloud service.

In our case, we are orchestrating the integration flow. As we are calling a rest service and the
response is being mapped to Oracle ERP Currency rates service.

The first step in defining an integration flow is the creation of the source and target connections.
On the right you can search for the right connection and the earlier created REST connection must
be dragged to the source part. Define a name for the endpoint of this connection and provide the
relative URI. You need to define the http method like GET, POST etc. You can configure the
endpoint to receive the response in a format.
5 Oracle Integration Cloud Service – Use Case

You can specify the parameters if needed. You have specify the format of the response in the
response payload file and specify the type of payload as reply.

As soon as you complete the above step. ICS automatically adds a mapping. You can use it if you
need to map anything specific to be mapped from scheduler to the rest service.
In our example, we have used date as the parameter, so that rest service will return only the
exchange rates for a particular day.

In the next step, we need to write the contents/response from Rest service into a CSV file. So we
drag a stage action and select a write operation.
6 Oracle Integration Cloud Service – Use Case

You need to select the File name and output directory of file to be written. Also you need to define
the structure of csv file by importing sample csv file.
7 Oracle Integration Cloud Service – Use Case

Once the write operation is completed, you need to zip the csv file so that Oracle ERP recognises
the same.

In the next step we will zip the file by using a stage file action again. You need to specify the
filename and the directory.

In the Next step, we drag the Oracle ERP adapter and configure the same. Configuration of ERP
adapter is mentioned below. Provide the name for the endpoint and select “Import Data into
Financials Cloud Application” as we are using the bulk Import option of Oracle ERP.
8 Oracle Integration Cloud Service – Use Case

In the next step, we select the Job name as “Import and Calculate Daily Rates”

Now specify the Notification Mode, where you will notified on the Job completion. You can also
specify the call back so that you can use the Job id further in your flow (if required).
9 Oracle Integration Cloud Service – Use Case

Once the above configuration is completed, you will automatically see a map action to map
between Zip file and Oracle ERP connection.
Below is the mapping between the Oracle ERP and ZIP file. Where you map the file reference and
File Name.

The last step is to save the integration and activate it, make sure enable tracing is selected.
After the activation the whole integration (figure below) is ready to use and you can test it.
10 Oracle Integration Cloud Service – Use Case

Test The Integration

To test the integration, we need to either schedule the integration or you can submit immediately
by clicking the “submit now”.

Note: Before clicking Submit Now or Schedule please make sure that Integration is active.

Or you can click schedule to run the process every night, so that currency rates are updated in
Oracle ERP.

You can specify the frequency of the Schedule job.

11 Oracle Integration Cloud Service – Use Case

Once the above configurations are done. You need to make sure to start the schedule.

Once the schedule is started you can see the runs in the Past runs.

You can click on the run and track the instance.

Once you see schedule is completed, integration is completed and you can verify the same on the
Oracle ERP.

The result of the integration must be a Currency Rates Manager in ERP Cloud. Login to ERP
Cloud with the same username/password used for the ERP Cloud connection in ICS and go Period
Close > Manage Currency rates > Daily rates tab. Enter the From Currency (EUR) and rate Date to
search for Conversion rates (figure below).
12 Oracle Integration Cloud Service – Use Case

Summary

The Use Case in this article shows that an integration with Oracle ERP with the real time exchange
rates isn’t hard to build if ICS is used. An REST adapter can be use on source side and an ERP Cloud
adapter on Target side. The most complex thing is the mapping between the two adapters in ICS
but there are predefined functions to simplify this, also we can download the integration to Oracle
Jdeveloper 12C and modify the mapping accordingly to the requirement.

The most important conclusions in this article are:

 ICS Delivers a lot of adapters to connect to a wide range of applications or systems

 There are different kind of integration patterns available
 Mapping is simplified through predefined functions
 On-premise integration to Cloud is possible using a connectivity agent

About the Authors

Yuvaraj works as Technical Consultant for SINUBE which is based in

Kontich, Belgium. He is a certified Oracle SOA Suite engineer and has
experience with Oracle Integration Cloud Service, a cloud solution
for integrations.