Document: Essbase Beginners Guide Loading Data into Essbase Cube Chapter-XI

Description:
This is another guide from Essbase beginners series. The document provides the practical approach to load data into Essbase cube. The document is for public access. We assist Hyperion Essbase learner to explore the various ways to load data into Essbase cube. We encourage people to see one of world most advance and successful OLAP solution.

History:
Version
0.1 0.1

Description Change
Initial Draft Review 01

Author
Gaurav Shrivastava Amit Sharma

Publish Date
18-Jan-2011 01-Feb-2011

Learnhyperion.wordpress.com | Loading data into Essbase Cube

Table of Contents
1) Manual Data Loading..3 2) Free form data loading..4 3) Data load using Rule file...5 4) Data load with header8 5) Overwrite on Existing data ..11 6) Add data value to existing data..12 7) Subtract data from existing data14 8) Ignore field during data load15 9) Data load with sing flip.....16 10) Data load through Microsoft Excel lock & Send.18 11) Data Load through Smart View20 12) Data load through SQL..21 13) Oracle Data Integration....24 14) Data load through MaxL Script....29 15) Data load Reject ..31

Learnhyperion.wordpress.com | Loading data into Essbase Cube

Loading Data into Essbase

Loading data is the process of adding data values to an Essbase database from a data source such as a spreadsheet or SQL database. We are trying to demonstrate the various ways to load data into Essbase cube. Below is the step by step approach to load data into Essbase cube.

Essbase has option to load data manually. Before loading data into Essbase one can preview the existing data. To preview data into Essbase Cube right click on database then select preview data.

1) Manual Data Loading:-

Drill down up to level 0 members of the database and insert data. You can load data at any level in BSO cube provided that the given member had storage property as store only. However, member with Dynamic Calc or Dynamic Calc and store doesnt allow to insert data into the member.

After inserting data in to field click on update button. Once the data has been loaded at level 0, I execute Default Calculation (Calc All) to ensure data is available at higher level for business user access. Follow the steps given in the below diagram.

To execute database calculation click ok. You will have consolidated data at higher blocks. In the below diagram it is clearly visible that the data is available at year. We loaded data at
Learnhyperion.wordpress.com | Loading data into Essbase Cube 3

month level and as a result of calculation data gets consolidated at parent lever (YearQtrMonth).

2) Free form data Loading:- If the source file format is 100% matching with the outline format, then only we will go for Free form data loading. There is no need to create rule file. Free form loading doesnt require any rule file when source file contains at least one member from each dimension and data appears at last column as given in below diagram. The free form loading can be done manually or we can create a import script to load data at scheduled time.

In order to load data into Essbase cube, Right click database and select load data.

Go to Load dataSelect Load Only from the given Drop Down. Im assuming as my data source is flat file.

Browse database text file.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

No need to do rule file selection and other option.

Just click ok.

After successful loading of data, right click on database and Execute default Calculation to ensure data is available at higher blocks.

3) Data Load Using Rules File: Rules define operations that Essbase performs on data values or on dimensions and members when it processes a data source. Use rules to map data values to an Essbase database or to map dimensions and members to an Essbase outline. Rule file use for filtering data and then load in to metadata. Rule files use for mapping text file or source file with outline structure. The particular data will go to a particular field. First lets clear all available data. Just right click on database and clear all data.
Learnhyperion.wordpress.com | Loading data into Essbase Cube 5

Data Source

Rule File

Essbase Cube

Im going to clear all data before I load data from text file to Essbase cube.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

Data deletion is a risky task so it will ask confirmation.

Create a rule file for the text file given below. The below text file is not aligned with the outline structure thus we need rule file to load the data. You need to build a rule file and specify that what data filed in which outline field.

Step#1 Set space as delimiter. Map all fields of data source file. Step#2 Map all the fields from flat file to outline file given below and finally all the data field.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

Once mapping has done, validate the rule file.

Select data file and rule file by using Find Data File and Find Rule Files button. Click ok

Right click ok database and execute calculation.

Learnhyperion.wordpress.com | Loading data into Essbase Cube 8

Data gets loaded.

4) Data load with Header a) Some times the data load file has header row. During data loading we want to skip first row considering it as header row. There is no need to load header information.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

You need to skip header row while installation.

Set mapping properties with data source file.

Validate the build rule.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

10

Select both data source file and rule file and click ok.

You can see the data load successfully.

b) This data load source file has different scenario. You can set number of rows in header tab. That number of rows will not load while loading data.

Map data source file

Learnhyperion.wordpress.com | Loading data into Essbase Cube

11

Validate rule file

Select both data source file and rule file from Find Data File and Find Rules File button respectively. Click ok

You can check data loaded successfully.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

12

5) Overwrite Existing Values : While loading data into Essbase cube there is one option to overwrite the data value This is the existing data value in Essbase server.

You can overwrite data on the existing data. While mapping data source file open data load settings go to data load values tab and select Overwrite existing value option.

Validate rule file

Select data source file and rule file. Click ok

Learnhyperion.wordpress.com | Loading data into Essbase Cube

13

You can check new data is loaded in Essbase server.

This is the existing data value in Essbase server.

6) Add Data value to Existing data

You can add data in to existing data. The source file has updated data values.

Open data load settings

Learnhyperion.wordpress.com | Loading data into Essbase Cube

14

In data load settings, open data load value tab and select Add to existing values then click ok.

Select data source file and rule file.

Result after adding data.

7) Subtracting data from Existing data

This is the existing data value in Essbase server.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

15

You can subtract existing data value. Data file which you can use for subtraction.

Create rule file for the data source files. Open data load settings and select Subtract from existing values option in the data load values tab.

Once rule file created successfully, select data source file and rule file then click ok.

You can see the data values get updated again.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

16

8) Ignore field during data load: Sometimes the data source files consists of some fields which you do not want to load into Essbase cube, Essbase rule interface provides an option to ignore the filed while loading the data. This is the data source file, first field is not necessary.

While mapping data source file make check box true Ignore field during data load option in data load properties.

After selecting all properties, mapping will look like as below.

Select data source file and rule file then click ok.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

17

You can check data loaded successfully.

9) Data load with Sign Flip: Sometime there is need to load the data souce by flipping the sign( + become - and - become +). We flip the sign based on UDAs associated with the member.The below example demonstrate you how to achieve this. This is the data source file which has data for two cities.

You can see UDA for Florida is major market.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

18

Create rule file for the data source file. Open data load settings, go to data load values tab set sign flip on Major market.

Select data file and rule file, then click ok.

You can see data loaded successfully.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

19

10) Loading Data using Lock and Send method. This method is perhaps the quickest, down and dirty, method of loading data into an Essbase database. While it is fast and easy, there are limitations and precautions. Since Microsoft Excel is the natural front end for Oracle Essbase, they do work rather seamlessly together. However, you do need to remember, that what you are doing with a spreadsheet's "Lock and Send" function is updating existing data as there are no provisions for adding new members to the database outline through Microsoft Excel. Also, Essbase seems to have difficulty locking too many data cells when asked by Microsoft Excel. Due to performance issues, you may want to consider splitting spreadsheets that contain a considerable amount of rows. Update your desired cell then select complete outline with updated value then lock it.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

20

When you open Essbase add-ins there is option send.

The final operation of lock and send method is retrieve.

You can see the final updated database is showing in excel. This is very fast way to update data base. You can see the associated formula also execute automatically.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

21

You can upload data directly from Excel. Insert 0 level data then click on submit data.

11)

Data Load through smart view

On refreshing excel sheet the updated value will comes automatically. Refreshed result shown in Excel.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

22

12)

Data Load through SQL Database: You need to create system DSN for loading
data through SQL database.

System DSN is created successfully.

Now you need to create rule file for data load.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

23

You have DSN for SQL server. Go to file and open Open SQL, and then you need to select Essbase server information server name, application name and database name.

You have build DNS bisp, so you need not to specify connection information again. You need to write SQL statement then click ok and retrieve. You need to enter username/password in SQL Connect and specify Essbase server information click ok.

Set data load properties for building rule file.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

24

Validate the rule file

Save rule file.

There is import and export wizard utility in SQL server, through which you can import data from SQL database into text file. Browse text file and rule file and click ok for loading data in to Essbase.

13) Loading data using Oracle Data Integration

Learnhyperion.wordpress.com | Loading data into Essbase Cube 25

Step: 1) Creating Data Store for flat files. We will use same model which we have use during data extraction from Essbase to flat file. We need to create new data store for source text file. Select the model Right click and select New Data Store. In Definition tab enter the name then click on Resource Name browse button select you text file from open dialog box and press Open.

Step: 2) Go to file tab select file format as delimited set heading to 1 and field separator to Comma (,).

Step: 3) Now go to Column tab and click on reverse engineer button.

Learnhyperion.wordpress.com | Loading data into Essbase Cube 26

Step: 4) we need to change the data type of Actual, Budget and Variance to Numeric because it is numeric fields.

Step: 5) Save it.

Learnhyperion.wordpress.com | Loading data into Essbase Cube 27

Step: 6) Source is ready, now we will create the interface. Select same project that we have created previously open it and select interface right click and new interface.

Specify the name, context and Staging area.

Step: 7) Go to mapping tab and drag load datastore and drop it to source area. Similarly drag Essbase odidemo_odidata to target place. It will ask you for auto mapping press Yes.

Step: 8) Go to overview tab and select staging area different from target check box.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

28

Step: 9) Now go to Flow tab where you specify the Knowledge module for the interface these are the required knowledge module. If you have not imported it till now import it. i) LKM File To SQL ii) IKM SQL TO Hyperion Essbase (Data).

Step: 10) Save it.

Learnhyperion.wordpress.com | Loading data into Essbase Cube 29

Step: 11) Execute the interface.

Step: 12) Go to the operator tab and check the execution result.

Step: 13) Now go to Essbase application refresh it and check the data.

14)

Data Load through MaxL script

1) You can load data through Maxl script. This is the data source file for loading data

through Maxl script.

Learnhyperion.wordpress.com | Loading data into Essbase Cube 30

File New Maxl Script

Write MaxL Script to load data. This is the script for loading data. Set data source file path and error file path. import database 'Bisp'.'BispBD' data from data_file 'F:\Hyperion\products\Essbase\EssbaseServer\app\Bisp\data_FL.txt' on error write to 'F:\DataError\Essbase\Error.txt';

You can check that data loaded successfully.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

31

2) Data load through MaxL script when the data source require rule file.

File New Maxl Script

Write MaxL Script to load data. This is the script for loading data. Set data source file path, rule file path and error file path.

import database 'Bisp'.'BispBD' data from data_file 'F:\Hyperion\products\Essbase\EssbaseServer\app\Bisp\R_data.txt' using rules_file 'F:\Hyperion\products\Essbase\EssbaseServer\app\Bisp\BispBD\R_Data.rul' on error write to 'F:\DataError\Essbase\Error.txt'; Script executed successfully.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

32

You can check that data loaded successfully in the Essbase server.

15) Dealing with the rejected records.

1) When data load gets fails the error message with rejected records store in dataload.err file. In the below example, we are trying to load the data for the member which does not exist in outline. Member 500-10 is not exists in the product dimension.

Rule file for respective data source file.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

33

Select both data source file and rule file and click ok for loading data. Data load result shows warning message, it means that there is something wrong with data source file or rule file. Click on Warning for the detail information.

You can see detail warning message in the second part of data load results.

Detailed error message stored inside the fallowing path F:\Hyperion\products\Essbase\eas\client. Open dataload.err file in notepad to see error message.

Error message says member not found in the present outline.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

34

2) You will get error if data source file is in wrong format. Inverted coma is missing in the last record of data source file.

You will get the following error message. Essbase server could not understand the last record. Error message says that 11 records are completed but there is one unknown member.

Correct the source file and reload the data.

Learnhyperion.wordpress.com | Loading data into Essbase Cube

35