Oracle Essbase 9 Implementation Guide- P24 pdf

Building the Essbase Outline
[ 100 ]
• Create Using Join: This function is used to join two or more elds to
create a new eld.
In this example, we have joined the eld containing the value of United
States of America and the eld containing the value USA, into a new
eld which looks like: United States of AmericaUSA, as shown in the
following screenshot:
• Create Using Text: Creates a new eld based on the text you have entered.
This is particularly helpful when you need to make Essbase-friendly data
that is repeatedly sent from the same source.
As shown in the following example, a eld is added between Field 6 and
Field 7 called US:
This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009
8601 ave. p #1, , lubbock, , 79423
Download at Boykma.Com
Chapter 3
[ 101 ]
Step 8: Associate elds with dimensions
Now that our source data le transformation is complete, we are ready to proceed
with the outline update. Before we update the outline, we need to set the Dimension
Build Properties, meaning we need to dene the attributes of each column. In other
words, how Essbase will interpret the data in each column.
Since our market data source is to be a generation build method, let us dene
each column and how the outline must be updated according to the data.
Open the Dimension Build Properties in EAS, with the Data Prep Editor open:
1. Click on Fields and then click on the Field Properties
2. Since this is Dimension build rule le, go to the tab Dimension
Build Properties
The following screenshot shows the Dimension build settings:
In the Dimension Build Properties screen, you need to dene the dimension

name, and the corresponding eld that the data will load to. Some of the
available options are Generation, Alias, Property, Level, Parent, and Child.
This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009
8601 ave. p #1, , lubbock, , 79423
Download at Boykma.Com
Building the Essbase Outline
[ 102 ]
You can also ignore a eld by selecting the option Ignore eld during dimension
build. There may be times when an entire column or eld is not needed for you
to load the data into Essbase. For example, the le you are loading has a column
for cities in it. Your database outline is only set up for countries and states. Cities
are not needed so there is no need to even look at them.
In our example, the Field 1 input data eld is the
Generation 2 member name
(Generations always start from Generation 2 as the Generation 1 level is the
dimension name itself) and the next eld will be the member alias.
Click on Field 1, then assign the Field Denition | Dimension as TOTAL MARKET,
in the Field | Type select Generation and in the Field | Number enter 2 and click OK.
The input data Field 1 is now set to load to
Generation 2/Member Name. If you were
nished, you could click OK now, with more elds to dene, you can simply click on
Next. Did you see how the cursor has automatically moved to Field 2. Select TOTAL
MARKET as the dimension name and click on Alias eld type. When you select Alias
the Field | Number is set to Generation 2 as shown:
This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009
8601 ave. p #1, , lubbock, , 79423
Download at Boykma.Com
Chapter 3
[ 103 ]
Repeat the above steps by clicking on Next and choosing the Dimension name and

Field | Type until you reach the end of the le. The Generation number will be
incremented by one for each new eld in the data that you dene as a new member.
Finally, all of the elds in the input data le are dened in the Essbase rules le.
The rules le should look like this:
Step 9: Validate the Dimension Build rules le
Now that all of the input data elds are assigned to the appropriate outline members,
we need to validate the rules le against the database outline. With the rules le
open, click on the validate button (the quick select button says Validate when you
hover over it). The validate function validates if the rules le is properly dened for
the specic database outline. If the validate is successful, you will receive a validate
successful message. If the rules le is not properly dened to the database outline, you
will receive a message stating the validation was unsuccessful. One common example
of a rules le validation failing is if you have two elds dened as building members in
the same dimension. When you set the dimension build to use the generation method,
you must be careful that you dene the elds correctly. The eld that is going to build
Generation 2 members must be the only eld set upto do so.
Upon successful rules le validation, click on File | Save and give the rule le
a name (preferably something meaningful but remember, upto 8 characters in
the name). The rules le can be saved on either the Essbase server or as a local le.
Where you save it depends on your specic architecture.
This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009
8601 ave. p #1, , lubbock, , 79423
Download at Boykma.Com
Building the Essbase Outline
[ 104 ]
Update your outline using a rules le
Now that you have completed your rst rule le, you need to update the outline
using this rules le.
There are several ways you can update an outline using a data rules le and
a data le:

• Updating the outline from the EAS Outline Editor
• Executing MaxL commands
• Making your own API calls
• Running Essbase command scripts
We will discuss the rst and second points now, and the third and fourth points
will be discussed with examples provided, in the next chapter.
Update your outline using the EAS Outline
Editor
One of the easiest ways the outline can be updated is manually by using
the EAS Outline Editor.
The steps to update the outline are:
1. In the EAS, open the Application | Database for which the outline
needs to be updated.
2. Double-click on the Outline, the outline editor is opened for editing.
3. Or, you can click on the Outline in the Menu option and then click on
the Update outline. The following screen will then be displayed:
This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009
8601 ave. p #1, , lubbock, , 79423
Download at Boykma.Com