Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Introduction
Integration Cloud Service (ICS) is a PaaS cloud offering from Oracle that provides capabilities of integrating applicatio
cloud and on-premise (on-prem). ICS provides rich set of connectors/adapters to connect to Oracle’s SaaS and on-pre
applications and many third-party cloud and on-prem applications. One such connector that ICS provides is the Oracle
Cloud Adapter which is used to connect to Oracle Cloud ERP. Oracle Cloud ERP (ERP) offers the most complete and
Enterprise Resource Management solutions for operations, GRC, and performance management.
ERP exposes web-services (mainly SOAP) to integrate with ERP. This blog shows how to use ICS to integrate with ER
may wonder if ERP exposed websevices then what’s the big deal in integrating with it? Why do we need this blog in th
place? While integration with ERP query services can be done in a simple manner, there are challenges dealing with b
services. So what are these challenges?
1. How can a very large file say 500 MB or more be read, transformed and uploaded to ERP?
2. How to handle zip files that ERP expects as input?
3. How to handle the callback response from ERP?
This blog looks into these challenges and provides a solution design to address these challenges using ICS. This blog
example of syncing Journal from a third-party application into ERP.
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 1/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 2/20
5/14/2018 Integrating with ERP Cloud using ICS
The source application’s data file may not be in the FBDI format always. In this case the source application data forma
be converted to FBDI format. This can easily achieved using ICS mapper functionality (XSLT) to transform from sourc
the destination format. However, there may be cases where the source generated file may be too large, for example, 5
Anyone who has experience dealing with on-premise integration products like Fusion Middleware (FMW) can tell that
large file in-memory is not a good approach. This is because there are chances of running out of memory reading the
memory. Since ICS is a PaaS offering, there has been checks on the file sizes that can be read with FTP Adapter. ICS
largest file that can be read in-memory using FTP Adapter to maximum of 1 MB. With this being the case, how could o
500 MB source file, transform to FBDI format and then upload to ERP? Fortunately, ICS has ability to chunk read the
source file. This feature is called the Stage Read. Stage Read is a map reduce feature within ICS. Prior to making use
Read in the ICS flow, one must make sure to download the file locally to ICS where ICS can read the file in chunks. Th
why the file must be downloaded to ICS prior to chunk reading it is because chunk reading from a FTP Server is very
With the above context, lets look at how the ICS flow to convert from source format to FBDI format looks like the below
The flow has been marked with logical numbers to explain the different steps involved to generate the FBDI format.
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 3/20
5/14/2018 Integrating with ERP Cloud using ICS
4| List File
List file is needed for ICS to determine how many FBDI files are written out.
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 4/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 5/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 6/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 7/20
5/14/2018 Integrating with ERP Cloud using ICS
The ERP Adapter takes the zip file containing the FBDI file and Property File as input. Since the read activity has rea
just the file reference and name needs to be passed to the ERP Adapter as shown below.
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 9/20
5/14/2018 Integrating with ERP Cloud using ICS
“CHILD”:[
{
“JOBNAME”:“Load File to Interface”,
“JOBPATH”:“/oracle/apps/ess/financials/commonModules/shared/common/interfaceLoader”,
“REQUESTID”:“603549”,
“STATUS”:“SUCCEEDED”
},
{
“JOBNAME”:“Transfer File”,
“JOBPATH”:“/oracle/apps/ess/financials/commonModules/shared/common/interfaceLoader”,
“REQUESTID”:“603548”,
“STATUS”:“SUCCEEDED”
}
]
},
{
“JOBNAME”:“Import Journals”,
“JOBPATH”:“/oracle/apps/ess/financials/generalLedger/programs/common”,
“REQUESTID”:“603550”,
“STATUS”:“ERROR”
}
],
“SUMMARYSTATUS”:“ERROR”
}
2. ZIP File
This zip file sent from the ERP contains the results of all the jobs that ran on ERP. The content of the zip file is expla
picture below.
Summary
With the help of ICS orchestration pattern, complex integration scenarios can be designed. ICS provided ERP Adapte
integrate with Oracle ERP Cloud. The ERP Adapter hides a lot of complexities integrating with ERP especially dealing
integration using FBDI. ICS also provides Stage Read feature which is a map reduce feature in ICS. This feature is ve
when large files are to be read by ICS. With rich set of connectors and features, ICS is a service of choice when it com
integrating between SaaS and SaaS or On-prem and SaaS. ICS offers the depth of integration capabilities dealing wit
SaaS and this blog has showed this for Oracle ERP Cloud.
All site content is the property of Oracle Corp. Redistribution not allowed without written permission
filed under: cloud, enterprise resource planning, integration cloud service, paas, uncategorized tagged with: erp a
cloud integration, ics, map reduce, map reduce ics, stage read
Comments
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 11/20
5/14/2018 Integrating with ERP Cloud using ICS
Hi Abhay,
Excellent article! thanks for this. I have a question. Is it it possible to have more than one entry in the manifest
file? the use case is to call multiple import jobs. I tried it but looks like it is invoking only the first job. Could you plea
know?
Regards,
Madhu
Log in to Reply
Log in to Reply
Sidhwartha says:
January 9, 2018 at 7:12 AM
Hi Abhay,
This is very helpful document…
— Sid
Log in to Reply
I have a question,
Q1: I tried it, if the trigger file is not in FTP, the integration will be failed. Is it what you expected?
Q2: What’s your schedule? If I set the schedule as every 10 mins, will it be too frequent and impact ICS instance’s
performance?
Thank you!
Regards,
Paula
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 12/20
5/14/2018 Integrating with ERP Cloud using ICS
Log in to Reply
Q2: 10 mins is the min schedule that you can set from the UI drop down. However you can use iCal express to s
lower value like 3mins.3mins is the min as it gets. The schedule depends on your requirement. 10 mins will not b
frequent and will not affect the ICS performance.
Log in to Reply
Binay says:
October 17, 2017 at 1:28 PM
Hi Abhay,
What happens to the files staged in ICS?
How do you delete those files from ICS?
Regards
Binay
Log in to Reply
Log in to Reply
Binay says:
November 2, 2017 at 5:46 PM
Hi Abhay,
Thanks for your response.
My requirement is to add a data validation using PL/SQL and as a part of that i tried inserting records in a DB
DB adapter and looks like it inserts record by record.
It took 31 mins to insert 1700 records
is this the way DB adapter insert will work or am i missing any step here?
Log in to Reply
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 13/20
5/14/2018 Integrating with ERP Cloud using ICS
1. We defined the callback in STEP 2. The integration flow identifier is “JOURN_3_CALLB_FUSIO_TO_ICS”. I supp
can obtain this integration after step 2. But I tried it out in ICS, it seems that what I understand is wrong. So it mean
need to create a new integration with identifier “JOURN_3_CALLB_FUSIO_TO_ICS” in STEP 3, right?
2. You mentioned “The callback ICS must exist in the same ICS instance”. I don’t quite understand. Do you mean w
to consume 3 ICS flows in a same java class client instance?
Log in to Reply
2. I don’t understand the question. But all the ICS flows needs to exist on the same ICS POD if this helps.
Log in to Reply
murfy92 says:
August 15, 2017 at 6:15 AM
I have tried to create a callback integration but no instances are being triggered. Is there any additional
config (not mentioned on article) that needs to be carried out for the callback to work?
Log in to Reply
Log in to Reply
Clyde says:
May 9, 2017 at 8:43 PM
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 14/20
5/14/2018 Integrating with ERP Cloud using ICS
Where can someone get more details around the properties manifest file? Sample version? I searched
everywhere and can’t find any real detail around what exactly needs to go into the file and its format.
Log in to Reply
Log in to Reply
Nice article. Can you provide list of business operations provided by ERP Cloud Adapter or any link for the docume
reference.
Please share your code for my understanding.
Regards,
Rakesh Soni
Log in to Reply
abhay.x.kumar@oracle.com says:
April 10, 2017 at 8:31 PM
You can get the list of business operations by running through ERP Adapter.
Log in to Reply
Regards,
Vikas Manchanda
Log in to Reply
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 15/20
5/14/2018 Integrating with ERP Cloud using ICS
abhay.x.kumar@oracle.com says:
April 10, 2017 at 8:32 PM
Thanks Vikas. I am glad you liked it.
Log in to Reply
Share
8
Categories
Categories
Cloud (327)
Recent Posts
GoldenGate Cloud Service (GGCS): How
to run SSH Socks Proxy Server for
Oracle GoldenGate (OGG)
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 16/20
5/14/2018 Integrating with ERP Cloud using ICS
Archives
Archives
Select Month
All content and s/w code on this site are offered without any warranty, or promise of operational quality or functionality.
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 17/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 18/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 19/20
5/14/2018 Integrating with ERP Cloud using ICS
http://www.ateam-oracle.com/integrating-with-erp-cloud-using-ics/ 20/20