Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 1

Document:
Crac|e Data Integrator 11g (11.1.1)
nyper|on Lssbase Integrat|on

Descr|pt|on:
This guiue is uesigneu to uemonstiate 0BI integiation with Essbase. It uemonstiates
simple step by step methou to pull metauata anu uata fiom 0iacle Bypeiion Essbase. It also
shows how to loau uata anu metauata into 0iacle Bypeiion Essbase Seivei

n|story:
Vers|on Descr|pt|on
Change
Author Þub||sh Date
0.1 lnlLlal urafL Courav ALalkar 9-CcL-2010


kev|ewed 8y: Am|t 5harma




Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 2


Crac|e Data Integrator
1|t|e Þage No.
1) Extracting Hyp¢rion Essbas¢ M¢tadata to Uracl¢ Data Int¢grator 3
2) Loading M¢tadata to Hyp¢rion Essbas¢ from Flat Fil¢ 13
3) Loading Data to Hyp¢rion Essbas¢ from Flat fil¢s 18
4) Extracting Hyp¢rion Essbas¢ Data to Flat fil¢ using R¢port Script 23
5) Extracting Hyp¢rion Essbas¢ Data to RDBMS using MDX Qu¢ry 35
















Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S

Extracting Hyp¢rion Essbas¢ M¢tadata to Uracl¢
Data Int¢grator
St¢p: 1) uo to StaitPiogiam Files0iacle0iacle Bata Integiatoi exploie 0BI anu login
to woik iepositoiy.

St¢p: 2) Aftei successfully login to woik iepositoiy go to Topology Navigator select
Physical Aichitectuie Tab anu select Technology anu expanu it. uo to the Bypeiion Essbase
Right Click anu select 'New Bata Seivei'.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 4

St¢p: 3) In the uefinition tab entei the following uetails as shown in the pictuie below:

St¢p: 4) Click on Save it will ask you to cieate physical schema piess '0K'.

St¢p:5) In Technology Tab go to Bypeiion Essbase expanu it anu select newly cieate uata
seivei Right Click anu select 'New Physical schema'.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S


St¢p:7) In the uefinition tab entei the Essbase Application name to which you want to
connect.

St¢p: 8) Click on Save it will ask you to specify the context piess '0K'.

St¢p: 9) uo to the Logical Arcbit¢ctur¢ tab Expanu Technologies anu select Bypeiion
Essbase Right-click anu select 'New Logical Schema'.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 6

St¢p: 10) uive appiopiiate name to logical schema anu set the Context to Bypeiion Essbase
physical schema.

St¢p: 11) Click on 'Save'.
St¢p: 12) uo to the 0BI Besignei anu cieate new Pioject with appiopiiate name.

St¢p: 13) Click on 'Save'. You can check in the pioject tab

St¢p: 14) Expanu pioject go to knowleuge mouule iight click anu impoit following
knowleuge mouules.
RKM Hyp¢rion Essbas¢
LKM Hyp¢rion Essbas¢ M¢tadata to SQL
IKM SQL to Fil¢ App¢nd

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 7



St¢p: 15) Piess Ctil anu select all thiee knowleuge



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 8



5tep: 1ó) 'Save'.

St¢p: 17) Now go to the mouel tab anu cieate new mouel Foluei.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 9


St¢p: 17) Now go to the mouel tab anu cieate new mouel.

St¢p: 18) In the uefinition tab entei the uetails



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 1u


St¢p:19) uo to the Reveise Engineei tab select customize check box anu entei uetails as
follows:

St¢p:20) 'Sav¢'

St¢p:21) Newly cieateu Nouel will be available foi Reveise Engineeiing go to Nouel tab
select Bypeiion planning mouel anu Right Click anu select Reveise Engineeis. Befoie
Reveise Engineei the mouels make suie youi agent seivices aie iunning if not stait it with
following commanu:
C:\oracl¢\Middl¢war¢\Uracl¢_UDI1\oracl¢di\ag¢nt\bin>ag¢nt -NAME=localag¢nt


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 11

St¢p: 22) Now you can r¢v¢rs¢ ¢ngin¢¢r it.


Pr¢ss 'UK'.
St¢p: 23) uo to the Up¢rator Tab check whethei the Execution iun successfully oi not.

If all tb¢ cb¢cks ar¢ gr¢¢n tbat m¢ans your mod¢l r¢v¢rs¢d succ¢ssfully.

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 12


St¢p: 24) uo to the D¢sign¢r anu open mouel tab expanu Bypeiion Essbase mouel again.
You can check all the uimensions aie visible theie fiom youi Essbase application.













Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 1S

Loading M¢tadata to Hyp¢rion Essbas¢ Application
Flat Fil¢---To--->Hyp¢rion Essbas¢
I am going to be using the Bata Seivei anu Physical schema I have set up pieviously
connecting to the Sample.Basic uatabase. The basic uatabase has five attiibute uimensions.

The fiist thing to uo is to cieate a mouel to holu the ieveiseu essbase uatabase: if you alieauy have
a mouel you can use the same one anu iun the ieveise again, the impoitant uiffeience this time is
that we aie going to set an auuitional option foi the RKN.

If you set EXTRACT_ATTRIB0TE_NENBERS to "Tiue" when the ieveise is initiateu it cieates extia
columns in the uimensions which aie associateu with attiibutes, e.g Piouuct will have columns foi
Caffeinateu, Intio Bate, 0unces, Pkg Type.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 14

So now we have oui ieveiseu mouel we neeu some souice
metauata to tiy anu loau into the Essbase outline.


I cieateu a CSv file that will loau a new bianch to the hieiaichy anu
set an attiibute foi each new level u membei, the file was saveu
into the location wheie the file technology is pointing to (in my
system uiiectoiy C:\oiacle\Niuulewaie\0iacle_0BI1
\oiacleui\Bemo\Bemonstiation).



A BataStoie was cieateu using the flat file mouel, the file foimat was set to Belimiteu,
heauing set to 1 anu fielu sepaiatoi set to comma.



The BataStoie was then ieveiseu to cieate the column infoimation foi the flat file.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 1S



So that's the souice anu taiget uone, time to cieate the inteiface.
The inteiface was names anu the staging aiea set as "S0N0PSIS NEN0RY ENuINE'.
In the uiagiam aiea the flat file BataStoie was uiaggeu on to the souice anu the Essbase BataStoie
uiaggeu onto the taiget, most of the columns weie automappeu except foi the columns with spaces
in such as "Pkg Type" anu "Intio Bate" so these weie manually set up.

In the flow aiea, the LKN was set to "LKM Fil¢ to SQL" as we aie loauing fiom a flat file.
The IKN was set to "IKM SQL to Hyp¢rion Essbas¢ {M¢taData)".

Theie aie a few options to be awaie of:

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 16

Rule File: Name of the Rules file to be useu foi metauata loau.
Rule File_Sepaiatoi: (0ptional) Rule sepaiatoi specifieu in the Rules file.
valiu values
- Comma
- Tab
- Space
- Custom chaiactei: foi example, @, #, ^
Restiuctuie_Batabase: Peifoims the iestiuctuie opeiation on the outline aftei a metauata
loau.
The valiu values aie:
- BISCARB_ALL_BATA
- KEEP_ALL_BATA
- KEEP_INP0T_BATA
- KEEP_LEvELu_BATA
The cuiient IKN is not awaie of many options foi loauing metauata such as youi uimension
builu piopeities Allow Noves, Allow piopeity changes to name a few, this means you have
to cieate a loau iule the same as you woulu if you weie loauing metauata into essbase.
Cr¢at¢ a Rul¢ fil¢:

Sav¢ tb¢ rul¢ fil¢

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 17

A loau iule was cieateu anu the name auueu to the options of the inteiface, if the loau iule
exists in the essbase app uiiectoiy then the name is only iequiieu, if the iule file is
elsewheie you neeu to entei the full path uetails to it.

Now execute the newly cieateu inteiface.


In the essbase outline all the new membeis weie auueu anu the attiibute infoimation
coiiectly associateu.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 18

Loading Data to Hyp¢rion Essbas¢ Application
Flat Fil¢---To--->Hyp¢rion Essbas¢
St¢p: 1) Cieating Bata Stoie foi flat files. We will use same mouel which we have use
uuiing uata extiaction fiom Essbase to flat file. We neeu to cieate new uata stoie foi souice
text file. Select the mouel Right click anu select New Bata Stoie. In Befinition tab entei the
name then click on Resouice Name biowse button select you text file fiom open uialog box
anu piess '0pen'.

St¢p: 2) uo to file tab select file foimat as uelimiteu set heauing to 1 anu fielu sepaiatoi to
Comma (,).



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 19

St¢p: 3) Now go to Column tab anu click on ieveise engineei button.






St¢p: 4) we neeu to change the uata type of Actual, Buuget anu vaiiance to Numeiic
because it is numeiic fielus.

1
2
3

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 2u

St¢p: 5) Sav¢ it.

St¢p: ó) Souice is ieauy, now we will cieate the inteiface. Select same pioject that we have
cieateu pieviously open it anu select inteiface iight click anu new inteiface.

Sp¢cify tb¢ nam¢, cont¢xt and Staging ar¢a.

St¢p: 7) uo to mapping tab anu uiag loau uatastoie anu uiop it to souice aiea. Similaily
uiag Essbase ouiuemo_ouiuata to taiget place. It will ask you foi auto mapping piess 'Yes'.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 21

St¢p: 8) uo to oveiview tab anu select staging aiea uiffeient fiom taiget check box.

St¢p: 9) Now go to Flow tab wheie you specify the Knowleuge mouule foi the inteiface
these aie the iequiieu knowleuge mouule. If you have not impoiteu it till now impoit it.
i) LKM Fil¢ To SQL
ii) IKM SQL TU Hyp¢rion Essbas¢ {Data).


St¢p: 10) Sav¢ it.

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 22

St¢p: 11) Execute the inteiface.


St¢p: 12) uo to the opeiatoi tab anu check the execution iesult.


St¢p: 13) Now go to Essbase application iefiesh it anu check the uata.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 2S

Extracting Hyp¢rion Essbas¢ Data to Flat Fil¢
Essbas¢-To-Flat Fil¢
Theie aie thiee methous to be able to extiact uata fiom Essbase: these aie using eithei a
Calc sciipt (9.S onwaius), Repoit sciipt of an NBX queiy. If youi Essbase ub is BS0 then
you will be able to use all of the methous, if it is AS0 then you will only be able to use the
iepoit sciipt oi NBX queiy.

Using R¢port Script:
-Requiieu Knowleuge Nouules
RKN Bypeiion Essbase
LKN Bypeiion Essbase Bata to S0L
LKN Bypeiion Essbase Netauata to S0L
St¢p: 1) Fiist we neeu to wiite the Repoit sciipt foi sample.Basic Application this sciipt
help us to conveit uata into tabulai foimat.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 24

Nake suie you use the commanus
{SUPALL}{TABDELIMIT}{RUWREPEAT}{NUIDENTCEN} these will foimat the output in
the way 0BI can inteipiet. Execute it

Step:2) now neeu to cieate taiget uata souice that can be a csv, file flat file oi RBBNS. We
aie using text file as oui taiget uata stoie so take a look how it cieateu.

St¢p:3) uo to the Topology Navigatoi select Physical Aichitectuie anu expanu technology
tab anu go to File Right-click anu select 'New Bata Seivei'.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 2S


uo to IBBC tab anu inseit following uetails:


St¢p: 4) Click on 'Save' Button it will ask you foi iegistei physical schema click '0K'.

St¢p: 5) uo to newly cieate uata seivei Right Click anu select 'New Physical Schema'.

An 0BI Physical Schema coiiesponus to a paii of schemas:
A (Bata) Schema, in which 0iacle Bata Integiatoi will look foi the souice anu taiget uata
stiuctuies foi the inteifaces.
A Woik Schema in which 0iacle Bata Integiatoi can cieate anu manipulate tempoiaiy
woik uata stiuctuies associateu to the souices anu taigets containeu in the Bata Schema.
You neeu to manually entei the location into the Biiectoiy (Schema) anu the Biiectoiy
(Woik Schema).

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 26


St¢p: ó) Now Click on 'Save'


St¢p: 7) Now go to Logical aichitectuie tab anu select Technology expanu it anu select File
Right Click anu select 'New Logical Schema'. In uefinition tab entei the name foi the logical
schema anu select newly cieateu physical schema foi the global context.

St¢p:8) 'Save'

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 27

St¢p:9) uo to the Besignei navigatoi anu select mouel tab anu cieate new mouel foluei foi
file Bata stoie.

St¢p: 10) 'Save'.
St¢p: 11) Now select newly cieateu foluei anu Right Click anu select 'New Nouel'. In
Befinition tab entei uetails as given in below image anu 'save'.

St¢p: 12) Now neeu to cieate new BataStoie go to newly cieate Nouel Right Click anu
select 'N¢w DataStor¢'.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 28


St¢p: 13) Entei appiopiiate name anu biowse the file you want to use as taiget.

St¢p:14) uo to the file tab anu select File Foimat as Belimiteu, heauing as 1 because flat file
uocument fiist line contents the heauei anu fielu sepaiatoi as comma(,).


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 29

St¢p: 15) Now go to column tab anu click on Reveise Engineei button.

St¢p: 1ó) Click 'Yes' foi saving the BataStoie anu again click 'Yes' foi automatically lock the
object.





Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page Su

St¢p: 17) With the souice anu taiget Bata Stoies cieateu the next stage is to cieate the inteiface.
uo to Pioject tab in Besignei Navigatoi anu select pieviously cieateu Essbase pioject anu expanu it
anu impoit new knowleuge mouule LKM Hyp¢rion Essbas¢ to SQL.




Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S1

St¢p: 18) Now we cieate new inteiface go to inteiface Right Click anu select 'New
Inteiface'. Entei suitable name select context as ulobal anu staging aiea as
:Sunopsis_M¢mory_Engin¢


St¢p:19) uo to mapping tab anu uiag sample.Basic table fiom Essbase mouel to souice
aiea anu taiget sample_basic.csv uataStoie fiom file moluel.




Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S2

When you select Auto mapping 'Yes' it will automatically map all same column name fiom
souice to taiget iemaining column mapping we neeu to peifoim manually.

St¢p: 20) uo to 0veiview tab again anu check the Staging Ar¢a diff¢r¢nt from targ¢t
checkbox anu In-M¢mory Engin¢: Sunopsis_M¢mory_Engin¢.

St¢p:21) uo to the Flow tab Select Souice object anu in LKN selectoi select LKM Hyp¢rion
Essbas¢ Data to SQL. In Uptions s¢t as follows:

EXTRACTIUN_QUERY_TYPE - RepoitSciipt
EXTRACTIUN_QUERY_FILE - extiact oi you can put in the fully qualifieu Repoit Sciipt file
path if it is not pait of the essbase uatabase.
EXT_CUL_DELIMITER - The iepoit is tab uelimiteu so \t is useu.

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page SS


St¢p: 22) Now select taiget object anu set IKN Selectoi to SQL to Fil¢ App¢nd.

St¢p: 23) Click the 'Save' button youi inteiface is ieauy to execute. Right click on inteiface
anu select Execute.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S4


St¢p: 24) Now go to the 0peiatoi Navigatoi anu check the execution successful oi not anu
go to the file uiiectoiy wheie youi taiget file is locateu open the taiget file anu check the
loau uata.


Execution went successful now check taiget file.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page SS

Extracting Hyp¢rion Essbas¢ Data to RDBMS
Essbas¢-To-RDBMS
Using MDX Qu¢ry :
St¢p: 1) Fiist we neeu to wiite the NBX 0ueiy foi ouiuemo.oui Application this sciipt help
us to conveit uata into tabulai foimat.

St¢p2) Execute it.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S6

St¢p 3) Save it.

St¢p 4)We will use same ouiuemo.oui application fiom Essbase as uata souice which we have
extiacteu pieviously.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S7

St¢p 5) Cieate Taiget uata souice in RBBNS foi loauing uata fiom ouiuemo.oui application.

St¢p: ó) Now we neeu to cieate uata seivei foi 0iacle RBBNS these aie the step to cieate it. uo to
the Topology Navigatoi in Physical aichitectuie expanu Technology tab select 0iacle Right Click
anu select new uata Seivei. Specify following uetails:
Nam¢: Appiopiiate name
Instanc¢: oicl
Us¢r: ouiuemo |Schema Name wheie youi uata table is locateu]
Password: ******|Schema passwoiu wheie youi uata table is locateu]



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S8

St¢p 7) uo to the IBBC tab anu set appiopiiate uiiveis anu uil foi the 0iacle uatabase. Test
the connection by piessing the Test connection button.


St¢p: 8) Save it.

St¢p: 9) In Technology Tab go to 0iacle expanu it anu select newly cieate uata seivei Right
Click anu select 'New Physical schema'. Select schema in which youi uatabase locateu.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page S9

St¢p: 10) Click on Save it will ask you to specify the context piess '0K'.

St¢p: 11) uo to the Logical Arcbit¢ctur¢ tab Expanu Technologies anu select 0iacle
Right-click anu select 'New Logical Schema'.


St¢p: 12) Click on 'Save'.
St¢p: 13) Now go to Besignei Navigatoi anu then mouel tab anu cieate new mouel Foluei.

St¢p: 14) Save it.

Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 4u


St¢p: 15) Now go to the newly cieateu foluei anu cieate new mouel.

St¢p: 1ó) In the uefinition tab entei the uetails.

St¢p:17) Save the mouel it will visible in youi mouel foluei now select it Right click anu
select ieveise engineei.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 41



Pr¢ss 'UK'.
St¢p: 18) uo to the Up¢rator Tab check whethei the Execution iun successfully oi not.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 42

If all tb¢ cb¢cks ar¢ gr¢¢n tbat m¢ans your mod¢l r¢v¢rs¢d succ¢ssfully.

St¢p: 19) uo to the D¢sign¢r anu open mouel tab expanu 0iacle mouel again. You can
check all the tables' metauata aie visible theie fiom youi 0iacle schema.

Now the taiget is ieauy to set foi loauing the uata.




Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 4S

St¢p: 20) the souice Essbase ouiuemo.oui anu the taiget oiacle RBBNS is ieauy. Now neeu
to cieate a pioject anu inteiface that help us to loau Bypeiion Essbase uata to the taiget
oiacle uata souice.

St¢p: 21) uo to the pioject tab select 'New pioject'

St¢p: 22) Save it.

St¢p: 23) uo to Pioject tab in Besignei Navigatoi anu select pieviously cieateu Essbase pioject
anu expanu it anu impoit new knowleuge mouule.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 44

St¢p: 24) Impoit following knowleuge mouules







Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 4S

St¢p: 25) Now we cieate new inteiface go to inteiface Right Click anu select 'New
Inteiface'. Entei suitable name select context as ulobal anu staging aiea as
:Sunopsis_M¢mory_Engin¢.

St¢p:25) uo to mapping tab anu uiag ouiuemo.oui table fiom Essbase mouel to souice aiea
anu uiag ouiuemo_ub fiom oiacle uata mouel anu uiop it to taiget place.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 46


Not¢: You n¢¢d to sp¢cify tb¢ Mapping to staging ar¢a.
St¢p: 2ó) uo to 0veiview tab again anu check the Staging Ar¢a diff¢r¢nt from targ¢t
checkbox anu In-M¢mory Engin¢: Sunopsis_M¢mory_Engin¢ .

St¢p:27) uo to the Flow tab Select Souice object anu in LKN selectoi select LKM Hyp¢rion
Essbas¢ Data to SQL. In Uptions s¢t as follows:

EXTRACTIUN_QUERY_TYPE - NBX0ueiy
EXTRACTIUN_QUERY_FILE - extiact oi you can put in the fully qualifieu NBX file path if it
is not pait of the essbase uatabase.
EXT_CUL_DELIMITER - The iepoit is tab uelimiteu so \t is useu.


Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 47

St¢p: 22) Now select taiget object anu set IKN Selectoi to SQL to SQL App¢nd.



St¢p: 23) Click the 'Save' button youi inteiface is ieauy to execute. Right click on inteiface
anu select Execute.



Business Intelligence Solution Pioviueis | Bypeiion Essbase Integiation With 0BI 11g Page 48



St¢p: 24) Now go to the 0peiatoi Navigatoi anu check the execution successful oi not anu
go to the oiacle anu check the loau uata.

Execution went successful now check taiget file.