You are on page 1of 200

OPN Hyperion Planning 11.1.

1 Implementation Bootcamp
Activity Guide

D64290GC10 Edition 1.0 December 2009

Copyright 2009, Oracle. All rights reserved. Disclaimer This document contains proprietary information and is protected by copyright and other intellectual property laws. You may copy and print this document solely for your own use in an Oracle training course. The document may not be modified or altered in any way. Except where your use constitutes "fair use" under copyright law, you may not use, share, download, upload, copy, print, display, perform, reproduce, publish, license, post, transmit, or distribute this document in whole or in part without the express authorization of Oracle. The information contained in this document is subject to change without notice. If you find any problems in the document, please report them in writing to: Oracle University, 500 Oracle Parkway, Redwood Shores, California 94065 USA. This document is not warranted to be error-free. Restricted Rights Notice If this documentation is delivered to the United States Government or anyone using the documentation on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS The U.S. Governments rights to use, modify, reproduce, release, perform, display, or disclose these training materials are restricted by the terms of the applicable Oracle license agreement and/or the applicable U.S. Government contract. Trademark Notice Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Title of Presentation
Presenters Name Oracle Hyperion Planning Presenters Title Implementation Boot Camp
Lab Guide

Developed in Partnership With:

Table of Contents Oracle Hyperion Planning Implementation Boot Camp Lab Guide
Housekeeping & Case Study Introduction 3

Section Objectives ...................................................................................................................................... 3 Exercise 1.1 Copy Distributed Files ........................................................................................................ 4 Exercise 1.2 Launch the Essbase Services .............................................................................................. 5 Exercise 1.3 Introduce Case Study and Discuss Plans for building Essbase application ....................... 6

Essbase Modeling

11

Section Objectives .....................................................................................................................................11 Exercise 2.1 Create new Essbase Application and Database.................................................................12 Exercise 2.2 Create a New Database from Files ....................................................................................28 Exercise 2.3 Add Essbase Spreadsheet Add-in for Excel and update Options .......................................34 Exercise 2.4 Essbase Spreadsheet Add-in for Ad-hoc Queries and Reports ...........................................42 Exercise 2.5 Smart View for Office for Ad-hoc Queries and Reports.....................................................47 Exercise 2.6 Essbase Data Loads ...........................................................................................................54 Exercise 2.7 Essbase Dense/Sparse Settings and Database Properties: Dimensions, Statistics and Storage ......................................................................................................................................................62 Exercise 2.8 CALC DIM command and review of block creation and Database Statistics....................63 Exercise 2.9 Review Blocks, Index, Dense/Sparse, Compression and Fragmentation concepts ............71 Exercise 2.10 Member Calculations and Member Set Functions ...........................................................72 Exercise 2.11 Correct Percent, Rate and Variance Calculations...........................................................74 Exercise 2.12 Dynamic Calculations......................................................................................................77

Classic Planning Application Creation

78

Section Objectives .....................................................................................................................................78 Exercise 3.1 Create Hyperion Planning Relational Database Repository, Create Planning Application and Data Source ........................................................................................................................................79 Exercise 3.2 Model Planning Application Dimensions ........................................................................106 Exercise 3.3 Outline Load Utility .........................................................................................................120

Data Form Design

121

Section Objectives ...................................................................................................................................121 Exercise 4.1 Forms Designer ...............................................................................................................122 Exercise 4.2 Business Rules..................................................................................................................135 Exercise 4.3 Additional Form Components ..........................................................................................148

Security and Administration

121

Section Objectives ...................................................................................................................................121 Exercise 5.1 - Planning Security..............................................................................................................171 Exercise 5.2 - Life Cycle Management ...................................................................................................183

Appendices

189

Section Objectives ...................................................................................................................................189 Appendix A.1 Copy Files to Virtual Image ...........................................................................................189 Appendix A.2 Troubleshooting Shared Services Issues ........................................................................189

1
Housekeeping & Case Study Introduction

Section Objectives
In this section, you: Copy the distributed required files for completion of the exercises Launch the services required to run Essbase Server, Essbase Administration Services (EAS) and Smart View Review

1 Housekeeping & Case Study

Hyperion Planning Implementation Boot Camp

Exercise 1.1 Copy Distributed Files


In this exercise, you copy the distributed files to be used for the exercises in this workbook to your version of BIC2g (Business Intelligence Challenge 2 Go) EPM Demo Image
Copy exercise files

Insert the thumb drive that is distributed by instructor. 2. See Appendix A-1 for details on copying files saved on your Host system to various Virtual systems. 3. Start your Virtual Image.
1.

Following Dialog Box displays:

This is a known issue and not a concern, click OK button


4.

Copy and expand the files Planning_Training folder of the thumb drive to a new folder on the VM image: c:\BootCamp Eject the thumb drive.

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Housekeeping & Case Study

Exercise 1.2 Launch the Essbase Services


In this exercise, you launch the services necessary to access Essbase Server, Essbase Administration Services and Smart View. See Appendix A.1 for specific instructions for starting the necessary services.
Start Services 1.

For the exercises in this section, the following services are needed. (see Appendix A.1 for specific instructions on starting the necessary services)

OracleOraDb11g_home1TNSListener OracleServiceORCL

Hyperion Foundation OpenLDAP Hyperion Foundation Shared Services

Hyperion Essbase Services 11.1.1 - hypservice_1 Hyperion Administration Services - Web Application Hyperion Provider Services - Web Application
At end of Day, Stop Services in reverse order before Shut Down of virtual image to help avoid Shared Services corruption issues.

Hyperion Planning Implementation Boot Camp

1 Housekeeping & Case Study

Hyperion Planning Implementation Boot Camp

Exercise 1.3 Introduce Case Study and Discuss Plans for building Essbase application
In this exercise, you will be introduced to the case study that we will use for the entire boot camp. You will be provided with reports and a sample input data format and asked to plan out the application structure in terms of dimensions and members.
Review the reports provided by the client 1. Review the following reports

provided by the client and with the rest of the attendees in an interactive session, agree on the Dimensions and Members that will need to be included in Essbase to produce the reports.

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Housekeeping & Case Study

Hyperion Planning Implementation Boot Camp

1 Housekeeping & Case Study

Hyperion Planning Implementation Boot Camp

2. 3. 4. 5. 6.

What Dimensions are required in Essbase to build reports? What are the Members Hierarchies in the Dimensions? What questions should we ask the client? What recommendations can we make to the client? Review the Sample Data file provided by client IT Department.

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Housekeeping & Case Study

Does this answer any questions? 8. Does it raise additional questions? 9. Lets ask the client our questions and see what we learn.
7.

Hyperion Planning Implementation Boot Camp

2
Essbase Modeling

Section Objectives
At the end of this section, you will be able to: Create new Essbase Application and Database Build new Essbase Database Outline Use Essbase Spreadsheet Add-in to do ad-hoc queries and create reports Use Smart View for Office to do ad-hoc queries and create reports Build and Run Essbase Data Load Rules Understand Essbase Architecture: Dense, Sparse, Blocks and Index Learn Calculation Fundamentals

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.1 Create new Essbase Application and Database


In this exercise, you log in to Essbase Administration Services and create a new Application and Database.

Log in to Essbase Administration Services 1.

From the Windows Start button select All Programs > Oracle EPM System > Essbase > Administration Services > Start Administration Services Console
After selecting this path once, Start Administration Services Console should be added to your program favorites.

The Administration Services console window appears and a Login dialog box displayed:

Under Username, type demoadmin Under Password, type Demov52 Click OK. 3. Expand Essbase Servers so that demodrive appears
2. Create Application and Database 4.

From the Windows Start button select All Programs > Oracle Right-click on demodrive and select Create > Application > Using block storage

12

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

(you can also Create Application with demodrive Server selected and by selecting menu bar item Actions > Create > Application for demodrive > Using block storage)

The Create Application dialog box displays:

5.

Under Application name:, type AutoDemo and click OK.


Be patient! This may take about 30 seconds as Essbase creates new file structure for new Application and related objects and allocates additional memory as new Application is started.

Hyperion Planning Implementation Boot Camp

13

2 Essbase Modeling
6.

Hyperion Planning Implementation Boot Camp

Expand demodrive node (or double-click) so that Applications appears in next level. 7. Expand Applications node so that AutoDemo appears in next level. 8. Right-click on AutoDemo and select Create database

14

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

The Create Database dialog box displays:

Under Database name: type New and click OK. 10. Expand AutoDemo node so that New appears in next level. 11. Expand New node so that Outline appears in next level. 12. Right-click on Outline and select Edit.
9.

The Outline Editor displays:

Hyperion Planning Implementation Boot Camp

15

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Hide/Unhide the Navigation Pane on the left by selecting View and then uncheck/check Navigation. 14. Select the Maximize button to display Outline Editor in a larger view.
13.

16

Enablement 2.0

Hyperion Planning Implementation Boot Camp 15.

Essbase Modeling

Click on button to Add a child to selected member button (see above) and enter the Dimensions: Measures, Time and Scenario.

Press Enter to close the input box. 17. Select Time and click on button to Add a child to selected member 18. Enter Time dimensions members: Year, M1, M2, M3, M12, Q1, Q2, Q3 and Q4 and press Enter to exit Input box 19. Select M10, M11 and M12 (Crtl-click each M11 and M12 or Shiftclick M12) and click on button to Mark the selected member to be cut.
16.

Hyperion Planning Implementation Boot Camp

17

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

20.

Select Q4 and click on button to Paste the marked member as a child of the selected member.

18

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

The Outline Confirmation dialog box is displayed.

21.

Click Yes.
Confirmation is useful to avoid making inadvertent changes, but can be turned off by selecting Tools > Console Options and then selecting Outline Tools tab in the Options dialog box as displayed below.

Hyperion Planning Implementation Boot Camp

19

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Following the Paste, the Outline Editor shows the members in the new position:

20

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Repeats steps 19-21 to move the other Month members as children of appropriate Quarter members st 23. Select the Year member, right-click and select 1 option Edit member properties 24. The Member Properties dialog box displays, enter Default Alias of Calendar Year and click Next button to Save modifications and change selection to the next member
22.

Hyperion Planning Implementation Boot Camp

21

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

25.

Update remaining Aliases for Time dimension using Quarter 1, January, February, March, Quarter 2, April The Time dimension in Outline Editor should appear as follows:

22

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

26.

Add Members for Measures dimension through Total Gross Sales (refer to page 6), hint: change Consolidation properties by using right-click option to Edit member properties Tag Measures dimension as Accounts and Time dimension as Time using Member Properties dialog box and Dimension type:

27.

Hyperion Planning Implementation Boot Camp

23

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Select one of Account members and Edit member properties , Notice new properties under Account information 29. Select Time dimension, right-click and select Dynamic time series 30. Enable Y-T-D as Gen1 and Q-T-D as Gen2 and click OK
28.

31.

After Time dimension you will now see (Active Dynamic Time Series Members: Q-T-D). Why isnt Y-T-D included? Year is the predefined generation name for the Y-T-D Dynamic Time Series. Since Year already exists as member in the Time dimension, Essbase

24

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

wont allow adding a Dynamic Times Series with generation name of Year. 32. Rename the Year member to Full Year and enable Enable Y-T-D dynamic time series as Gen1 The Measures dimension in Outline Editor should appear as follows:

Add Scenario members Actual (~), Budget (~) and Actual vs Budget (~) with appropriate Consolidation properties. 34. While in the Member Properties dialog box for Actual vs. Budget, select the Formula tab. 35. Check the checkbox for Insert Arguments and under Math category (or near bottom of Alphabetical listing), select @VAR function, double-click @VAR to move it to the Script pane. 36. Expand the Scenario dimension and with mbrName1 highlighted, double-click on Actual, then with mbrName2 highlighted, doubleclick on Budget.
33.

Script should show @VAR (Actual, Budget) as shown below:

Hyperion Planning Implementation Boot Camp

25

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

37.

Click on the Verify button. Member Formula dialog box displays -

38.

Click OK button. The message indicates unexpected end of expression. All formulas and calc script commands need to end with a semi-colon (;). Add a semi-colon at end of formula and click on the Verify button. Member Formula dialog box displays -

26

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

39.

Click OK button, then click OK button in Member Properties dialog box. The Scenario dimension in Outline Editor should appear as follows:

40.

What are two other ways to calculate Actual Budget? What are the pros and cons of each approach? Save Outline and remain in Essbase Administration Services for following exercise.

41.

Hyperion Planning Implementation Boot Camp

27

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.2 Create a New Database from Files


In this exercise, you create new AutoDemo:Auto database, upload Outline from file in BootCamp folder, save Outline to server, load data from file in BootCamp folder and calculate database to be used in subsequent exercises.
Create new Database 1.

Repeat steps 8 and 9 from exercise 2.1 to create new database in AutoDemo Application called Auto

2.

From the menu bar, select File > Open and in Open dialog box, with tab on File System, navigate to C:\BootCamp\Calcs\calcbeg.otl and press OK button.

28

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

3.

The outline will appear in the Outline Editor. From the menu bar, select File > Save as and in Save As dialog box, with tab on Essbase Server, double-click on Auto, select Auto.otl and click OK button.

Hyperion Planning Implementation Boot Camp

29

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

A Confirmation dialog box displays:

4.

Click Yes button. A Outline Editor dialog box displays:

Click No button. 6. In Navigation pane, select the new AutoDemo:Auto database. Rightclick and select Load data
5.

30

Enablement 2.0

Hyperion Planning Implementation Boot Camp 7.

Essbase Modeling

In the Load Data dialog box, click on Find Data File button and in Open dialog box, with tab on File System, navigate to C:\BootCamp\Calcs\explev0.txt and click OK button. 8. Back in Load Data dialog box click OK button to start data load. The Data Load Results dialog box displays:

9.

After confirming Status of Success, click Close button. In Navigation pane, select the AutoDemo:Auto database. Right-click and select Execute calculation The Execute Database Calculation dialog box displays:

Hyperion Planning Implementation Boot Camp

31

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Click OK button to initiate the default calculation which will take about 10 seconds to complete. 11. In Navigation pane, select the AutoDemo:Auto database. Right-click and select Preview data
10.

The Data Preview Grid displays:

12.

If you see data, this confirms data has been successfully loaded and calculated at the top level of each dimension. The number shown is followed by E8, so it is 205,939,054.

32

Enablement 2.0

Hyperion Planning Implementation Boot Camp 13.

Essbase Modeling

From Navigation Pane expand AutoDemo node so that Auto appears and expand Auto node so that Outline appears, right-click on Outline and select View. Notice the following items: - Measures: many Metrics, but no formulas, just examples - Time: PTD members using shared members, No Time member - Scenario: ScenarioCalculations members - Total Dealers: Regions alternate hierarchy, No Dealer member - Department: No Department member - Products: No Product member - US Regions: Attribute dimension, go back to Total Dealers and select AW 001, notice UDA, right-click and View Member Properties, notice attribute of West US, right-click and Remove split view, to close Member Properties pane 14. Leave the Essbase Administration Services console open to review the outline as we work through other Day 1 exercises.

Hyperion Planning Implementation Boot Camp

33

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.3 Add Essbase Spreadsheet Add-in for Excel and update Options
In this exercise, you add the Essbase Spreadsheet Add-in to copy of Excel on the Demo image using file from EssbaseClient\bin directory.

Add Essbase Spreadsheet Addin 1.

From the Windows Start button select All Programs > Microsoft Office > Microsoft Office Excel 2007
After selecting this path once, Microsoft Excel should be added to your program favorites.

2.

Select Microsoft Office button (in upper left hand corner) and select Excel Options at bottom of dialog box.

The Excel Options dialog displays:

34

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Select Add-ins on the left pane. The Add-ins pane displays on the right:

Hyperion Planning Implementation Boot Camp

35

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

15.

With Manage: Excel Add-ins selected in the dialog box at the bottom, click on adjacent Go button. A new Add-Ins dialog box displays:

36

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

16.

Click on Browse button to the right. Browse to C:\ORCL\HYSL\products\Essbase\EssbaseClient\bin and select essexcln.xll file The Add-ins pane will be redisplayed showing the new add-in:

Hyperion Planning Implementation Boot Camp

37

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

17.

Press OK button. The Add-Ins menu bar option will now show Essbase as an option:

38

Enablement 2.0

Hyperion Planning Implementation Boot Camp Update the Default Options 7. Select

Essbase Modeling

Essbase > Options

The Essbase Options dialog box is displayed:

Hyperion Planning Implementation Boot Camp

39

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

On Display tab, under Cells, select Adjust Columns. 9. Clink on Global tab.
8.

40

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

10.

Close Excel

Hyperion Planning Implementation Boot Camp

41

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.4 Essbase Spreadsheet Add-in for Ad-hoc Queries and Reports
In this exercise, you will familiarize yourself with using the Essbase Spreadsheet Add-in to create ad-hoc queries and reports in Excel.

Connect to an Essbase Database 1.

From the Excel 2007 Add-Ins ribbon, select Essbase > Connect The Essbase System Login dialog box displays.

Enter Username: demoadmin, Password: Demov52 and click OK button. 3. Select Application/Database: AutoDemo:Auto and click OK button. 4. Do default Retrieve using Essbase > Retrieve or double-click in the Excel grid. The value of 205,939,054 represents one cell in the cube at the Dimension level of each of the 6 dimensions represented in the Auto database. Notice that this is the exact same number as shown in the Data Preview Grid.
2.

42

Enablement 2.0

Hyperion Planning Implementation Boot Camp 5. 6. 7.

Essbase Modeling

8. 9. 10.

11.

Double-click on Measures (or use Essbase > Zoom In). You will see the 2 Gen1 members under Measures. Do Essbase > Flashback and then Essbase > Options and on Zoom tab, change Zoom In to All Levels and click OK. Again zoom in on Measures. Now you will see all levels of the Measures dimension, similar to a P&L statement. Be careful not to use the All Levels or the Bottom Level settings when doing zoom in on a large dimension as it will bring back more data than you can reasonably analyze and may take a long time to complete or error out if there are more rows than Excel can accommodate. Select Essbase > Options and on Zoom tab, change Zoom In back to Next Level and click OK. Select Fleet Units Sales and Essbase > Keep Only. Double-click on Total Dealers and Pivot the Measure member Fleet Unit Sales from Rows to a Column using Essbase > Pivot or by drag and drop. Double-click on North America. Double-click on Dealers. Double-click on Auto World. Double-click on Regions. Double-click on Western US. Double-click on Regions. Doubleclick on Western US. You can see the Regions alternate hierarchy uses shared members. Select Total Dealers and Essbase > Keep Only and then Essbase > Member Selection, in the Member Selection dialog box select member Total Dealers and click Add-> button so that Total Dealers appears under Rules: The Essbase Member Selection dialog box should be as below:

Hyperion Planning Implementation Boot Camp

43

2 Essbase Modeling
12.

Hyperion Planning Implementation Boot Camp

Right-click on Total Dealers under Rules: and select Subset, click on the Add as AND Condition button. The Subset Dialog box should be as below:

Click on OK. On Member Selection dialog box, under Rules:, under Total Dealers, you will now see Attribute of UDAWest, click on OK. The 5 members of Total Dealers dimension with UDA of UDAWest will be in each row. Retrieve to see data. 14. Right double-click on AW 001 (or use Essbase > Zoom In), continue zooming out to North America, then zoom in and zoom in again on Regions. 15. In new column (cell G1), enter the Attribute dimension US Regions (or use Essbase > Member Selection, and select Dimension US Regions), then zoom in on US Regions and pivot the attribute dimension to columns.
13. You would not typically include both alternate hierarchies AND attribute dimensions for the same members. Discuss why you might use one of the other. 16.

Delete row 2 attribute dimension members, zoom-in on Dealers, zoom-in on Auto World, select AW 001 and Essbase > Keep Only

44

Enablement 2.0

Hyperion Planning Implementation Boot Camp 17.

Essbase Modeling

In place of Departments, type cc6350 and do a Retrieve. If you know the names of members, you can simply type them in. Notice that the data value doesnt change. CC6350 is the only department with Fleet Unit Sales data. 18. In place of Products, type 155 and do a Retrieve. The Essbase Error dialog box displays:

19.

20. 21. 22. 23.

24. 25. 26.

27.

28.

29.

Essbase only recognizes Text members and Excel be default recognizes number strings as Numbers. In place of 155, type 155 (with single quote in front) and do a Retrieve. Now Essbase recognizes 155 as a member. In place of 155, type 155-1000-10 (without single quote in front) and do a Retrieve. With dashes in the string, Excel now recognizes this as a Text Zoom In on Time and Pivot the Total Dealers member AW 001 from Rows to a Column. Why does PTD have no value? Check the outline for an explanation. Type PTDApr in place of PTD and do a Retrieve. In new row below Time, type y-t-d(apr) and do a Retrieve. This uses Dynamic Time Series to generate the same values as created by using the PTD members. Why use PTD members versus Y-T-D Dynamic Time Series? Select Calendar Year and Essbase > Keep Only. Zoom In on Calendar Year and each of the Quarters so all months are displayed. Select Essbase > Options and on Display tab under Aliases, select checkbox to Use Aliases, click OK and do a Retrieve to display member aliases. Select Scenario, and use Alt + double-click to Zoom In across Rows, select 2003 and Scenario (Ctrl+click) and Essbase > Remove Only. Zoom In on 2004 and ScenarioCalculations. Why does Actual/Budget only have values for the months? See Outline to find an answer. What are options to fix this? Keep Only 2004 Actual, 2004 Budget and 2004 Forecast

Hyperion Planning Implementation Boot Camp

45

2 Essbase Modeling
30.

Hyperion Planning Implementation Boot Camp

Copy the values of Jan:Jul from 2004 Actual to 2004 Forecast and add new value for Aug -> 2004 Forecast of 48. Then do Essbase > Lock, Essbase > Send and do a Retrieve. 31. Create Report1 (see page 6) using Essbase Spreadsheet Add-in. 32. Select Essbase > Disconnect

Click on the Disconnect button and then click on the Close button.

46

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Exercise 2.5 Smart View for Office for Ad-hoc Queries and Reports
In this exercise, , you will familiarize yourself with using the Smart View for Office to create ad-hoc queries and reports in Excel.

Connect to an Essbase database 1.

From the Excel 2007 Hyperion ribbon, select Data Source Manager. The Smart View Data Source Manager window displays. Use the Switch button (on left) to select Common Provider Connections in lieu of Independent Provider Services.

2.

The click on Connect to Provider Services

Hyperion Planning Implementation Boot Camp

47

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Then under Pre-defined drop-down, select All in lieu of Pre-defined

3.

Select the Oracle Essbase connection and expand to display the demodrive node, select demodrive. The Connect to Data Source dialog box displays:

48

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Enter Username: demoadmin, Password: Demov52 and click the Connect button. 5. Expand AutoDemo node, right-click on Auto and select Ad-Hoc Analysis.
4. You can also Add to Favorites (for End-Users) or Add To Predefined (for Administrators).

6.

The default query (Measures and Time) displays, with the top level in the other dimensions included in the Point of View (POV).

Hyperion Planning Implementation Boot Camp

49

2 Essbase Modeling
7. 8.

Hyperion Planning Implementation Boot Camp

Zoom In on Time using double-click (or use the Zoom In

button).

Select Calendar Year and use the Keep Only button. 9. Type Fleet Unit Sales in place of Measures and click on Refresh button. 10. Click on Total Dealers drop down in POV and select

The Member Selection dialog box displays:

11.

Select Total Dealers, AW 001, AW 002, AW 003 and AW 004 and click the Add button and then the OK button.

50

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

The values are added to POV as displayed below:

Select AW 001 and click Refresh button. 13. Left-click on Products in POV and drag to a colum.
12. 14.

Use Select Calendar Year and Pivot

button to switch it to row

and select Fleet Sales Units and Pivot button to switch it to column. 15. Zoom In on Calendar Year, Q1, Q2, Q3 and Q4.
16.

Click on Undo

button 4 times (to Zoom Out from quarters) and

button 3 times to Zoom In on Q1 thru Q3. Undo is click on Redo enabled on the Options dialog box and the Ad Hoc tab In Number
of Undo Actions, specify the number of permissible Undo operations 2 through 100.
17.

Right-click on any cell and select Hyperion > Ad Hoc Analysis > Change Alias Table. The Select Alias Table dialog box displays:

Hyperion Planning Implementation Boot Camp

51

2 Essbase Modeling
18. 19. 20.

Hyperion Planning Implementation Boot Camp

Select Default alias and click OK button. Notice that aliases are displayed in grid as well as in the POV. Select Products in grid and Member Selection button

In Member Selection dialog box, 1st click Remove button to remove Products from under Selection, then expand Total Products, SUV and Bump Jumper, select Bump Jumper EUV and click the button and then the OK button. Add 21. Right-click and drag Bump Jumper EUV from grid back to the POV (or use Hyperion > Ad Hoc Analysis > Pivot to POV) 22. Left-click and drag Scenario from the POV to a column and Rightclick and drag Fleet Unit Sales from grid back to the POV 23. In the POV, select Department CC6350 (under Functional > Sales and Mktg > Sales) Select Scenario in grid, Member Selection button, select 2004 Actual, 2004 Budget and 2004 Forecast (exclude Scenario) and Refresh. You should recognize 2004 Forecast data entered earlier. 25. Revise Aug -> 2004 Forecast from 48 to 51, notice cell changes to yellow to indicate value has been updated.
24.

Click on Submit Data button (this combines Lock and Send into one step), notice cell changes back to white to indicate there are no outstanding updates. 27. Create Report1 (see page 6) using Smart View for Office. 28. In Smart View Data Source Manager, right-click on AutoDemo:Auto, click on Disconnect > Data Source Connection followed by Disconnect > Common Provider Connection.
26.

52

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Hyperion Planning Implementation Boot Camp

53

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.6 Essbase Data Loads


In this exercise you will create new Data Load Rules for loading a text files to Essbase.

Log in to Essbase Administration Services 1.

Log on to Essbase Administration Serices (follow steps from Exercise 2.1, page 11) 2. Expand Essbase Servers node, demodrive node, Applications node, and AutoDemo node, right-click on AutoDemo and select Create database The Create Database dialog box displays: Under Database name type AutoPlan and click OK.
3.

4. 5. 6. 7.

8.

9.

Repeat steps 2 through 5 from exercise 2.2 to open C:\BootCamp\Model\FinishedAutoplan.otl from File Server and Save to AutoPlan.otl on Essbase Server. Review AutoPlan outline making note of dimensions and format of members. Right-click on AutoPlan and select Create > Rules file, the Date Prep Editor pane displays. From menu bar select File > Open data file (NOT Open), select File System tab and select C:\BootCamp\Load\LoadACT.txt file Select Options > Associate outline (or use Associate outline shortcut button) and confirm AutoDemo:AutoPlan is selected and click OK button. Select Options > Data source properties (or use Data source properties shortcut button). The Delimiter tab has Delimiter set as Tab (the default), for this tab delimited file. If appropriate, you can select other delimiter including Custom delimiters like | (pipe) or specific Column width. Select the Header tab. Since the data file has some month number labels in Row 1, we want to ignore it under Header lines change Number of lines to skip from 0 to 1.
Data source header records can be used if a header row contains all the Data Load or Dimension Build field names.

Click OK button.

54

Enablement 2.0

Hyperion Planning Implementation Boot Camp 10.

Essbase Modeling

Are all dimensions represented in data? Select Options > Data load settings (or use Data load setting shortcut button). Leave Data Load Values tab with default Overwrite existing values. On Header Definition tab, expand Dimension > Scenarios and double-click on Actuals member so that Actuals appears after Header > Name, then expand Dimension > Versions and double-click on Final member so that Final appears after Header > Name Data Load Setting dialog box should look as follows:

Click OK button. 11. Select View and make sure Data load fields is checked. This is a toggle, with either Data load fields or Dimension build fields checked (or use Data load fields shortcut button). 12. Select Field > Properties and the Field Properties dialog box displays for Field number:1. 13. Select the Data Load Properties tab and double-click on Dimension > Year so that Year appears after Data load > Field definition.

Hyperion Planning Implementation Boot Camp

55

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Field Properties dialog box should look as follows:

14.

Click Next >> button and proceed to map fields to dimensions: Field2 Total Dealers Field3 Entity Field4 Products Field5 Account Field6 M1 (expand Period > YearTotal > Q1) Field6 M1 Field7 M2 Field8 M3 Field9 M4 Field10 M5 Field11 M6 Field12 M7 Field13 M8 Field14 M9 Field15 M10 Field16 M11 Field17 M12

56

Enablement 2.0

Hyperion Planning Implementation Boot Camp 15.

Essbase Modeling

What do we do with Field18? Select checkbox to Ignore field during load

Click OK button. In Data Prep Editor pane all columns should now show corresponding Dimension or Member name, or in case of Field18, the values (No Time in row 1) should be grayed out 17. Are any changes needed to map data to outline members? 18. Select Feild1 and then select Field > Properties. On the Global Properties tab, enter Replace 20 and With FY as shown below:
16.

Hyperion Planning Implementation Boot Camp

57

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Click OK button. In Data Prep Editor pane all values under Field1/Year should now appear as FY04. 20. Change Field Properties for Field3/Entity to include prefix of CC and click OK button.
19.

58

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

21.

Select Options > Validate (or Validate shortcut button) The Validate Rules File confirmation box should be displayed.

Click OK button.
22.

Select File > Save As and save in Essbase Server, Look in: AutoPlan as File name: LoadAct

Hyperion Planning Implementation Boot Camp

59

2 Essbase Modeling
23.

Hyperion Planning Implementation Boot Camp

Right-click on AutoPlan, select Load data and the Data Load dialog box displays. 24. Click on Find Data File button and select File System tab and select C:\BootCamp\Load\LoadACT.txt file and click OK button. 25. Click on Find Rules File button and select Essbase Server tab and select LoadAct.rul file and click OK button. Data Load dialog box should look as shown below:

26.

Click the OK button to initiate the data load. Data Load Results dialog box should be displayed indicating Status of Success:

60

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Click Close button. On your own, create a new data load rule for AutoDemo:Auto using C:\BootCamp\Load\datafield.txt file. What is different? What do we do? 28. Keep Essbase Administration Services Console open for following exercise.
27.

Hyperion Planning Implementation Boot Camp

61

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.7 Essbase Dense/Sparse Settings and Database Properties: Dimensions, Statistics and Storage
In this exercise you will review Dense/Sparse settings of the AutoDemo:Auto database, calculate the block size and review Database Properties.

Review Essbase Outline Properties 1.

2. 3. 4.

5. 6.

7.

8.

From the Essbase Administration Services Console Navigation Pane, select AutoDemo:Auto Outline (under Auto), right-click and select Edit, the Outline Editor pane displays. Select Properties tab and scroll down to bottom to review Dimension Storage Types Select Outline tab and expand the dense dimensions by selecting dimension name and then Outline > Expand to descendants. Count the stored members for each dense dimension remembering to ignore Shared Members and Dynamic Calc Members and Implied Shared Members. Calculate the Block Size (Dense Dimension1 stored members x Dense Dimension2 stored members x x 8 bytes/member). From the Essbase Administration Services Console Navigation Pane, select AutoDemo:Auto Database, right-click and select Edit > Properties, the Database Properties pane displays. Select Dimensions tab and review Type, Members and Member Stored columns. Notice that no members are stored for Attribute Dimensions. Do values of Members Stored for Dense dimensions match your calculations from step 4? Select Statistics tab, does Block Size match your calculations from step 5?
Average clustering ratio of 1.0 indicates no fragmentation. If you experience fragmentation that degrades performance, consider a database restructure or alternatively, Export Lev0 data, Clear database, Load Export file and Calculate.

Select Storage tab and review information. When is RLE or ZLIB compression appropriate? 10. Based on understanding of Dense and Sparse, how should data load files be formatted to optimize performance?
9.

62

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Exercise 2.8 CALC DIM command and review of block creation and Database Statistics
In this exercise you will create a Rollup Calc script using CALC DIM command and iteratively add additional dimensions to gain better understanding of how CALC DIM command works and when blocks are created.
Start by Clearing data 1.

From the Essbase Administration Services Console Navigation Pane, select AutoDemo:Auto database, right-click and select Clear > All data. The Confirm Database Clear dialog box displays. Clink Yes button. Database Clear dialog box will then be displayed. Click OK button. 2. Right-click on Auto database and select Create > Calculation script, the Calculation Script Editor pane displays. 3. On bottom left-hand side of Calculation Script Editor pane, make sure Insert Arguments is checked and with Categorical tab selected, expand Functional and scroll down and double-click on SET UPDATECALC

Hyperion Planning Implementation Boot Camp

63

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Edit command to be SET UPDATECALC OFF; and press Enter to go to 2nd line. Review Essbase Technical Reference to understand details for this command. nd rd 4. Add 2 command SET MSG DETAIL; and press Enter to go to 3 line. Review Essbase Technical Reference to understand details for this command. rd 5. Add 3 command CALC DIM(dimlist); with dimlist highlighted, right-click on Measures and select Insert member name.

64

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

6.

From menu bar select Syntax > Check syntax (or use Check syntax shortcut button). The Calculation Script Editor confirmation box should be displayed:

If there are any errors, they should be displayed in the Messages pane. From menu bar select File > Save as, and save in Essbase Server, Look in: Auto as File name: Rollup and click OK button. 8. Before we go to Excel, delete the Application log file. Right-click on AutoDemo Application and select Delete > Log.
7.

Hyperion Planning Implementation Boot Camp

65

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

A confirmation dialog box displays:

Click OK button. Open new Excel workbook, from Hyperion ribbon 1st confirm that for Options on Ad Hoc tab that the checkbox Suppress Rows No Data/#Missing is not checked. Select Data Source Manager, Connect to Provider Services, navigate to AutoDemo:Auto database, right-click and select Ad-Hoc Analysis. 10. Configure the following grid, enter data values shown below and Click on Submit Data button.
9.

11.

On the Add-Ins ribbon, select Hyperion > Calculation options > Calculate. The Calculation Scripts dialog box displays:

66

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

12.

Select Calculation Script Rollup and Cube Auto and click the Launch button. Calculation Script confirmation dialog box should be displayed:

Hyperion Planning Implementation Boot Camp

67

2 Essbase Modeling
Click OK button.
13.

Hyperion Planning Implementation Boot Camp

From Hyperion ribbon, click on Refresh button. New values for Fleet Sales and Auto Sales are displayed.

How many blocks exist in the database? From Essbase Administration Services Console, right-click on AutoDemo Application and select View > Log. 15. Modify Rollup.csc adding Time to CALC DIM command CALC DIM ("Measures","Time"); Save revised Calc Script, right-click on Auto database and select Execute Calculation .
14.

The Execute Database Calculation dialog box is displayed:

68

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Select Rollup and click OK button.


16.

In Excel, click on Refresh button. New values for Q1 and Calendar Year are displayed.

17.

How many blocks exist in the database? From Essbase Administration Services Console, right-click on AutoDemo Application and select View > Log.

Hyperion Planning Implementation Boot Camp

69

2 Essbase Modeling
18.

Hyperion Planning Implementation Boot Camp

19.

20.

21. 22.

23.

24.

Modify Rollup.csc adding Total Dealers to CALC DIM command. Save revised Calc Script, and execute calculation. How many blocks exist in the database? View the Outline and the Total Dealers hierarchy to help determine the correct answer. Remember to consider Shared Members. Then view log file to confirm results. Modify Rollup.csc adding Products to CALC DIM command. Save revised Calc Script, and execute calculation. How many blocks exist in the database? View the Outline and the Products hierarchy to help determine the correct answer. Then view log file to confirm results. Modify Rollup.csc adding remaining Scenario and Department dimensions and save revised Calc Script. This will be used later in subsequent exercises. Clear All data from AutoDemo:Auto database (see step 1 for details). Load data from C:\BootCamp\Calcs\explev0.txt file and calculate database using (default) calculation (see steps 6-10 in Exercise 2.2 for details). In Excel, start with query for Measures and Time and Sparse dimensions 2004 Actual, AW 001, CC6350 and 155-100010. Change Options on Ad-Hoc tab to Zoom-In All Levels and Zoom In on Measures and Time. Notice that 12 of 18 Stored Time members have data and 19 of 55 Stored Measures members have data. The block density based on this one block would be 12/18 * 19/55 or 23%. Check AutoDemo:Auto Database Statistics and see that it shows average Block Density of 25.46%. This is actually a reasonable value for many applications. Reset Options back to Zoom-In Next Level

70

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Exercise 2.9 Review Blocks, Index, Dense/Sparse, Compression and Fragmentation concepts
In this exercise you will review a series of worksheets to reinforce the concepts discussed earlier regarding Essbase Architecture, with specific related to the AutoDemo:Auto database.

Open Excel Architecture workbook

Open C:\BootCamp\Calcs\123Arch.xls. 2. Review and discuss the initial 5 worksheets: - Our Block View - Our Index View - Basic Consolidation D-S Stats - Compression - Fragmentation 3. Prepare for next exercise by leaving 123Arch.xls open and from the Essbase Administration Services Console Navigation Pane, select AutoDemo:Auto database, right-click and select Clear > All data. The Confirm Database Clear dialog box displays. Clink Yes button. Database Clear dialog box will then display. Click OK button.
1.

Hyperion Planning Implementation Boot Camp

71

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.10 Member Calculations and Member Set Functions


In this exercise you will be introduced to Member Calculations and Member Set Functions

Open Excel Architecture workbook

Open C:\BootCamp\Calcs\123Arch.xls and select Member Calc worksheet. 2. Right-click on Member Calc worksheet name, select Move or Copy and select Before sheet: Member Calc and make sure to select Create a copy checkbox as shown below.
1.

3.

Select Data Source Manager and connect to AutoDemo:Auto database using right-click and selecting Ad-hoc Analysis. A Smart View dialog box displays:

Select No button so that the contents of the sheet are NOT cleared.

72

Enablement 2.0

Hyperion Planning Implementation Boot Camp 4. 5.

Essbase Modeling

6.

7.

8. 9. 10.

11.

Copy the data values from original Member Calc worksheet to the Member Calc (2) worksheet and Click on Submit Data button. From Administration Services Console Navigation Pane, right-click on Auto database and select Create > Calculation script, the Calculation Script Editor pane displays. On bottom left-hand side of Calculation Script Editor pane, make sure Insert Arguments is checked and with Alphabetical tab selected, expand Functional and scroll down and double-click on SET UPDATECALC. Change to SET UDATECALC OFF; On top left-hand hand side of Calculation Script Editor pane, make sure Use Aliases is checked, expand Measures and Net Sales and right-click on Total Cost of Sales (Alias: COS) and select Insert member name. Validate/Check syntax and File > Save As MembCalc.csc in Essbase Server. Execute MembCalc.csc In Smart View click on Refresh to see results of calculation. Why are there no results for Total Cost of Goods Sold? Revise MembCalc.csc adding the children of Total Cost of Goods Sold: "Incentives & Rebates"; "Marketing"; "COS"; Save and execute revised MembCalc.csc do Smart View Refresh.
You could also use Member Set function @ICHILDREN(COS); For more than one level use @IDESCENDANTS. Member Calcs provide finer level of detail than available with CALC DIM;

Hyperion Planning Implementation Boot Camp

73

2 Essbase Modeling

Hyperion Planning Implementation Boot Camp

Exercise 2.11 Correct Percent, Rate and Variance Calculations


In this exercise you will fix issues related to incorrect Percent, Rate and Variance calculations resulting from default consolidation of results.

Reload Data

Load data from C:\BootCamp\Calcs\explev0.txt file and calculate database using (default) calculation (see steps 6-10 in Exercise 2.2 for details). 2. Open C:\BootCamp\Calcs\123Arch.xls, select Rates and consolidations worksheet and connect to AutoDemo:Auto database using right-click and selecting Ad-hoc Analysis. Is anything wrong with the calculations? 3. Select AW 001 and Zoom Out, select Auto World and Zoom In. Is there anything else that is wrong with the calculations?
1. 1 lets fix Rebate % of Sales calculation 4.
st

5. 6.

7.

8.

9.

10.

What should the calculation for Rebate % of Sales be? Is it obvious or do we need to ask the client? Think about this carefully from a business perspective. From Administration Services Console Navigation Pane, right-click on Outline under Auto:Demo:Auto database and select Edit. In Outline Editor, expand Measures, Metrics and Sales Metrics. Right-click on Rebates % of Sales and select Edit member properties. In Member Properties dialog box, select Formula tab and enter formula - "Rebates" % "Auto Sales"; Click Verify button, click OK button for Member Formula success dialog box , click OK button for Member Properties dialog box and Save button in Outline Editor. Recalculate database using (default) calculation and in Smart View click Refresh. Did the results for Rebate % of Sales change? Why not? Recalculate database using Rollup.csc calculation (note: SET UPDATECALC OFF; turns Intelligent Calculation off) and in Smart View click Refresh. Are results now correct? Why not? In Outline Editor, right-click on Rebates % of Sales and select Edit member properties. In Member Properties dialog box, select Information tab and change Two-Pass calculation: from false to true, click OK button for Member Properties dialog box and Save button in Outline Editor.

74

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Restructure Database Options dialog box is displayed:

11. 12.

13.

14.

Select All data (default) and click OK button. Recalculate database using Rollup.csc calculation and in Smart View click Refresh. Are results now correct? Why not? Revise Rollup.csc adding CALC TWOPASS; and This explicitly forces Two-Pass calculations. Recalculate database using Rollup.csc calculation and in Smart View click Refresh. Are results now correct? Note that CALC ALL; automatically forces any Two-pass calculations. Are there other options to make correct calculation? In Outline Editor, right-click on Rebates % of Sales and select Edit member properties. In Member Properties dialog box, select Information tab and change Two-Pass calculation: from true to false, change DataStorage from Store Data to Dynamic Calc, click OK button for Member Properties dialog box and Save button in Outline Editor. For Restructure Database Options dialog box, select All data (default) and click OK button. Revise Rollup.csc by commenting out CALC TWOPASS /* CALC TWOPASS; */. Save and recalculate database using Rollup.csc calculation and in Smart View click Refresh. Are results correct? Dynamic Calc using a different calculation order that often resolves percent and rate calculation issues. In some cases you may also need Dynamic Calc and Two-Pass calculation.

Now lets fix the Price roll-up issues 15.

Any ideas? Dynamic Calc wont work, because then the Lev0 Price input data is lost. Two-Pass wont work because ???? Seems to work! 16. The solution is something called a Back Calc, recalculating after the Main Rollup. 17. Revise Rollup.csc by adding: (Fleet Price = Fleet Sales / Fleet Unit Sales; Dealer Price = Dealer Sales / Dealer Unit Sales;) Note: the set of parentheses are necessary to force a 2nd pass for the

Hyperion Planning Implementation Boot Camp

75

2 Essbase Modeling
Finally lets fix 2004 Actual vs 2004 Budget 18. 19.

Hyperion Planning Implementation Boot Camp

Back Calc. Save and recalculate database using Rollup.csc calculation and in Smart View click Refresh. Are results correct?

20.

21.

22.

Select the Dynamic Retrieve worksheet and click Refresh. Is anything wrong? In Outline Editor, expand Scenario and ScenarioCalculations, rightclick on 2004 Actual vs 2004 Budget and select Edit member properties. In Member Properties dialog box, select Information tab and change DataStorage from Store Data to Dynamic Calc, click OK button for Member Properties dialog box and Save button in Outline Editor. For Restructure Database Options dialog box, select All data (default) and click OK button. When changing member(s) to Dynamic Calc there is no need to recalculate the database. Select the Dynamic Retrieve worksheet and click Refresh. Is the data still wrong? Think about the calculation order. In Outline Editor, right-click on 2004 Actual vs 2004 Budget and select Edit member properties. In Member Properties dialog box, select Information tab and change Two-Pass calculation: from false to true, click OK button for Member Properties dialog box and Save button in Outline Editor. For Restructure Database Options dialog box, select All data (default) and click OK button. Select the Dynamic Retrieve worksheet and click Refresh. Is the data correct? Select Dynamic Variance worksheet to confirm numbers are correct. Anything else that needs to be fixed? Are higher Rebates good?

Expense Reporting

In Outline Editor, expand Measures, Net Sales, Total Costs of Sales and Incentives and Rebates, right-click on Rebates and select Edit member properties. In Member Properties dialog box, select Information tab and change Variance reporting expense: from false to true, click OK button for Member Properties dialog box. Repeat for Rebates % of Sales and click Save button in Outline Editor. For Restructure Database Options dialog box, select All data (default) and click OK button. 24. Select the Dynamic Retrieve worksheet and click Refresh. 25. From Data Source Manager, disconnect from Data Source Connection and Common Provide Connection (see end of Exercise 2.5 for details).
23.

76

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Essbase Modeling

Exercise 2.12 Dynamic Calculations


In this exercise you will learn how to set Dynamic Calc Members and understand their impact on database block size.

Change Time consolidations to Dynamic Calc 1.

In Outline Editor, expand Time and Calendar Year, select Q1, then Q2, Q3 and Q4 using Ctrl+click, right-click and select Edit member properties. In Member Properties dialog box, select Information tab and change DataStorage from Store Data to Dynamic Calc, click OK button for Member Properties dialog box. Repeat for Calendar Year and click Save button in Outline Editor. For Restructure Database Options dialog box, select All data (default) and click OK button. 2. From the Essbase Administration Services Console Navigation Pane, select AutoDemo:Auto Database, right-click and select Edit > Properties, the Database Properties pane displays. 3. Select Dimensions tab and notice that Members Stored decreased from 18 to 13. Select Statistics tab, notice that Block Size has decreased by almost 30%. Select the Dynamic Retrieve worksheet and click Refresh. Notice that query response time hasnt noticeably changed.

Hyperion Planning Implementation Boot Camp

77

3
Classic Planning Application Creation

Section Objectives
At the end of this section, you will be able to: Create new Planning Database, Application and Data Source Model Dimensions and Members in new Planning Application Use Outline Load Utility to load Metadata to Planning Application

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Exercise 3.1 Create Hyperion Planning Relational Database Repository, Create Planning Application and Data Source
In this exercise you will create the Hyperion Planning Relational Database Repository which stores Planning metadata and security and then a Data Source. Each Planning application must be associated with a Data Source, which links the relational database and the Essbase server.
Start Services 1.

For the exercises in this section, start following services (see Appendix A.1 for specific instructions on starting the necessary services)

OracleOraDb11g_home1TNSListener OracleServiceORCL

Hyperion Foundation OpenLDAP Hyperion Foundation Shared Services Hyperion Apache 2.0 Hyperion Workspace - Web Application Hyperion Workspace - Agent Service

Hyperion RMI Registry Hyperion Planning - Web Application

Hyperion Essbase Services 11.1.1 - hypservice_1 Hyperion Administration Services - Web Application Hyperion Provider Services - Web Application

Hyperion Planning Implementation Boot Camp

79

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

At end of Day, Stop Services in reverse order before Shut Down of virtual image to help avoid Shared Services corruption issues.

Start at Demo Drive Homepage 2.

Double-click on the Demo Drive Homepage shortcut found on the Demo Drive desktop (see below)

Create Tablespace 3.

On the left-hand side of page, expand Oracle Database DemoUtilities and click on Create Tablespace to display C:\Home\CreateTablespace.html page on right as shown below.

4.

Click on Create Tablespace link at the bottom of page on the right to open C:\DemoUtilities\3PS\Database\Oracle\create_tablespace\Admin folder

80

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Double-click on RunCreateTablespace.exe Create Tablespace Utility dialog box displays:

5.

Enter Tablespace Name - AutoPlan and click OK button. OK Pressed dialog box displays:

Hyperion Planning Implementation Boot Camp

81

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Click OK button and wait several seconds. Process finished dialog box displays:

Click OK button and leave Create Tablespace Utility dialog box open.
6.

Return to C:\Home\CreateTablespace.html page and click on Logs link on the right to open C:\DemoUtilities\3PS\Database\Oracle\create_tablespace\Logs folder

Double-click on log.txt to open file in Notepad.


7.

Scroll down to end of file and confirm that Tablespace created successfully.

82

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Close the log.txt file and C:\DemoUtilities\3PS\Database\Oracle\create_tablespace\Logs folder 9. Create EPMa tablespace repeating steps 4-7 using EMPaPlan instead of AutoPlan. 10. Click on Quit button to close Create Tablespace Utility dialog box.
8.

Quit Pressed dialog box displays:

Click OK button 11. Close the C:\DemoUtilities\3PS\Database\Oracle\create_tablespace\Admin folder


Create User 12.

Back on Homepage, on the left-hand side of page, expand Oracle Database DemoUtilities and click on Create User to display C:\Home\CreateUser.html page on right as shown below.

Hyperion Planning Implementation Boot Camp

83

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

13.

Click on Create User link at the bottom of page on the right to open C:\DemoUtilities\3PS\Database\Oracle\create_user\Admin folder

14.

Double-click on RunCreateUser.exe Create Tablespace Utility dialog box displays:

84

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

15.

Enter Oracle user AutoUser and User password Demov52. Leave default entries USERS and TEMP unchanged and click OK button. OK Pressed dialog box displays:

Click OK button and wait several seconds. Process finished dialog box displays:

16.

Return to C:\Home\CreateUser.html page and click on Logs link on the right to open C:\DemoUtilities\3PS\Database\Oracle\create_user\Logs folder

Hyperion Planning Implementation Boot Camp

85

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Double-click on log.txt to open file in Notepad.


17.

Scroll down to end of file and confirm that Grant succeeded..and Commit complete messages displayed. Do not be concerned about error - ORA-30041: Cannot grant quota on the tablespace

18.

Close the log.txt file and C:\DemoUtilities\3PS\Database\Oracle\create_user\Logs folder

86

Enablement 2.0

Hyperion Planning Implementation Boot Camp 19.

Classic Planning Application Creation

Click on Quit button to close Create User Utility dialog box. Quit Pressed dialog box displays:

Click OK button 20. Close the C:\DemoUtilities\3PS\Database\Oracle\create_user\Admin folder


Create Data Source 21.

On the left-hand side of Home page, collapse Oracle Database Utilities and click on Home

22.

On right, select Oracle EPM Workspace link under Workspace

Hyperion Planning Implementation Boot Camp

87

3 Classic Planning Application Creation


Notes:

Hyperion Planning Implementation Boot Camp

- you can also access Oracle EPM Workspace directly from Internet Explorer Favorites st - 1 time you access Workspace, you should see message Pop-up blocked. To see this pop-up or additional options click here . Select Always Allow Pop-ups from This Site or Setting > Turn Off Pop-up Blocker

http://demodrive:19000/workspace/index.jsp page displays:

Enter User Name: demoadmin and Password: Demov52


23.

Click on Navigate menu (in upper left-hand corner), select Administer > (scroll down) Classic Application Administration > Planning Administration

88

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Classic Application Wizard page displays:

Click Manage Data Source button. New page displays:

Hyperion Planning Implementation Boot Camp

89

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Collapse pane on left and click Create Data Source button. 24. Data Source definition page displays:

Enter values as shown above: Data Source Name *: AutoPlan Select Database Platform Oracle Application Database Server *: demodrive Port *: 1521
90

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Database *: ORCL User *: AutoUser Password *: Demov52 Essbase Server Server *: demodrive User *: demoadmin Password *: Demov52 25. Click Validate Database Connection button on bottom left. Message at top should be displayed: The database connection was successful. Click the after message to clear message. Click Validate Essbase Connection button on bottom right. Message at top should be displayed: The Essbase connection was successful. Click the after message to clear message. Click Finish button in bottom right-hand corner. The previous page with message at top should be displayed: Data source AutoPlan was created successfully Click the after message to clear message.
Create Application 26.

From Classic Application Wizard page, following successful creation of the AutoPlan Data Source, click the Create Application button in the bottom right-hand corner.

Hyperion Planning Implementation Boot Camp

91

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

27.

Page displays with 5 tabs starting with Select tab;

92

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Enter values as shown above: Data Source AutoPlan Application AutoPlan Shared Services Project Planning Instance PLN Sample Application unchecked Click the Next button. 28. Page displays with Calendar tab:

Hyperion Planning Implementation Boot Camp

93

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Enter values as shown above: Base Time Period 12 Months Fiscal Start Year 2004 Fiscal Start Month January Weekly Distribution 4-4-5 Distribution Total Years 3 Click the Next button. 29. Page displays with Currencies tab: Under Will your application support multiple currencies? Select No Click the Next button. 30. Page displays with Plan Types tab:

94

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Enter values as shown above: Plan Type 1 AutoFin Plan Type 2 AutoHR Plan Type 3 unchecked and Name deleted Click the Next button.
31.

Page displays with Finish tab displaying summary of selected settings:

Hyperion Planning Implementation Boot Camp

95

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Click the Finish button.


Be patient! This process will require ~ 1 minute.

Congratulations page displays:

96

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Click on 1st link to refresh workspace Navigate->Applications menu


32.

At this point the Planning tables will be created in the Planning Relational Database Repository. To view tables, click Start > All Programs > Oracle Client > SQL Developer.

Hyperion Planning Implementation Boot Camp

97

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Right-click on Connections and select New Connection


33.

The New / Select Database Connection dialog box displays:

98

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Enter: Connection Name AutoPlan User AutoUser Password Demov52 Change SID from xe to ORCL Click Save button and then Connect button 34. On left-hand pane, expand AutoPlan and Tables. Select HSP_CALENDAR table and on right-hand pane select the Data tab.

Hyperion Planning Implementation Boot Camp

99

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

You will see information entered during the Create Application process such as FIRST_YEAR - 2004 and NUM_YEARS 3 Close SQL Developer.
Register Application 35.

Click on Navigate > AutoPlan


st

> Applications > (scroll down) Planning

The 1 time it will take a number of seconds for applications to appear after you select Applications.

100

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

The AutoPlan page displays. 36. From menu bar on AutoPlan page, select Administration > Register Application G Register Application page displays:

Hyperion Planning Implementation Boot Camp

101

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Select AutoPlan and click Register Application button. Register Application pop-up window displays:

102

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

For Select Shared Services Project: select Planning and click OK button. Back on Register Application page message at top should be displayed: Applications successfully registered. Click the after message to clear message. Click Finish button in bottom right-hand corner.
Create Database 37.

Click on Navigate > Applications > (scroll down) Planning > AutoPlan. From menu bar on AutoPlan page, select Administration > Manage Database B Manage Database page displays:

Select Database checkbox and click Create button. WARNING message displays:

Hyperion Planning Implementation Boot Camp

103

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Click Create button. Cube Refresh/Create in Progress displays:

When Create Complete message displayed, click Finish button.


38.

At this point the Essbase databases related to AutoPlan application have been created. Open Essbase Administration Services Console and View AutoPlan:AutoFin Outline to see Dimensions and Members.

104

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Close Outline Viewer.

Hyperion Planning Implementation Boot Camp

105

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Exercise 3.2 Model Planning Application Dimensions


In this exercise you will learn how to change member names and aliases, add members to existing dimensions, add Account members and understand Account Types, add Custom Dimensions and add Attribute Dimension.
Update Period names and aliases

From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Period. Note: Begbalance is primarily used for Balance Sheet accounts. Expand YearTotal and Q1, select Jan and click Edit button. Change Name: to M1 and Alias: to Jan and click Save button. An error message displays - An object with the name Jan already exists. In order to change Alias to an existing Name, you need to Edit and Save the member twice. Close the error message and with just Name: of M1 click Save button. Now for M1, click Edit button. Add Alias: Jan and click Save button. 2. Repeat step 1 for remaining months M2/Feb through M12/Dec
1.

3.

From menu bar on AutoPlan page, select Administration > Alias Tables A. On Alias Tables page click Add button. Explorer User Prompt dialog box displays:

106

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

4. 5.

6.

7.

Enter name for new Alias Table French Repeat step 3 for M2/Fevrier and M3/Mars. From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Period. Expand YearTotal and Q1, select M1 and click Edit button. Change value for Aliases drop down list from Default to French and enter Alias: of Janvier and click Save button. From menu bar on AutoPlan page, select Administration > Manage Database B. On Manage Database page, Select Database checkbox and click Refresh button. When Refresh Complete message displayed, click Finish button. Open Essbase Administration Services Console and Edit AutoPlan:AutoFin Outline to confirm changes to Period member Names and Aliases. To change Alias table, go to Properties tab, under Alias tables right-click on French and select Set as Active. Return to Outline tab and confirm French aliases for M1, M2 and M3. Return to Properties tab and reset Default as the Active alias table. Close Outline Editor. From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Scenario. Select Current and click Edit button. Change to Name: Actuals, Start Yr.: FY06, Alias: Act, unselect checkbox next to Enabled for Process Management and click Save button. Click Add Sibling button and enter following values: Scenario: Budget Start Yr.: FY06 Start Period: M1 End Yr.: FY06 End Period: M12 Alias: Bud Enabled for Process Management: checked Click Save button.

Add Scenario members 8.

Hyperion Planning Implementation Boot Camp

107

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Click Add Sibling button and enter following values: Scenario: Forecast Start Yr.: FY06 Start Period: M1 End Yr.: FY06 End Period: M12 Alias: Fcst Enabled for Process Management: checked Click Save button. Click Add Sibling button and enter following values: Scenario: Act vs Bud Start Yr.: FY06 Start Period: M1 End Yr.: FY06 End Period: M12 Data Storage: Dynamic Calc Enabled for Process Management: unchecked Click on Member Formula tab and Enter Member Formula: @VAR(Actuals,Budget); Click Save button.
Validate Member Formula does not provide accurate validation.

Click Add Sibling button and enter following values: Scenario: Act vs Fcst Start Yr.: FY06 Start Period: M1 End Yr.: FY06 End Period: M12 Data Storage: Dynamic Calc Enabled for Process Management: unchecked Click on Member Formula tab and Enter Member Formula: @VAR(Actuals,Forecast); Click Save button.

108

Enablement 2.0

Hyperion Planning Implementation Boot Camp Add Version members 9.

Classic Planning Application Creation

From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Version. Select BU Version_1 and click Edit button. Change Name: to Current and Alias: to Working and click Save button. Click Add Sibling button and enter Version: Final and click Save button. Click Add Sibling button and enter Version: R1, Alias: Round1 and click Save button. Click Add Sibling button and enter Version: R2, Alias: Round2 and click Save button. Click Add Sibling button and enter Version: R3, Alias: Round3 and click Save button. Click Add Sibling button and enter Version: WhatIf1 and click Save button. Click Add Sibling button and enter Version: WhatIf2 and click Save button.

Add Account members 10.

From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Account. Create the Account hierarchy based on worksheet below from C:\BootCamp\Model\123Model.xls (you may want to open worksheet in order to cut and paste Account member names). Use Multiplication for both price members after Plan Types: for both AutoFin and AutoHR For appropriate higher level Account members (e.g. Total Cost of Sales, Allocated Costs, Operating Expenses and Taxes) change Account Type: to Expense (Variance Reporting: will also change to Expense) and use Subtraction after Plan Types: for both AutoFin and AutoHR.
When you add descendants of these members, they will default to Expense.

Leave default of Source Plan Type: AutoFin

Hyperion Planning Implementation Boot Camp

109

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

11.

Also add Metric accounts: Select Net Sales, click Add Sibling button and enter: Name: Metrics Plan Types: Ignore (for both AutoFin and AutoHR) Click Save button. Click Add Child button and enter: Name: Headcount Account Type: Saved Assumption

110

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Plan Types: Ignore (for both AutoFin and AutoHR) Click Save button. Click Add Sibling button and enter: Name: Average Inventory Account Type: Asset Plan Types: Ignore (for both AutoFin and AutoHR) Click Save button. Click Add Sibling button and enter: Name: Rebate % Sales Account Type: Expense (Variance Reporting: will also change to Expense) Plan Types: Ignore (for both AutoFin and AutoHR) Select the Member Formula tab and Enter member Formula: "Rebates" % "Auto Sales"; Click Save button. From menu bar on AutoPlan page, select Administration > Manage Database B. On Manage Database page, Select Database checkbox and click Refresh button. When Refresh Complete message displayed, click Finish button. 13. Open Essbase Administration Services Console and View AutoPlan:AutoFin Outline to confirm Account hierarchy Member Names, Consolidations and Expense Reporting properties. Close Outline Editor. 14. Right-click on AutoPlan:AutoFin and select Set > Default calculation , add SET UPDATECALC OFF;
12.

Hyperion Planning Implementation Boot Camp

111

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Click OK button. 15. Open C:\BootCamp\Model\123Model.xls and Copy the LOAD worksheet to worksheet Before sheet: LOAD (remember to select Create a copy checkbox). 16. Select Data Source Manager and connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. A Smart View dialog box displays:

Select No button so that the contents of the sheet are NOT cleared. Copy the data values from original LOAD worksheet to the LOAD (2) worksheet and click on Submit Data button. 18. Right-click on cell and select Hyperion > Calculation Options > Calculate, select the Default Calculation Script for AutoFin Cube and click Launch button.
17.

112

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Calculation Script has been processed dialog box displays. Click OK button and click Close button to close Calculation Scripts dialog box. 19. Select Validate worksheet and connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. Select No button so that the contents of the sheet are NOT cleared. Confirm that value for Net Sales in cell B45 is 130,000,000. If there are differences, compare with MeasuresModel worksheet to identify differences, make corrections to Account members, Refresh Database and revalidate. 20. Copy the ScenVariance worksheet to worksheet Before sheet: ScenVariance (remember to select Create a copy checkbox). 21. Select Data Source Manager and connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. Select No button so that the contents of the sheet are NOT cleared.

Hyperion Planning Implementation Boot Camp

113

3 Classic Planning Application Creation


22.

Hyperion Planning Implementation Boot Camp

23. 24. 25.

26. 27.

28.

29.

30.

31.

32.

33. Create Custom Dimensions 34.

Copy the Actuals and Budget values from original ScenVariance worksheet to the ScenVariance (2) worksheet and click on Submit button. Data Click Refresh button, both variances should be 100 indicating that Expense Reporting for Rebates and @VAR formula is set correctly. Copy the TimeBalanceInput worksheet to worksheet Before sheet: TimeBalanceInput (remember to select Create a copy checkbox). Connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. Select No button so that the contents of the sheet are NOT cleared. Copy the data values from original TimeBalanceInput worksheet to the TimeBalanceInput (2) worksheet and click on Submit Data button. Right-click on cell and select Hyperion > Calculation Options > Calculate, select the Default Calculation Script for AutoFin Cube and click Launch button. Select TimeBalanceBefore worksheet, connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. Select No button so that the contents of the sheet are NOT cleared. Data should roll up across time in standard manner. From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab and from Dimensions drop down list select Account. Select Headcount, click Edit button, set Time Balance: Balance and Skip: Missing and click Save button. Select Average Inventory, click Edit button, set Account Type: Asset, Time Balance: Average (default for Asset accounts is Balance) and Skip: Missing and click Save button. From menu bar on AutoPlan page, select Administration > Manage Database B. On Manage Database page, Select Database checkbox and click Refresh button. When Refresh Complete message displayed, click Finish button. Select TimeBalanceAfter worksheet, connect to AutoPlan:AutoFin database using right-click and selecting Ad-hoc Analysis. Select No button so that the contents of the sheet are NOT cleared. Data should now reflect appropriate Time Balance calculations across time. Review TimeBalanceSkipMiss worksheet. From menu bar on AutoPlan page, select Administration > Dimensions D. On Dimensions tab click Add Dimension button. Add Dimension window displays:

114

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Enter Dimension: Total Dealers, check Apply Security: and click Save button. Confirmation dialog box displays:

Click OK button.
35.

With Total Dealers selected, click Custom Dimensions button. The Manage Attributes and Value window displays: Click Create button at top of left-hand pane to create new Attribute dimension related to Total Dealers.

Hyperion Planning Implementation Boot Camp

115

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Enter Name: US Regions, leave Data Type: Text (default), click Save button and then click on in upper right-hand corner to close Create Attribute dialog box. 36. Click Create button at top of right-hand pane to create new Attribute dimension Values.

116

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Classic Planning Application Creation

Enter Name: East US and click Save button. Also add Central US and West US and then click on in upper right-hand corner to close Create Attribute Value dialog box and click Close button to close the Manage Attributes and Value window. 37. On Dimensions tab click Add Child button and enter Name: AW 001.
Plan Types which were left checked (Valid) for AutoFin and AutoHR now have to be valid for every member of Total Dealers All or Nothing.

Click on Attribute Values tab.

Hyperion Planning Implementation Boot Camp

117

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

38.

39. 40.

41.

Select West US on left and click on Add button to assign Attribute Value to member. Click Save button. We will be adding members later using Outline Load Utility. On Dimensions tab click Add Dimension button and enter Dimension: Products, check Apply Security: and click Save button. We will be adding members later using Outline Load Utility. Click on the Performance Setting tab. The default settings appear to be reasonable for this application. From menu bar on AutoPlan page, select Administration > Manage Database B. On Manage Database page, Select Database checkbox and click Refresh button. When Refresh Complete message displayed, click Finish button. Open Essbase Administration Services Console and View AutoPlan:AutoFin Outline to confirm Custom Dimensions and Attribute Dimension. Right-click on AW 001 member, select View member properties and confirm Attribute Value assigned. View AutoPlan:AutoHR Outline and expand Accounts dimension. For Accounts, AutoFin was set as Source Plan Type. @XREF formulas then bring values from the AutoFin cube to the AutoHR cube.

Plan Types 42.

118

Enablement 2.0

Hyperion Planning Implementation Boot Camp Load Data 43.

Classic Planning Application Creation

Right-click on AutoFin, select Load data and the Data Load dialog box displays. Click on Find Data File button, select File System tab, select C:\BootCamp\Load\LoadACT.txt file and click OK button. Click on Find Rules File button and select Essbase Server tab. Look in: demodrive:AutoDemo:AutoPlan, select LoadAct.rul file and click OK button. Data Load dialog box should look as shown below:

Click the OK button to initiate the data load. Data Load Results dialog box should be displayed indicating Status of Success: Click Close button. 44. Right-click on AutoFin database, select Execute Calculation and select the (default) calculation.

Hyperion Planning Implementation Boot Camp

119

3 Classic Planning Application Creation

Hyperion Planning Implementation Boot Camp

Exercise 3.3 Outline Load Utility


In this exercise you will learn how to use the Outline Load Utility including setting up Password Encryption and to load dimension members to Planning Application.

Load members using utility 1.

2. 3. 4.

5.

6. 7.

8.

9.

Open C:\BootCamp\ODIDIM\OutlineLoadCommands.txt to use as reference for this exercise. You can Copy commands to the clipboard and within Command Prompt window do right-click and select Paste. Open Command Prompt Window by selecting shortcut. Paste cd orcl\hysl\products\planning\bin and press Enter. The PasswordEncryption utility creates a file that stores the password in encrypted form and is used to suppress password prompts for Planning utilities using the [- f:passwordFile] option as the first parameter in the command line. Paste PasswordEncryption \orcl\hysl\password.txt and press Enter. After prompt to Enter password to encrypt, enter Demov52. You should see message Password has been encrypted and written to the file successfully Paste 1st OutlineLoad command for Entity dimension and press Enter. This uses the /N parameter at end of command to perform a dry run by parsing the load file without loading data or metadata. To confirm that the load file parses without any errors, check the C:\BootCamp\OutlineLoadEntity.log file to be sure no error messages were generated. Then paste command again, backspace 3 spaces past /N and press Enter. Repeat step 5 using 2nd OutlineLoad command for Products dimension and C:\BootCamp\OutlineLoadProduct.log file Repeat step 5 using 3rd OutlineLoad command for Total Dealers dimension and C:\BootCamp\OutlineLoadDealer.log file. It appears there is an error. Hint what is correct format for Dimension Property Aggregation? See hp_admin.pdf. Make correction and redo. From menu bar on AutoPlan page, select Administration > Dimensions D. Review new members for Entity, Products and Total Dealers dimensions. Select Administration > Manage Database B and Refresh Database. [Optional - if the Account dimension in Exercise 3.2 is incomplete] Repeat step 5 using 4th OutlineLoad command for Account dimension and C:\BootCamp\OutlineLoadAccount.log file.

120

Enablement 2.0

4
Data Form Design

Section Objectives
At the end of this section, you will be able to: Design new data forms including Asymmetric and Composite forms Create new Business Rules with Run-time Prompts and link them to Data Forms Use additional Data Form Components including Adjust Data, Grid Spread, Account Annotations, Planning Unit Annotations, Cell Text, Cell Level Documents, Supporting Detail and Menus

4 Data Form Design


Exercise 4.1 Forms Designer

Hyperion Planning Implementation Boot Camp

In this exercise you will design basic forms provided by client and then learn how to design Asymmetric and Composite forms.

Create Data Forms

Start services (see Exercise 3.1 for details). 2. Client has provided us with two initial forms that they want to use for the new Planning application: 1) for entering Unit Sales and Prices and 2) for entering Operating Expenses.
1.

122

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Start Services (see Exercise 3.1) 4. Access Planning Web Client using Internet Explorer Favorite Oracle EPM Planning
3.

Hyperion Planning Implementation Boot Camp

123

4 Data Form Design

Hyperion Planning Implementation Boot Camp

5.

From menu bar on AutoPlan page, select Administration > Manage Data Forms F. Click on Create button above Data Form Folders
You may receive message This website is using a scripted window to ask you for information. If you trust this website, click here to allow scripted windows proceed by clicking on message and selecting Temporarily Allow Scripted Windows, then click again on Create button.

You will be prompted to enter new folder name.

Enter - BootCampForms

124

Enablement 2.0

Hyperion Planning Implementation Boot Camp 6.

Data Form Design

Click on Create button above Data Forms. Create window displays starting with Properties tab:

Enter Data Form name 1Unit Sales and Price, Enter Instructions and click on Next button.
Plan Type defaults to 1st Plan Type AutoFin. This determines the data form's valid Account and Entity members. Accounts included on data form with a source plan type other than the assigned data form plan type are read-only on that data form. You can NOT change the Plan Type for Data Form after it is assigned
7.

Create window displays on Row/Column Layout tab:

Hyperion Planning Implementation Boot Camp

125

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Under Column Dimension(s) select Period and click on Select Members button to the left. Member Selection Period window displays:

126

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Select checkbox next to YearTotal, select Level 0 Descendants from dropdown box and click on Add button. ILvl0Descendants(YearTotal) should be displayed under Selected Members. Click on Submit button. 8. Follow same steps as above for Row Dimension(s) selecting Account dimension and members: Fleet Unit Sales, Fleet Price, Dealer Unit Sales, Dealer Price and Auto Sales. Click on Next button. 9. Create window displays on Page/Point of View Layout tab:

Hyperion Planning Implementation Boot Camp

127

4 Data Form Design

Hyperion Planning Implementation Boot Camp

For Page Dimension(s) enter Dimension/Members: - Products: 155-1000-10, 155-1000-20 - Total Dealers: AW 001, AW 002
Dimensions not selected as Row, Column or Page dimensions will automatically be included as Point of View dimensions.

For Point of View Dimension(s) enter Dimension/Members: - Entity: CC6350 - Scenario: Budget -Version: Current -Year: FY06 Click on Preview tab. 10. The Preview should appear as follows:

128

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Click on Save button and Click OK button to return to the Data Form Management page. 11. In left-hand pane, under Folders, expand Forms, select BootCampForms and select 1-Unit Sales and Price data form and wait several seconds for the form to be rendered. 12. From menu bar, select View > Instructions I and click the Close button. 13. Enter sample data into the form as shown below.
As data is entered, cell background color changes from white (default) to yellow indicating dirty cells, whose values changed but are not yet saved. Cells in the Auto Sales row have background color of light blue indicating read-only cells.

Hyperion Planning Implementation Boot Camp

129

4 Data Form Design

Hyperion Planning Implementation Boot Camp

14.

Select cells Fleet Unit Sales > M1 thru Dealer Price > M3 and select Edit > Copy O (or Ctrl+C). Internet Explorer dialog box displays:

Click on Allow access button. Change product to 155-1000-20 and click the Go button. Select cell Fleet Unit Sales > M1 and select Edit > Paste P (note: Ctrl+V wont work). Again, the above Internet Explorer dialog box displays, click on Allow access button.

130

Enablement 2.0

Hyperion Planning Implementation Boot Camp 15.

Data Form Design

Select File > Save from the menu bar (or click on the Save shortcut button). 16. From menu bar, select Administration > Manage Data Forms F. Expand Forms folder, select BootCampForms folder and follow above steps to Create data form - 2-Operating Expenses. Column Dimension(s) enter Dimensions/Members: - Period: IChildren(Q1) Click on Dimension Properties button to right of Period and after Display: uncheck Member Name and check Member Alias - Scenario: Budget, Actuals Row Dimension(s) enter Dimensions/Members: - Account: IDescendants("Operating Expense") Page Dimension(s) enter Dimension/Members: - Products: 155-1000-10, 155-1000-20 - Total Dealers: AW 001, AW 002 -Year: FY05, FY06 Properties - Display: Alias Point of View Dimension(s) enter Dimension/Members: - Entity: CC6350 -Version: Current Properties - Display: Alias note: Preview does not show aliases Click on Save button. 17. In left-hand pane, under Folders, expand Forms, select BootCampForms and select 2-Operating Expenses data form. Change Year to FY05 and click Go button. You will see Actuals data that was loaded previously and notice that Budget columns are readonly. This ties back to initial Application set-up when we defined Start Yr.: FY06, Start Period: M1, End Yr.: FY06 and End Period: M12 for Budget.
Asymmetric Data Forms 18.

After reviewing the Operating Expenses form with client, they indicate that they would like a form that has Actual columns for FY05 Final Version by quarter and Budget columns for FY06 Current/Working Version by month. 19. From menu bar on AutoPlan page, select Administration > Manage Data Forms F. Expand Forms folder, select BootCampForms folder and follow above steps to Create data form 3-Asymmetric. Column Dimension(s) enter Dimensions/Members:

Hyperion Planning Implementation Boot Camp

131

4 Data Form Design

Hyperion Planning Implementation Boot Camp

- Scenario: Actuals -Version: Final click Add Dimension button -Year: FY05 click Add Dimension button - Period: Children(YearTotal) select checkboxes for Read-only: and Show separator: click Add Column button and enter Dimensions/Members: - Scenario: Budget - Version: Current - Year: FY06 - Period: ILvl0Descendants(YearTotal) Row Dimension(s) enter Dimensions/Members: - Account: IDescendants("Operating Expense") Page Dimension(s) enter Dimension/Members: - Products: 155-1000-10, 155-1000-20 - Total Dealers: AW 001, AW 002

Point of View Dimension(s) enter Dimension/Members: - Entity: CC6350 Click on Save button. 20. In left-hand pane, under Folders, expand Forms, select BootCampForms and select 3 - Asymmetric data form.
Composite Data Forms 21.

Client likes the new Asymmetric Form, but would like to see if they could have one form to enter both Sales Units and Prices as well as Operating Expenses. 22. From menu bar on AutoPlan page, select Administration > Manage Data Forms F. Expand Forms folder, select BootCampForms folder and click on Create Composite button to create data form - 4-Composite. Edit Composite Window displays: On Properties tab enter Data Form name Composite and click Next button.

132

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

23. 24.

25. 26.

On Row/Column Layout tab, select checkboxes for Combine POV and Combine Page. Where the two forms use same Point of View or Page definitions, these displays once and apply to both data forms. Select Unit Sales and Price and Asymmetric forms, click on Add button to move them under Selected Data Forms and click Save button. In left-hand pane, under Folders, expand Forms, select BootCampForms and select Composite data form. The client likes the new forms that have been created. However, they are concerned that Price values wont be correct for consolidated members. Calculate the AutoPlan:AutoFin database using (default) calc script. Select 1-Unit Sales and Price data form, change product to 1551000 and click the Go button.

Hyperion Planning Implementation Boot Camp

133

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Notice that prices are adding up across Lev0 Product members. This is the same issue we had before. How can we make it easy for Data Form users to get correct results?

134

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Exercise 4.2 Business Rules


In this exercise you will learn how to create a new Business Rule from Essbase Administration Services, add Run-time Prompts and link Business Rule to a Data Form.

Start a New Application 1.

In Essbase Administration Services, expand Business Rules and Repository View, right-click on Rules and select New Rule.

Rule Editor displays in right pane.

Hyperion Planning Implementation Boot Camp

135

4 Data Form Design

Hyperion Planning Implementation Boot Camp

From Associated Outline dropdown box, click on Select outline. The Select Database Outline dialog box displays:

Select AutoPlan:AutoFin database. 2. Before designing Rule, add Local Variables that will be used in the Rule. Click on the Variables tab, underneath click the Local Variables tab and click Add button.

136

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

A new dialog box will display:

Enter values for YearPrompt as shown above and click the Apply button. A Save As dialog box displays, click OK button, then click Close button.

Hyperion Planning Implementation Boot Camp

137

4 Data Form Design


3.

Hyperion Planning Implementation Boot Camp

Add Local Variable for Scenario with: Name ScenarioPrompt, Type Members, Dimension Scenario, Default Value Budget, Usage Type Run-time prompt, Prompt String Enter Scenario: and check checkbox next to Do not save value 4. Add Local Variables for VersionPrompt (Default Value Current) and EntityPrompt (Default Value CC6350). 5. Click on Graphical tab and with left pane set to BR Language tab, navigate under Graphical > Actions, select Aggregate Data icon and drag it next to Global Range on the right.

On bottom pane on right, under Value type, and next to Account, click on Not specified and change to User defined, click on the Member Select button that will appear at the right. The Multiple Select dialog box displays:

138

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Select Auto Sales and Descendants (inc), click > button to move under Selected and click the OK button. 6. On bottom pane on right, under Value type, scroll down and next to Totals Dealers and Products, click on Not specified and change to All. 7. In middle pane on right, select the Range tab.

Hyperion Planning Implementation Boot Camp

139

4 Data Form Design

Hyperion Planning Implementation Boot Camp

From bottom pane on right, click on Member Select button to the right of Dimension Year. The Multiple Select dialog box displays:

Click on Local Variables tab, select YearPrompt, click > button to move [YearPrompt] under Selected and click the OK button. 8. Repeat for Scenario, Version and Entity using appropriate Local Variable, note: you can also type in [LocalVar], but the editor is somewhat finicky. 9. On left pane, navigate under Graphical > Formulas > Units-Rates, select Rates = Amount/Units icon and drag it next to Aggregate Data on the right. 10. In lower right-hand pane, make following selections: Destination: Account Fleet Price, Year [YearPrompt], Scenario [ScenarioPrompt], Version [VersionPrompt] and Entity [EntityPrompt] Amounts: Account Fleet Sales and same values as above for Year, Scenario, Version and Entity Units: Account Fleet Unit Sales and same values as above for Year, Scenario, Version and Entity

140

Enablement 2.0

Hyperion Planning Implementation Boot Camp 11.

Data Form Design

Repeat steps 9 and 10 adding 2nd Graphical formula - Rates = Amount/Units using Dealer Price, Dealer Sales and Dealer Unit Sales. 12. Click the Save button. Save As dialog box displays:

Enter Name - FixPrice and click OK button.


13.

Select the Locations tab

Hyperion Planning Implementation Boot Camp

141

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Click Allow All Locations button.


14.

Select the Access Privileges tab and click the Add button. Add Privilege dialog box displays:

142

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Select demoadmin and click > button to move under Selected, then click OK button. 15. On Rules Editor window, click on Save button and then Validate button. Validate dialog box displays:

Hyperion Planning Implementation Boot Camp

143

4 Data Form Design


Click on Validate button.

Hyperion Planning Implementation Boot Camp

Message dialog box displays:

Click on OK button. 16. Select the Source tab to see the underlying Business Rule script. Click somewhere in script as though you were going to edit script. Select an Option dialog box displays:

Click No or Cancel button and on Rule Editor pane click Close button. 17. Return to Planning Web Client, Edit 1-Unit Sales and Price data form and select Business Rules tab.

144

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Select AutoFin Rule FixPrice, click button to move it under Selected Business Rules on right and click Properties button in lower right-hand corner. Check the checkbox under Use Member on Data Form.

Hyperion Planning Implementation Boot Camp

145

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Hide Prompt selection doesnt apply as it requires that No dimensions are repeated in the runtime prompt.

Click OK button in lower left-hand corner. Click Save button and click subsequent OK button. 18. Open 1-Unit Sales and Price data form and from menu bar select Edit > Launch Rules L. Launch Business Rules window displays:

Select AutoFin FixPrice and click the Launch button. Runtime Prompts window displays:

146

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Click the Launch button. Launch Business Rules window displays with information message FixPrice was successful. Click to close information message and click Close button to close dialog box. 19. From menu bar, select View > Refresh R (or use Refresh shortcut button). Confirm that Price values for Product 155-1000 are correct.

Hyperion Planning Implementation Boot Camp

147

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Exercise 4.3 Additional Form Components


In this exercise you will gain experience using Data Form capabilities and components including Adjust Data, Grid Spread, Account Annotations, Planning Unit Annotations, Cell Text, Cell Level Document, Supporting Detail and Menus.
Adjust Data

1. Open 1-Unit Sales and Price data form. Highlight cells for Fleet Unit Sales and M1 through M3 and from menu bar select Edit > Adjust Data J. Adjust Data dialog box displays:

You can adjust data by values or percent, select By Percentage and Increase by - 10 and click Adjust Data button.

148

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Close Adjust Data dialog box.


Grid Spread

1. The client indicates they would like to be able to spread Operating Expense data from quarters and Total Operating Expense down to months and accounts that are descendants of Operating Expense. How can we address this requirement?
Grid Spread is only available with Versions defined as Standard Target Values are entered from the parent level down. Versions defined for AutoPlan were all Standard Bottom Up Values are entered at the lowest member level and aggregated upward.

2. Add new Version member named Target with Type: of Standard Target and Refresh database. Notice that for Standard Target Version, the Enabled for Process Management: checkbox is grayed out only Standard Bottom Up Version can be Enabled for Process Management: 3. Edit 2Operating Expenses data form by adding Version to Page Dimension(s) (this will automatically delete Version from Point of View Dimensions) and Select Members Current and Target. Save the data form. 4. Open 2Operating Expenses data form, select version - Target and click Go button. Enter data as shown below:

Hyperion Planning Implementation Boot Camp

149

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Save data. 5. Calculate the AutoPlan:AutoFin database using (default) calc script. 6. Return to data form and from menu bar select View > Refresh R (or the Refresh shortcut key). From menu bar select Edit > Grid Spread G. Select the Operating Expense > Q1 > Budget cell.

150

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Enter Spread Value of 144, with default Spread Type of Proportional Spread selected, click the Spread button. Proportional Spread Spreads the value proportionally, based on the existing values in the target cells. All the Budget values will double in proportion to the change to Expense > Q1 > Budget cell. 7. Select the Operating Expense > Q1 > Actuals cell.

Hyperion Planning Implementation Boot Camp

151

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Enter Spread Value of 192, with Spread Type of Evenly Split and click the Spread button. Evenly Split Spreads the value evenly among the target cells. All the Actuals values will appear as 8 ( 192 / 3 months / 8 Lev0 descendants).

152

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

8. Explore behavior when you select cells and lock them, Edit > Lock/Unlock Cell K, prior to doing an Adjust or Grid Spread.
Locked cells will have a tan background to indicate they are locked. Fill behavior with 11.1.1.0.0 does not appear to be working as expected.
Planning Unit Annotations

1. Open Unit Sales and Price data form. Notice that POV for this form defines a specific Planning Unit (combination of ScenarioVersion-Entity). From menu bar select Edit > Annotate Planning Unit N. You should see an error message The planning unit you selected is not started. Please select a planning unit that has been started. Click the Close button. We will discuss Workflow Management later, but for now lets go through steps to start a Planning Unit. 2. From menu bar select File > Workflow W > Manage Process M. You will 1st be prompted to Select a valid scenario and version.

Hyperion Planning Implementation Boot Camp

153

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Enter Scenario Budget and Version Current and click the Go button. The Entity dimension displays.

Expand Entity dimension until CC6350 is displayed and click on the radio button next to CC6350 under Start column. Message displays at top of window - The planning unit has been started. Notice

154

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

that the entitys ancestors (Sales, Sales and Mktg and Functional) are automatically started. Click the after the message. 3. Click on Unit Sales and Price in left pane and from menu bar select Edit > Annotate Planning Unit N. As 4. Enter an annotation in box under Enter Text box on left and click Submit button.

Message displays at top of window - The annotation has been saved. And the annotation is displayed in the Existing Annotation box on right. Click the after the message and click the Close button. 5. From menu bar select File > Workflow W > Manage Process M. Enter Scenario Budget and Version Current and click the Go button. Click on the Details link to right of CC6350 under Action column. The View Details window displays:

Hyperion Planning Implementation Boot Camp

155

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Notice that you can also add annotations from this window. 6. Click the Change Status bottom and the Change Status dialog box is displayed. This is where Planners promote the Planning Unit and Approvers Approve it. Click the Cancel button to close Change Status dialog box and click the Done button.
Account Annotations

1. Open Unit Sales and Price data form. From menu bar select View > View Account Annotations A. This option is grayed out, by default Account Annotations are NOT enables for data forms. 2. From menu bar, select Administration > Manage Data Forms F. Expand Forms folder, select BootCampForms folder, select Unit Sales and Price data form and click Edit button. 3. Select Other Options tab and under Display Properties, click on checkbox for Enable account annotations: Click on Save button and on next screen click OK button. 4. Open Unit Sales and Price data form. From menu bar select View > Edit Account Annotations A. 5. Enter annotations as shown below:

156

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Save form, select different Page settings and click Go button. Notice that Account Annotations remain with form across all Page combinations.
Cell Text and CellLevel Document

1. Open Unit Sales and Price data form. From menu bar select Edit > Cell Text T. Cell Text window is displayed:

Hyperion Planning Implementation Boot Camp

157

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Enter text and click on Submit button. Cell Text indicator will appear in upper right-hand corner of cell and message This cell has cell text displays when cursor hovers over cell.

158

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

2. Right-click on the cell and select Add/Edit Document

Before you add a cell-level document, the document must be added to the Workspace repository.

Hyperion Planning Implementation Boot Camp

159

4 Data Form Design

Hyperion Planning Implementation Boot Camp

The Add/Edit Document window displays:

Click the Browse to Workspace button and browse to Eden /Planning and Forecasting/Support Files/Laptop Specification.pdf
Browse button in only available in the Workspace client, NOT the Planning Web Client.

From Planning Web Client you can type in the URL: http://demodrive:19000/workspace/index.jsp?module=tools.relate dcontent&repository_path=/Eden/Planning and Forecasting/Support Files/Laptop Specification.pdf

160

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Make sure Type: is All Files or Standard > PDF file Click the OK button. 3. The Add/Edit Document will be redisplayed with the link to document.

Hyperion Planning Implementation Boot Camp

161

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Click the Submit button. 4. Cell Document indicator will appear in lower right-hand corner of cell and message This cell has a document attached displays when cursor hovers over cell.

5. Right-click on the cell and select Open Document

162

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

After several seconds the document displays:

Supporting Detail

1. The client has asked how Planners can provide details for their Fleet Unit Sales by Vehicle Model Year. This is only a requirement for the 155-1000 product line. Open Unit Sales and Price data form. Highlight cells for Fleet Unit Sales M1 through M3 and from menu bar select Edit > Supporting Detail S.

Hyperion Planning Implementation Boot Camp

163

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Supporting Detail window displays:

Enter 2008 Model Year and click on Add Sibling button, enter 2009 Model Year and click on Add Sibling button and enter 2010 Model Year. Then enter data values for M1, M2 and M3 and click the Save button. 2. The Unit Sales and Price form will be redisplayed with the new values for Fleet Unit Sales:

Cells change to a teal background color indicating cells have supporting details. The cell values can no longer be changed on the data form, values can only be changed by updating the Supporting Detail.

164

Enablement 2.0

Hyperion Planning Implementation Boot Camp Menus

Data Form Design

1. From menu bar select Administration > Manage Menus M. Manage Menus window displays:

Select the Create button and a dialog box displays

Enter TestMenu and click OK button. 2. On Manage Menus window, select checkbox next to TestMenu click on Edit button. Edit Menu window will be dislayed:

Hyperion Planning Implementation Boot Camp

165

4 Data Form Design

Hyperion Planning Implementation Boot Camp

Click on the Add Child button. Add Menu Item window displays:

Enter values as shown above and click the Save button. On Edit Menu window, select checkbox next to menu Item 1.0 Form1 and press Add Sibling button.

166

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

Enter values as shown above and click the Save button. On Edit Menu window, click the Close button. 3. Manage Data Forms and select the 1-Unit Sales and Price data form, click Edit button and go to Other Options tab. Notice at bottom left under Available Menus is TestMenu. Select TestMenu and click the Add button to move it under Selected Menus. Click the Save button.

Hyperion Planning Implementation Boot Camp

167

4 Data Form Design

Hyperion Planning Implementation Boot Camp

4. Select 1-Unit Sales and Price data form and right click on a row or column. Notice the 2 menu options now available in addition to thew default right click options. Select Operating Expenses.

168

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Data Form Design

The display will be immediately open to 2-Operating Expenses form. If we had added TestMenu to 2-Operating Expenses data form, you would be able to select Unit Sales and Price and return the 1-Unit Sales and Price form.

Hyperion Planning Implementation Boot Camp

169

5
Security and Administration

Section Objectives
At the end of this section, you will be able to: Add new users and groups, provision them with appropriate role(s) and set up appropriate access to Forms and Data Use Life Cycle Management

Hyperion Planning Implementation Boot Camp

Security and Administration

Exercise 5.1 Planning Security


In this exercise, based on requirements provided by client, you will add a new user, provision user as a Planner and set up appropriate Form and Data access.

Create New User

1. Client has requested that we add a User, Joseph Blow, a Planner for Auto World Los Angeles (AW 001) and Bump Jumper EUV (1551000-10) that will only be able to enter Budget data for Units and Prices. 2. From Planning Web Client menu bar select Administration > User Management N. Shared Services Console displays:

Expand User Directories > Native Directory, right-click on Users and select New. Create User window displays:

Hyperion Planning Implementation Boot Camp

171

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Enter values as shown above, Password Demov52 and click Finish button. 3. The Status Message window displays - User 'jblow' created. Click OK button.
Create New Group

4. On Shared Services Console follow same procedure to create a new Group Auto World Planners. Create Group window displays. After entering Name on the 1. General tab, click Next button. The 2. Group Members tab allows creating Groups within Groups nested Groups, click Next button to go to 3. User Members tab. Click the Go button to display Available Users.

172

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Select checkbox next to jblow and click Add button to Add jblow under Assigned Users, click Finish button. 5. The Status Message window displays - Group 'Auto World Planners' created. Click OK button.
Provision Group

6. On Shared Services Console, right-click on Auto World Planners group and select Provision.

Provision pane displays:

Hyperion Planning Implementation Boot Camp

173

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Expand Planning and AutoPlan, select Planner and click Add button to move under Selected Roles. Click the Save button. Provision Summary displays:

174

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Click OK button. 7. From Shared Services Console menu bar, select File > Log Off. Shared Services Log On window displays. Select Oracle EPM Planning (Planning Web Client) from Internet Explorer Favorites.
Log On as new user

8. Log On using new User Name and Password

An error message displays: Application is in maintenance mode. New logins are not allowed.

Hyperion Planning Implementation Boot Camp

175

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Click the
Update Application Settings

button to right or error message.

9. Log On as demoadmin and from menu bar select Administration > Application Settings S. Application Setting window displays:

176

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

With Show Advanced Settings and System Setting tab selected, change value in dropdown box for Application Maintenance Mode Enable Use of the Application for: to All Users and click the Save button. Message will be displayed - Application settings have been saved. Click the button. 10. Log Off and Log On as with User Name jblow

Hyperion Planning Implementation Boot Camp

177

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Notice that no Forms are available and that the Administration menu bar option is not available. This is expected behavior. There is No Access to Forms for Planners or Interactive Users unless the Administrator specifically assigns access.
Add Form Access

11. Log On as demoadmin and from menu bar select Administration > Manage Data Forms F and select 1-Unit Sales and Price form. 12. Click on Assign Access button and then the Add Access button.

Select jblow, radio button next to Write and click the Add button.

178

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Message will display - Adding of Users/Groups succeeded Click the button. 13. Log Off and Log On as with User Name jblow Notice that now 1-Unit Sales and Price forms is available, but when you select it an error is displayed. Again, this is expected behavior. Planners can select only members to which they have read or write access and can edit data forms only if they have access to at least one member of each secured dimension.
Add Data Access

14. Log On as demoadmin and from menu bar select Administration > Dimensions D. Select Accounts dimension and Auto Sales member, click Assign Access button. Assign Access for Auto Sales window displays, click the Add Access button.

Select jblow, radio button for Write and Descendent (inclusive) from dropdown box. Click Add button, then Close button. On the Assign Access for Auto Sales window click Close button. 15. Repeat process providing Write access to following dimensions and members (selecting Member from drop down): Entity CC6350 Products 155-1000-10 Scenario Budget Total Dealers AW 001 Version Current Notice Assign Access is NOT available for Period and Year dimensions

Hyperion Planning Implementation Boot Camp

179

5 Security and Administration


Refresh Security

Hyperion Planning Implementation Boot Camp

16. From menu bar, select Administration > Manage Database B

Select checkbox for Security Filters and click the Refresh button. 17. Log On to Essbase Administration Services Console, select AutoPlan:AutoFin database, right click and select Edit > Filters. On Filters pane, select fjblow and click the Edit button.

180

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Click Close button and click Close button on Filters pane. 18. From Planning Web Client, Log Off and Log On as with User Name jblow. Select 1-Unit Sales and Price form

Hyperion Planning Implementation Boot Camp

181

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Notice that 155-1000-10 is only member available in Products dropdown box and AW 001 is only member available in Total Dealers dropdown box. Change data and save. Attempt to Launch FixPrice business rule, notice it is unavailable. 19. Return to Essbase Administration Services Console, select add Access for FixPrice business rule to jblow. 20. Return to form and now launch FixPrice business rule defaults to Actual which is unavailable to jblow user, change to Budget (only member available to jblow), Validate and then Launch. Refresh data to confirm data recalculated.

182

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Exercise 5.2 Life Cycle Management


In this exercise you will gain experience using Shared Services, exploring Planning application artifacts and migrating artifacts.

Log On to Shared Services

1. Select ORACLE EPM Shared Services from Internet Explorer Favorites (http://demodrive:28080/interop/index.jsp) and Log On as User Name: demoadmin.
Review Planning Artifacts

2. Navigate to Application Groups > Planning > AutoPlan. Artifact List tab displays:

Expand categories such as Data, Global Artifacts and Plan Type to explore level of detail available for Planning application artifacts. 3. Click Select All button and then the Define Migration button.

Hyperion Planning Implementation Boot Camp

183

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Migration Wizard Source Options window displays:

Select checkbox for Include dependent dimensions: and click the Next button (it is unclear what the purpose of this option is). Destination window displays:

184

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Expand File System, enter AutoPlan and click the Next button.
The default destination on the Shared Services computer is hyperion_home/common/import_export/username@ProviderName /

Destination Options window displays:

Hyperion Planning Implementation Boot Camp

185

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Click the Next button. Summary window displays: Click Execute Migration button. Hyperion Shared Services Information dialog box displays:

186

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Wait several seconds and click Launch Migration Status Report button.

Hyperion Planning Implementation Boot Camp

187

5 Security and Administration

Hyperion Planning Implementation Boot Camp

Confirm status of Success, select View Details and click on Cancel button several times. 4. From Explore, navigate to C:\ORCL\HYSL\common\import_export\demoadmin@Native Directory\AutoPlan\resource\Data, select Cell Texts.xml, right-click and Open With > Notepad. You will see the Cell Text that we entered in previous exercise as part of this Boot Camp.

188

Enablement 2.0

A
Appendices

Section Objectives
Copy Files to Virtual System Update Application from Life Cycle Management artifacts Troubleshoot Shared Services Issues

A Appendices

Hyperion Planning Implementation Boot Camp

Appendix A.1 Copy Local Files to Virtual System


This appendix provides details for copying files from your local physical system to various Virtual systems.

When using Remote Desktop to connect to hosted Oracle image


How to gain access to local files in a remote desktop session to a Windows XP-based or to a Windows Server 2003-based host computer [http://support.microsoft.com/kb/313292] You can gain access to your disk drives on the local computer during a Remote Desktop session. You can redirect the local disk drives, including the hard disk drives, CD-ROM disk drives, floppy disk drives, and mapped network disk drives so that you can transfer files between the local host and the remote computer in the same way that you copy files from a network share. You can use Microsoft Windows Explorer to view the disk drives and files for each redirected disk drive. Alternatively, you can view the files for each redirected disk drive in My Computer. The drives are displayed as "drive_letter on terminal_server_client_name" in both Windows Explorer and My Computer. To view the disk drives and files for the redirected disk drive:
1.

Click Start , point to All Programs (or Programs), point to Accessories, point to Communications, and then click Remote Desktop Connection.

190

Enablement 2.0

Hyperion Planning Implementation Boot Camp 2.

Security and Administration

Click Options, and then click the Local Resources tab.

Hyperion Planning Implementation Boot Camp

191

A Appendices
3.

Hyperion Planning Implementation Boot Camp

Under Local devices and resources, click the More button.

4. Expand Drives and select drive the USB Flash Drive the BootCamp folder is assigned to (e.g. H:) 5. Click OK button to return to Local Resources tab and then click Connect

192

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

When using local Microsoft Virtual Server 2005 image Option 1


Add a Microsoft Loopback adapter to the host machine, give it an IP address in the same subnet as the guest machines. Then tie the guest machines' adapter to the loopback adapter. http://www.microsoft.com/technet/prodtechnol/virtualserver/2005/proddocs/vs_operate_u sing_loopback.mspx

Option 2
The simple solution I've found is IsoRecorder ... this provides a Windows Explorer shell extension that enables a folder to be quickly converted to an ISO format disk image which can then be attached 'on the fly' to the CD Drive running within the VS virtual machine. http://isorecorder.alexfeinman.com/isorecorder.htm Attach ISO file to the CD drive inside virtual server using options in the Virtual Server configuration

Hyperion Planning Implementation Boot Camp

193

A Appendices
Option 1
To

Hyperion Planning Implementation Boot Camp

When using local Microsoft Virtual PC image


Do this

Point to the file or folder on the host operating system to be Copy a file or folder copied, and then drag the file or folder to a location on the to a virtual machine virtual machine. Notes
Dragging and dropping large files will cause Virtual PC to temporarily stop responding until the process is complete. As an alternative to copying a file or folder, you can use shared folders to make a file or folder available to both the host and virtual machine. For more information, see Share a folder between a virtual machine and the host operating system.

Option 2
1. After the image has been started, return to Virtual PC Console and click the Settings button.

If you havent previously selected checkbox to Dont show this message again, the following Note will display:

194

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Click OK button. 2. The Settings window displays:

3. Select the Shared Folders setting on left pane and click on Share Folder... button in right. The Browse for Folder window displays:

Hyperion Planning Implementation Boot Camp

195

A Appendices

Hyperion Planning Implementation Boot Camp

Expand the drive assigned to the USB Flash Drive and select the BootCamp folder. Make note of the drive letter assigned (e.g. Z, or alternatively you can select a specific drive letter). 4. Press the OK button and when you return to the Setting window, press the OK button.

196

Enablement 2.0

Hyperion Planning Implementation Boot Camp

Security and Administration

Appendix A.2 Troubleshooting Shared Services Issues


This appendix provides details for troubleshooting Shared Services Issues.

If Shared Services service does not startup, try to start the OpenLDAP service manually from the Services control panel. If it fails then it is possible that Shared Services is corrupt. To resolve this issue, shut down all services except the Oracle database, open Windows Explorer and go to c:\prods\ss\batch and run Repair_OpenLDAP.bat. Then restart Shared Services and test the login to Shared Services UI before starting other services. If Shared Services does not start up even after running Repair_OpenLDAP script, shutdown all services except the Oracle database. Ensure that no process is connected to the Oracle database. If you are unsure of this, reboot the machine and start the Oracle database only. Now open Windows Explorer and go to c:\prods\ss\batch and run Refresh_app.bat. This will restore Shared Services to the state of the image at its release. Any work done with user provisioning since obtaining the image will be lost. If Shared Services is started without the Oracle database starting up completely, issues may be encountered with logins of products or services not starting up. When this happens use the shortcut to the Shared Services UI in the Internet Explorer favorites to login to Shared Services using Demoadmin/Demov52 or admin/password. If you get an error, restart Shared Services and then restart other services to fix this issue.

Hyperion Planning Implementation Boot Camp

197