Академический Документы
Профессиональный Документы
Культура Документы
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
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.
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.
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.
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.
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.
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.
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.
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>
DocumentAuthor <USER1>
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.
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:
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
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
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
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