Вы находитесь на странице: 1из 21

Fusion ERP Cloud Service

External Data Integration- Demo Flow

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 1
Agenda
• External Data Integration Services: Overview & Flow
• Inbound: Manual Flow
 Locate & Download File Importing Templates
 Prepare Data Files
 Steps to Load Data Files to UCM > Interface Table > Application Table > Verify log files
 Troubleshooting
• Inbound: Flow automation using Web Services
 Locate & Download File Importing Templates
 Prepare Data Files
 Pre-requisites
 Steps to Load Data Files to UCM > Interface Table > Application Table > Verify log files
 Troubleshooting

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 2
External Data Integration Services: Overview

• External Data integration services are used to load data into Oracle Fusion Applications from external
sources such as legacy systems and third-party applications.
• The following are the components in the overall process:
 Templates for structuring, formatting and generating the data file according to the requirements of the
target application tables.
 A File based load process for loading data from the data file into the interface tables.
 Application-specific data import processes for transferring data from interface tables to the application
tables in Oracle Fusion Applications.
• Journal import flow is used as an example to illustrate the inbound data integration flow with Oracle
Fusion Applications.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 3
External Data Integration Services: Flow

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 4
Inbound: Manual Flow

 Locate & Download File Importing Templates


 Prepare Data Files
 Load Data Files to UCM
 Load Data to Interface Table
 Import Data to Application Table
 Troubleshooting

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 5
Locate & Download File Importing Templates
• Locating Templates
 Sign in to Oracle Enterprise Repository - https://fusionappsoer.oracle.com.
 Enter the following information in the Search fields and click search:
Field Value
Search String FBDI
Type File Based Data Import
Product Family <product family>

 Click Search.
 Select your respective import process from the results pane. E.g. “Journal Import”.

• Downloading Templates
 After Locating the Template, click on the “Details” tab on the lower pane.
 Download the XLSM templates using the link provided. E.g. “JournalImportTemplate.xlsm” used for “Journal
Imports” process.

• Video – Locating and Downloading Template.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 6
Prepare Data Files
• Step 1: Open XLSM Template
• Step 2: Prepare Data in XLSM Template
 The first worksheet in each template provides instructions for using the template.
 Data must be prepared legitimately as per instructions.
 Data must conform to the Data Types, Specific Formats for Amounts/Date fields.
 Refer to the bubble text for additional information associated with the column.

• Save a copy of the file.


• Click the Generate CSV File button.
 Macro generates a comma-separated values (CSV) file and compresses it into a ZIP file

• Video – Preparing Data Files.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 7
Load Data Files to Content Server (UCM)
• File Import and Export UI lets you upload data file(s) to Content Server.
• Uploading for Import -- Uploading a file creates a record.
• Specify the UCM account associated with the process.
Refer: fusionappsoer > FBDI Process > Overview Tab > UCM Account

The import process picks up the file from the respective account.
• Steps to Import Zip File:
 Step 1: Navigation: Navigator Tools > File Import and Export.
 Step 2: Create a record by providing File and relevant Account details.

• Video – Uploading for Import.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 8
Load Data to Interface Table
• Loads external setup or transaction data from the file present on the Content Management Server to
interface tables.
• Pre-requisites:
 Prepare data file.
 Transfer the data file to the content management server.

• Steps to Import Zip File from Content Management Server to Interface tables:
 Step 1: Navigation: Navigator Tools > Scheduled Processes.
 Step 2: Schedule New Process by selecting the Target Import Process and Data File.
• Search and select the “Load Interface File for Import” job.
• When the Process Details page appears: Select the target import process and data file name.
• Refer: fusionappsoer > FBDI Process > Taxonomy Tab > Ess job
• Submit the process.

• Video – Uploading to Interface Tables.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 9
Import Data to Application Table
• Import setup or transaction data from interface table(s) to application table(s).
• Pre-requisites:
 Load data to Interface tables.

• Steps to Import data from Interface table(s) to Application table(s):


 Step 1: Navigation: Navigator Tools > Scheduled Processes.
 Step 2: Schedule New Process by selecting import process for the target application tables.
• Search and select the import process for the target application tables.
• When the Process Details page appears: Select the process that corresponds to the data that is getting imported.
E.g. “Import Journals”
• Submit the process.

• Video – Importing to Application Tables.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 10
Troubleshooting
• Correcting Import Process Errors:
 Correction spreadsheets
• Review the errors in the import log.
• Correct the data in the interface table by using spread sheet for error records.
• Re-Submit the import process.
• Video – Correction Spreadsheet.
 Purge process
• Review the errors in the import log.
• Run the purge process to delete all the records from the interface table.
• Correct the data in the data file and re-upload to UCM account.
• Entire process needs to be repeated.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 11
Inbound: Flow automation using Web Service
 Pre-requisites
 Locate & Download File Importing Templates
 Prepare Data Files
 Load Data Files to UCM
 Load Data Files to Interface Table
 Import Data to Application Table
 Troubleshooting

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 12
Pre-requisites
• Pre-requisites
 Importing certificate into your local keystore.
 Configure the sample web service tester.
 Identify the user name & password to invoke “Import Journals” process.
 Verify user access to “AttachmentsRead” role in the UCM.
 Verify the end point url for the web service
https://<domainname>/finFunShared/FinancialUtilService?WSDL
 Steps to construct the end point url
• Navigate to an application's dashboard/workarea page that belongs to Journals Service.
• Let us take the Journals workbench as an example, Url looks like: https://<domainname>/ledger/faces/JournalEntryPage
• The <domain name> might be like https://<pod-name>.<lba>.xxx.oraclecloud.com
• In above URL, take "https://<domainname>“ and append the static context root i.e. "/finFunShared/FinancialUtilService"
extracted from OER to it.

• Video – Pre-requisites
• Video – Referring OER for UCM account, Job package and definition name

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 13
Locate & Download File Importing Templates
• Locating Templates
 Sign in to Oracle Enterprise Repository - https://fusionappsoer.oracle.com.
 Enter the following information in the Search fields and click search:

Field Value
Search String FBDI
Type File Based Data Import
Product Family <product family>

 Click Search.
 Select your respective import process from the results pane. E.g. “Journal Import”.

• Downloading Templates
 After Locating the Template, click on the “Details” tab on the lower pane.
 Download the XLSM templates using the link provided. E.g. “JournalImportTemplate.xlsm” used for “Journal
Imports” process.

• Video – Locating and Downloading Template

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 14
Prepare Data Files
• Step 1: Open XLSM Template
• Step 2: Prepare Data in XLSM Template
 The first worksheet in each template provides instructions for using the template.
 Data must be prepared legitimately as per instructions.
 Data must conform to the Data Types, Specific Formats for Amounts/Date fields.
 Refer to the bubble text for additional information associated with the column.

• Save a copy of the file.


• Click the Generate CSV File button.
 Macro generates a comma-separated values (CSV) file and compresses it into a ZIP file

• Video – Preparing Data Files

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 15
Load Data Files to Content Server (UCM)
• Invoke Web Service Operation : uploadFileToUcm to load the data file.
• Steps to Import Zip File:
 Step 1: Prepare the payload to upload the file to Content Server by invoking the web service. Payload input parameters
details:
Payload Parameter Name Value Comments
Content <Output From the sample Run the base64 encoding sample program to provide the value of “Content”.
utilEncodeBase.java program>

ContentType zip Eg. “.txt”,”.csv” ,“.zip” for content type.

DocumentTitle <Sample Journal Import>

DocumentAuthor <USER1>

DocumentSecurityGroup FAFusionImportExport Fixed Value. Do not change.

DocumentAccount fin$/generalLedger$/import$ Provide Document Account & add ‘$’ as escape character before ‘/’
Refer: fusionappsoer > FBDI Process > Overview Tab > UCM Account

 Step 2: Use Service Tester to invoke the web service with the payload.
If Successful, Response contains Document Identifier else Error Code.

• Video – Upload File to UCM

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 16
Load Data to Interface Table
• Invoke Web Service Operation – submitESSJobRequest to load data to Interface tables.
• Steps to Import Zip File from Content Server to Interface tables:
 Step 1: Prepare the payload to upload the file to Interface tables via web service. Payload input parameters details:

Payload Parameter Name Value Comments


jobPackageName oracle/apps/ess/financials/commonModules/shared/common/interfaceLo
ader
jobDefinitionName InterfaceLoaderController
paramList 15 Value of “Import Journals” from the list of values.
paramList <372750> Document Id associated with file uploaded to UCM.
paramList N
paramList N

 Step 2: Use Service Tester to invoke the web service with the payload.
Response contains Request Identifier for Ess process.
 Step 3: Check Status of Request Submitted by using Web Service Operation - getEssJobStatus

• Video – Upload data to Interface table

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 17
Import Data to Application Table
• Invoke Web Service Operation – submitESSJobRequest to load data to Application tables.
• Steps to Import data from interface table(s) to Application table(s):
 Step 1: Prepare payload to import data from Interface to Application tables via web service. Payload input parameters
mapping details:
• Sign in to the Oracle Fusion Applications and Navigate to Navigator Tools > Scheduled Processes.
• Click the “Schedule New Process” button. Find and select the “Import Journals” process.
• Submit the process by entering the requisite parameters > Process Monitor > Select submitted process.
• In the “Details” region expand the “Parameters” node. Note ordered list of arguments along with their values.
Payload Parameter Name Value Comments
jobPackageName /oracle/apps/ess/financials/generalLedger/programs/common

jobDefinitionName JournalImportLauncher Refer: fusionappsoer > FBDI Process > Taxonomy Tab > Ess Job

paramList 1061 Data Access Set Identifier

paramList Expenses Source

paramList 1 Ledger Identifier

paramList ALL Group Identifier

paramList N Post Account errors to suspense account

paramList N Create Summary Journals

paramList N Import Descriptive Flexfields

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 18
Import Data to Application Table – Contd….
 Step 2: Use Service Tester to invoke the web service with the payload.
Response contains Request Identifier for Ess process.
 Step 3: Check Status of Request Submitted by using Web Service Operation - getEssJobStatus

• Video – Import data to Application tables.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 19
Troubleshooting
• Correcting Import Process Errors:
 Correction spreadsheets
• Review the errors in the import log.
• Correct the data in the interface table by using spread sheet for error records.
• Re-Submit the import process.
• Video – Correction Spreadsheet.
 Purge process
• Review the errors in the import log.
• Run the purge process to delete all the records from the interface table.
• Correct the data in the data file and re-upload to UCM account.
• Entire process needs to be repeated.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal 20

Вам также может понравиться