3/8/2017 Document1954381.

IntegratingOBIAFinancialAnalyticswithOracleEssbaseforOracleEBS(DocID1954381.1)

InthisDocument

Abstract
Overview
History
Details
KeyPoints
PreRequisites
EssbaseLoadPlans
BuildingaFinancialReportfromOBIEEanswers
Applyingsegmentoverrides(asdoneinaFSGreportinEBS)intheFinancialReports
UseCase1:ApplyafilteronCostCenter,AccountandCompanysegmentswhichmaptoCostCenter,Natural

AccountandBalancingSegmentrespectively.
UseCase2:ApplyafilteronAccountandOrganizationsegmentswhichmaptoNaturalAccountandGLSegment3

respectively.
LoadingFinancialReportinghierarchiesfromacsvfile

APPLIESTO:

BusinessIntelligenceApplicationsObserver
Informationinthisdocumentappliestoanyplatform.
OracleBusinessIntelligenceApplicationsrelease11.1.1.9.1only.

ABSTRACT

Overview

SomeofthekeyrequirementsinOBIAFinancialAnalyticshavealwaysbeentoreportgeneralledgerdataagainstmultiple
accountingsegmenthierarchiesi.e.todorollupreportingagainsttheaccountingsegmenttrees.Inadditiontherehasbeena
requirementtobuildafinancialreportinBIexactlysimilartotheFSGreportasbuiltinOracleEBSwhichinvolvesvariouskinds
ofarithmeticaggregationsinthehierarchystructureandalsodrilldownonthemeasureswithinthesefinancialreports.

OracleEssbasewithitsarchitectureprovidesuscapabilitiesofloadingaggregateddatawhichwillresultinbetterretrieval
timeswhencomparedtoasimilarrequestonastarschemaintheDW.Alsoitallowsustododynamicaggregationwhichwill
helpustoloadtheFSGhierarchiesintoEssbaseandbuildasimilarreportfromOBIEEusingthedataloadedintothecube.So
weareleveragingthesekeybenefitsofEssbaseandintegratingourGLdataandprovidingacapabilityofreportingagainstthe
Essbasedata.

Withthisintegration:

WeareloadingGLBalancesandGLBudgets(ActualsandBudgets)datafromourDWintotheEssbasecube.

Weareloadingtheaccountingsegmenthierarchies(ValueSetHierarchiesinEBSterminology)intothecube.Unlikethe
hierarchiesthatareloadedintheDWwhicharelevelbasedandhaveaconsistentnumberoflevels,thesehierarchies
loadedintotheEssbasecubeareraggedhierarchiesandwillbereportedasraggedhierarchiesfromOBIEE.

WeareloadingFSGrowsethierarchiesintooneofthedimensionsinthecubewhichwillbereferredtoastheFinancial
Reportingdimensionfromnowon.

WehaveintegratedEssbasewithOBIEEaswellandprovidedacapabilityofreportingEssbasedatafromOBIEE.In
additiontotheFinancialReportingdimension,wehaveprovidedsupportforalltheotherkeyGLdimensionssuchas

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 1/10
3/8/2017 Document1954381.1

Time,Ledger,Budget,AccountingsegmentdimensionssuchasBalancingSegment,CostCenter,NaturalAccount,GL
Segment1throughGLSegment10,ProgramSegment,andProjectSegmentwhichwillenableuserstobuildsimilar
reportstotheonesbuiltfromtheregularDWGLStarschema.

HISTORY

NA

DETAILS

KeyPoints

1.Forthefinancialreportingdimension,wehavebroughtinonlytherowsethierarchiesfromEBSwhichwillallowyouto
dovariouskindsofarithmeticaggregationsamongthehierarchynodes.Wehaveshippedsomebasemetricslike
BudgetAmount,BalanceAmountandActivityAmountwhichcanbeusedforreporting.Ifneededsomeadditional
metricslikeYTD,PTDmetricscanbebuiltasacustomizationontopofthebasemetricsthatwehaveshippedoutof
thebox.

2.Thebasemetricsprovidedoutoftheboxaresupportedin4differentcurrenciesLedgerCurrency,Global1Currency,
Global2Currency,andGlobal3Currency.Thereisnosupportfordocumentcurrencyyet.

3.Thisintegrationiscurrentlysupportedonlyforbudgetsandactualsdata.EncumbrancesarenotloadedintotheEssbase
cube.

4.ThisintegrationiscurrentlysupportedonlyforaDWloadedfromasingleEBSinstanceandisnotintendedforamulti
sourceDWoramultiinstanceDW.

5.UsersareexpectedtoretrievethedataresidinginEssbaseonlythroughOBIEEandnotsupposedtoseethedata
throughotherEssbasefrontend(s)likesmartviewetc.

6.Ledgersecurityhasbeenimplementedforthisintegrationatthispointintime.Thedataviewedbyusersarerestricted
bytheledgerstheusershaveaccessto.

PreRequisites

Givenbelowaresomeoftheprerequisitesneededforthisintegrationtowork.

1.CreateanODBCconnectionwiththenameOBIAFA(samenamehastobeusedsincethisisusedinthecode)from
yourEssbaseserverhostpointingtoyourOracleDWtargetdatabase.

IfyourEssbaseserverisonawindowshost,createtheODBCconnectionusingtheDataDirect6.0OracleWire
Protocoldriver.

2.CreateanewlogicalschemafortheEssbaseserverconnection.

NavigatetoTopologyLogicalArchitectureTechnologiesOracleinyourODIrepository.Deletethe
ESSBASE_BIAPPS11Glogicalschema.

NavigatetoTopologyLogicalArchitectureTechnologiesHyperionEssbaseinyourODIrepository.Createa
newlogicalschemacalledESSBASE_BIAPPS11G.

3.CreateaphysicaldataserverintheODIrepositorypointingtoyourEssbaseserverandassignittotheappropriate
executioncontext.

NavigatetoTopologyPhysicalArchitectureTechnologiesHyperionEssbaseinyourODIrepository.Createa
newphysicaldataserverwiththenameEssbase_BIAPPS11Gasshowninthescreenshotbelow.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 2/10
3/8/2017 Document1954381.1

ThevaluefortheServer(DataServer)fieldalwayshastobeintheformatessbase_server_host:
essbase_server_port.

Createanewphysicalschemaforthenewphysicaldataserverthatwascreatedinthepreviousstep.Hardcode
theapplicationandthedatabasenametobeOBIAFA.

AssignthenewlycreatedphysicalserverandschematotheappropriatelogicalschemafortheGlobalContext.
NavigatetoTopologyContextsGlobalinyourODIrepository.

Undertheschemastab,setthelogicalschemaESSBASE_BIAPPS11Gtothenewphysicalschemathatwas
createdinstep3and4.

EssbaseLoadPlans

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 3/10
3/8/2017 Document1954381.1

AllthenecessarymappingsthatareneededtoloadtheEssbasecubeareshippedinseparateLoadPlans(oneperEBS
version)andareNOTintegratedwiththeregularLoadPlancomponents.ItisexpectedthattheseLoadPlansarerunafterthe
regularDWLoadPlanexecutioniscomplete.

TheseLoadPlanscanbeexecutedonlyfromODIStudio.TheseLoadPlansalwaysruninfullmodei.e.thereisno
incrementallogicimplementedforanyofthemappingsintheLoadPlan.EventheEssbasecubeisrefreshedinfullevery
timethisLoadPlanruns.

TheseLoadPlansarepresentunderLoadPlansandScenariosPredefinedLoadPlansEssbase

SincetheseLoadPlansarenotintegratedwiththemainflow,someoftheparametervalueshavetobepassedintheStartup
ValueswindowwhileexecutingtheLoadPlan.Thedetailsofsuchparametersaregivenbelow.

1.DATASOURCE_NUM_IDThisisthedatasourceIDconfiguredforyoursourceEBSinstanceinConfigurationManager.
Itisveryimportantthatyoupasstherightvalueorelsethemappingswontprocessanydatabecauseallthemappings
haveafilteronDSN.

2.LANGUAGE_BASEPassthevalueconfiguredforthisparameterinConfigurationManager.

3.ESSBASE_LOG_LOCATIONLocationwhereallthelogfilesarestored.Thisisusefulfordebuggingpurposes.

4.IS_FIN_ESSBASE_ENABLEDSetittoY.

BuildingaFinancialReportfromOBIEEanswers

OnceyouhavecompletedtheexecutionoftheEssbaseLoadplansandloadedthedataintoEssbase,youwillbeabletobuild
FinancialReports(similartoFSGreportsinEBS)usingtheFinancialsGLBalance(Essbase)subjectarea.Thissection
explainsthebasicstepsofhowtobuildafinancialreportfromOBIEEanswers.

1.PullinthenecessarycolumnsfromFinancialsGLBalance(Essbase)subjectarea.FortheFinancialReporting
dimension,pullintheFinancialReportingpresentationhierarchyasshowninthescreenshotbelow.

2.Applyanyfiltersasappropriate.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 4/10
3/8/2017 Document1954381.1

3.NavigatetotheResultstabandyouwillseealltheapplicablehierarchiesdisplayedinthereport(forthefiltersapplied).
Thesehierarchies(shownbelow)areFSGrowsetsthataredefinedinEBS.

4.Drilldownonanyhierarchy/rowsetofyourchoice.Howeverifyouwanttoseejustonehierarchyinareportandsave
thereportforfutureusage,followthestepsbelow.

5.Sincethisisahierarchy,usetheSelectionStepsfeatureofOBIEEtofilteroutthenecessaryhierarchy.Forexamplelet
usassumethatweneedtofilterontheBalanceSheethierarchy.

6.ExpandSelectionSteps(inthebottompane)andedittheDimFinancialReportingdimensiontostartwiththe
hierarchyyouwant.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 5/10
3/8/2017 Document1954381.1

7.ThiswillincludeonlytheBalanceSheethierarchyasshownbelow.

8.Expandallthenodesinthehierarchyandsavethereportforfutureusage.

Applyingsegmentoverrides(asdoneinaFSGreportinEBS)intheFinancialReports

ItisaverycommonpracticetooverridesomesegmentvaluesfortheCOAstructurewhenanFSGreportisbuiltinEBS.For
exampleaBalanceSheetreportcanbebuiltforacompany,productandsubaccountcombination.Thesectionbelowexplains
howtoapplysuchfiltersonthereportsbuiltfromOBIEE.

Letustakethesameexampleofthereportthatwasexplainedintheprevioussection.TheBalanceSheetreportthatwas
explainedearlierdidnthaveanysegmentfilters.Nowletusassumethatweneedtoapplyafilteronthecompany(Segment
Value01),Product(SegmentValue000)andSubaccount(SegmentValue0000)segments.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 6/10
3/8/2017 Document1954381.1

Beforeyouapplythesefilters,youwillneedtoknowexactlywhatdimensionsthesesegmentsmapstoinBIandthenapplythe
filtersaccordingly.ForexampleletusassumethatCompanymapstoBalancingSegmentdimension,SubAccountmapstoGL
Segment1andProductmapstoGLSegment2dimensions.Inthiscasethefilterswouldbeappliedonthecodecolumnsofthe
respectivedimensionsasshownbelow.

AllthesegmentvaluesarestoredashierarchiesintheEssbasecubeandhencethefiltersareappliedasfullyqualifiedpaths
andhencehavetostrictlyadheretotheformat

[<SegmentString>].[<ValueSetID>].[<ValueSetID>~<SegmentValue>]

Thesegmentstringsthatneedtobeusedforthevariousdimensionsareasshowninthetablebelow.

Dimension SegmentString

BalancingSegment AllBalancing
Segments

NaturalAccount AllNaturalAccounts

CostCenter AllCostCenters

GLSegment110 AllSegments

Afewmoreexamplesaregivenbelowforbetterunderstanding:

UseCase1:ApplyafilteronCostCenter,AccountandCompanysegmentswhichmaptoCostCenter,Natural
AccountandBalancingSegmentrespectively.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 7/10
3/8/2017 Document1954381.1

UseCase2:ApplyafilteronAccountandOrganizationsegmentswhichmaptoNaturalAccountandGLSegment3
respectively.

LoadingFinancialReportinghierarchiesfromacsvfile

ThissectionisapplicableforEBScustomerswhodonthaveFSGimplementationbutstillwanttoleveragetheOracleEssbase
functionalityexplainedaboveandbuildfinancialreportsfromOBIEE.Thesectionbelowexplainshowtoaddsuchfinancial
reportinghierarchiesinacsvfilesothattheETLprocessloadsthesehierarchiesintothecubesimilartothewayinwhichwe
loadFSGhierarchiesintothecube.TherestoftheprocessofbuildingthereportinOBIEEremainsthesameasexplainedin
previoussections.

Youcandefinethefinancialreportinghierarchiesusingthefollowingconfigurationfile:

file_group_acct_hier.csvthisfilemapsthefinancialreportinghierarchies

TheconfigurationfileorfilesforthistaskareprovidedoninstallationofOracleBIApplicationsatoneofthefollowing
locations:

Sourceindependentfiles:<OracleHomeforBI>\biapps\etl\data_files\src_files\.

Sourcespecificfiles:<OracleHomeforBI>\biapps\etl\data_files\src_files\<sourceadaptor>.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 8/10
3/8/2017 Document1954381.1

YoursystemadministratorwillhavecopiedthesefilestoanotherlocationandconfiguredODIconnectionstoreadfromthis
location.Workwithyoursystemadministratortoobtainthefiles.Whenconfigurationiscomplete,yoursystemadministrator
willneedtocopytheconfiguredfilestothelocationfromwhichODIreadsthesefiles.

Editthefilefile_group_acct_hier.csvfileanddefineanyfinancialreportinghierarchyyouneed.Thescreenshotshownbelow
givesanexampleforonesuchhierarchy.

HIERARCHY_NAME PARENT_GROUP_ACCT_NUM CHILD_GROUP_ACCT_NUM SEQUENCE AGGREGATION

SampleIncome NetIncome 1 +
Statement

SampleIncome NetIncome GrossProfit 1 +

Statement

SampleIncome NetIncome TotalExpenses 2

Statement

SampleIncome GrossProfit REVENUE 1 +

Statement

SampleIncome GrossProfit COGS 2

Statement

SampleIncome TotalExpenses DEPCN 1 +

Statement

SampleIncome TotalExpenses R&DExpenses 2 +

Statement

SampleIncome TotalExpenses Sales&MarketingExpenses 3 +

Statement

SampleIncome TotalExpenses OtherOperatingExpenses 4 +

Statement

SampleIncome R&DExpenses OTHERR&DEXP 1 +

Statement

SampleIncome R&DExpenses R&DPAYROLL 2 +

Statement

SampleIncome Sales&MarketingExpenses MKTGPAYROLL 1 +

Statement

SampleIncome Sales&MarketingExpenses OTHERMKTGEXP 2 +

Statement

SampleIncome Sales&MarketingExpenses SLSPAYROLL 3 +

Statement

SampleIncome Sales&MarketingExpenses OTHERSLSEXP 4 +

Statement

SampleIncome Sales&MarketingExpenses FREIGHT 5 +

Statement

SampleIncome Sales&MarketingExpenses TRAVEL&ENTEXP 6 +

Statement

SampleIncome OtherOperatingExpenses EMPBENFT 1 +

Statement

SampleIncome OtherOperatingExpenses GENPAYROLL 2 +

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 9/10
3/8/2017 Document1954381.1

Statement

SampleIncome OtherOperatingExpenses EMPSUPP 3 +

Statement

SampleIncome OtherOperatingExpenses CONTEXP 4 +

Statement

SampleIncome OtherOperatingExpenses EMPOVERTIME 5 +

Statement

SampleIncome OtherOperatingExpenses VARIANCEEXP 6 +

Statement

SampleIncome OtherOperatingExpenses MISCOPEREXP 7 +

Statement

1.WhiledefiningthehierarchyenterallthechildnodesundertheCHILD_GROUP_ACCT_NUMcolumnandtheparent
nodesunderPARENT_GROUP_ACCT_NUMcolumn.ThevaluestobeenteredinthesecolumnsshouldbetheGroup
Accountcodes.ThenamesanddescriptionsforthesegroupaccountcodescanbeenteredinOracleBIApplications
ConfigurationManagerfortheGroupAccountsdomain.Ensurethatthevaluesenteredinthecsvfilematcheswiththe
valuesdefinedinConfigurationManager.

2.TheAGGREGATIONcolumnindicatesthearithmeticoperatorbetweenthenodesinthehierarchywhichcanbe+,,*or
/.

3.TheSEQUENCEcolumnindicatedthesequenceofchildnodesforanyparentnodeinthehierarchy.Forexampleinthe
hierarchyshownabove,GrossProfitisdefinedasREVENUECOGSandhencethesequenceisdefinedas1forREVENUE
and2forCOGS.Thissequenceisimportantbecausethenodesareenteredinthesameorderasmentionedinthecsv
fileintothecubeanditwillenableEssbasetodotheappropriatearithmeticoperation/consolidationintheproper
order.

4.ThefollowingexampleexplainshowtodefinethisSEQUENCEcolumnbetter.Letusassumethatyouwanttodefinean
expressionforanodeAasA=(B+C)/(D+E).

Insuchacaseitisalwaysprudentthatyousplittheseoperations.Sodefinetwointermediatenodes

XwhosechildrenareBandCwithsequence1and2respectivelyandYwhosechildrenareDandEwithsequence1
and2respectively.

ThendefinethenodeAwithchildrenXandYwithsequence1and2respectively.ThiswillenableEssbasetodothe
consolidationintheappropriateorderasmentionedabove.

TwosamplehierarchiesSampleIncomeStatementandSampleBalanceSheetareshippedintheoutofthebox
filewhichcanbeusedasreferences.

Didn'tfindwhatyouarelookingfor?

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=xzugvxkj4_417&id=1954381.1 10/10