You've reached the end of your free preview.
Want to read all 554 pages?
Unformatted text preview: Oracle® Hyperion Financial Data
Quality Management, Enterprise
Administrator's Guide Release 126.96.36.199.220
February 2019 Oracle Hyperion Financial Data Quality Management, Enterprise Edition Administrator's Guide, Release
Copyright © 2009, 2019, Oracle and/or its affiliates. All rights reserved.
Primary Author: EPM Information Development Team
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,
license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agencyspecific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the
programs, including any operating system, integrated software, any programs installed on the hardware,
and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.
No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of
their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,
the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle. Contents
Documentation Feedback 1 Using FDMEE
Supported Source Systems 1-1 File-Based Data Loads 1-2 Supported EPM System Target Applications 1-2 Key FDMEE Benefits 1-3 FDMEE Application Folder Architecture 1-3 FDMEE Architecture 1-6 Drilling Through 1-8 Drilling Through to the FDMEE Landing Page
Configuring Oracle Data Integrator With FDMEE 1-9
1-10 Set up the Data Server Based on the Enterprise Resource Planning (ERP)
Source System 1-10 Setting up Physical Schemas 1-11 Setting up the ODI Context Code 1-12 Setting up ODI to Integrate with JD Edwards 1-12 Security 1-17 Integration Process Overview 1-19 Extracting General Ledger Data 1-19 Writing Back Data from EPM Applications 1-19 Integrating Metadata 1-20 Understanding General Ledger Integration 1-20 Requirements 1-21 Required Dimensions 1-22 Member Properties Sourced from the Enterprise Resource Planning (ERP)
System 1-22 How Dimensions Are Processed 1-26 How Languages Are Processed 1-27 iii How Currencies Are Processed 1-28 Defining Metadata Rules 1-29 Loading Source System Hierarchies into EPM Dimensions 1-36 Extracting Human Resource Data
Navigating FDMEE 1-36
1-37 Toolbars 1-37 Help Menu 1-37 Task Pane Options 1-37 Workflow Tasks 1-37 Setup Tasks 1-38 Working with Data in Grids 1-39 FDMEE User Interface Elements 1-39 Advanced Search Options 1-40 Using the POV Bar 1-41 Selecting the Location POV 1-41 Setting the Period POV 1-42 Setting the Category POV 1-43 Locking and Unlocking a POV 1-43 Administration Tasks
Predefining a List of Profiles 1-44
1-45 Setting System-Level Profiles 1-45 Setting Application-Level Profiles 1-54 Setting User Level Profiles 1-59 Setting Security Options 1-61 Setting up Source Systems 1-67 Registering Enterprise Resource Planning (ERP) Source Systems 1-68 Registering File-Based Source Systems 1-70 Deleting Registered Source Systems 1-70 Editing Registered Source System Details 1-71 Adding File-Based Data Load Definitions 1-71 Working with Source Adapters 1-72 Using a Prepackaged Integration for SAP 1-72 Adding Source Adapter Definitions 1-73 Defining Source Adapter General Information 1-73 Defining Source Adapter Detail 1-76 Registering Target Applications 1-82 Creating a Custom Target Application 1-84 Adding Lookup Dimensions 1-87 Defining Application Dimension Details 1-87 Defining Application Options for Essbase and Planning 1-88 Defining Application Options for Profitability and Cost Management (HPCM) 1-96 iv Defining Application Options for Public Sector Planning and Budgeting 2 1-99 Defining Application Options for Financial Management 1-101 Deleting Registered Target Applications 1-110 Reusing Target Application Names Multiple Times 1-111 Selecting Source Accounting Entities 1-111 Assigning General Ledger Responsibility 1-112 Working with Source Accounting Entity Groups 1-113 Loading Excel Data 1-114 Downloading to Excel 1-115 Uploading from Excel 1-116 Integrating Tasks
Working with Import Formats
Defining the Import Format 2-1
2-2 Viewing Import Format Information 2-2 Adding Import Formats 2-3 Deleting an Import Format 2-5 Querying by Example 2-6 Defining Import Format Mappings 2-6 Defining the Import Format Mappings 2-7 Concatenating Source Dimensions for Enterprise Resource Planning (ERP)
Segments 2-8 Adding Import Expressions 2-9 Import Expression Types 2-10 Processing Order 2-13 Defining Import Formats for File-Based Mappings 2-14 Concatenating Source Dimensions for a File-Based Source 2-17 Using the Import Format Builder 2-18 All Data Types Data Loads 2-20 All Data Types Data Load Process Description 2-20 Setting the All Data Types Load Method 2-21 Setting the All Data Types Load Method 2-22 Setting the Import Format Data Types 2-22 Setting the Import Format for Multi-Column Data Types 2-24 Loading Incremental Data using the LINEITEM Flag to an EPM Application 2-29 Loading Multi-Column Numeric Data 2-32 Loading Periods as a Column from the Data File 2-35 Write-Back Mappings 2-36 Defining Import Formats for Data Synchronization Between EPM Applications 2-37 Defining Import Formats for Data Synchronization Between Enterprise Resource
Planning (ERP) and EPM Applications 2-38 v Defining the Write-Back Mappings (E-Business Suite and PeopleSoft only)
Defining Locations 2-40 Defining Period Mappings 2-43 Global Mappings 2-46 Application Mappings 2-46 Source Mappings 2-47 Defining Category Mappings 3 2-40 2-49 Global Mappings 2-50 Application Mappings 2-50 Integrating Data
Creating Member Mappings 3-1
3-1 Creating Mappings Using the Explicit Method 3-3 Creating Mappings Using the Between Method 3-4 Creating Mappings Using the In Method 3-5 Creating Mappings Using the Multi-Dimension Method 3-5 Using Special Characters in Multi-Dimensional Mapping 3-6 Creating Mappings Using the Like Method 3-7 Using Special Characters in the Source Value Expression for Like Mappings
Automap Wildcarding 3-10 Using Special Characters in the Target Value Expression 3-12 Format Mask Mapping for Target Values 3-13 Ignoring Member Mappings 3-16 Importing Member Mappings 3-17 Downloading an Excel Template (Mapping Template) 3-19 Importing Excel Mappings 3-20 Exporting Member Mappings 3-22 Deleting Member Mappings 3-22 Restoring Member Mappings 3-23 Defining Data Load Rules to Extract Data 3-23 Defining Data Load Rule Details 3-23 Defining Data Load Rule Details for a File-Based Source System 3-43 Defining Source Parameters for Planning and Essbase 3-45 Defining Source Parameters for Financial Management 3-46 Managing Data Load Rules 3-47 Editing Data Load Rules 3-48 Running Data Load Rules 3-48 Scheduling Data Load Rules 3-52 Checking the Data Load Rule Status 3-53 vi Deleting Data Load Rules 3-53 Working with Target Options 3-53 Creating Custom Options 3-54 Loading Exchange Rates to Financial Management 3-54 Using Drilling Through 3-56 Creating the Drill Region 3-57 Drill Through Components 3-58 Adding the Server Component for the Drill Through URL 3-58 Adding the Detail Component for the Drill Through URL 3-59 Viewing the Drill Through Results 3-60 Integrating with the EPM Cloud 3-63 Configuring the Secure Sockets Layer (SSL) Certificate 3-64 Pre-requisites 3-66 Setting up the EPM Cloud Deployment 3-67 Loading Data to the EPM Cloud or On-Premise Application 3-67 Exporting the EPM Cloud Application 3-67 Using the Data Load Workbench 3-67 Workflow Grid 3-68 Processing Data 3-68 Using the Workbench Data Grid 3-72 Viewing Process Details 3-80 Integrating with the Oracle Financials Cloud 3-81 Integration Process Description 3-82 Configuring a Source Connection 3-83 Working with Import Formats 3-86 Defining Locations 3-87 Defining Category Mappings 3-89 Data Load Mapping 3-89 Adding Data Load Rules 3-91 Processing Oracle General Ledger Adjustment Periods 3-92 Adding Filters for Data Load Rules 3-94 Drilling Through to the Oracle Financials Cloud 3-96 Writing Back to the Oracle Financials Cloud 3-96 Using Excel Trial Balance Files to Import Data 3-101 Text Trial Balance Files Versus Excel Trial Balance Files 3-101 Downloading an Excel Trial Balance Template 3-101 Defining Excel Trial Balance Templates 3-101 Adding a Multiple Period Data Load Using Excel 3-102 Importing Excel Mapping 3-103 Using Journal Templates to Import Data
Additional Considerations for Loading Journal Templates 3-104
3-104 vii Integrating Financial Management Journals 3-105 Downloading a Journal Template 3-106 Defining Journal Templates 3-106 Processing Journals 3-109 Loading Data Using a Universal Data Adapter 3-112 Defining a Universal Data Adapter in Oracle Database Integrator (ODI) 3-113 Configuring SAP HANA 3-116 Working with a Universal Data Adapter in FDMEE 3-117 Universal Data Adapter Source Systems and Import Formats 3-123 Universal Data Adapter Source Systems and Locations 3-123 Data Load Mapping for Universal Data Adapter Related Sources 3-124 Data Load Rules for Universal Data Adapter Related Source 3-124 Integrating Data Relationship Management with FDMEE 3-127 Setting up the Integration 3-127 Data Relationship Management and FDMEE Locations 3-129 Data Relationship Management and FDMEE Metadata Rules 3-129 Importing Data Load Mappings from Data Relationship Management 3-130 Financial Close Management Integration with FDMEE
Data Load, Synchronization and Write Back 3-131
3-132 Overview 3-132 Synchronizing and Writing Back Data 3-133 Data Synchronization 3-133 Write-Back 3-140 Loading Human Resources Data 3-151 Understanding Human Resource Data Integration 3-151 Requirements 3-152 Running Processes in PeopleSoft Human Capital Management 3-152 Defining the Data Load Settings in Planning 3-152 Public Sector Planning and Budgeting Dimensions 3-153 Smart Lists 3-153 Using Loaded Data in Public Sector Planning and Budgeting 3-154 Defining Human Resource Data Load Rules 3-154 Defining the Rule Details 3-154 Creating Rule Line Definitions by Copying 3-155 Creating Rule Line Definitions by Using a Template Mapping 3-156 Creating Rule Line Definitions 3-156 Creating Mapping Definitions 3-157 Managing Human Resource Data Load Rules 3-158 Editing Human Resource Data Load Rules 3-158 Running Human Resource Data Load Rules 3-158 Deleting Human Resource Data Load Rules 3-160 viii Checking the Human Resource Data Load Rule Status 4 Logic Accounts
Overview of Logic Accounts 4-1 Creating a Logic Group 4-1 Creating Accounts in a Simple Logic Group 4-2 Logic Group Fields 4-3 Expressions and Functions 4-4 Value/Expression 4-7 Seq 4-7 Export 4-7 Creating Summarized Logic Accounts 4-7 Complex Logic Example 1: CashTx 4-8
4-9 Sample Imported Values 4-10 Sample Imported Account Names 4-10 Final Result 4-10 Complex Logic Example 2: CashTx 4-10 Sample Imported Values 4-11 Logic Members 4-11 Final Result 4-12 Check Rules
Overview of Check Rules 5-1 Creating Check Rule Groups 5-2 Creating Check Rules 5-2 Rule Logic 5-4 Using the Rule Logic Editor to Create Check Rules 5-4 Adding Rule Logic 5-6 Adding a Rule Logic Statement as Free Form Text 5-11 Testing Check Rule Expressions 5-12 Running Check Reports for Profitability and Cost Management BSO
Essbase Cube 5-13 Creating Check Entity Groups 6 4-2 Operator and Value/Expression Creating Complex Logic Accounts 5 3-160 5-14 Batch Processing
Working with Batch Definitions 6-1 Adding a Batch Group 6-8 ix Executing Batches 6-8 Using Open Batches 6-9 Name Format for Open Batch Files 6-9 Naming Conventions 6-9 Open Batch Import and Export Load Methods 6-10 Creating Open Batches 6-11 Creating an Open Batch to Run an Integration with E-Business Suite
Creating Open Batches for Multiple Periods
Canceling a Scheduled Job
Working with Batch Scripts 6-13
6-18 Using Password Encryption 6-19 Executing the Batch Script for Data Load Rules 6-19 Setting the Parameters for Data Load Rules 6-20 Executing the Batch Script for Metadata Rules 6-21 Setting the Parameters for Metadata Rules 6-22 Executing the Batch Script for HR Data Rules 6-22 Setting the Parameters for HR Data Rules 6-22 Executing the Batch Script to Import Mapping Rules
Setting the Parameters to Import Mappings Rules 6-23
6-23 Executing the Batch Script for Data Load Rules to Write Back 6-24 Running a Batch 6-24 Setting the Parameters for Running the Batch 7 6-13 6-24 Creating and Using Scripts
Overview 7-1 Key Jython Concepts 7-1 Using the Script Editor 7-2 Overview 7-2 Launching the Script Editor 7-2 Script Editor Layout 7-2 Using Import Scripts 7-2 Overview 7-3 Creating Import Scripts 7-3 Import Script Parameters 7-4 Assigning Import Scripts to Import Formats 7-4 Using Import Script Functions 7-6 Extracting Beginning Characters 7-6 Extracting Middle Characters 7-7 Extracting End of String 7-7 x Using Split Functions 7-8 Using the Skip Function (Conditional Skip) 7-9 Storing and Retrieving Temporary Variables
Storing Temporary Variables
Retrieving Temporary Variables
Import Script Sample
Using Mapping Scripts 7-9
7-13 Overview 7-13 Creating Mapping Scripts 7-13 Using Jython Objects with Mapping Scripts 7-15 Mapping Script Samples 7-16 Using Event Scripts 7-17 Overview 7-17 FDMEE Supported Event Scripts 7-17 Creating Event Scripts 7-21 Stopping the Execution of FDMEE from within a Script 7-21 Dynamically Changing Import Formats 7-21 Using the File System Object in Event Scripts 7-22 Events Script Sample 7-23 Using Custom Scripts 7-25 Overview 7-25 Creating a Custom Script 7-25 Working with Custom Scripts 7-25 Adding a Custom Script Group 7-26 Registering Scripts 7-26 Executing a Custom Script 7-28 Executing a Custom Script from a Command Line 7-28 Custom Script Sample using Jython 7-28 Submitting a Data Load Rule 7-28 Submitting a Report 7-30 Using the JAVA API 7-31 Overview 7-31 JAVA API List 7-33 Working with UNICODE Characters in Jython Scripts 7-42 Using JAVA IDE to Develop Scripts 7-43 Using Visual Basic API and Samples 7-44 Overview 7-44 Registering the Visual Basic API DLL Manually 7-44 Visual Basic API List 7-45 API Class (clsAppServerDM) 7-45 Application Class (clsApp) 7-45 xi Connection Class (clsConnection) 7-46 DataManipulation Class 7-47 Utilities Class (clsUtilities.cls) 7-48 Data Access Class (clsDataAccess) 7-48 SQL Manager Class (clsSQLMgr) 7-54 SQL Class (clsSQL) 7-58 DB Tools Class (clsDBTools) 7-59 Maintenance Manager Class (clsMaintenanceMgr) 7-61 POV Manager Class (clsPOVMgr) 7-62 State Class (clsState) 7-64 Visual Basic Sample Scripts 8 7-66 Visual Basic Script to Send Email 7-66 Visual Basic Script to Copy a File to the Inbox 7-69 Visual Basic Script to Execute SQL 7-71 Visual Basic Script to Access Various Properties 7-73 FDMEE Reports
FDMEE Reports 8-1 Working with Query Definitions 8-2 Working with Report Definitions 8-3 Adding Report Groups 8-3 Working with Report Definitions 8-4 Creating a Report Template 8-6 Creating a XLIFF File for Translated Report Templates 8-7 Running Reports 8-8 FDMEE Detail Reports 8-10 Audit Reports 8-10 Account Chase Wildcard (TargAcct, Per, Cat) 8-10 Account Chase - Freeform (TargAcct, Per, Cat) 8-11 Map Monitor for Location 8-11 Map Monitor for User 8-12 Check Reports 8-13 Check Report 8-13 Check Report Period Range (Cat, Start Per, End Per) 8-14 Check Report With Warnings 8-14 Check Report By Validation Entity Seq. 8-14 Base Trial Balance Reports 8-15 TB Current Location, with Targets (Cat, Per) 8-15 TB Current Location with Rules (Cat, Per) 8-15 TB Current Locations, All Dimensions-Targets, by Target Entity-Account
(Cat, Per) 8-16 xii TB Current Locations, All Dimensions-Targets (Cat, Per) 8-16 TB Current Location, by Target Acct (Cat, Per) 8-17 TB Current Location, By Target Entity Account (Cat, Per) 8-17 TB Converted Current Location by Target Entity/Account 8-17 Listing Reports
Import Formats by Location 8-18 Location Listing 8-18 Location Analysis 8-19 Dimension Map For POV (Dimension, Cat, Per) 8-19
8-20 Process Status Period Range (Cat, Start Per, End Per) 8-20 Process Monitor All Categories (Cat, Per) 8-20
8-21 Account Chase Variance 8-21 Trial Balance Variance 8-21 FDMEE Web Service
executeDataRule A-1 executeMetaDataRule A-2 getDataRuleNames A-2 getLocationNames A-3 getPeriodNames A-3 lockPOV A-3 unlockPOV A-4 FDMEE REST APIs
URL Structure for FDMEE B-1 Running Data Rules B-1 Running Batch Rules B-4 Import Data Mapping B-6 Export Data Mapping B-8 Execute Reports C 8-19 Process Monitor (Cat, Per) Variance Reports B 8-19 Dimension Map (Dimension)
Process Monitor Reports A 8-18 B-10 Source System Tables Used by FDMEE
Fusion and E-Business Suite Source System Tables C-1 PeopleSoft Enterprise Financial Management Source System Tables C-3 PeopleSoft Human Capital Management Source System Tables C-5 xiii PeopleSoft Commitment Control Source System Tables C-5 Creating Synonyms for E-Business Suite Tables C-6 D Creating an Alternate Schema in an Enterprise Resource Planning
(ERP) Source System E Staging Tables
FDMEE Staging Tables
Staging Table Used for Import from Source E-2 Data Tables Used for Drill Through E-2 Views Used for Export to Target E-2 PeopleSoft Human Capital Management Staging Tables
CHARTFIELD F Archiving the TDATAMAPSEG Table G Working with Open Interface Adapters
Setting up the Open Interface Adapter E-3
E-15 G-1 Using the Open Interface Table G-1 Loading Source Data using Custom Loaders G-2 Customizing OD...
View Full Document
- Fall '19