Oracle Financial Services Data Integration Hub · Data Integration Hub (DIH) enables to load the...
Transcript of Oracle Financial Services Data Integration Hub · Data Integration Hub (DIH) enables to load the...
-
Oracle Financial Services
Data Integration Hub
User Manual
8.0.3.0.0
-
Table of Contents
Page ii
TTAABBLLEE OOFF CCOONNTTEENNTTSS
PREFACE ........................................................................................................................................................ 4
Audience ..................................................................................................................................................................... 4
Prerequisites ............................................................................................................................................................... 4
Acronyms .................................................................................................................................................................... 4
Glossary of Icons ......................................................................................................................................................... 4
Related Information Sources ....................................................................................................................................... 5
1 INTRODUCTION TO DATA INTEGRATION HUB ............................................................................................. 6
1.1 Overview of Data Integration Hub (DIH) ..................................................................................................... 6
1.2 Benefits of DIH ........................................................................................................................................... 6
1.3 Summary of Chapters ................................................................................................................................ 7
2 DATA FLOW IN DIH.................................................................................................................................. 9
2.1 DIH Dataflow Diagram ............................................................................................................................... 9
2.2 Data Flow Environment without DIH ........................................................................................................ 10
2.3 Data Flow Environment with DIH ............................................................................................................. 10
3 LOGGING INTO DIH AND COMMON FUNCTIONALITIES .............................................................................. 12
3.1 Logging into DIH ...................................................................................................................................... 12
3.2 Common functionalities ............................................................................................................................ 13
3.2.1 Modifying a Parameter ................................................................................................................................. 13
3.2.2 Viewing a Parameter .................................................................................................................................... 13
3.2.3 Deleting a Parameter ................................................................................................................................... 14
3.2.4 Dependency ................................................................................................................................................. 14
3.2.5 Search and Filter .......................................................................................................................................... 14
4 SETTING UP THE PLATFORM AND PARAMETERS ...................................................................................... 15
4.1 Settings .................................................................................................................................................... 15
4.1.1 Editing the Settings ...................................................................................................................................... 15
4.2 Parameters .............................................................................................................................................. 17
4.2.1 Parameters in EDD Definition ....................................................................................................................... 18
4.2.2 Parameters in Connector ............................................................................................................................. 19
4.2.3 Defining a Parameter ................................................................................................................................... 19
5 DEFINING SOURCE SYSTEMS ................................................................................................................. 22
5.1 Creating an External Data Store .............................................................................................................. 22
6 EXTERNAL DATA DESCRIPTOR ............................................................................................................... 27
6.1 Creating an EDD ...................................................................................................................................... 27
-
Table of Contents
Page iii
7 SETTING ADI......................................................................................................................................... 34
7.1 Viewing an Application Data Interface ...................................................................................................... 34
8 MAPPING AN EDD TO ADI ..................................................................................................................... 36
8.1 Creating a Connector ............................................................................................................................... 36
8.1.1 Creating a Connector for Loading Data into Staging ..................................................................................... 41
8.1.2 Creating a Connector for Extracting Data from Staging ................................................................................ 46
8.1.3 Creating a Connector for Loading Data into Results ..................................................................................... 52
8.1.4 Creating a Connector for Extracting Data from Results ................................................................................ 58
8.2 Viewing a Connector ................................................................................................................................ 67
9 REFRESH .............................................................................................................................................. 68
9.1 Refresh ADI ............................................................................................................................................. 68
9.2 Refresh Target Datastores ....................................................................................................................... 70
10 PUBLISHING DIH METADATA.................................................................................................................. 71
10.1 Batch Publishing and Unpublishing .......................................................................................................... 72
11 OBJECT MIGRATION .............................................................................................................................. 73
11.1 Performing Object Migration .................................................................................................................... 73
11.2 Exporting Objects from Source Environment ........................................................................................... 73
11.3 Importing Objects from Target Environment ............................................................................................ 75
12 EXECUTING DIH METADATA .................................................................................................................. 76
13 EXECUTION HISTORY ............................................................................................................................. 78
13.1 Viewing the Execution History of a Connector ......................................................................................... 78
14 METADATA BROWSER ........................................................................................................................... 79
14.1 Connector ................................................................................................................................................ 79
14.2 External Data Descriptor .......................................................................................................................... 79
14.3 Application Data Interface ........................................................................................................................ 80
15 APPENDIX A .......................................................................................................................................... 81
15.1 Use Cases ............................................................................................................................................... 81
15.2 FAQ .......................................................................................................................................................... 84
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 4
PPrreeffaaccee
AAuuddiieennccee
Following are the intended audience for the DIH user guide:
ETL Developers: The ETL Developers from the IT Department of the financial services
institution, who do the data sourcing.
Business Analysts: The business analysts from the IT Department of the financial
services institution, who do the mapping of the tables.
PPrreerreeqquuiissiitteess
OFSAA application should be installed for the staging tables. This can be installed
before or after DIH.
Oracle Data Integrator (ODI) must be installed.
AAccrroonnyymmss
Acronym Description
DIH Data Integration Hub
UI User Interface
ODI Oracle Data Integrator
ADI Application Data Interface
KM Knowledge Module
EDD External Data Descriptor
Apps Application
GGlloossssaarryy ooff IIccoonnss
This manual may refer to all or some of the following icons.
Icons Description
To create a function
To Edit the details of a function
To View the details of a function
To Delete a function
To view Dependencies
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 5
RReellaatteedd IInnffoorrmmaattiioonn SSoouurrcceess
Along with this user manual, you can also refer to the following documents in the OTN documentation
library:
Oracle Financial Services Analytical Application-FCUBS Interface User Guide
Release 8.0.3.0.0
Oracle Financial Services Analytical Application-OBP Interface User Guide Release
8.0.2.0.0
Oracle Financial Services Analytical Application-DRM Interface User Guide Release
8.0.3.0.0
Oracle Financial Services Analytical Application-FAH Interface 8.0.2.0.0
Oracle Financial Services Data Integration Installation Manual Release 8.0.3.0.0
http://docs.oracle.com/cd/E60528_01/homepage.htm
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 6
11 IInnttrroodduuccttiioonn ttoo DDaattaa IInntteeggrraattiioonn HHuubb
This chapter provides an overview to Data Integration Hub (DIH), its benefits, and the structure of
remaining chapters in the user guide.
This chapter covers the following topics:
Overview of Data Integration Hub
Benefits of DIH
Summary of Chapters
11..11 OOvveerrvviieeww ooff DDaattaa IInntteeggrraattiioonn HHuubb ((DDIIHH))
Data Integration Hub (DIH) enables to load the data from the source systems to the OFSAA
staging tables, through logical interfaces, known as Application Data Interfaces (ADI).
Additionally, it enables extraction of data from the OFSAA system to downstream systems such
as file, and Oracle Database. DIH provides a set of User Interfaces (UI), which is used to define
and maintain External Data Descriptors (EDD), Application Data Interfaces, and also map the
EDDs and ADIs through Connectors. The mappings can be one to one, one to many, and
many-to-many.
The source systems that supply data include, the core banking systems, rating systems,
modeling systems, and so on. In the absence of DIH, the data from the source systems are
extracted, transformed, and loaded (ETL process) to the physical tables in Oracle Data
Integrator (ODI). With DIH, the ETL activity is not replaced; but DIH serves as an abstract,
logical layer to the physical tables in Oracle Data Integrator (ODI). In the logical layer, the entity
and attribute names are mentioned in Business terms in English. In the physical layer, the table
and column names are mentioned in technical terms.
The process is explained using the following example:
Let an attribute name in the logical layer be, Customer Account Number. The equivalent
column name in the physical layer is V_Account_Number. Using the Connectors in DIH, the
logical layer in ADI and physical layer in EDD are mapped. That is, in this case, Customer
Account Number is mapped to V_Account_Number. The advantage of having DIH is, when the
physical name of a column in an OFSAA table changes in the future, the financial institution
need not change their data extracts. This also results in saving time, effort, and money for the
migration activity.
Another major functionality of DIH is the support for Big Data. DIH supports source data in
formats like HDFS and Hive. Additionally, it supports DB2, Sybase, SQL Server and Teradata.
11..22 BBeenneeffiittss ooff DDIIHH
The benefits of DIH are as follows:
Provides a level of abstraction and insulates upstream ETL processes from staging model
changes.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 7
One of the examples is when the name of the table or column changes in the physical
layer, only the mapping with logical layer needs to be updated. This results in cost, time
and effort savings.
Support of Big Data.
Provides a simplified mapping screen for loading data into OFSAA staging via an abstract
layer.
Removes ETL technicalities by prepackaging and predefining ODI parameters based on
different use cases.
Download Specification is a system managed meta object for upstream data mapping.
Process/execution optimization for OFSAA data and known use cases. For example, in a
direct one-to-one mapping, there won’t be any hopping.
Hosts pre-defined integration with Oracle Products that play role of data providers to
Analytical Applications.
Helps in getting lineage right from source data to staging till results.
11..33 SSuummmmaarryy ooff CChhaapptteerrss
This user guide provides information on mapping of a External Data Descriptor (EDD) with
Application Data Interface (ADI). It begins with information on how a Parameter is defined, how
a Source System is defined in DIH, how an EDD and ADI are set, and how they are connected.
The metadata is then published to ODI. The execution part does not happen in DIH as it
depends on batches that are scheduled in the Financial Services Institutions. However, details
about that are mentioned in the last chapter.
The guide has the following chapters:
Data Flow in DIH: This chapter explains the flow of data in DIH.
Logging into DIH and common functionalities: This chapter explains how to login
to DIH and common functions such as modifying, viewing and deleting, using
Parameter as an example.
Setting up Platform and Parameters: This chapter explains how to configure and
edit the platform and parameters.
Defining Source Systems: This chapter explains how to define the External Data
Store information.
External Data Descriptor: This chapter explains how to define the source table/file,
and adding the different components
Setting ADI: This chapter explains how to configure the ADI for viewing an OFSAA
Data Interface
Mapping EDD between ADI: This chapter explains how to map one or more EDDs
to ADI and how to create and view a connector
Refresh: This chapter explains about the Refresh feature in DIH.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 8
Publishing DIH Metadata: This chapter explains how the DIH metadata is
transferred to Oracle Data Integrator (ODI).
Executing DIH Metadata: This chapter explains as to how after publishing, the
scheduled batches are executed.
Execution History: This chapter provides information about the execution history.
Metadata Browser: This chapter details the metadata browser.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 9
22 DDaattaa FFllooww iinn DDIIHH
This chapter provides high-level information of the data flow used in DIH.
22..11 DDIIHH DDaattaaffllooww DDiiaaggrraamm
The following is the DIH data flow diagram:
Start
Setup Platform and Variables
Define Source Data Structure
Create External Data Descriptor (EDD)Set Application Data Interface
(ADI)
Map EDD to ADI
Publish DIH Metadata
Execute DIH Metadata
Transfer Data to ODI
For mapping between the EDD and ADI, you need to define the parameter place holder
(optional), set up the source, define the EDD, and then connect the EDD and ADI. ADI is auto
seeded from the OFSA Applications data models that are installed.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 10
22..22 DDaattaa FFllooww EEnnvviirroonnmmeenntt wwiitthhoouutt DDIIHH
In this data flow environment diagram without DIH, the data is loaded from the source systems,
to the server in which OFSA Applications are installed (OFSAA Instance). In the OFSAA
Instance, data is loaded into the staging table.
SOURCE SYSTEMS
CORE
LOANS
DEPOSITS
GL
TREASURY
Load Data
ETL
ST
AG
ING
TA
BL
E
PR
OC
ES
SIN
G
RE
PO
RT
ING
OFSAA INSTANCE
22..33 DDaattaa FFllooww EEnnvviirroonnmmeenntt wwiitthh DDIIHH
The DIH is then used to pull data directly from the source tables, to the OFSAA staging tables.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 11
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 12
33 LLooggggiinngg iinnttoo DDIIHH aanndd CCoommmmoonn FFuunnccttiioonnaalliittiieess
In this chapter, details on how to log into the DIH application are explained. There are a few
common functionalities which are used in different modules of DIH. To avoid repetition, these
functionalities are explained under Common Functionalities section, taking Parameter as an
example.
This chapter has the following sections:
Logging into DIH
Common Functionalities
33..11 LLooggggiinngg iinnttoo DDIIHH
Access the DIH application using the login credentials (User ID and password). The built-in
security system ensures that you are permitted to access the window and actions based on the
authorization only.
After logging into the application, the following window appears:
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 13
Click the Data Integration Hub option in the Left Hand Side (LHS) of the menu. The DIH
window appears.
The DIH has the below five sub links for data mapping:
Administration
Application Data Interface
Data Mapping
Orchestration
Execution
33..22 CCoommmmoonn ffuunnccttiioonnaalliittiieess
You can modify, view, delete, and find dependencies of a Parameter, Source, EDD, ADI, and
Connectors. Following sections explains how this is done, taking the example of a parameter.
33..22..11 MMooddiiffyyiinngg aa PPaarraammeetteerr
You can edit an existing Parameter, other than the Parameter name.
To edit a Parameter:
1. Select the checkbox adjacent to the Parameter name.
2. Click Edit button from the tool bar. The edit parameter window appears.
3. Only the Parameter description, Parameter Type and the Value can be edited in this
window. Update the required details.
4. Click Submit to save the changes made.
33..22..22 VViieewwiinngg aa PPaarraammeetteerr
You can view a Parameter at any given point. To view an existing Parameter:
1. Select the checkbox adjacent to the Parameter name.
2. Click View button from the tool bar.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 14
The View parameter window displays the details of the selected Parameter.
33..22..33 DDeelleettiinngg aa PPaarraammeetteerr
This option only checks the higher order object. That is, if the order has dependency, you
cannot delete unless the dependency is removed.
Example: Assume Parameter is used in Connector. Then, unless that Connector is deleted,
the used Parameter cannot be deleted.
To delete an existing parameter:
1. Select the checkbox adjacent to the Parameter name.
2. Click Delete button from the tool bar. A confirmation dialogue appears
3. Click OK. The Parameter details are deleted.
33..22..44 DDeeppeennddeennccyy
As the name suggests, on clicking the Dependency icon , it lists where the entire parent
Parameter has dependency. That is, you cannot delete a child file without deleting the parent
file.
33..22..55 SSeeaarrcchh aanndd FFiilltteerr
The Search and Filter option in the user interface helps you to find the required information.
You can enter the nearest matching keywords to search, and filter the results by entering
information on the additional fields.
For example: enter the Parameter name as ‘GAAP’ in the search field.
Click the search icon to start the search or refresh icon to reset the search fields.
The entire Parameter name with GAAP is listed.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 15
44 SSeettttiinngg uupp tthhee PPllaattffoorrmm aanndd PPaarraammeetteerrss
This chapter has the following sections:
Settings
Parameters
44..11 SSeettttiinnggss
Setting up the platform and parameters (place holder) is the initial activity in DIH.
The Settings option allows in maintaining the Oracle Data Integrator (ODI) setup information
and application variables.
Click the Administration option from the LHS menu and select Settings option. The Settings
window appears in the RHS.
This window captures the ODI set up information.
NOTE: Only the DIH administrator is authorized to edit this field.
44..11..11 EEddiittiinngg tthhee SSeettttiinnggss
While editing the Settings, the fields that are displayed are explained as follows.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 16
FFiieellddss aanndd tthheeiirr ddeessccrriippttiioonnss
Fields Description
Fields marked in red asterisk(*) are mandatory
ODI User The ODI supervisor user name you defined when
creating the master repository or an ODI user name
you defined in the Security Navigator after having
created in the master repository.
ODI Password The ODI supervisor password you defined when
creating the master repository or an ODI user
password you defined in the Security Navigator after
having created the master repository.
Master Repository DB User Database user ID/login of the schema (database,
library) that contains the ODI master repository.
Master Repository DB
Password
This is the user's password.
Master DB Driver Specifies the driver required to connect to the
RDBMS supporting the master repository created
from the dropdown list. The default value is
oracle.jdbc.OracleDriver. It need not be changed if it
is on Oracle database.
Master DB Connection The URL used to establish the JDBC connection to
the database hosting the repository. The format is
jdbc:oracle:thin:@::
Work Repository The name of the work repository that has been
created previously (Example: WorkRep1).
Project Specify the Project Name created in ODI.
Folder Specify the folder name under the project created in
ODI so that all packages is created under this
location.
Agent URL Specify the agent URL where the ODI agent is
running. This is used to execute a DIH connector from
OFSAAI batch/RRF. This is not needed to do data
mapping. The format is http://:/
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 17
PPrroocceedduurree ttoo EEddiitt tthhee SSeettttiinnggss
1. Select the ODI User and click Edit button from the tool bar. The following
window appears.
2. Enter the ODI User, Master Repository DB User, Master DB driver, Master DB
Connection, Work Repository under the ODI Agent tab.
3. Under the Project Settings tab, enter the Project and Folder fields. The field details
are explained as tabulated in the Fields and their Description section.
4. Enter the details and click Submit.
The Audit Trail section at the bottom of the window displays the information of the activities
undertaken in this window. The User Comments section facilitates you to add or update
additional information as comments.
44..22 PPaarraammeetteerrss
Parameters are place holders and constant values that have different uses in DIH. Click the
Data Mapping option on the LHS. Select Parameters for the screen to appear.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 18
The uses of Parameters are explained in the following sections.
44..22..11 PPaarraammeetteerrss iinn EEDDDD DDeeffiinniittiioonn
While defining an EDD, parameter can be used as a place holder in a data filename.
For example:
Consider a table with 2 columns, such as Account number and Balance.
Account Number Balance
A1 1000
A2 1000
A3 1000
A1 1000
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 19
A2 1500
A3 1500
In the above example, a customer has 3 accounts (A1, A2 and A3).
The customer has deposited different amounts on January 1st and 2nd 2014. The csv data files
can be created for those two dates as follows:
The account transaction for January 1st 2014 is saved as
td_contracts_/01012014/.csv
The account transaction for January 2nd 2014 is saved as
td_contracts_/01022014/.csv
If a parameter, MISDATE is defined as a runtime, this can be used as a place holder that
substitutes date in mmddyyyy format. That is, the data filename can be mentioned as
td_contracts_%#MISDATE%.csv. When this file is called, it substitutes the date in the file
name, dynamically, in the run time.
Parameters Data Types need not always be RunTime. They can be Constants or values like
Current Date, which can also be used to substitute a value in a data filename.
44..22..22 PPaarraammeetteerrss iinn CCoonnnneeccttoorr
Parameters are used while defining the mapping, between EDD to ADI. While mapping the
ADI to EDD, the fields or columns within the ADI needs to be mapped to the fields in EDD. If
there are no corresponding extracts in EDD, parameters can be used to identify the default
values for certain ADI elements. Also, parameters can be used while defining derived
columns during mapping.
For Example: If you want to use the Runtime MIS date as parameter then, it needs to be
converted to a date first. So, the expression would be following.
To_char(to_date(#DIHDEV.MIS_DATE,’dd-MON-YYYY’),’MM’)
NOTE: Runtime batch MIS date will be in string format. It needs to be converted to DATE. The
date format used here should be a valid SQL date format.
44..22..33 DDeeffiinniinngg aa PPaarraammeetteerr
While defining a Parameter, the fields that are displayed are explained as tabulated.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 20
FFiieellddss aanndd tthheeiirr ddeessccrriippttiioonnss
Fields Description
Fields marked in red asterisk(*) are mandatory
Parameter Name The name for the place holder that you want to define.
For example, MISDATE, which can be used as a
place holder for Date.
Parameter Description The description for the parameter you want to define.
In this example, the description can be, “MISDATE
can be used to substitute the date values for each
day, dynamically, in mmddyyyy format.”
Parameter Type There are 3 parameter data types:
Constant: Constant data type is selected, for
substituting a constant value.
RunTime: RunTime data type is selected for
substituting a value dynamically, in run time. In
the example that is used here, MISDATE can
be selected as Run Time, because, it is used to
make a substitution, dynamically.
CurrDate: CurrDate data type is selected for
substituting a value as Current System Date.
Value Only for constant types. Holds the actual value that of
the parameter
PPrroocceedduurree ttoo ddeeffiinnee aa PPaarraammeetteerr
To define a new Parameter:
1. Click the Add ( ) button from the tool bar menu. The following window appears.
2. Enter the Parameter Name and description.
Example: Parameter Name: MISDATE
3. Select the Parameter Type from the drop down list and enter the Value in its
respective field.
The fields are explained as tabulated in the Fields and their Description section
4. Enter the above details and click Submit to save the changes made.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 21
The Audit Trail section at the bottom of the window displays the information of the parameter created.
The User Comments section facilitates you to add or update additional information as comments.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 22
55 DDeeffiinniinngg SSoouurrccee SSyysstteemmss
This option enables to define the External Data Store information. DIH supports Oracle database,
XML, EBCDIC, Flat file data sources, DB2, SQL server, Sybase, Teradata, and Big data sources
such as HDFS and Hive.
Click the Data Mapping option on the LHS and select External Data Store. The External Data
Store window appears in the RHS.
In the Source Systems section of the External Data Store window, you can define, edit, and delete a
source.
You can make use of the Search option to search for a specific Source.
This chapter has a section named Creating a Source.
55..11 CCrreeaattiinngg aann EExxtteerrnnaall DDaattaa SSttoorree
While creating a Source, the fields that are displayed are explained as tabulated.
FFiieellddss aanndd tthheeiirr ddeessccrriippttiioonnss
Fields Description
Fields marked in red asterisk(*) are mandatory
Source Name Is the name of the Source we are going to create. Example: USG_FILE_SRC. This
must be in uppercase.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 23
Fields Description
Fields marked in red asterisk(*) are mandatory
Source Description A description for the Source is to be mentioned.
Example: The landing zone where all the required files will be arrived for loading data
into OFSAA.
Source Type The available options are:
EBCDIC: Extended Binary Coded Decimal Interchange Code (EBCDIC) File is
a binary code for alphabetic and numeric characters.
FILE: American Standard Code for Information Interchange (ASCII) File is
a character-encoding scheme.
HDFS: Hadoop Distributed File System (HDFS) is an open source and
fundamentally a new way of storing and processing data. It enables distributed
processing of huge amounts of data across industry-standard servers that both
store and process the data, and can scale without any limits HDFS is Big Data in
a raw format.
HIVE: Hive provides a mechanism to project structure onto the data in Hadoop.
Big data in tabulated format. On selecting this option, all the HIVE type files are
displayed.
ORACLE DB: An Oracle database (DB) is a collection of data treated as a unit.
The purpose of a database is to store and retrieve related information. On
selecting this option, all the ORACLE DB type files are displayed.
XML: Extensible Markup Language (XML) is a markup language that defines a
set of rules for encoding documents.
DB2: IBM DB2 is a family of database server products. These products support
the relational model.
SQL Server: Microsoft SQL Server is a relational database management system.
It is a software product with the primary function of storing and retrieving data as
requested by other software applications which may run either on the same
computer or on another computer across a network.
Sybase: Sybase produces software to manage and analyze information
in relational databases.
Teradata: Teradata Corporation provides analytic data platforms, applications
and related services. Its products enable users to consolidate data from different
sources and make the data available for analysis.
With respect to the above example, select the Source Type as File.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 24
Fields Description
Fields marked in red asterisk(*) are mandatory
Note: For Db2/SQL Server/Teradata/Sybase to work as source for DIH, Jar files with
the following JDBC driver classes should be copied into the following paths:
1. /ficweb/webroot/WEB-INF/lib
2. /odi/agent/lib
DB2: com.ibm.db2.jcc.DB2Driver
SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver
Teradata: com.ncr.teradata.TeraDriver
Sybase: com.sybase.jdbc3.jdbc.SybDriver
These are third party libraries. Therefore, the names of the files may change for each
version. Refer to the documentation of these databases, for the exact name of the file
which contains these drivers.
This field changes depending on the Source type you select.
For example:
If the Source type is selected as File, the next field is File Location. In this field, you
need to mention the location of the file.
Example: /landingzone/inputfiles
If the Source type is selected as HDFS, in addition to File Location, the following field
appears:
HDFS JDBC URL: In this field, you need to mention the URL of the DB.
Example: hdfs://:
If the Source type is selected as HIVE, in addition to File Location, the following field
appears:
JDBC URL: In this field, you need to mention the URL of the DB.
Example: jdbc:hive://:/
If the Source type is selected as ORACLE DB, the following Fields appear
URL: In this field you need to mention the URL of the DB
Note: The JDBC URL of the DB should be defined using the service name of the DB
Instance. For example:
jdbc:oracle:thin:@//:/
User ID: Enter the User ID
Note: Only the tables that are a part of this Schema can be defined in the External
Data Descriptor Page.
Password : Enter a password
Schema: Enter the Schema name in upper case
If the Source type is selected as SQL Server, the following Fields appear
URL: In this field, you need to mention the URL of the DB
Note: The JDBC URL of the DB should be defined. For example:
jdbc:sqlserver://\SQLExpress
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 25
Fields Description
Fields marked in red asterisk(*) are mandatory
Location User ID: Enter the User ID
Password: Enter password.
Schema: Enter the Schema name
Note: Only the tables that are a part of this Schema can be defined in the External
Data Descriptor Page.
If the Source type is selected as Sybase, the following Fields appear
URL: In this field, you need to mention the URL of the DB
Note: The JDBC URL of the DB should be defined. For example:
jdbc:sybase:Tds::
User ID: Enter the User ID
Password : Enter password
Schema: Enter the Schema name
Note: Only the tables that are a part of this Schema can be defined in the External
Data Descriptor Page.
If the Source type is selected as Teradata, the following Fields appear
URL : where you need to mention the URL of the DB
Note: The JDBC URL of the DB should be defined. For example:
jdbc:teradata://
User ID: Enter the User ID
Password : Enter password
Schema: Enter the Schema name
Note: Only the tables that are a part of this Schema can be defined in the External
Data Descriptor Page.
If the Source type is selected as DB2, the following Fields appear
URL: In this field, you need to mention the URL of the DB
Note: The JDBC URL of the DB should be defined. For example:
jdbc:db2://[:]/
User ID: Enter the User ID
Password: Enter password
Database: Enter the database name
Note: Only the tables that are a part of this database can be defined in the External
Data Descriptor Page.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 26
PPrroocceedduurree ttoo CCrreeaattee aann EExxtteerrnnaall DDaattaa SSttoorree
To create a new source from External Data Store window:
1. Click Add button from the tool bar. The External Data Store window appears.
2. Enter the Source Name. Example: USG_FILE_SRC and enter a description for the
same.
3. Select the Source Type from the drop down list. Example: File.
4. The rest of the fields will change as per the option selected for Source Type. If
Source Type is selected as File, The File Location field needs to me mentioned.
The fields are explained as tabulated in the Fields and their Description section.
5. Click “Test Connection” to test the connection details (User ID/ Password) for the
database types DB2, HIVE, Oracle DB, SQL Server, Sybase, and Teradata.
6. Enter the above details and click Save.
The Audit Trail section at the bottom of the window displays the information of the source created.
The User Comments section facilitates you to add or update additional information as comments.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 27
66 EExxtteerrnnaall DDaattaa DDeessccrriippttoorr
The External Data Descriptor (EDD) allows defining or registering external source data structures
in DIH. The EDD definition can be used for loading and extracting data into/from OFSAA. The
control tab is not used for extraction. It is only used when reconciliation is required while loading
data into OFSAA.
Click the Data Mapping option on the LHS and select External Data Descriptor. The External
Data Descriptor window appears in the RHS.
This chapter has a section named creating an EDD.
66..11 CCrreeaattiinngg aann EEDDDD
While creating an EDD, the fields that are displayed are explained as tabulated.
FFiieellddss aanndd tthheeiirr ddeessccrriippttiioonnss
In the Source Data tab:
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 28
Fields Description
Fields marked in red asterisk(*) are mandatory
Data File Name You can add multiple data files to an EDD. For
example, You need to add Term Deposits Contracts
data file. There are Term Deposits Contracts data
files for Retail as well as Corporate accounts.
Therefore, to get both these details, you first add the
Term Deposits Contracts data file for Retail accounts,
say, td_contracts%#MISDATE%_1.csv and as the
next record, add Term Deposits Contracts data file for
Corporate accounts.
Example: td_contracts%#MISDATE%_1.csv
Record Delimiter The records are stored differently in different
operating systems. The options available are:
MS-DOS
Unix
No Record Delimiter
Other
With respect to the example, select Unix.
Read from template A template contains all the values and is in Excel file
format. If the template is not available, you need to
create it manually by clicking the Add button,
under Source Data Elements tab. If the template is
available, you can browse for the template. Refer to
the File SDI Template.
In the Data Elements tab:
Fields Description
Fields marked in red asterisk(*) are mandatory
Name Name of the field in EDD.
Example: Field name in a file or column name in a
table.
Note: Field name of XML type should not be more
than 25 characters and for others should not be more
than 30 characters.
http://docs.oracle.com/cd/E60528_01/books/DIH/Embedded_Files/File_SDI_Template.xlsx
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 29
Fields Description
Fields marked in red asterisk(*) are mandatory
Type This shows the Data type of the field.
Example: String, Number, EBCDIC and so on.
Physical Length This is applicable only for EBCDIC format. This is the
length of EBCDIC data type. In case of file, it is length
only.
Logical Length This is applicable only for EBCDIC format. This is the
logical length of EBCDIC data type. It gets
automatically calculated in template based EDD
creation. In case of file, it is available.
Precision It is to specify the decimal point.
Example: 10.3.
Format It is the format to specify the date format.
Example: YYYY-MM-DD. The format should be in
capitals.
Record Type Code This identifies the Record type in a file where Header,
Trailer and Data are of different record length and
type. The values can be any string available in the
text file. This value is only possible for the first field in
a file.
Example: The values can be DATA; CTRL to specify
it is a control record.
In the Control tab:
Fields Description
Fields marked in red asterisk(*) are mandatory
File Name Specify the name of the file.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 30
Fields Description
Fields marked in red asterisk(*) are mandatory
File Format There are 2 options:
Fixed Length: The file will have records and
columns with a fixed length. Each column will
have a predetermined and unchanging size, set
when the record layout is designed, and the
sum of the column sizes will add up to the
record size.
Delimited: There will be a separation of the
records and columns using a delimiter
character like comma, semicolon, hyphen and
so on.
With respect to the above example, select Delimited.
Column Delimiter If the File Format is selected as Fixed Length, the
Column Delimiter would by default be Other.
If the File format is selected as Delimited, the
following options are available in the drop down list.
Other
Space
Semicolon
Comma
Tab
With respect to the above example, select Comma.
Record Type Code Used to uniquely identify a record within a file. Many
times, Bank provides file having data and control
record within same file. In that case, in order to
distinguish between data record and control record,
the first field is Record Type. It has a specific value to
identify that. Here, specify the value that identifies the
Data. Values can be ‘DATA’ and so on. For Control
record, the value is specified under control tab. Only
the first field of a file is used for Record Type.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 31
Fields Description
Fields marked in red asterisk(*) are mandatory
Record Delimitter The records are stored differently in different
operating systems. The options available are:
MS-DOS
Unix
No Record Delimiter
Other
With respect to the example, select Unix.
Text Qualifier It’s a character that identifies a text. This is used
when some characters exists within a text. Generally,
double quotes are used, prefixed and suffixed with a
text. This is optional.
Skip number of records The number of records to be skipped is to be
mentioned. The records are skipped from the top.
Generally, this is to skip the Headers.
Decimal separator This mentions up to which decimal digit you want to
view the result in.
Record Type Length This is applicable only for Control records that are of
Fixed length. The length of the record type value to
pickup the correct record. For example, if control
record is “DATATotal Records400” .and DATA is the
Record type, the length is ‘4’.
Control Name Length Based on the above example, Control name is “Total
Records”. Hence, the Control Name Length is ‘13’.
Control Value Length Based on the above example, the Control value is
400. Hence, the length of the control Value is ‘3’
PPrroocceedduurree ttoo CCrreeaattee aann EEDDDD
To create a new EDD from the External Data Descriptor window,
1. Click the Add button from the tool bar. The External Data Descriptor
Specifications window appears. This screen is divided into two sections, Source
Details and External Data Descriptor Specification Details.
2. In the Source Details section, select the Source Code from the drop down list. The
Source Code is the Source you had created. In this example it is,USG_FILE_SRC.
The values in creating an external data store example are used. The description
comes up automatically.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 32
NOTE:
The fields in the External Data Descriptor Specification Details section changes
as per the Source Code selected.
For HDFS data, the working date format is yyyy-MM-dd.
For Hive table, the working date format is dd-MON-yyyy.
For Sybase source database, date data type is not supported. It has to be
timestamp.
For file extract, SDI date format is not supported. By default it produces
timestamp. If a particular format is required then derived column has to be
defined with specific format in connector.
3. In the External Data Descriptor Specification Details tab, enter the Name and
description.
For example:
Name: USG_FILE_EDD. This must be in uppercase.
Description: Term deposit data from USG source on daily basis.
In the Source Data tab, enter the Data File Name. To add more files to the existing
EDD, click the + symbol against the Data File Name field.
Example: td_contracts%#MISDATE%_1.csv
td_contracts%#MISDATE%_2.csv
4. Select the File Format, Record Delimiter, and Column Delimiter from the drop down
list.
5. Enter the Text Qualifier, Skip number of Records, and Decimal Separator fields.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 33
6. For the ‘Read from Template’ option, on selecting Yes, you can browse the required
template (only in .xls and .xlsx format). If the template is not available, you need to
create it manually by clicking the Add button, under Source Data Elements tab.
The fields are explained as tabulated in the Fields and their Description section.
7. If data needs to be reconciled post loading, then control has to be defined for the
EDD by clicking on Control Tab. In this version, only Number of records control is
possible.
8. Click Save.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 34
77 SSeettttiinngg AADDII
Application Data Interface data comes pre-seeded based on the application that is installed.
Application Data Interface enables to view the logical definition of OFSAA physical entities of
staging and Result area. This can be viewed by selecting application and its subtype.
This chapter has a section named viewing an Application Data Interface.
77..11 VViieewwiinngg aann AApppplliiccaattiioonn DDaattaa IInntteerrffaaccee
You can view an Application Data Interface at any given point. To view an OFSAA Data
Interface:
1. Select the Application from the drop down list and click on search icon.
2. Select the checkbox adjacent to the Application Data Interface name.
3. Click the View button from the tool bar. The Application Data Interface window
appears.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 35
4. Select one or more Application(s) for the given ADI. The list of applicable attributes
is mentioned below under Application Data Elements tab.
5. Depending on the ADI selected, there may or may not be additional subtype filters.
Such as, for Transactions: Customer Account, there is a Product Class list as
subtype filters available. You can choose one or more Product class to filter the
attributes listed below.
6. Depending on the Application selected, there will be additional filters such as
Jurisdiction and Approach for BASEL application.
The Search panel helps to search the attributes based on Attribute name, domain
and Staging and Results area. You can search all the relevant attributes for staging
and result area.
The Application Data Elements section has 2 tabs
Logical View
Physical View
The Logical view shows all the attributes and its associated description with additional information.
For example, if the attribute is mandatory or not for the selected application, its domain and LOV (List
of values) that are possible for the particular attribute.
The Physical view tab shows the underlying physical table name of the selected ADI. On selecting the
physical table name, it shows the mapping between the logical attribute name and its corresponding
physical column name.
In case of ADI with subtype such as Customer Account, the physical table name is based on the
Subtype. Hence, one or more physical table names may appear
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 36
88 MMaappppiinngg aann EEDDDD ttoo AADDII
Connector allows mapping one or more External Data Descriptor with Application Data Interface.
It allows mapping of one or more ADI with EDD as well, in case of extract type connector.
There are pre-built Connectors for Oracle applications such as, Flexcube, Oracle Banking
Platform, and so on. For other applications you need to define Connectors for your EDDs.
Click the Data Mapping option on the LHS and select Connector. The Connector window
appears in the RHS.
This chapter has the following sections:
Creating a Connector
Viewing a Connector
88..11 CCrreeaattiinngg aa CCoonnnneeccttoorr
To create a connector the following information should be decided at the beginning. Based on
the options the connector functionality varies.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 37
Fields Description
Fields marked in red asterisk(*) are mandatory
Which operation should this
connector perform on
OFSAA?
This option decides whether the connector will load
data into OFSAA or extract data out of OFSAA. This
field has two options:
Insert Data – Select this option when
connector should load data into OFSAA.
This is the default option.
Extract data – Select this option when the
connector needs to extract data.
On which OFSAA module
should this operation be
performed?
This field has two options:
Staging – When data needs to be loaded or
extracted into/from the staging area.
Results – When data needs to be loaded or
extracted into/from the Result area.
For which application (if
any) should this connector
be mapped?
This is an optional choice to filter source/targets at the
beginning.
For which External Data
stores (if any) should the
connector be mapped?
This is an optional choice to filter source/targets at the
beginning.
While creating a Connector, the fields that are displayed are explained as tabulated.
FFiieellddss aanndd tthheeiirr ddeessccrriippttiioonnss
In the Connector Details tab:
Fields Description
Fields marked in red asterisk(*) are mandatory
Connector Name The name of the Connector to be created.
Example: USG File Connector 1
Connector Description A description for the Connector is to be mentioned.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 38
In the Target tab:
Fields Description
Fields marked in red asterisk(*) are mandatory
Application Select the application from the drop down list.
Example: FSDF
Application Data Interface Select the Application Data Interface from the drop
down list.
Example: Customer Account
Sub Type Select the Product Class from the drop down list.
Example: Term Deposit
In the Properties tab:
The properties by default have some values. For every connector, it needs to be reviewed.
Generally, no change is required. If the change is required for every connector then, the
default value can be changed in the FSI_DIH_OPTIONS_B table.
The columns name is DEF_VAL_ID and DEF_TEXT_VAL.
Fields Description
Fields marked in red asterisk(*) are mandatory
Loading mechanism This option is only applicable for ASCII file source type
EDD.
This has two options:
External Table
SQLLDR
Note: If the loading mechanism is selected as External
Table, the file should be located in the same place as the
database server.
Please provide CREATE DIRECTORY role to the atomic
schema. And the path/folder used in the directory should
be having read, write permission.
DIRECT Direct path load of SQLLDR. Values can be True and
False. By default, it is set as TRUE. Only applicable for
ASCII/Text File source type EDD.
Parallel Parallel option. True means the loading happens with
parallel option and False means it happens in sequential
way.
Degree of Parallel Decides the degree of parallelism.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 39
Fields Description
Fields marked in red asterisk(*) are mandatory
No: of Errors Shows the number of errors allowed for the SQLLDR and
External Table to proceed. By default it is 0. That means
single record fails the job fails.
Maximum Discard Discarded records allowed for SQLLDR. This needs to be
set to a very high number when using multiple subtypes
under an ADI. That means it is multiple targets.
ODI FOLDER By default the value is same as whatever is set under
Settings page. The value decides under which folder in
ODI repository, the connector will be published. If user
needs to have a different folder name than whatever is
already set in the settings page, then this value has to be
edited before publish.
XML date Format In this field, you can define the format of the XML Date.
Example: MMDDYYYY.
Avoid Partition Exchange It has 2 values ‘Yes’ and ‘No’. By default it is set as ‘No’.
The parameter decides if the user wants to avoid
Partition Exchange option or not. The partition exchange
is used if the target table has partition and the connector
execution goes via temp table. Sometimes because of
some unknown reason, if the connector execution fails
due to partition exchange option, then user has an
opportunity to avoid partition exchange by selecting “Yes”
in the drop down list.
Do you want to use Data
Pump?
There are two values ‘Yes’ and ‘No’. By default it is set as
‘Yes’. If the value is ‘Yes’, it indicates that the Oracle
Database source is loaded into OFSAA using the Data
Pump method. Alternatively, the standard way of using
DBLink method is followed.
Note: Provide the following access is required for data
pump option.
- Grant create any directory to Source schema
- Grant create any directory to target schema
- Grant execute on DBMS_FILE_TRANSFER to
target schema
- Grant execute on utl_file to source schema
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 40
Fields Description
Fields marked in red asterisk(*) are mandatory
Source and Target in Same
Environment?
This parameter is used only if Data Pump is used. If the
value is ‘Yes’ then file transfer step is not performed
during loading. Alternatively, it will transfer file from
source to target folder using DBLink.
Source Dump Location
Specify a folder/path that is accessible by Source Oracle
Database to create the dump file.
Target Dump Location
Specify a folder/path that is accessible by Target Oracle
Database to read the dump file.
Number of Splits for Dump
File
Specify a number to transfer the files in parallel chunks.
For example, three, indicates that dump file will be split in
three and transferred separately. This is to improve
performance of file transfer.
Effective Dated Key for Result
Area?
This parameter is used for loading data into the result
area. It decides whether it will perform lookup into
dimension for latest record, or effective dated record. To
get the latest record, it appends f_latest_record_indicator
=’Y’ and for effective dated it appends mis_date between
d_record_start_date and d_record_end_date.
The default value is No. That indicates that it will append
f_latest_record_indicator=’Y’.
Note: For extraction data or any date attribute, effective
dating does not work. If this parameter is selected as
“Yes” and any date field needs to be loaded into
Extraction date or any other date field, then do not rely on
surrogate key generation. Use derived column and enter
the value in the format “YYYYMMDD” as a number.
Do you want to use DBLink? This parameter is used to specify the source database
connection method. There are two values ‘Yes’ and ‘No’.
By default it is set as ‘No’
If the value is ‘Yes’, it indicates connection source
database will be created using DBLink method
If the value is ‘No’ , it indicates connection to source
database will be created using JDBC url
Hive Date Format This parameter is used to specify the date format for date
columns in Hive source. the default value will be ‘yyyy-
MM-dd’
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 41
88..11..11 CCrreeaattiinngg aa CCoonnnneeccttoorr ffoorr LLooaaddiinngg DDaattaa iinnttoo SSttaaggiinngg
To create a Connector for loading data into staging follow the below steps:
1. Navigate to Data Mapping > Connector.
2. Click the Add button from the tool bar. The Connectors Definition window
appears.
3. The Definition tab provides the option to load and extract data. The options Insert
data and Staging are selected by default.
4. Click Next.
5. The ‘Source’ block of the flow chart is selected and the respective fields are
displayed by default.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 42
NOTE: When the Insert data option is selected, the EDD becomes source and ADI
becomes target. Similarly, if Extract Data option is selected, then ADI
becomes source and EDD becomes target.
6. Enter the Connector Name and description. The Fields and details are explained as
tabulated in “Fields and their descriptions” section.
7. Under the EDD Selector section, the available EDD’s are listed. Select the required
EDD in order to map it. The selected EDD’s are displayed in the ‘Source’ section as
displayed in the above figure.
8. In case multiple EDDs are selected, Add Join section appears below with selected
EDDs appearing on the left and right side. Select the fields from the Left and right
side, and join the fields. If LOOKUP is required, then check the lookup checkbox has
during the mapping.
NOTE: If Lookup option is checked, then the join would be left outer join. Else it
would be inner join.
9. To edit the filter expression, click icon. The Specify Expression window appears.
Select/key in the required expression and click OK.
NOTE:
You do not need to add ‘WHERE’ clause for the filter.
For File data loading, use filter expression of Number type along with single
quotes. For example: N_DRAWN_AMOUNT ='40000'.
For Date field refer To_CHAR function for comparison.
Parameters can also be used in filter expression. Date format must be a valid
SQL date format.
For Example:
[EDD_GL_DATA].[EXTRACTION_DATE] =
TO_DATE(#DIHDEV.MIS_DATE,’dd-MM-yyyy’)
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 43
10. If Source type is Hive, the filter expressions must conform to the following
restrictions:
Expression must be valid HiveQL
Does not include Oracle built in or user defined functions
Does not include Sub queries
Includes Hive built in functions only
Parameters can also be used in filter expression. MISDATE can also be
passed dynamically so that it is loaded from Batch Execution Screen. The date
format specified must be valid Hive Date format i.e. yyyy-MM-DD
For Example:
Filter Expression in Connector:-[EDD_GL_DATA].[EXTRACTION_DATE] =
#DIHDEV.MIS_DATE
MISDATE Parameter in Batch:
MISDATE=$MISDATE:yyyy-MM-dd
NOTE: This is only applicable if the patch 8.0.2.1.4 (Bug - 24487929) is applied.
11. Click Next. The ‘Target’ block appears.
12. Select Application Data Interface from the available list in the left panel. Import that
to right side of the panel. The Selected ADI grid shows the selected ADIs along with
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 44
filter expression. The filter on target can be applied by clicking the filter expression.
The Fields and details are explained as tabulated in “Fields and their descriptions”
section.
NOTE: If multiple sub types/ADI is selected, then the filter expression is necessary to direct
required data into the correct entity/table.
This is required to identify which record goes into which target. It will be an
expression such as . = ‘TD’ under Term deposit and
. = ‘CARDS’ under Cards.
13. Click the Mapping block in the flow chart, to map the EDD’s. For details on Auto-
mapping refer to section Auto-mapping.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 45
14. Select the EDD from the drop down list. For details on drop-down options for EDD
refer to section Options in Mapping EDD.
15. Select the ‘Mandatory’ option to populate the mandatory Attributes to be mapped.
NOTE: On selecting ‘Derived Column’ option as EDD from the drop down list, you
can add an expression.
All the mapped attributes are listed under the ‘Column Mapping’ sector. For details
on the options in the Mapping grid such as Auto-mapping, Export to Excel and so
on; refer to section Fields in Mapping.
NOTE: If the application is chosen as BASEL, while mapping, you can select the
type of approach (such as, IRB or Advanced Approach) and the
Jurisdiction (BIS, BRAZIL, China, India and so on) for filtering.
16. Click the Properties block in the flow chart. The Properties related fields and the
Connector details appear automatically.
17. Select the Loading Mechanism. Select the Direct and Parallel option from the drop
down list. Key in the value for Degree of Parallel, No: of Errors, Maximum Discard,
ODI Folder, XML Date Format, Do you want to use Data Pump?, Source and Target
in Same Environment?, Avoid Partition Exchange, Source Dump Location, Target
Dump Location, Number of Splits for Dump File, Hive Date Format, Effective Dated
Key for Result Area? and Do you want to use DBLink?. The Fields and details are
explained as tabulated in “Fields and their descriptions” section.
18. Click the Summary block in the flow chart to view the summary of all sections.
OFSAA_DI_8.0.1_User%20Guide.docx#mapping_edd_optionsOFSAA_DI_8.0.1_User%20Guide.docx#Fields_in_mapping
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 46
19. Click Publish. This converts DIH metadata into ODI objects.
The Audit Trail section at the bottom of the window displays the information of the
source created. The User comments section facilitates you to add or update additional
information as comments.
88..11..22 CCrreeaattiinngg aa CCoonnnneeccttoorr ffoorr EExxttrraaccttiinngg DDaattaa ffrroomm SSttaaggiinngg
To create a Connector for extracting data from staging follow the below steps:
1. Navigate to Data Mapping > Connector.
2. Click the Add button from the tool bar. The Connectors Definition window
appears.
3. The Definition tab provides the option to load and extract data. The Extract data
option enables you to extract the data from the OFSAA system. Additionally, you
have the option to select whether the loading/extracting should be performed in the
Staging or Results area. Click Next.
4. Select Extract data and Staging.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 47
5. Click Next. The Source block appears.
NOTE: When the Extract data option is selected, the ADI becomes the source and
EDD becomes target. Only ADIs relevant to staging area are displayed.
6. Enter the Connector Name and Connector Description. The Fields and details are
explained as tabulated in “Fields and their descriptions” section.
7. Under the ADI Selector section, the available ADI’s are listed. Select the required
ADI in order to map it. The selected ADI’s are displayed in the Source grid.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 48
8. If multiple ADIs are selected, Add Join section appears below with selected EDDs
appearing on the left and right side. Select the fields from the Left and right side, and
join the fields. If LOOKUP is required, then check the lookup checkbox has during
the mapping.
NOTE: If Lookup option is checked, then the join would be left outer join. Else it
would be inner join.
9. To edit the filter expression, click icon. The Specify Expression window appears.
Select/key in the required expression and click OK.
NOTE:
You do not need to add ‘WHERE’ clause for the filter.
For File data loading, use filter expression of Number type along with single
quotes. For example: N_DRAWN_AMOUNT ='40000'.
For Date field refer To_CHAR function for comparison.
Parameters can also be used in filter expression. Date format must be a valid
SQL date format.
For Example:
[EDD_GL_DATA].[EXTRACTION_DATE] =
TO_DATE(#DIHDEV.MIS_DATE,’dd-MM-yyyy’)
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 49
10. If Source type is Hive, the filter expressions must conform to the following
restrictions:
Expression must be valid HiveQL
Does not include Oracle built in or user defined functions
Does not include Sub queries
Includes Hive built in functions only
Parameters can also be used in filter expression. MISDATE can also be
passed dynamically so that it is loaded from Batch Execution Screen. The date
format specified must be valid Hive Date format i.e. yyyy-MM-DD
For Example:
Filter Expression in Connector:-[EDD_GL_DATA].[EXTRACTION_DATE] =
#DIHDEV.MIS_DATE
MISDATE Parameter in Batch:
MISDATE=$MISDATE:yyyy-MM-dd
NOTE: This is only applicable if the patch 8.0.2.1.4 (Bug - 24487929) is applied
11. Click Next. The ‘Target’ block (in Flow chart) appears.
12. Select External Data Descriptor from available list shows left panel. Move that to
right side on selected panel. The Selected EDD grid shows the selected EDDs along
with the filter expression. The filter on target can be applied by clicking the filter
expression. The Fields and details are explained as tabulated in “Fields and their
descriptions” section.
NOTE: For extract type of connector, only one EDD should be selected. It does not
support multiple EDD.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 50
13. Click the Mapping block in the flow chart, to map the EDD’s. For details on Auto-
mapping refer to section Auto-mapping.
14. Select the ADI from the drop down list. There are 3 options in the drop down list. For
details on options for ADI refer to section Options in Mapping ADI.
NOTE: For extract connector, mandatory attributes are not applicable. There is no
validation of mandatory attributes during publish. Mandatory indicator (*)
against an attribute for ADI is for reference only. All the mapped attributes
is listed under the ‘Column Mapping’ sector.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 51
15. Select the ‘Mandatory’ option to populate the mandatory Attributes to be mapped. All
the mapped attributes are listed under the ‘Column Mapping’ sector. For details on
the options in the Mapping grid such as Auto-mapping, Export to Excel and so on
refer to section Fields in Mapping.
NOTE: If the application is chosen as BASEL, while mapping, you can select the
type of approach (such as, IRB or Advanced Approach) and the Jurisdiction
(BIS, BRAZIL, China, India and so on) for filtering.
16. Click the Properties block in the flow chart.
The Properties related fields appear. The Connector details appear automatically.
17. No action is required in properties section. Proceed to the summary tab.
18. Click the Summary block in the flow chart to view the summary of all sections.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 52
19. Click Publish. This converts DIH metadata into ODI objects.
The Audit Trail section at the bottom of the window displays the information of the
source created. The User comments section facilitates you to add or update additional
information as comments.
88..11..33 CCrreeaattiinngg aa CCoonnnneeccttoorr ffoorr LLooaaddiinngg DDaattaa iinnttoo RReessuullttss
To create a Connector for extracting data from staging follow the below steps:
1. Navigate to Data Mapping > Connector.
2. Click the Add button from the tool bar. The Connectors Definition window
appears.
3. The Definition tab provides the option to load and extract data. Select Insert Data
and Results. Click Next.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 53
4. The Source block appears by default, and the respective fields are displayed.
NOTE: When the Insert data option is selected, the EDD becomes source and ADI becomes
target. Similarly, if Extract Data option is selected, then ADI becomes source and EDD
becomes target.
5. Enter the Connector Name and description. The Fields and details are explained as
tabulated in “Fields and their descriptions” section.
6. Under the ‘EDD Selector’ section, the available EDD’s are listed. Select the required
EDD in order to map it. The selected EDD’s are displayed in the ‘Source’ section.
7. In case of multiple EDDs selected. Add Join section appears below with selected
EDDs appearing on the left and right side. Select the fields from the Left and right
side, and join the fields. If LOOKUP is required, then check the lookup checkbox has
during the mapping.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 54
NOTE: If Lookup option is checked, then the join would be left outer join. Else it
would be inner join.
8. To edit the filter expression, click icon. The Specify Expression window appears.
Select/key in the required expression and click OK.
NOTE:
You do not need to add ‘WHERE’ clause for the filter.
For File data loading, use filter expression of Number type along with single
quotes. For example: N_DRAWN_AMOUNT ='40000'.
For Date field refer To_CHAR function for comparison.
Parameters can also be used in filter expression. Date format must be a valid
SQL date format.
For Example:
[EDD_GL_DATA].[EXTRACTION_DATE] =
TO_DATE(#DIHDEV.MIS_DATE,’dd-MM-yyyy’)
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 55
9. If Source type is Hive, the filter expressions must conform to the following
restrictions:
Expression must be valid HiveQL
Does not include Oracle built in or user defined functions
Does not include Sub queries
Includes Hive built in functions only
Parameters can also be used in filter expression. MISDATE can also be
passed dynamically so that it is loaded from Batch Execution Screen. The date
format specified must be valid Hive Date format i.e. yyyy-MM-DD
For Example:
Filter Expression in Connector:-[EDD_GL_DATA].[EXTRACTION_DATE] =
#DIHDEV.MIS_DATE
MISDATE Parameter in Batch:
MISDATE=$MISDATE:yyyy-MM-dd
NOTE: This is only applicable if the patch 8.0.2.1.4 (Bug - 24487929) is applied
10. Click Next. The ‘Target’ block appears.
11. Select Application Data Interface from available list shows left panel. Move that to
right side on selected panel. Below grid shows the selected ADIs along with filter
expression. The filter on target can be applied by clicking the filter expression. The
Fields and details are explained as tabulated in “Fields and their descriptions”
section.
NOTE: In case multiple sub types/ADI are selected, the filter expression is
necessary to direct required data into right entity/table. If no filter
expression chosen then all the records are loaded into all the ADI/subtypes
entities/tables. This is required to identify which record goes into which
target. It will be an expression such as . = ‘TD’
under Term deposit and . = ‘CARDS’ under
Cards.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 56
12. Click the Mapping block in the flow chart, in order to map the EDD’s. For details on
Auto-mapping refer to section Auto-mapping.
13. Select the EDD from the drop down list. For details on drop-down options for EDD
refer to section Options in Mapping EDD.
14. Select the ‘Mandatory’ option to populate the mandatory Attributes to be mapped.
NOTE: On selecting ‘Derived Column’ option as EDD from the drop down list, you
can add an expression.
All the mapped attributes are listed under the ‘Column Mapping’ sector. For details
on the options in the Mapping grid such as Auto-mapping, Export to Excel and so
on, refer to section Fields in Mapping.
OFSAA_DI_8.0.1_User%20Guide.docx#mapping_edd_optionsOFSAA_DI_8.0.1_User%20Guide.docx#Fields_in_mapping
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 57
NOTE: If the application is chosen as BASEL, while mapping, you can select the type of
approach (such as, IRB or Advanced Approach) and the Jurisdiction (BIS, BRAZIL,
China, India and so on) for filtering.
15. Click the Properties block in the flow chart. The Properties related fields come up.
The Connector details come up automatically.
16. Select the Loading Mechanism. Select the Direct and Parallel option from the drop
down list. Key in the value for Degree of Parallel, No: of Errors, Maximum Discard,
ODI Folder, XML Date Format, Do you want to use Data Pump?, Source and Target
in Same Environment?, Avoid Partition Exchange, Source Dump Location, Target
Dump Location, and Number of Splits for Dump File, Effective Dated Key for Result
Area?. The Fields and details are explained as tabulated in “Fields and their
descriptions” section.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 58
17. Click the Summary block in the flow chart to view the summary of all sections.
18. Click Publish. This converts DIH metadata into ODI objects.
The Audit Trail section at the bottom of the window displays the information of the
source created. The User comments section facilitates you to add or update additional
information as comments.
88..11..44 CCrreeaattiinngg aa CCoonnnneeccttoorr ffoorr EExxttrraaccttiinngg DDaattaa ffrroomm RReessuullttss
To create a Connector for extracting data from results follow the below steps:
1. Navigate to Data Mapping > Connector.
2. Click the Add button from the tool bar. The Connectors Definition window
appears.
3. The Definition tab provides the option to load and extract data. Select Extract data
and Results. Click Next.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 59
4. Click Next. The ‘Source’ block appears.
5. If Extract data option is selected, the ADI becomes source and EDD becomes target.
Only staging relevant ADIs appear there.
6. Enter the Connector Name and description. The Fields and details are explained as
tabulated in “Fields and their descriptions” section.
7. Under the ‘ADI Selector’ section, the available ADI’s are listed. Select the required
ADI in order to map it. The selected ADI’s are displayed in the ‘Source’ section.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 60
8. In case of multiple ADIs selected, Add Join section appears below with selected
EDDs appearing on the left and right side. Select the fields from the Left and right
side, and join the fields. If LOOKUP is required, then check the lookup checkbox has
during the mapping.
NOTE: If Lookup option is checked, then the join would be left outer join. Else it would be inner
join. For few ADIs/Subtypes, there are known relationship so joins in case of multiple
ADIs occurs automatically.
9. To edit the filter expression, click icon. The Specify Expression window appears.
Select/key in the required expression and click OK.
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 61
NOTE:
You do not need to add ‘WHERE’ clause for the filter.
For File data loading, use filter expression of Number type along with single
quotes. Example: N_DRAWN_AMOUNT ='40000'.
For Date field refer To_CHAR function for comparison. Parameters can also be
used in filter expression. Date format must be a valid SQL date format.
For Example:
[EDD_GL_DATA].[EXTRACTION_DATE] =
TO_DATE(#DIHDEV.MIS_DATE,’dd-MM-yyyy’)
10. If Source type is Hive, the filter expressions must conform to the following
restrictions:
Expression must be valid HiveQL
Does not include Oracle built in or user defined functions
Does not include Sub queries
Includes Hive built in functions only
Parameters can also be used in filter expression. MISDATE can also be
passed dynamically so that it is loaded from Batch Execution Screen. The date
format specified must be valid Hive Date format i.e. yyyy-MM-DD
For Example:
Filter Expression in Connector:-[EDD_GL_DATA].[EXTRACTION_DATE] =
#DIHDEV.MIS_DATE
MISDATE Parameter in Batch:
MISDATE=$MISDATE:yyyy-MM-dd
NOTE: This is only applicable if the patch 8.0.2.1.4 (Bug - 24487929) is applied
-
Oracle Financial Services Data Integration Hub User Manual
Oracle Financial Services Software Page 62
11. Click Next. The ‘Target’ block appears.
12. Select Exte