planning- oracle bootcamp 1

Hyperion Planning 9.3.1:Create and Manage ApplicationsVolume I • Student Guide

D52599GC10

Edition 1.0

December 2007

D53078

®®

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Copyright © 2007, 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 RIGHTSThe U.S. Government’s 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.

Author

Sandy Krameisen

Technical Contributors and Reviewers

Bryan Dehmler-Buckley

Suzanne Gill

Vicki Hardiman

Art Hetherington

Lea Jensen

Sandy Krameisen

Ronald Reiley

Eleanor Salerno

Theresa Songco

Shankar Viswanathan

Stuart Weiner

Editor

Susan Moxley

Graphic Designer

Carisa Cannan

Publisher

Judy Gaitan

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents 1

Preface

Course Objectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixCourse Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxCourse Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Student Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxActivity Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

Module 1: Getting Started

Lesson 1: Planning Overview

Oracle’s Enterprise Performance Management System . . . . . . . . . . . . . . . . . . . . . . . 1-2Oracle Business Intelligence Suite Enterprise Edition Plus . . . . . . . . . . . . . . . . . . . . . 1-4Hyperion Product Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Product Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8Additional Product Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10

Planning Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12Client Tier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12Application Tier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13Database Tier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13User Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14EPM Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15Planning Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16

Planning and Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17Planning Repository and Essbase. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19Dimension Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21Dimensions and Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22Multidimensional View of Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23Drill-Down Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24Essbase Terminology—Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25Essbase Terminology—Families . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-26Essbase Terminology—Generations and Levels . . . . . . . . . . . . . . . . . . . . . . . . . 1-27

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

iv Planning: Create and Manage Applications

Lesson 2: Navigating Workspace

System 9 Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Workspace Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Launching Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5Workspace User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6Workspace Navigate Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8Opening Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10Navigating in Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-11

Reviewing Available Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-11Basic and Advanced Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17View Pane and Content Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19Opening Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20

Module 2: Creating Application Structures

Lesson 3: Creating Dimensions Overview

Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Planning Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3Required Dimensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Period and Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Scenario and Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Entity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5HSP_Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6Alias and Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

User-Defined Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7Dense Dimensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8Sparse Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9Data Block Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10

Determining the Number of Data Blocks in a Database . . . . . . . . . . . . . . . . . . . .3-11Creating Data Blocks and Retrieving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13Determining Data Structure and Performance of Data Blocks. . . . . . . . . . . . . . . 3-14

Selecting Aggregation, Storage, and Calculation Options . . . . . . . . . . . . . . . . . . . . . 3-15Selecting Aggregation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16Selecting Data Storage Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17Calculating Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21Using Two-Pass Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22Determining Performance Efficiency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications v

Lesson 4: Managing Dimensions with EPM Architect

About Dimension Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Master View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Application View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3EPM Architect Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Adding Dimensions to Master View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5Organizing Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

Filtering Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9Sorting Dimensions and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-11

Creating Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12Guidelines for Member Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13Modifying Member Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14Property Value Inheritance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16Managing Property Value Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17Creating Alternate Rollups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

Managing Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19Moving Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19Deleting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20Renaming Members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20Reordering Children. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20Inserting Members Using Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21Finding Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

Creating Aliases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25Adding Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27

Number Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28Triangulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28Reporting Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28

Creating Associations Between Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29

Lesson 5: Setting Up the Period, Scenario, and Version Dimensions

Time Periods Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2Period and Year Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5Dynamic Time Series Members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6Setting Up Dynamic Time Series Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Choosing How Data Is Stored . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9Scenario Dimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

vi Planning: Create and Manage Applications

Creating Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12Enable Process Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Exchange Rate Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Use Beginning Balance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Deleting Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

Version Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16Creating Versions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

Lesson 6: Setting Up the Entity Dimension

Entities Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Entity Members and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3Identifying the Currency Value for Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5Adding and Modifying Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6Saving Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8Deleting Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

Lesson 7: Setting Up the Account Dimension

Accounts Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2Account Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Time Balance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5Saved Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7Data Types and Exchange Rates Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

Creating Account Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10Adding and Modifying Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-11Consolidation Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12Consolidation Order Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13

Lesson 8: Creating User-Defined Elements

User-Defined Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2Attributes Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Viewing, Aggregating, and Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5Creating Attribute Crosstab Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

Creating Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6Examples of Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications vii

Assigning Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9Member Formulas Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-11

Adding Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12Adding User-Defined Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-14

Smart Lists Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16Creating Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

Modifying Smart Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20Associating Smart Lists with Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-22Setting Data Forms to Use Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-23

Module 3: Loading Metadata

Lesson 9: Loading Metadata from a File

Metadata Load Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2Formatting Load Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3Load File Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4Formatting Dimensions Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5Formatting Members Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6Formatting Hierarchies Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9Formatting DimensionAssociation Sections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

Loading Metadata Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12Creating Import Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13Mapping Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15Mapping Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17Running Import Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18Viewing Job Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19Viewing Import Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20

Loading Metadata from Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21Interface Tables Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21Setting Up Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22

Lesson 10: Creating Application Views

Creating Application Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2Dimension Library Panes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4Adding Dimensions to Application Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5Excluding Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7Member Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

viii Planning: Create and Manage Applications

Configuring Application Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9Configuring Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-11Specifying Currency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-13Setting Up Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

Removing Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-16Setting Up Dimension Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-17Choosing Performance Settings for Optimal Performance . . . . . . . . . . . . . . . . . . . 10-19Dimension Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-21

Lesson 11: Deploying Applications

Deploying Applications Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-2Deployment Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-3Validating Application Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-4Comparing Application Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-6Deploying Application Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-8Creating Essbase Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-10Reviewing Planning Outlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-11

Essbase Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-12Redeploying Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-13

Lesson 12: Setting Up Exchange Rates

Currencies and Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2Exchange Rates Tables Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3Creating Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4

Entering Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6Types of Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6Calculating Implied Rates Through Triangulation . . . . . . . . . . . . . . . . . . . . . . . . 12-8Determining the Calculation Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9

Exchange Rates and the HSP_Rates Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10Generating Currency Conversion Calculation Scripts . . . . . . . . . . . . . . . . . . . . . . . .12-11

Copy Rates Calculation Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12Currency Conversion Calculation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12Calculate Currencies Business Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications ix

Module 4: Loading Data and Calculating the Database

Lesson 13: Loading and Calculating Data Overview

Loading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2Requirements for Data Load Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4Multicurrency Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6Setting Up Data Load Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7Staging Data Using Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-9

Data Calculation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-10Calculations Within Dimensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-11Calculations and Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12Calculation Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-14

Lesson 14: Loading Data

Loading Data Using Administration Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2Creating Data Load Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3

Opening Data Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4Defining Header Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6Associating Column Fields with Dimensions and Members . . . . . . . . . . . . . . . . 14-8Replacing Text Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-10Validating and Saving Rules Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-12Fixing an Invalid Rules File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-13Loading Data Using Rules Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-14

Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-16Creating Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-17Loading Data Using Interface Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-18

Module 5: Setting Up Security

Lesson 15: Provisioning Users and Groups

Planning Security Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2Levels of Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-3User Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4Task Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5Object Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-6Data Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-7

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

x Planning: Create and Manage Applications

User and Group Provisioning Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-8User Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-9Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-10Unassigned Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-11

Provisioning Users and Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-12User Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-14Generating Provisioning Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-16

Lesson 16: Setting Up Access Rights to Planning Applications

Assigning Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2Access Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3Inheritance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-5Precedence and Inheritance of Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . 16-7Reporting on Access Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-9

Importing Security Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-10Creating the Secfile.txt File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-11Importing Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-14Creating Security Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-16

Module 6: Designing Data Forms

Lesson 17: Creating Data Forms and Folders

Data Forms and Folders Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2Data Form Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3Creating Folder Structures for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-5Data Form Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-6

Considerations for Setting up Data Forms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-7Setting Data Form Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-9Setting Row and Column Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-10Selecting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14Creating Substitution and User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-16Creating Asymmetric Columns and Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-17Setting Page and Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-18Setting Options on the Other Options Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-19Identifying Missing Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-21Selecting Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-22Previewing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-24

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications xi

Composite Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-25Creating Composite Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-26Selecting Business Rules on Composite Data Forms . . . . . . . . . . . . . . . . . . . . 17-27

Printing Data Form Definition Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-28Assigning Access Rights to Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-29

Lesson 18: Customizing Data Forms

Exporting and Importing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4

Creating Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6Associating Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-10

Advanced Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18-11System Settings Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-12Custom Tools Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-12Current Application Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-13

Managing User Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-14Creating User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-15Applying User Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-16

Setting Up User Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-17Setting Up E-mail for Workflow Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-18Applying Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-18Setting Member Selection and Workflow Options . . . . . . . . . . . . . . . . . . . . . . . 18-18Setting Individual Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-19Setting Individual Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-22Setting Individual User Variable Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-23

Module 7: Entering Data in Planning

Lesson 19: Entering Data

Submitting Data in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2Elements on the Enter Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3Data-Entry Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5Viewing Form Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6Recognizing Cell Color Cues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7Navigating Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-9Copying and Pasting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19-11Working with Non-Aggregated Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-13

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

xii Planning: Create and Manage Applications

Saving and Refreshing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-14Spreading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-15

Time Balance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-17Spreading Data Using Grid Spreader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-19Spreading Data Using Mass Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-20

Adjusting and Annotating Plan Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-22Performing Ad Hoc Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-23Exporting Data to Spreadsheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-24Adding Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-25Adding Cell Text and Account Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-26Adding Planning Unit Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-27Adding Supporting Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-28

Calculating Data in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-30Calculate Data Form Calculation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-32Calculate Currencies Calculation Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-33Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-34

Entering Data with Smart Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-35Navigating Data Forms with Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-36

Lesson 20: Entering Data in Smart View

Smart View Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-2Integrating Smart View with Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-3Smart View Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-4Establishing Data Source Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-5

Planning and Smart View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-8Opening Data Forms in Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-9Navigating Data Forms in Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-10Entering Data in Smart View Using Data Forms . . . . . . . . . . . . . . . . . . . . . . . . .20-11Adding Formulas to Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-13Calculating Data in Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-15

Offline Planning Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-16Taking Data Forms Offline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-17

Working with Planning Offline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-19Synchronizing Data to the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-21

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications xiii

Module 8: Adding Business Rules

Lesson 21: Creating Business Rules

Business Rules Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2Business Rules Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-4Prerequisites for Accessing Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-5

Navigating Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6Components of Enterprise View Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6Components of BR Language Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-7Navigating the Rule Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8

Business Rules Creation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9Setting a Plan for Developing Business Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9Launching the Rule Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-11Adding Actions to Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-14Selecting Members for Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17Assigning Access to Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-19

Launching Business Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-21Launching Business Rules from Administration Services Console . . . . . . . . . . 21-22Launching Business Rules from Planning – Data Forms. . . . . . . . . . . . . . . . . . 21-23Launching Business Rules from Planning – Tools Menu. . . . . . . . . . . . . . . . . . 21-24

Printing Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25

Lesson 22: Building Runtime Prompts for Business Rules

Runtime Prompts Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-2Adding Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4

Setting Up Runtime Prompts as Global Variables . . . . . . . . . . . . . . . . . . . . . . . . 22-5Applying Runtime Prompts as Global Variables . . . . . . . . . . . . . . . . . . . . . . . . . 22-8Setting Up Runtime Prompts as Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . 22-9Specifying Limits for Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-10

Lesson 23: Adding Formulas to Business Rules

Business Rules Formula Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-2Building Formulas for Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-3

Components for Pro-Rata Ratio Formulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-4Setting Up Pro-Rata Ratio Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-5Setting Up Units-Rates Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-8

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

xiv Planning: Create and Manage Applications

Setting Up Variable Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-9Setting Up Custom Formulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-10

Specifying Data Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23-11Managing Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-12

Module 9: Managing the Planning Process

Lesson 24: Managing the Approval Process

Process Management Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3

Planning Units and Process States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-4Reviewer Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-6Impact of Entity Hierarchy on the Review Process . . . . . . . . . . . . . . . . . . . . . . . 24-8

Managing the Review Cycle for Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-10Starting or Excluding Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24-11Checking the Status of Planning Units. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-13Viewing the Details of Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-14Printing Planning Unit Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-17

Copying Data Between Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-19Copying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-21

Lesson 25: Creating Task Lists

Task Lists Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-2Navigating Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-4

Navigating Task Lists in Basic Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-5Navigating Task Lists in Advanced Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-8

Task List Creation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25-11Working with Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-12Building Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-14

Adding Tasks to Task Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-16Setting Up Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-17Setting Task Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-19

Assigning Access to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-21Validating Task Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-22Reporting on Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-23

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications xv

Module 10: Analyzing Planning Data with Financial Reporting

Lesson 26: Financial Reporting Overview

Financial Reporting Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-2Workforce Planning and XBRL Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-3Financial Reporting Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-5Security Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-7Users, Groups, and Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-8

Data Sources for Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-10Financial Reporting Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-12Working with Financial Reporting Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-13

Financial Reporting Studio Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-14Viewing Repository Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-16Opening Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-18Report Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-19Changing the User Point of View Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-20Previewing and Printing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-21

Lesson 27: Navigating Reports in Workspace

Workspace Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-2Workspace User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-4Workspace Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-6View Pane Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-7

Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-8Setting General Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-8Setting Authentication Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-9Setting Explore Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-10Setting Financial Reporting Studio Preferences . . . . . . . . . . . . . . . . . . . . . . . . .27-11Setting Financial Reporting General Preferences . . . . . . . . . . . . . . . . . . . . . . . 27-12

Browsing the Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-14Searching for Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-16Previewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-17

Changing the User Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-19Previewing the Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-21Limiting User Point of View Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-22

Changing Page Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-26Printing Reports and Snapshots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-27

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

xvi Planning: Create and Manage Applications

Integrating Reports into Microsoft Office Applications . . . . . . . . . . . . . . . . . . . . . . . 27-28Exporting Reports to Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-29Exporting Reports to Word and PowerPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-31Importing Reports to Microsoft Office Applications . . . . . . . . . . . . . . . . . . . . . . 27-33

Module 11: Appendices

Appendix A: Sharing Data Using Data Synchronization

About Data Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2Creating Mapping Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3Creating Data Synchronizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

Specifying Source and Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6Linking Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7Setting Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8Applying Filter Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9Inserting Mapping Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10Validating Data Synchronizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11

Viewing Data Flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-12Executing Data Synchronizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13

Appendix B: Working with Classic Application Administration

Classic Administration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2Processes in Creating Planning Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4Planning Application Creation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6Planning Relational Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7Configuring Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8Creating Applications Using Classic Application Wizard . . . . . . . . . . . . . . . . . . . . . . B-10Accessing Classic Application Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11

Selecting the Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12Setting Up the Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-15Setting Up Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-16Completing Application Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-18Creating Essbase Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-19Reregistering Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-20

Building Member Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-21Working with Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-23Creating Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-25

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

Planning: Create and Manage Applications xvii

Smart Lists Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-27Smart List Creation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-28Creating Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-29Associating Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-31

Setting Up UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-32Setting Up Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-34Data Integration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-35Planning Adapter Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-36Working with Planning Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-37

Creating Planning DSNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-38Importing Target Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-39Creating UDA Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-40

Loading Metadata to Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-42Creating Planning Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-43Configuring Session Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-44

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Table of Contents

xviii Planning: Create and Manage Applications

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Preface 0

Welcome to Hyperion Planning 9.3.1: Create and Manage Applications!

Before you begin, please take a moment to review this section. The preface presents an overview of the following information:

• Course objectives

• Structure of the course

• Course materials used in the class

• Conventions used in the book

Course ObjectivesAfter completing this course, you should be able to:

• Create Planning applications

• Load data into Planning applications

• Set up security for users, groups, and members

• Create data forms and enter data by using data forms

• Set and test business rules

• Review budget data by using process management

• Analyze planning results in Financial Reporting

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Preface

xx Planning: Create and Manage Applications

Course StructureHyperion Planning 9.3.1: Create and Manage Applications is a 5-day, instructor-led training course consisting of lectures, demonstrations, and hands-on exercises. In this course, the instructor presents a topic conceptually by explaining its purpose, demonstrating how it works, and then guiding the students through the exercises. Demonstrations and hands-on exercises reinforce the concepts and skills introduced during lectures.

Course MaterialsYou use two books in class—the student guide and the activity guide. The instructor may also give you handouts.

Student GuideThe student guide is designed to be used by students and the instructor during lecture time. It has 11 modules:

• Module 1 describes an overview of Planning and navigating Workspace.

• Module 2 describes setting up dimensions and members.

• Module 3 describes importing dimension members using EPM architect.

• Module 4 describes loading data and calculating the database.

• Module 5 describes setting up security.

• Module 6 describes designing data forms.

• Module 7 describes entering data in Planning.

• Module 8 describes adding business rules.

• Module 9 describes managing the planning process.

• Module 10 describes analyzing data with Financial Reporting.

• Module 11 contains appendices which provide additional information about Planning not covered in this course.

Each module contains lessons. Each lesson begins with a list of objectives followed by the presentation of slides and accompanying text. The lesson ends with a summary of the topics covered in the lesson.

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Preface

Planning: Create and Manage Applications xxi

Activity GuideThe activity guide has two sections—exercises and exercise solutions.

ExercisesA critical part of the learning process is the challenge of completing real tasks associated with each lesson. Each exercise is an opportunity to apply your new knowledge.

Exercise SolutionsThe exercise solutions present the detailed steps to successfully complete the exercises.

ConventionsThe following text conventions are used in this course book:

• Text to be typed, options to be selected, names of files and modules, and menu selections are displayed in bold type. Examples:

- Select Clear Profile.

- Click YES to clear the profile.

• When available, figures are used to identify an object or task. Example:

Click Edit.

• Keyboard shortcuts are displayed as follows: Ctrl+Enter

• Alerts are used to direct your attention to different types of information.

N O T E

A note provides related information, common mistakes, or cautions about the current topic.

T I P

A tip provides information that helps you work more efficiently.

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Preface

xxii Planning: Create and Manage Applications

Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 1

Getting Started 0

OverviewThe aim of this module is to provide an overview of the product features, capabilities, components, and architecture of Planning. You also learn about the relationship between Planning and Essbase. You navigate the Workspace and access Planning using Workspace.

Lessons in this module include:

• Planning Overview

• Navigating Workspace

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1

Planning Overview 1

ObjectivesAt the end of this lesson, you should be able to:

• Describe Oracle’s Enterprise Performance Management system

• Describe Oracle Business Intelligence Suite Enterprise Edition Plus

• Describe the main features of Planning

• Describe the product architecture of Planning

• Describe the relationship between Planning and Essbase

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 1 Getting StartedLesson 1 Planning Overview

1-2 Planning: Create and Manage Applications

Oracle’s Enterprise Performance Management SystemOracle Business Intelligence (BI) is a portfolio of technology and applications that provides the industry's first integrated, end-to-end Enterprise Performance Management (EPM) system, including category-leading financial performance management applications, operational BI applications, BI foundation and tools, and data warehousing.

It is pervasive, comprehensive, and hot-pluggable:

• Pervasive—Delivers intuitive, role-based intelligence for everyone in an organization from front line employees to senior management to enable better decisions, actions, and business processes. There is a common workspace and a range of real-time and event-based capabilities. It also covers all styles of reporting and analysis needs.

• Comprehensive—Integrates information from your financial performance management, operational intelligence, and transactional applications. It has a single integrated platform architecture and a unified enterprise information model.


Oracle’s Enterprise Performance Management System

Integrates transaction, intelligence, and f inancial systems

Oracle In

ternal & O

racle Aca

demy

Use O

nly


Planning: Create and Manage Applications 1-3

• Hot-Pluggable—Uses your existing transaction systems, databases, and middleware applications. Oracle BI products are hot-pluggable with Oracle and non-Oracle environments.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle Business Intelligence Suite Enterprise Edition PlusOracle Business Intelligence Suite Enterprise Edition Plus (Oracle BI EE Plus) is a comprehensive suite of enterprise BI products that delivers a full range of analysis and reporting capabilities. Featuring a unified, highly scalable, modern architecture, Oracle BI EE Plus provides intelligence and analytics from data spanning enterprise sources and applications—empowering the largest communities with complete and relevant insight.

Oracle BI EE Plus bundles key Oracle Hyperion reporting products for integrated reporting with Oracle’s Hyperion financial applications.


Oracle Business Intelligence Suite Enterprise Edition Plus

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Hyperion Product ComponentsOracle BI Suite Enterprise Edition Plus is a combination of Oracle BI Suite Enterprise Edition and Hyperion product components.

Primary components of Hyperion products:

• Financial Performance Management Applications—A modular suite of integrated applications that support the entire financial management cycle of goal-setting, modeling, planning, monitoring, analysis, and reporting

• Essbase—The business analysis server technology that provides an environment for rapidly developing custom analytic and enterprise performance management applications

• Reporting and Analysis—A suite of tools that enable you to create analytical, financial, and production reports as well as dashboards


Hyperion Product Components

Workspace

Data ManagementData Relat ionship Management

Data Integration Management

Financial Data Quality Management

Performance Scorecard

Financial Management

Strategic Finance

Financial Performance Management Applications

Planning

Shared ServicesFoundation Services

Smart View

Interact ive Reporting

SQR Production Report ing

Financial Reporting

Web Analysis

Reporting and Analysis

EssbaseEssbase

Administrat ion Services

Provider Services

Integration Services

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Data Management—A packaged solution that enables organizations to integrate disparate sources of data across an enterprise, map data, and manage change

• Foundation Services—A single, standardized infrastructure that facilitates the deployment of Hyperion product solutions and simplifies ongoing maintenance

• Workspace—The Web client for Reporting and Analysis, Planning, and Financial Management. It enables you to access and interact with Hyperion-authored content as well as third-party documents, such as Microsoft Word and Excel files

Oracle In

ternal & O

racle Aca

demy

Use O

nly



PlanningPlanning is a Web-based budgeting and planning solution that drives collaborative, event-based, operational planning processes through the organization for a wide range of financial and operational needs. Planners have the flexibility to adapt rapidly to changes in direction, ensuring that plans are always current, relevant, and functional.

Powered by Essbase, Planning uses a multidimensional data structure for flexible data collection and analysis.

Planning also supports driver-based plans that are based on global assumptions, such as interest rates and head count.


Planning

Planning has the following features:Multidimensional data structure Target setting and bottom-up planningIterative planning cyclesComplex business rules and allocationsWeb-based data entry; management of the planning cycleCurrency conversion for multicurrency applicationsHeadcount and salary expense modeling

Metadata and data transfer between Planning applications and other Hyperion products

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Product ComponentsYou use the Planning Web interface to deploy applications to planning organizations. To extend the power and flexibility of Planning, you use it with other Hyperion products.

Product DescriptionEssbase Enables you to store Planning application data (Planning

runs on top of Essbase.)

Administration Services Interfaces to Essbase Server, using Essbase Administration Services Console, and enables you to design, develop, maintain, and manage multiple Essbase applications and databases.

Workspace Enables you to navigate and manage Planning within Workspace

Business Rules Enables you to use a graphical user interface to create calculation scripts


Product Components

PlanningEssbaseAdministration Services

WorkspaceBusiness Rules

Smart View

Financial Reporting

Shared Services

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Smart View Enables you to enter Planning data in Microsoft Excel spreadsheets, using the same functionality as Planning, and to take Planning data offline to work disconnected from the data source

Financial Reporting Enables you to create reports and charts for Web or print for analysis and distribution of budget plans

Shared Services Enables you to provision users from external systems to Hyperion products and to share data and metadata among Planning applications or between Planning and other Hyperion products

Product Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Additional Product ComponentsSeveral complementary Hyperion products are integrated with Planning, completing the Hyperion Business Performance Management solution.

Product DescriptionWorkforce Planning Enables you to handle workforce, salary, and compensation

planning

Capital Expense Planning Enables you to plan for new asset purchases and existing asset actions

Performance Scorecard Enables you to communicate strategy, set goals, and measure and monitor business performance

Strategic Finance Enables you to easily test financial models, create contingency plans, and form alternative strategies


Additional Product Components

Workforce Planning

Capital Expense Planning

Performance ScorecardStrategic FinanceFinancial ManagementWeb Analysis

HyperionSystem 9

Applications

Enterprise Performance Management Solutions

Dashboarding and Scorecarding

Modeling Planning, Budgeting,and Forecasting

Consolidationand Reporting

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Financial Management Enables you to consolidate results, reduce the cost of regulatory reporting compliance, and gain important insights into performance

Web Analysis Enables you to transform data into insightful information through easy-to-use, highly graphical displays and robust analytics

Product Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning ArchitecturePlanning is a multitier application that combines the advantages of Essbase (a multidimensional database) with the advantages of a relational database to optimize performance and maintenance.

Client TierThe client tier contains the administrator client, Workspace, and the Smart View client.

Planning administrators use the client tier to enter data, perform process management, manage users and security, launch business rules, copy versions, develop data forms, and perform other administrative tasks.

In the client tier, you can enter data through spreadsheets by using Smart View.


Planning Architecture

Client

Application

Database

Workspace

Planning RDBMS

Essbase

Administrator Client

Financial Reporting Server

Shared Services, Java Application Server for Planning, EPM

Architect, Administration Services

EPM Architect RDBMS

Smart View Client

EPM Architect Dimension Server

Web Server

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Application TierThe application tier consists primarily of the following servers:

• Financial Reporting server

• Java Application server (for Planning, EPM Architect, and Essbase Administration Services)

• EPM Architect Dimension Server

• Shared Services server

• Web server

Database TierThe database tier consists of a third-party relational database management system (RDBMS) and Essbase. The relational database is used primarily to store the application’s definition. The following information is stored in the RDBMS:

• Application framework*

• Dimensions, dimension members, and properties*

• Exchange rates*

• Member access (security filters)*

• Data form design definitions

• Planning units

• Annotations (planning unit, account, and cell text)

• Supporting details

• Process management workflow status

N O T E

The Web server can be on a separate machine or on the same machine as the Planning application server. The Web server enables you to access Planning applications from a Web client through a Web browser. The Web server uses Hypertext Transfer Protocol (HTTP) as the communications protocol.

N O T E

Items with an asterisk (*) are updated to the Essbase databases during application refreshes.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User RolesPlanning meets the needs of multiple users within an enterprise-wide budgeting cycle. You can set up users with several different types of user profiles to reflect what access is needed.

The following global Shared Services roles are also used in Planning:

• Application Creator— Creates applications. This is a EPM Architect role.

• Dimension Editor — Creates profiles and imports dimensions. This is an EPM Architect role.

• Create Integrations — Creates Shared Services data integrations (the process of moving data between applications) using a wizard.

• Run Integrations — Views and runs Shared Services data integrations.


User Roles

Planning RolesProvisioning ManagerAdministratorManage ModelsInteractive UserPlannerView UserOffline UserMass AllocationEssbase Write Access

Shared Services RolesAdministratorDimension EditorApplication Creator

Oracle In

ternal & O

racle Aca

demy

Use O

nly



EPM ArchitectEnterprise Performance Management Architect (EPM Architect) is a feature set in Planning. EPM Architect enables budget administrators to manage, create, and deploy Hyperion applications within one interface.

Using the Data Synchronization feature in EMP Architect, administrators can create data movement synchronizations between Hyperion applications, create data mappings for reuse, and create flat file and staging area mappings to import data into Hyperion applications.


EPM Architect

Create Metadata— Maintain a centralized collection of metadata for Hyperion products and add

metadata to applications by using the EPMA interface— Load metadata by using flat files or metadata loaded and stored in interface

tables— Build metadata by entering metadata directly into EPM Architect

Manage Applications— Create Planning applications— Create and work with Planning applications and dimensions, Smart Lists,

UDAs, and member formulas

Synchronize data— Synchronizes data flow between Hyperion applications— Automate point-to-point transfer of data

between Hyperion applications— Load data from an external flat file or

a database table into Hyperion applications

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning InterfacePlanning administrators use Workspace to access Planning. In Planning, Planning administrators can provide flexibility and user guidance to budget preparers (planners) by defining user variables and task lists. You can also define data forms for data entry and assign access to the appropriate users and groups.

Budget administrators, budget analysts, and budget preparers can all enter and submit data for review and approval, run business calculations, and enter annotations.


Planning Interface

Manage Planning components— Manage data forms, task lists, user variables,

and Shared Services— Provision users and groups — Assign member access— Copy data (including supporting details)— View statistics and run administration reports

Enter data, supporting details, and annotationsRun business calculationsManage Workflow— Managing the Planning process— Copying data between versions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning and EssbasePlanning uses Essbase to store dimension hierarchies and consolidate data.

When you deploy an application view, EPM Architect creates tables and appropriate values in your Planning relational database, creates an application and outline in Essbase without the need to refresh the cube from within the Planning Interface, and creates the HSP_Rates dimension for multi-currency applications.

Planning stores the application definition in its own relational databases. It uses the definition information to create the necessary Essbase databases and security privileges for your application. The plan data that end users enter in a Planning application is stored in the Essbase databases created for the application.

Prior to application deployment, EPM Architect stores the application data in its own EPM Architect relational database.


Planning and Essbase

Workspace Interface

Java Application Server

Planning Repository

Essbase Server

EPM Architect Repository

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning Repository and EssbaseDimensions and members are stored in the Essbase databases as well as the Planning repository. Data values are stored in Essbase. Some information is stored only in the Planning relational database. For example, planning unit annotations, account annotations, cell text, and supporting details are stored in the Planning relational database. You can report on these annotations and details with Financial Reporting.

Smart list information is stored in both the relational database and the Essbase databases, however, smart list information is stored numerically in Essbase.


Planning Repository and Essbase

EssbaseSecurityMetadataForeign Exchange Rates

DataBusiness RulesRule FilesCurrency Calculation ScriptsSubstitution VariablesSmart Lists (numerically)

Planning Relational DatabaseSecurityMetadataForeign Exchange RatesProcess Management DetailsAnnotations/ Cell Text/ Supporting DetailsTask ListsPreferencesApplication SetupData FormsUser VariablesSmart Lists

Oracle In

ternal & O

racle Aca

demy

Use O

nly



DimensionsDimensions are the structural elements of an application that describe and hold data. Examples of dimensions are Account, Entity, and Period.

The elements that compose a dimension are called members. For example, California and Connecticut are members of the Entity dimension.

The dimensions defined in a Planning application become the dimensions in the Essbase outlines and databases.


Dimensions

Structural elements of an application that describe and hold data.

Account Entity Period

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dimension HierarchiesMembers of a dimension are arranged in hierarchies. Members in a hierarchy exist at different levels. Some members, siblings, are at same level and have relationships to other members of the hierarchy.

Upper-level members are called parent members, and the members immediately below the parent members are referred to as their children. All members below a parent are referred to as descendants. The bottom-level members of a hierarchy are called base-level members.

The graphic on the slide shows a part of the dimension hierarchy of the Account dimension. In this hierarchy, the TotalRevenues member is a child of GrossMargin. Sales and OtherRevenues are children of TotalRevenues and descendants of GrossMargin. Sales and OtherRevenues are also base-level members.


Dimension Hierarchies

Descendants of GrossMargin

ParentChild of GrossMargin; parent of Sales and OtherRevenues

Oracle In

ternal & O

racle Aca

demy

Use O

nly



MetadataMetadata is defined as the structural elements of an application that describe and hold data. Examples of metadata are dimension names, member names, properties, and security.

For the example shown on the slide, the circled dimension member labels are the metadata. The metadata describes what the data value represents. The value for January Actual Final Net Sales for Alliance Merchandise for New York is $3,689.00.


Metadata

January Actual Final Net Sales for Alliance Merchandise in New York is 3689.00.

Data

Metadata

Net SalesActual

Alliance MerchandiseJanuary New York

3689.00

Final

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dimensions and DataData is entered into the base-level members of the dimensions, and not into the parent members, unless you are working with a target version. You use target versions to perform top-down budgeting by setting targets at the parent level. The values for the parent-level members are aggregated from the values of their children when the Planning database is calculated in Essbase.

For the example shown on the slide, the data values from the base-level members are rolled up to the parent-level members. TotalRevenues (+) and TotalCosts (-) are then rolled up to their parent GrossMargin.


Dimensions and Data

Data aggregates to parents based on aggregation options.

+ Add

- Subtract

* Mult iply

/ Divide

~ Ignore

Data is input into base-level members.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Multidimensional View of InformationFor the example shown on the slide, each cube represents a different view of a five-dimensional database. The highlighted portion in each cube indicates the same data value.

Data is represented in multidimensional form, and hierarchies are represented within each dimension. As your analytical needs change, you can switch easily from one to another form of the data.


Multidimensional View of Information

WestSF

LADenver

Sales

Margin

CameraTV

AudioVCR

February MarchActual ActualBudget Budget

CameraTV

AudioVCR

CogsMargin

Total Exp.Profit

TV

VCR

JanFeb

Qtr 1Mar

East WestActual ActualBudget Budget

JanFeb

Qtr 1Mar

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Drill-Down ProcessDrilling down is a specific analytical technique by which you navigate through levels of data, ranging from the most summarized (top) to the most detailed (bottom).


Drill-Down Process

Week

Month

Quarter

Year

Period

New York

East

N America

Worldwide

Entity

Expenses

COGS

Sales

Profit

Account

Dept 10

Sears

Retail

All Customers

Customer

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Essbase Terminology—HierarchiesEssbase uses hierarchical and familial terms to describe the roles and relationships of members in an outline. Within the tree structure of the database outline, a consolidation is a group of members in a branch of the tree.

Hierarchical Term DefinitionOutline Representation of the relationship among the members in the

database

Dimension Perspective on the data being analyzed

Member Discrete component making up a dimension

Attribute Characteristic of a member in an outline

Attribute dimension Dimension tagged as an attribute that contains members that help to describe another dimension in the outline


Essbase Terminology —Hierarchies

Dimensions

Members

Outline

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Essbase Terminology—FamiliesThe following table summarizes the common familial terminology used in Essbase.

Familial Term DefinitionParent Member that has at least one child member immediately

below it

Child Member that has a parent immediately above it

Sibling Child member at the same branch level as another child member with the same parent

Ancestor Any member in a branch above a member

Descendant Any member below a parent


EssbaseTerminology —Families

Year TotalQtr1Qtr2

AprilYear TotalQtr1Qtr2

April

Dimension

Ancestors of April

Descendants of Year Total

Parent of April

Child of Qtr2

Siblings

Period

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Essbase Terminology—Generations and LevelsThe following table summarizes the common generation terminology used in Essbase.

The term generation describes a member’s location within the outline hierarchy from a particular perspective. The generation number identifies the branch on which the member lies in reference to its distance from its dimension name. Generations are counted from the top of their dimension down through their descendants.

Level describes a member’s location in the outline, counting from the bottom to the top. The example on the slide shows a portion of an outline labeled by both generation and level.

Generation Term DefinitionGeneration Position within the hierarchy of a dimension, counted from top to bottom

Level Position within the hierarchy of a dimension, counted from bottom to top

Leaf node Member that has no children


EssbaseTerminology —Generations and Levels

Gen 1Gen 2Gen 3Gen 4

Gen 3

Level 0

Level 1Level 2Level 3

Level 0

Leaf Node

Oracle In

ternal & O

racle Aca

demy

Use O

nly



SummaryIn this lesson, you should have learned to:

• Describe Oracle’s Enterprise Performance Management system

• Describe Oracle Business Intelligence Suite Enterprise Edition Plus

• Describe the main features of Planning

• Describe the product architecture of Planning

• Describe the relationship between Planning and Essbase

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 2

Navigating Workspace 2


• Describe the user interface components

• Access Planning through System 9 Workspace

• Navigate Planning

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 1 Getting StartedLesson 2 Navigating Workspace


System 9 WorkspaceWorkspace provides a centralized interface for viewing and interacting with content created using Hyperion System 9 financial applications, such as Planning and Financial Management, and reporting content.

Workspace provides the following benefits:

• Single user logon: Users log on to Workspace to access both BI+ reporting content and Planning.

• Single console for application management and creation: Users create, manage, and deploy applications from a single location. These applications are opened in Planning for data retrieval and data output.

• Centralized repository of key dimensional elements for Hyperion products

• Centralized console for controlling data flow between applications

• Audit logging and process controls


System 9 Workspace

Workspace

Manage Enterprise Financial Information

BI+ Planning

Hyperion Applications Planning Output

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Workspace OverviewWorkspace provides a single EPM interface to users. From Workspace, you can perform the following tasks:

• Build and manage applications

• Execute planning application tasks

• Perform consolidation application tasks

• Run or view highly formatted financial and operational reports from most data sources, including from Planning and Financial Management

• Conduct high-performance, multidimensional modeling, analysis, and reporting with Analytic Services

• Using Interactive Reporting, generate ad hoc relational queries, self-service reporting, and dashboards against ODBC data sources


Workspace Overview

Manage applications View reports

Work with Planning

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Run high-volume, enterprise-wide reporting for production reporting

• Using Web Analysis, perform interactive ad hoc analysis, presentations, and reporting of multidimensional data

• Generate enterprise metrics for management metrics and analysis and present information in easy-to-use, personalized, interactive dynamic dashboards

• In addition, Workspace provides access to and interaction with other published content, like Word or Excel documents. Access to Workspace menus and toolbar features are based on which roles are assigned to and which modules are provisioned for the user.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Launching WorkspaceYou launch Workspace from a Web browser by using the following Uniform Resource Locator (URL) to display the logon page:

http://<web server>:<port number>/workspace

You can obtain the Web server name and port number from the system administrator.

To launch Workspace:

1. In your web browser, enter the Workspace URL, and press Enter.

The Workspace Logon screen is displayed.

2. Enter your user name and password, and click Log On.

The Workspace user interface is displayed.


Launching Workspace

The password is case-sensitive.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Workspace User InterfaceWorkspace includes the following elements:

Element DescriptionAdjuster Adjusts the size of the view pane and content area

Buttons Navigates between view pane displays

Content Area Displays active-module items, tasks, or files

Document tab bar Displays information specific to the current module

Menu bar Provides commands that organize tasks and modules

Navigate menu Provides access to Workspace modules

Process bar Displays location of the current folder, item, or step


Workspace User Interface

Content AreaViewpane

Buttons

Standard toolbar

Module toolbar

Documenttab bar

Menu barStandard toolbar

Adjuster

Process bar

NavigateMenu

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Standard toolbar Provides shortcuts for performing tasks

View Pane Provides buttons that enable jumps between panels

Element Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Workspace Navigate MenuThe Navigate menu enables you to select to navigate to the different modules available within Workspace. The following table describes the options on the Navigate menu:

Option Description Explore List and navigate through repository content and

manage and control files and folders

Applications Access Hyperion System 9 Planning and Hyperion System 9 Financial Management applications (Applications are displayed only when a user has rights and applications are available.)


Workspace Navigate Menu

To Access EPM Architect modules, select Navigate > Administer

BPM Architect Menu

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Administer > Dimension Library • Manage dimensions from a centralized location• Create dimension import profiles for flat files and

staging areas• Add, delete, and modify dimension members• Modify dimension and member properties

Administer > Application Library • Create Planning, Financial Management, and Essbase applications that are based on Planning and Financial Management dimension sets

• Manage all applications in one centralized location• View the data flow between applications• Migrate applications to different servers

Administer > Data Synchronization • Create data movement synchronizations between Hyperion Applications (For example, an administrator can synchronize data in one Planning application to data in another Planning application. Administrators can also synchronize data from one Financial Management application to data in another Financial Management application and from a Planning application to a Financial Management application.)

• Create data mappings that can be reused• Create flat file and staging area mappings to import

data into Hyperion Applications

Administer > Application Upgrade Upgrade from previous Planning and Financial Management releases

Administer >Library Job Console View a summary of Dimension Library and Application activities, including imports, deployments, and data synchronizations

Schedule Manage jobs and schedule batches and events for automated processing

Impact Manager Update Interactive Reporting documents when database structures, database connections, or links to external data sources change

Administer > Classic Application Administration

Create, delete, and register classic applications.

Option Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Opening ApplicationsIn Planning, all data is processed within applications. An application is a related set of dimensions and dimension members that meet a specific set of analytical or reporting requirements. For example, you can have an application named Test used for development and a separate application named Production to roll out to end users.

To access Planning applications, select Navigate > Applications > Planning, and then select the application that you want to open.

You can select Preferences from the File menu to make the application that is currently open the default application. When you log on, the default application is opened automatically.


Opening Applications

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Navigating in PlanningAfter you access Planning from the Navigate menu, the application displays in a window with a tab at the bottom left. Planning provides several tools for selecting tasks and documents:

• Planning menus

• Planning toolbar

• The View pane

Reviewing Available Menu OptionsYou have access to only those menu options to which you are assigned access based on your user profile. For example, users who are assigned the administrator role have access to all functions on the Administration menu. Users who are assigned the interactive user role have limited access to the Administration menu.


Navigating in Planning

Content Area

Planning toolbarPlanning Menus

Open Application

View Pane

Oracle In

ternal & O

racle Aca

demy

Use O

nly



File MenuThe following table describes the commands under the File menu:

Edit MenuThe following table describes the commands under the Edit menu:

New Add a new document, personal page, data form, report, task list, or user variable

Open Open a new document, application, or URL

Close Close current, others, or all

Save Save data inputted to data forms

Print Print the current screen

Workflow Manage the Planning process or copy versions

Spreadsheet Export Export a data form to a spreadsheet

Preferences Set general, authentication, explore, Web Analysis, Financial Reporting, Interactive Reporting, or Production Reporting preferences

Log Off Log off Planning

Exit Exit Workspace

Adjust Increase or decrease data values by a percentage

Grid Spread Spread data values across multiple dimensions on the gridChoose from allocation options: proportional, 4-4-5, evenly split

Mass Allocate Allocate data values across multiple dimensionsChoose from allocation options: proportional and relational spread, fill, 4-4-5, evenly splitAfter the calculation executes, refresh the grid to see the result of the mass allocation

Allocate data beyond what is displayed on data forms

Cut, Copy, Paste Cut, Copy, or Paste data from one or more cells into one or more cells

Add Row Add rows to a data form on-the-fly, only available if the data form was defined to allow rows to be added dynamically

Launch Rules Launch a Business Rule from a data form

Oracle In

ternal & O

racle Aca

demy

Use O

nly



View MenuThe following table describes the commands under the View menu:

Administration MenuThe following table describes the commands under the Administration menu:

Annotate Planning Unit Add comments to a planning unit; the comment can be plain text, a URL, or paths to servers

Cell Text Add comments to a specific cell at any level in a data form

Lock/Unlock Cells Lock cells to ignore cells when spreading data

Supporting Detail Add detail that will aggregate the cell value in a data form

Initialize Workforce Load predefined dimensions and members, data forms, smart lists, member formulas, business rules, and menus to prepare plans for workforce resources. Members, forms and business rules can be customized.

Initialize Capex Load predefined dimensions and members, data forms, smart lists, member formulas, business rules, and menus to prepare plans for capital expenditures. Members, forms and business rules can be customized.

View Pane Hide or show the View Pane

Refresh Refresh the current view to reflect what is stored in the database

Instructions View instructions for a data form, available only if the data form includes instructions

Currency Look up a currency code

View Account AnnotationsEdit Account Annotations

Enter, edit, or view comments for a specific account, entity, scenario, and version combination

Basic Mode Toggle the view for tasks between Basic Mode and Advanced Mode

Task List View task lists to which you have access; View task status and create a task list report

Manage Data Forms Create, edit, move, delete, and assign access to data forms

Manage Task Lists Create, edit, move, delete, and assign access to task lists

Manage Menus Create and edit menus

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Favorites MenuYou use the Favorites menu to select which favorites to show on the favorites menu.

Tools MenuThe following table describes the commands under the Tools menu:

Manage User Variables Set up variables that are assigned to data forms by specifying the variable’s value

Manage Properties Manage application and system properties

Dimensions Set and change access for dimensions, such as account, entity, scenario, version, and user-defined custom dimensions

Copy Data Copy data, including supporting details, from one planning unit to another

Reporting Print data form definitions, user and group report lists, access assignments for dimensions, and planning unit annotations and process status lists and activate application auditing

View Statistics View information about the Planning application and its usage

Application Settings Set Planning application-wide preferences

Create Application Create Classic applications

Delete Application Delete Classic applications

Register Application Register Classic applications with Shared Services

Copy Document Link Link tasks in task lists to application pages

Manage Models Manage metadata modules by performing version tracking, maintaining access control, and renaming and deleting models

Data Load Administration

Use the Data Load Administration page to set up the data to load directly into an Essbase database through Planning Adapter

Manage Database Create and refresh Essbase databases with changes made to relational databases, such as with exchange rates updates

Manage Currency Conversion

Create currency conversion calculation scripts

Manage Exchange Rates Create and set up exchange rate tables and exchange rates and delete exchange rate tables

Manage Security Filters Create security filters for users

Personalize Show subscribed items and manage personal pages

Links Manage links to other products or URLs

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Help MenuYou can access help on the currently selected task or document.

Planning ToolbarThe toolbar buttons open dialog boxes that you can use to manage documents, task lists, and favorites and provide shortcuts to planning tasks.

The following table describes the buttons on the toolbar:

Install Install Interactive Reporting Web Client and Smart View

Business Rules Launch business rules

Broadcast Message Create and send broadcast messages

Business Rules Status View the status of business rules currently executing

Button Purpose DescriptionNew Document • Create Workspace document

• Collect Reports in a book• Batch Reports for Scheduling

Open Document Open Workspace documents

Home Workspace startup page

Explore Display Workspace Folders in View Pane

Save Save data input on data forms

Refresh Refresh the data form with data stored in the database

Print Print the current screen

Adjust Increase or decrease values by a percentage

Lock/Unlock Cells Lock or unlock cells when spreading data

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Grid Spread Spread data across dimensions on the data form

Mass Allocate Run a Mass Allocate calculation

Cut, Copy, Paste Cut, Copy, or Paste values from one or more cells to one or more other cells on data forms

Cell Text Add comments to a specific cell at any level in data forms

Supporting Detail Add detail that aggregates the cell value in data forms

Spreadsheet Export Export data forms to a spreadsheet

Task List Open task lists if task lists have been assigned to you

Status Check task lists status

Logoff Log off the application

Help Access help for the currently selected task or document

Maximize content pane (on far right of navigation path)

Maximize or restore the content pane.

Button Purpose Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Basic and Advanced ModesSome users’ roles in the budgeting and planning cycle may require that the user only performs only a limited number of tasks and that those tasks be performed in a specified order. Budget administrators and interactive users can set up task lists to help planners navigate through their required tasks.

If task lists are assigned to you, you can choose to work with the task list in either Basic or Advanced mode. Basic mode provides a wizard to guide you through the sequenced steps in the task list. Advanced mode provides the flexibility of working with all Planning functions to which you have access.

When you navigate in Basic mode, you use the view pane to select a task list. The task lists shown in the view pane are those to which you have access. The task list page helps you focus on your predefined tasks. A progress bar and navigation features are displayed to help you move between tasks and monitor your status.


Basic and Advanced Modes

Basic mode limits users to the tasks and documents in the Task Lists to which they have access.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



When you navigate in Advanced mode, you have access to all tasks, through menus and toolbars, to which you are assigned based on your role. You are not guided through a predefined list of tasks; you navigate freely to perform your tasks.

When you switch between modes, you return to the activity that you were performing before you switched. For example, if you are working in a data form when you switch to Basic mode, you are returned to the same form when you return to that mode.

To switch from Advanced Mode to Basic Mode:

1. Select View > Basic Mode.

The View Pane is displayed listing task lists to which you have access.

To switch from Basic Mode to Advanced Mode:

1. Select View > Advanced Mode.

You have all menu functionality for your role and all functionality to which you are provisioned available to you.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



View Pane and Content AreaAfter you open a planning application, you see a View pane and a Content area. What is displayed in the View Pane and Content area depends on what selections you make.

For example, when you work with data form management, the View pane lists form folders, data forms, and business rules. You can use the View pane to navigate from one folder or data form to another. After selecting a specific data form, you see the contents of that data form in the content area.

If you select the launch business rules option from the Tools menu, you see the launch business rules dialog box in the Content area. However, the View pane lists form folders, data forms, and business rules. After you launch business rules, you can use the View pane to navigate away from the launch business rules dialog box and open a data form.


View Pane and Content Area

Business Rules

DataForms

Viewbuttons

View Pane

Content Area

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Opening Data FormsData forms are contained within the folders. After you select a folder, a list of data forms within the selected folder is displayed on the View pane as well as in the content area. Only those forms to which you have access are displayed. You can select a data form from this list. After you select a data form, it is displayed in the content area.


Opening Data Forms

Data Forms

Select Folder

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe the user interface components

• Access Planning through Workspace

• Navigate Planning

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 2

Creating Application Structures 2

OverviewThe aim of this module is to create dimensions and members for a Planning application. First, you identify required and user-defined dimensions. Next, you describe dense and sparse dimensions and basic concepts of data blocks. Finally, you create the dimensions and dimension members for the databases for your Planning application.


• Creating Dimensions Overview

• Managing Dimensions with EPM Architect

• Setting Up the Period, Scenario, and Version Dimensions

• Setting Up the Entity Dimension

• Setting Up the Account Dimension

• Creating User-Defined Elements

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 3

Creating Dimensions Overview 3


• Describe plan types

• Identify required dimensions

• Identify user-defined dimensions

• Describe dense and sparse dimensions

• Describe data block creation

• Set up aggregation, data storage, and calculation options

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 3 Creating Dimensions Overview


Plan TypesAn Essbase database is created for each plan type. Plan types initially are set at the application level. You also select plan types for dimensions and members. You select one database in which to store data. Data values stored in one database are referenced by another databases, by sharing data for those members.


Plan Types

Essbase database created for each plan typeThree customizable plan typesData sharing between plan typesSet plan types for application views, dimensions and members

Budgeting Application

Capex= Plan Type 1 Plan Type 2 Plan Type 3 Workforce

Additional modules available for purchase

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning Dimensions Planning data is stored in Essbase databases. Data storage in Essbase is different from data storage in relational databases. Understanding how Essbase stores and retrieves data is important for designing an application that functions efficiently.

Planning applications are organized by dimension. The dimensions in your application represent the categories of data in your organization. For example, when you enter data in a plan, you must identify what item you are budgeting. Budget items such as travel expense and salary expense are in the Account dimension. You also need to identify the time period for the item, such as current quarter or next quarter, located in the Period dimension.

How you set up dimension properties affects the storage and calculation of information, the efficiency of the database, and the display of information in data forms and reports. You can define aliases for dimension members and select to view either the alias or the member name in data forms and reports.


Planning Dimensions

Planning Repository

Essbase

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Required DimensionsA Planning application has six required dimensions.

Period and YearYou specify a time period and year for each value. Base time periods, such as months, are automatically rolled up to summary time periods, such as quarters and total year. As administrators, you specify base time periods and distribution of weeks in the Period dimension when you create application views. You use the Year dimension to add years to the calendar.

Scenario and VersionThe Scenario and Version dimensions represent the broadest categories of data in your application. Scenario describes the type of data that a plan includes, such as budget, actual, or forecast, as well as the time span that the plan covers.


Required Dimensions

Six Required Dimensions*PeriodYearScenarioVersionEntityAccount

Other DimensionsAliasSmart Lists

*multicurrency applications require two additional dimensionsCurrencyHSP_Rates

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Version allows for flexibility and iterative planning cycles. For example, your application could have two versions, Working and Final, for each scenario. You can also use versions to model possible outcomes based on different assumptions about interest rates, growth rates, and so on. For example, your application can have a Best Case and Worst Case version for each scenario.

EntityThe Entity dimension represents the flow of Planning information through your organization. You can establish an entity for each group or responsibility center that submits a budget plan. These units could be geographic regions, departments, or divisions, depending on your requirements.

AccountThe Account dimension specifies the data to be collected from budget planners. You can establish accounts for all budgeted items to the necessary level of detail. Examples of accounts are Rent Expense and Cash on Hand.

CurrencyYou can plan in one or more currencies. The Currency dimension identifies the currency in which values are displayed. In the Currency dimension, you set up the following categories:

• Which currencies are used by applications and reporting

• How currencies are displayed in reports and data forms

• How currencies are translated into other currencies

• When currency conversions occur

N O T E

For dimension member names and alias names, you can include up to 80 characters, and you must make the name unique across all dimensions. You can include the characters %, &, $, #, (), *, ^, - and _ in the member and alias names. You cannot include \ / : ? < > | in the member or alias names.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



HSP_RatesThis dimension contains a member to store exchange rate values for each currency. It also contains a member for input values and currency overrides.

Alias and Smart ListsIn addition to the required Planning dimensions, you must set up an Alias dimension if you want to assign aliases to dimensions such as Account or Entity. If you want to use Smart Lists in your application, you must set up a Smart List dimension.

N O T E

The system generates the dimension HSP_Rates for multicurrency applications. This dimension is visible only in Essbase.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User-Defined DimensionsIf your organization requires further levels of plan detail than is provided in the Account dimension, you can include user-defined dimensions or custom dimensions. For example, your application can have a group of revenue accounts for revenue planning. It can have a dimension called Customer that you can use with the revenue accounts to budget revenue on a per-customer basis. An application can have up to 14 user-defined dimensions.

Using EPM Architect, you assign valid plan types for user-defined dimensions at the dimension level, not the member level. You cannot delete user-defined dimensions after you create them. You can assign access permissions to members in Planning. You can rearrange the dimension hierarchy, and share members of user-defined dimensions just as you can with other dimensions by using EPM Architect.


User-Defined Dimensions

14 User-Defined Dimensions* For example:

EmployeeProductChannelProjectCustomer

*A Planning application can have a total of 20 dimensions. The number ofuser-defined dimensions available varies between multicurrency andnoncurrency applications.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dense DimensionsMultidimensional databases contain dense dimensions. A dense dimension is a dimension that contains a high percentage of occupied data values in each combination of dimensions. For example, when data exists for an entity, it typically exists for most or all accounts and time periods. Account and Period are typically dense dimensions.


Dense Dimensions

DenseDimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Sparse DimensionsMultidimensional databases also contain sparse dimensions. Sparse dimensions contain a low percentage of occupied data values in each combination of dimensions. Sparse dimensions have these characteristics:

• Data values are not smoothly and randomly distributed throughout the database.

• Data values do not exist for the majority of member combinations in the database.

For example, if each entity sells only to a subset of customers, most combinations of entity and customer have no associated data. Entity and Customer are typically sparse dimensions.


Sparse Dimensions

SparseDimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data Block CreationEssbase stores data in data blocks, rather than in records or rows. You can think of a data block as a grid or spreadsheet with the dimension members on the rows and columns. Data is stored in the cells formed by the intersection of the members of different dense dimensions. For a data block with two dense dimensions, Dimension A and Dimension B, each with five members, 25 cells are created for storing data.


Data Block Creation

Data is stored in data blocks.Data blocks are the cells formed by the intersection of selecteddimension members.

Members of Dimension A

Members of Dimension B

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Determining the Number of Data Blocks in a DatabaseThe dense and sparse settings for dimensions determine the structure of the data blocks and the number of data blocks in the database. The dense dimensions determine the data block structure. A data block always includes all stored members of all dense dimensions. By default, Account and Period are dense dimensions in Planning applications.

The data in a data block is stored at the intersections formed by the members of the dense dimensions. For example, if the Account and Period dimensions are dense, the combination of one time period (January) and one account (Sales) equals one cell of data within a data block.

N O T E

If your application uses currencies, the dense dimension HSP_Rates stores exchange rates.


Determining the Number of Data Blocks in a Database

Period (Dense)

PeriodJan to Dec

Account (Dense)

AccountAccount1Account2Account3

Version (Sparse)

Version1st DraftFinal

Entity (Sparse)

EntityCorp

Each block contains 36 cells= (3 Accounts * 12 Time Periods)

Scenario (Sparse)

ScenarioBudget

Year (Sparse)

Year2007

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Sparse dimensions determine the number of data blocks in a database. There is the potential of having a data block for each unique combination of sparse dimension members. By default, Entity, Scenario, Version, and Year are sparse dimensions. For an application that uses currencies, the Currency dimension is set to sparse.

Consider the simple database shown on the slide. There is potential for two data blocks in the database:

• Corp -> Budget -> 2007 -> 1st Draft

• Corp -> Budget -> 2007 -> Final

The dense dimensions determine the data block structure, and so each data block has 36 cells (3 accounts × 12 time periods).

N O T E

If you add additional dimensions, such as Product or Customer, you can tag them as either dense or sparse. The default is sparse.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Data Blocks and Retrieving DataAfter data is entered in one of the cells of a data block, the data block is created. When data is posted to a cell in a data block, Essbase first checks to see whether the data block exists. If it does not exist, the data block is created. Because data blocks are based on unique sparse dimension combinations, which typically do not have data for all members, this strategy helps reduce database size.

Data is retrieved by data block. If a report or data form requests data from a cell in a data block, Essbase retrieves the entire data block into memory. For example, if a report or calculation requests the value in the cell for Corp -> Budget ->2007 -> 1st Draft -> Account2 -> Feb, Essbase first loads the Corp -> Budget -> 2007 -> 1st Draft data block into memory and then retrieves the value from the Account2 -> Feb cell for this block.


Creating Data Blocks and Retrieving Data

A data block is not created until data is input into a cell in the data block.Essbase checks to see whether the block exists. If a block does not exist, it is created.Data is retrieved by data block.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Determining Data Structure and Performance of Data BlocksThe dense and sparse settings for dimensions determine data structure. The data structure can have a significant impact on data retrieval and calculation time. Although design considerations can vary significantly between applications, follow the general guidelines for performance.

When you view or calculate data, you typically experience the best performance if the cells that need to be calculated or viewed are in the same data block.


Determining Data Structure and Performance of Data Blocks

Performance is typically best if the cells that need to be calculated or viewed are in the same data block.Considerations for dense and sparse settings apply to calculations.The number of cells in a data block grows exponentially as densedimensions are added to the data base.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting Aggregation, Storage, and Calculation OptionsThere are a number of factors that impact calculations in a database. You set up aggregation, storage, and calculation options to define how data is calculated. Aggregation options determine whether data is added, subtracted, multiplied, divided, ignored, or treated as a percentage. Storage options define whether data is stored or calculated when requested. Understanding the order in which the calculations are performed is important. This order has an impact on calculation results.


Selecting Aggregation, Storage, and Calculation Options

Aggregation involves defining calculations based on relationships in the hierarchy.Storage options define how data is maintained in the database.Calculations are performed in a specified order.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting Aggregation OptionsYou define calculations within dimension hierarchies using aggregation options. Aggregation options determine how values of child members are aggregated to the parent value.

For example, Sales and COGS might be children of the member Net Income. If you set the aggregation option for the Sales member to addition and the aggregation option for COGS to subtraction, then the aggregated value for the Net Income member represents the Sales member minus the COGS member.

N O T E

Because dimension members can belong to more than one plan type, you can specify different aggregation options by plan type.


Selecting Aggregation Options

Define calculations in the hierarchy based on parent-child relations.Aggregation options — + Addition— - Subtraction— * Multiplication— / Division— % Percentage— ~ Ignore

Net IncomeSales (+)COGS (-)

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting Data Storage OptionsYou select from several storage and calculation options for dimension members to optimize performance and disk usage. The following table describes these options:

StoreData Stores data values of members. This is the default value for all members.

DynamicCalcAndStore Calculates the data value the first time the member is retrieved and then saves the value.

DynamicCalc Calculates the data values each time the member is retrieved. The value is not stored in the database.

Share Data Allows two or more members in the same dimension to share data values.


Selecting Data Storage Options

Use storage options to optimize performance and disk usage.Storage options— StoreData (default)— DynamicCalcAndStore— DynamicCalc— ShareData— NeverShare— LabelOnly

Oracle In

ternal & O

racle Aca

demy

Use O

nly



DynamicCalcAndStoreWith DynamicCalcAndStore, on the first retrieval, the data value is calculated and then stored. Subsequent retrievals use the stored value. The DynamicCalcAndStore option is used infrequently. In most cases, you can optimize your calculation and lower disk usage by using DynamicCalc when you calculate members of sparse dimensions. Use DynamicCalcAndStore for members of sparse dimensions in the following situations:

• A sparse member with a complex formula

• A sparse member that users retrieve frequently

For members of dense dimensions, use Dynamic Calc for calculations. Using Dynamic Calc and Store increases retrieval time and regular calculation time. In addition, disk usage is not lowered significantly.

DynamicCalcIf a member is set to DynamicCalc, Essbase does not calculate its data value during regular database calculation; for example, when the CALC ALL function is executed, Essbase calculates the data value upon retrieval; a specific example of this is data being calculated when it is retrieved into a data form.

Advantages of DynamicCalc:

• Reduction in the regular calculation time of the database because Essbase has fewer member combinations to calculate.

• Reduction in disk usage because Essbase stores fewer data values. Database size and index size are reduced.

DynamicCalc is most useful for parent-level dense dimension members. Since values for DynamicCalc members are not stored, the data block size is reduced, which improves performance. However, retrieval time for the member is increased.

DynamicCalc should be used sparingly with sparse dimension members. Because each member of a sparse dimension references a separate data block, a dynamic calculation that includes many sparse members must retrieve data from a large number of data blocks. Retrieving data from many data blocks can reduce performance. As a rule of thumb, use DynamicCalc for upper-level members of sparse dimensions only if those upper-level members have six or fewer children.

NeverShare Prohibits two or more members in the same dimension from sharing a data value.

LabelOnly Has no data associated with the member.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



DynamicCalc guidelines:

• Do not use DynamicCalc for base-level members for which users enter data. Data values are not saved for DynamicCalc members.

• Do not use DynamicCalc for a parent member if you enter data for that member in a target version. Parent members set to DynamicCalc are read-only in target versions.

• Do not set a parent member to Stored if its children are set to DynamicCalc. With this combination, when a user saves and refreshes a data form, the new total for the parent is not calculated.

ShareData and NeverShareUse ShareData when you want to allow for alternate rollup structures. You can set members within the same dimension to share data values, enabling alternate rollup structures within the application. For shared members, you must set the data storage to Share Data so that the shared member is added when the Application View is deployed.

Use NeverShare when a parent has a single child that aggregates to the parent. In this case, set the parent to NeverShare. You can set appropriate security to the child member. Typically, you set the currency, entity, version, and any custom dimensions to NeverShare. Members within the currency, entity, version, and any custom dimensions are not set to NeverShare, and typically are set to either StoreData or DynamicCalc.

LabelOnly Data Storage LabelOnly members are virtual members; they are typically used for navigation and have no associated data. For example, you might have a parent member named Statistical that groups statistical accounts such as Headcount and Interest Rate. Because these accounts do not aggregate to a meaningful total, there is no need to calculate or store a value for the member Statistical.

Making a dimension member LabelOnly helps minimize database space by decreasing block size, which improves performance. LabelOnly members can also be used to group members or to navigate and report more easily from Financial Reporting or Essbase Smart View Provider.

LabelOnly guidelines:

• You cannot designate level 0 members as LabelOnly.

• Even though a Label Only member has no data associated with it, it can still display a value. A parent member set to LabelOnly displays the value of its first child member.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• In single-currency applications, LabelOnly is the default data storage type for all root dimensions. In multicurrency applications, LabelOnly is the default data storage type for HSP_Rates, Account, Period, Year, and Scenario.

• You cannot assign attributes to LabelOnly members.

• In multicurrency applications, you cannot apply the LabelOnly storage option to members of the following dimensions: Entity, Version, Currency, and user-defined dimensions. If you want to store exchange rates, you must set them to NeverShare.

• The data storage option for children of LabelOnly parents is set to StoreData by default.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculating DataThe calculation order in Essbase can affect the result of a calculation. Essbase calculates the Account members first, the Period members second, and the remaining dimensions according to their order in the database outline. Sometimes the calculation for a member in one dimension depends on the calculated result of a member or members of a dimension that is not calculated until after the first dimension. You can assign the Two-Pass Calculation option to a member in such situations. After Essbase calculates the database, a second pass calculates members tagged Two-Pass Calculation.


Calculating Data

Essbase calculates the outline in the following order:1. Account dimension2. Time dimension3. Other dense dimensions in top-down order4. Other sparse dimensions in top-down order 5. Members that are tagged as Two-Pass Calculations

Calculated Data (After Two-Pass)

1st Pass 2nd Pass

Calculated Data (Before Two-Pass)

Level 0 Data

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Using Two-Pass CalculationsA good example of two-pass calculation is the calculation for the Margin Percent account for North America. That calculation depends on the aggregated value of the Gross Margin and Net Revenue accounts (Margin Percent = Gross Margin / Net Revenue). Since the Entity dimension is calculated after the Account dimension, the aggregated values are not available. To calculate Margin Percent correctly, Essbase must first aggregate the values for the children of North America to derive the totals for Net Revenue and Gross Margin. After these totals are calculated, a second pass is needed to calculate the Margin Percent account for North America. To accomplish this task, you select the Two-Pass Calculation option for the Margin Percent account.

The Two-Pass Calculation option is used primarily for members of the Account dimension. For other dimensions, the Two-Pass Calculation option is valid only for Dynamic Calc or Dynamic Calc and Store members.


Using Two-Pass Calculations

Before Two-Pass

After Two-Pass

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Determining Performance EfficiencyIn a data form in which there is only one member from each sparse dimension, Essbase must retrieve only one data block to populate the form. Because the Account and Period dimensions are dense, the cells for the account and time period members are already in that data block.

If the Period dimension were tagged as sparse, data would need to be retrieved from 17 different data blocks to populate the form, 17 members of Period are displayed, resulting in less efficient performance. Considerations for dense and sparse settings apply to calculations.

For example, a typical calculation in the Account dimension is Net Profit = Gross Sales - Cost of Goods Sold. If Account is tagged as a dense dimension, the data block includes the members needed for this calculation. If it is tagged as a sparse dimension, data must be retrieved from three data blocks to perform the calculation.


Determining Performance Efficiency

SparseDimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Another important factor for performance is the number of cells per data block. Because there is a multiplier effect between dense dimensions, the number of cells in a data block grows exponentially when dense dimensions are added to the database.

For example, your database might have 200 account members and 12 period members, resulting in 2,400 cells. If the HSP_Rates dimensions is added as a dense dimension with 10 members for currency rates, the number of cells jumps to 24,000 (200 × 12 × 10). As a general rule, smaller data blocks give better performance than larger data blocks.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe plan types

• Identify required dimensions

• Identify user-defined dimensions

• Describe dense and sparse dimensions

• Describe data block creation

• Describe aggregation, data storage, and calculation options

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 4

Managing Dimensions with EPM Architect 4


• Describe EPM Architect

• Navigate EPM Architect

• Create dimension members

• Manage dimensions

• Modify member properties

• Set up alias tables

• Add and modify currencies

• Create property associations

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 4 Managing Dimensions with EPM Architect


About Dimension Management You can view, manage, create, and deploy Hyperion applications within a single interface, the Dimension Library. The Dimension Library has two types of views—Master View and Application View.

Master ViewMaster View is a central repository that contains all dimensions and dimension members for Planning and Financial Management applications. All dimensions and dimension members are created in Master View or imported into Master View. Master View can contain more than one dimension of the same type. For example, it could contain two Period dimensions, with the names Quarterly Calendar and Trimester Calendar, that are used in different Planning applications.


About Dimension Management

Master view pane

Application view pane

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To Work in the Master View:

1. Select Navigate > Administer > Dimension Library.

Application ViewAn application view represents a selection of dimensions required by an application. You cannot create dimensions or dimension members in application views. Instead, you create them in Master View and then assign them to application views.

To Work in the Application View:

1. Select Navigate > Administer > Application Library.

2. Right-click on an application view, and select Edit.

The application view is displayed.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



EPM Architect ProcessYou manage dimensions and create Planning applications in EPM Architect:

1. Add dimensions to Master View. You can import them from formatted flat files, or you can create them manually in the dimension editor.

2. Create application views for Hyperion applications by selecting application types and assigning dimensions.

3. Create Planning applications by deploying application views with the Planning type to Planning application servers.


EPM Architect Process

1. Import from flat file into Dimension Library Master View

2. Create application views

3. Deploy application views from Dimension Server to product application servers

MasterViewAccountsEntityBudgetingEntityConsolPeriodsStandardPeriodsTrimesters

!Members‘Name, MemberValidForPlan1;TimeBalanceTravel;Y;FlowNew Computers;Y;Balance

FM Consol Application ViewAccountsEntityConsolPeriodsStandard

Budgeting Application ViewAccountsEntityBudgetingPeriodsTrimester

DimensionServer

Financial ManagementApplication Server

PlanningApplication Server

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Dimensions to Master ViewYou can add dimensions to the Master View. Dimension names must be unique and can contain up to 50 characters (including spaces).

To add dimensions to Master View:

1. Select File > New > Dimension.

The Add New Dimension dialog box is displayed.

2. Enter a dimension name.

Dimension names must be unique and can contain up to 50 characters, including spaces.

3. Optional: Enter a description.


Adding Dimensions to Master View

Dimension class

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. In the Type drop-down list, assign a dimension class to determine the properties that are available to the dimension members.

• Account

• Entity

• Generic (custom Planning dimension)

5. Click OK.

T I P

After you have added a dimension to Master View, you can copy the dimension or delete the dimension by right-clicking the dimension and selecting Copy or Delete from the menu.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Organizing DimensionsYou can organize dimensions by creating folders and copying or moving the dimensions into the folders. Dimensions can exist in more than one location. For example, you can organize dimensions and have the Account dimension exist in multiple folders or have the Account dimension exist at the highest level and also within a folder. You can rename folders.

You can move dimensions. You can drag dimensions to move them from their original location into a folder. You can move multiple dimensions at the same time by using the [ctrl] key to select more than one dimension to move.

You can delete folders that you create in the Dimension Library. When deleting folders, you have two options: 1) to delete only the folder, or 2) to delete the folder and content.


Organizing Dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To create folders:

1. In Master View, select File > New > Folder.

The Create New Folder dialog box is displayed.

2. Enter the name and description, and then click OK.

To copy dimensions into folders:

1. In Master View, right-click the folder and select Add Dimensions.

The Add Dimensions to Folder dialog box is displayed.

2. Perform one or more actions:

• Enter the name of the dimension to add or enter a wildcard, such as A* to add all dimensions beginning with an “A”.

• Using the [Ctrl] key, select one of more dimensions in the list.

• Enter the name or group that owns the dimension.

• Click OK.

To delete folders:

1. Right-click the folder, and select Delete and one of the following options:

• Only Folder

• Folder with Content

2. At the confirmation dialog box, click Yes.

3. Click OK to confirm.

N O T E

If you select the option to delete only folders, then only the folders are deleted. Any dimensions within the folder are not deleted and sub-folders are not deleted. Those dimensions and sub-folders are moved to the root of the Dimension Library. If you select to delete only a sub-folder, then only the sub-folder is deleted. Dimensions are not deleted, rather they are moved to the root folder.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Filtering DimensionsYou can filter the dimensions you see in the Dimension Library. Filtering only applies to dimensions, and not folders.

To filter dimensions:

1. Select View > Filter Dimensions.

The Dimension Filtering dialog box is displayed.

N O T E

If you create a dimension and have a filter applied that does not include the new dimension, the dimension will not display in the Master View until you remove the filter.


Filtering Dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



2. Enter the name, select the type, or enter the name of the user or group who owns the dimensions.

3. Click OK.

A filter icon is displayed in the Master View pane indicating that dimensions are filtered.

You can only filter dimensions in the 'root' Dimension Library. Dimensions in folders are not filtered.

T I P

You can remove filter criteria by selecting Edit > Clear Filter Criteria.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Sorting Dimensions and FoldersYou can sort dimensions and folders in ascending or descending order. You can sort by dimension class, name, description, or owner. When dimensions are sorted, a sort icon is displayed in the Master View pane.


Sorting Dimensions and Folders

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating MembersYou can add members to dimensions in the Dimension Library.

To add members to dimensions:

1. In the dimension hierarchy, right-click a member.

2. Select Create Member.

3. Select an option:

• Select As Child to add a member below the selected member

• Select As Sibling to add a member at the same level as the selected member

4. In the New Member dialog box, enter a name.

5. Click OK.


Creating Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Guidelines for Member NamesMember names can be up to 50 characters in length. Certain character cannot be used in member names for Planning applications.


Guidelines for Member Names

Period (.)Plus sign (+)Minus sign (-)Asterisk (*)Slash (/)Number (#)

Braces ({})Comma (,)Semicolon (;)At (@)Quotations (“)

Member names cannot contain these characters:

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Modifying Member PropertiesYou can modify properties for each dimension member. When the dimension is created, it takes on a default set of properties and property values. Properties are organized into categories based on the Hyperion products for which they are valid.

Property Category ApplicationPlanning Used for Planning applications

System Identify characteristics of a member, such as name, description, and if the member is inactive

Consolidation Used for Financial Management applications

Essbase Analytics Used for Oracle's Hyperion Essbase System 9 reporting cubes only


Modifying Member Properties

Save

Defined

Default

Property category

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Property fields are color-coded based on what is done with that property. Consider the following characteristics when working with properties:

• Properties that can be modified display a white background.

• Properties that are read-only display a grey background.

• Modified properties change to yellow.

Modified properties, called defined properties, are not saved until you click the Save button in the upper-right corner of the properties pane. Defined properties display the following icon: .

Unmodified properties display a check mark.

Enterprise Analytics Used for Essbase reporting cubes

Statistical Provide statistical information about a member such as number of children and number of siblings

Property Category Application

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Property Value InheritanceInheritance allows high-level members to share their properties’ values with lower points in the hierarchy. It allows new members to automatically obtain their property values from the appropriate ancestors. Proper use of inheritance enhances the referential integrity of your application and reduces maintenance requirements.

EPM Architect determines a property value in the following order:

1. EPM Architect looks for a value entered at the member. If a user directly entered a value at the member, that value is used.

2. If a value does not exist, EPM Architect searches the ancestors of the member for a value. The first entered value that EPM Architect finds by moving up the ancestral tree is used. Thus, a change to the properties of an ancestor can affect descendant members that inherit its value.

3. If no ancestor has an entered value, the system default value for the property is used.


Property Value Inheritance

Descendant members inherit property values from ancestors.Updating the property value for an ancestor automatically updates the value for its descendants.Modifying a property of a descendant directly prevents it from inheriting that property from an ancestor.

Currency propertyis set to Euro

Descendants of Europe inherit Euro as value for Currency property

Currency property is set to GBP, overriding inherited value

Descendants of United Kingdom inherit GBP for Currency property

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Managing Property Value InheritanceEPM Architect provides the following options for managing inherited properties:

• To clear a property value for an individual member, so that it reverts to the value inherited from its nearest ancestor, right-click the property for the member and select Remove Value.

• To clear all property value overrides by descendants, so that all descendants revert to the value set at the ancestor level, right-click the property at the ancestor level and select Remove Descendant Values.


Managing Property Value Inheritance

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Alternate RollupsYou can create multiple rollup paths for your data by placing a child member under more than one parent. In the slide illustration, EastSales and WestSales are members of a geographical rollup, with Geographical as the top member, and a functional rollup, with Activity as the top member.

A member has the same property settings under all parents in which it occurs, with one exception. One member has the property StoreData. Any additional members have their property storage set to ShareData. Editing the properties of the stored member under one parent updates it properties for all parents.

To place a member in an alternate hierarchy, you use the menu to copy the member and paste it to the new location.


Creating Alternate Rollups

EastSales and W estSales occur in alternate rollupsEntity

[None]

Activity

Ge ographical

SalesServices

WestSales

Manufacturing

EastSales

EmeaSales

Emea Services

D evelopme nt

Entity

[No ne]

United Sta tes

Geo graphical

C alifornia

Plant1

Activity

WestSales

C onnecticut

Ea stSales

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Managing MembersYou can change the order in which a member is displayed under a parent or move a member to another parent. You can delete a member from a single hierarchy or from all hierarchies.

Moving MembersYou can move a member to a new location in the hierarchy:

• To change the order in which children are displayed under a parent, drag members to another location.

• To move a child to another parent, right-click the member and select Cut. Right-click the member that you want as the new parent, and select Paste > As Child.


Managing Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Deleting MembersYou can delete members from the current hierarchy only or from the dimension. When you delete a member from the dimension, the member is removed from all hierarchies in Master View and from all application views.

• To delete a member from a hierarchy, right-click the member and select Remove Member.

• To delete a member from the dimension, select the member in any hierarchy in Master View, and select Delete Member.

Renaming MembersYou can rename members in the Dimension Library. You cannot rename system members. For Planning members, you cannot rename Currency or Year members.

Reordering ChildrenYou can reorder children in the Dimension Library.

To reorder children:

1. Right-click a dimension or member that has children, and select Reorder Children.

The Reorder Children dialog box is displayed.

2. Click on the up or down arrows to change the order of the children.

3. Click OK.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Inserting Members Using RelationshipsYou can insert a group of members into a hierarchy based on a member relationship. For example, you could insert all base members beneath a selected parent member into an alternate hierarchy.

To insert members using relationships:

1. Right-click a member that you want as the parent or sibling of the inserted members, and select Insert Member.

2. Select an option:

• Select Child to add the member as a child of the currently selected member.

• Select Sibling to add the member at the same level as the currently selected member.


Inserting Members Using Relationships

Oracle In

ternal & O

racle Aca

demy

Use O

nly



3. In the Insert member dialog box, select a member.

4. Right-click the member, and select an option:

5. Optional: Select Inclusive to include the selected member.

For example, if you select the Inclusive option with the Children option, the selected member and its children are inserted into the hierarchy.

Option To insertMember Selected member

Children All children of the currently selected member

Descendants All members below the currently selected member

Siblings All siblings of the selected member (Siblings are members that have the same parent member.)

Parent Parent of the currently select member

Ancestors All members above the currently selected member

Level 0 (Base) All base members beneath the currently selected member

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Finding MembersYou can search for members in the Dimension LIbrary.

To find members:

1. Right-click a dimension, and select Find Members.

2. Select to search by the member: Name, Alias, or Property.

3. Enter the value.

4. Select an option to view the results:

• List View —replaces the Properties Grid and lists all members in the Member Find pane.

• Navigation Button —displays the first member in the Master View pane. You can use navigation buttons on the Standard toolbar to move to the next or previous member.


Finding Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Click OK.

• Close the Member Find dialog box.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating AliasesIf you want to improve outline and report readability, you can assign one or more alternate names, or aliases, to dimension members. Aliases enable you to create unique sets of identifiers when working with dimensions and members. You can assign up to 10 aliases per dimension and dimension member, including the default alias. You create alias tables in EPM Architect by creating an Alias dimension and then adding members to that dimension.


Creating Aliases

Create table

Association

Oracle In

ternal & O

racle Aca

demy

Use O

nly



For example, you can set up alias tables to store information for different languages. If you want to include account names in English, French, and German, you create members in the Alias dimension named English, French, and German. Then you create an association between the Alias property in the base dimension and the alias dimension. In addition to associating aliases to the Account dimension, you can create associations with the Entity, Scenario, Version, Period, or Year dimensions or user-defined dimensions.

To create alias tables in the Dimension Library:

1. Select File > New > Dimension.

2. In the Add New Dimension dialog box, enter the Name and Description of the alias table.

3. Select Alias from the Type drop-down list.

4. Click OK.

To create members in the Alias dimension:

1. Right click Alias and then select Create Member > As Child.

2. Type the Name for the alias table, for example German.

3. Click OK.

To add aliases to dimension members:

1. Select the dimension member.

2. Double-click in the Alias field of the property grid.

3. Click the ellipsis button and enter aliases in the row representing the alias table.

N O T E

For Planning, you must include an Alias member named Default.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding CurrenciesYou set up currencies by creating a dimension with the dimension class Currency. You create members in the Currency dimension for each currency needed in your application.

Number FormattingYou can set the number format for each currency. For example, for the European euro, you can set the dot as the thousands separator and the comma as the decimal separator to match the European standard. You can also set the color of negative numbers.

N O T E

A dimension association is required between the Base Currency property of the Entity dimension and the Currency dimension.


Adding Currencies

Oracle In

ternal & O

racle Aca

demy

Use O

nly



ScalingYou can specify that data values are scaled when they are displayed in certain currencies. For example, you might set the scaling for the Japanese yen to thousands. You could enter 10,000 as a value for Japan. When you select Japanese yen as the display currency, the scaling is applied and 10 is displayed as the value for Japan.

TriangulationPlanning supports currency conversion by triangulation through an interim currency, which is referred to as the triangulation currency. For example, if you know the European euro exchange rates for U.S. dollars and French francs, you can calculate the U.S. dollar/French franc exchange rate by using the European euro as the triangulation currency.

You can also modify a currency’s triangulation currency by reentering the exchange rates relative to the triangulation currency period and then refreshing the application so that the new exchange rates are transferred and stored.

Reporting CurrencyPlanning supports currency conversion from local currencies to one or more reporting currencies. The converted reporting currency values are stored and are read-only for all users. The application default currency is also the default reporting currency. When you add currencies, you specify whether they can be used as reporting currencies.

For example, suppose your application contains the currencies Japanese yen, U.S. dollar, and European euro, with European euro specified as a reporting currency. When you create data forms and reports, Japanese yen and U.S. dollar values are converted to European euros and displayed.

You can load values directly into Essbase (from historical scenarios, for example) for reporting.

N O T E

You cannot select the default currency as a triangulation currency.

N O T E

Each reporting currency is added to the Currency dimension, increasing the size of the database and adding complexity to the currency conversion calculation scripts. Only enable Reporting Currency if required.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Associations Between DimensionsYou can associate a property in one dimension with the members of another dimension so that end users can set the value for the property by selecting from a pick list of members from the associated dimension.

For example, if you create an association between the Currency property of the Entity dimension and the Currency dimension, users can set the Currency property of an entity member by selecting from a pick list of members in the Currency dimension.

After you create an association for a property, users must select a member from the pick list to set the property value; no other entries are valid.


Creating Associations Between Dimensions

Ellipsis indicates that an association exists.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can create an association for any dimension property, but some dimension properties require that a dimension association be created. Values cannot be entered for these properties until an association exists. The following table shows the properties that require an association:

Dimension Type Properties Requiring AssociationsAccount Alias

Entity AliasAttributeCurrency

Scenario AliasStart PeriodEnd PeriodStart YearEnd Year

Version Alias

Currency Alias

Period Alias

Year Alias

Smart Lists Alias

Generic AliasAttribute

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe EPM Architect

• Navigate EPM Architect

• Create dimension members

• Manage dimensions

• Modify member properties

• Set up alias tables

• Add and modify currencies

• Create property associations

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 5

Setting Up the Period, Scenario, and Version Dimensions 5


• Describe Planning time periods

• Customize time periods

• Create scenarios

• Create versions

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 5 Setting Up the Period, Scenario, and Version Dimensions


Time Periods OverviewWhen creating application views, you add the Year and Period dimensions to represent time. You use the Period dimension to view and change the yearly calendar rollup structure, and you specify base time periods and distribution of weeks. You use the Year dimension to add years to the calendar.

After creating the application view and setting the calendar, you cannot change base time periods or reduce the number of years. You can, however, change the rollup structure of the Period dimension. You can also add more years to the Year dimension.

You can customize summary time periods in these ways:

• Update the name

• Change the description

• Modify starting and ending periods

• Change the range


Time Periods Overview

The Year and Period dimensions represent time.You can:

Add yearsCreate new summary time periods or change the name of summary time periodsAdd or change the aliasesAdd up to 100 calendar years and 500 time periods to an application

You cannot: Modify the Start Year after the application is deployedReduce the number of years without creating a databaseChange the base time periods

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Create new summary time periods

• Add or change the aliases

If you create new summary time period, you must work from the top of the hierarchy to the bottom. The Period Type property for a summary time period is Summary Time Period.

Keep in mind the following requirements:

• All base members must be the same number of levels from the root.

• Base members must have a Period Type property value of Base Time Period.

• The BegBalance member is a required member for Planning applications and must exist for successful deployment.

• The YearTotal member is a required member for Planning applications and must exist for successful deployment.

• The YearTotal member must have a Period Type property value of Year Time Period.

You can add up to 100 calendar years and 500 time periods to an application. Depending on the number of time periods and years and whether your application uses multiple currencies, Hyperion recommends these practical limits:

• 400 time periods per year and 27 years

• 360 time periods per year and 30 years

You can enable Dynamic Time Series (DTS) for Period dimension members. For DTS members, you can set the following properties: DTS Enabled, DTS Generation, and Alias.

N O T E

You cannot skip or change the order of base time periods. You cannot extend the range beyond the current fiscal year.

N O T E

The YearTotal member is the summary time period that aggregates all quarters or weeks (for custom time periods).

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can create alternate hierarchies and use shared descendants in the Period dimension. Data Storage for all time periods can be set to any valid Data Storage value. The Consolidation operator for all scenarios, versions, and time periods (including BegBalance) can be set to any valid consolidation operator. For example, it can be set to + instead of ~ (ignore).

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Period and Year DimensionsThe Year dimension contains a member for each year in the range of years for the application. The member identifies the year to which the data applies.

The Period dimension is populated with base time periods for the application and is tagged with the Time property in Essbase. When used in combination with the Account dimension, a time dimension has properties that enable you to control how data accumulates over time for an account.

The slide shows a typical example of a Planning data form, with Year FY07 in the point of view and months and quarters in the columns. The Essbase outline displays the years and time periods.


Period and Year Dimensions

Year Period

Year

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dynamic Time Series MembersYou can use Dynamic Time Series (DTS) members to create reports that show period-to-date data, such as quarter-to-date expenses. DTS members can be used with members of the Period dimension. You can enable DTS for members, and assign a generation number. For example, to calculate quarter-to-date values, you can enable the Q-T-D member and associate it with generation number 2. You can then use the Q-T-D DTS member to calculate monthly values up to the current month in the quarter.


Dynamic Time Series Members

Day-to-dateD-T-D

Week-to-dateW-T-D

Month-to-dateM-T-D

Quarter-to-dateQ-T-D

Period-to-dateP-T-D

Season-to-dateS-T-D

Year-to-dateY-T-D

History-to-dateH-T-D

DescriptionPredefined DTS Member

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up Dynamic Time Series MembersThe DTS members provide up to eight levels of period-to-date reporting. Your data and database outline determine which members you can use. For example, if the database contains hourly, daily, weekly, monthly, quarterly, and yearly data, you can report day-to date (D-T-D), week-to-date (W-T-D), month-to-date (M-T-D), quarter-to-date (Q-T-D), and year-to-date (Y-TD) information. If the database contains monthly data for the past 5 years, you can report year-to-date (Y-T-D) and history-to-date (H-T-D) information, up to a specific year. If the database tracks data for seasonal time periods, you can report period-to-date (P-T-D) or season-to-date (S-T-D) information.

You can import DTS members from .ads files, or add them manually to Application Views. After you add DTS members, you must enable them by selecting members and setting these options in the Properties Grid: DTSEnabled, DTSGeneration, and Alias. (Setting the DTS properties for non-DTS members has no effect.) Additional Period properties are not applicable to DTS members.


Setting Up Dynamic Time Series Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Follow these guidelines for using DTS members with Performance Management Architect:

• DTS members must be level 0 members and children of the root member (such as Period).

• The PeriodType property for DTS members is Dynamic Time Period.

• For members enabled as DTS, a DTSGeneration must be selected.

• If you are using Y-T-D, the Year dimension cannot be named Year.

• If you are using P-T-D, the Period dimension cannot be named Period.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Choosing How Data Is StoredBy default, when new members are added to an outline, they automatically store data in the Essbase database. In some cases, data for a member does not need to be stored in the database. By decreasing the number of members that store data, you can improve the performance of your application. You can specify whether data is stored for a member by using Essbase storage options (see screenshot in slide).

For most applications, setting the summary time periods in the Period dimension to Dynamic Calc results in improved performance.

You can change storage options by setting member properties in the application view. Alternatively, you can use the Administration Console to set storage options.


Choosing How Data Is Stored

The storage type for a member has a major impact on the size and calculation performance of your database.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Scenario DimensionYou can use the Scenario and Version dimensions to create individual plans. You create the Scenario and Version dimensions to set up individual plans to be reviewed and approved. For each entity, the scenario and version combination contains its own set of data for the accounts and other dimensions.

After entering entity data for a scenario and version, you can submit or promote the data to other users for review and approval. The intersection of entity, scenario, and version is referred to as a planning unit. Planning tracks the status or planning units as you move them through the planning process.

Scenarios enable you to:

• Apply different planning methods• Associate different scenarios with different time periods and exchange rates• Create forecasts and budgets


Scenario Dimension

The Scenario dimension specifies a data classification.

Actual Budget Forecast

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Enter data into scenarios• Assign user access rights by scenario• Report by scenario• Compare and analyze different scenarios

Creating scenarios enables you to group your data into separate plans with their own review cycles. Scenarios can also cover different time spans. For example, your organization might create one-year and three-year revenue plans that are prepared by different users and follow different review paths. For this purpose, you could create two scenarios, Current Year Revenue and 3Year Forecast.

You can create hierarchies and use shared members in the Scenario dimension. Scenarios are required for Planning applications, and must exist for successful deployment.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating ScenariosWhen you create a scenario you define these properties:

• Enable Process Management

• Start and End Years and Periods

• Exchange Rate Table

• Use Beginning Balance

• Access rights

Enable Process ManagementIn EPM Architect, select Enable Process Management if you want to include this scenario in process management. If you select this check box, this scenario is displayed in the scenario drop-down list on the Check Status and Manage Process page.


Creating Scenarios

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Time PeriodsIn EPM Architect, you assign each scenario a range of years and time periods for which it is valid. The range of time periods you select for a scenario has the following effects in your application:

• When you access a data form, you are able to enter data into that scenario for only the years and time periods within the range. Years and time periods outside the range are displayed as read-only.

• When you generate a currency conversion calculation script, the calculation script converts currencies for the range of time periods that are valid for the scenarios selected for the script.

You can modify the time range of scenarios as needed to allow for continuous planning. For example, you might have a scenario named 3Year Forecast that has 2007 as the start year and 2009 as the end year. At the beginning of the 2008 fiscal year, you could change the start year to 2008 and the end year to 2010, so that you can enter forecast data for 2010.

Exchange Rate TableIf your application uses currency conversion, you assign an exchange rate table to the scenario in EPM Architect. By assigning different exchange rate tables to scenarios, you can model the effect of different assumptions on your business. You must consider currency reporting needs when deciding which scenarios to create. For example, you may need to create scenarios associated with different exchange rate tables to eliminate the effects of currency rate fluctuations from variances (such as Budget at Actual Rate).

Use Beginning BalanceSelect Use Beginning Balance in EPM Architect as a time period option if you want to include the BegBalance time period in this scenario for currency conversion.

Access RightsYou can specify access permissions for Scenario dimension members to determine whether groups or users can view or modify data. A user or group can have only one of the following access rights: Read, Write, or None. You assign access rights for scenarios in Planning.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Members of the Year and Period dimensions do not have security associated with them. However, you can use the scenario start and end year and period properties to lock time periods out for data entry. For example, you could set the properties so that users can enter data only into the current year.

All time periods that fall outside the start and end range are displayed as read-only. You can also set the Start and End Period properties to allow a mix of actual and budget data in the same scenario for forecasting purposes. For example, if you are rolling out your application in quarter 2, the Forecast scenario could contain actual data for quarter 1 and forecast data for quarters 2, 3, and 4. If you set the start period to quarter 2, users can input forecast data for quarters 2, 3, and 4, but not edit the actual data in quarter 1. At the end of quarter 2, you load actual data for quarter 2, and change the start period to quarter 3, so that you can create a rolling forecast.

Deleting ScenariosWhen you delete scenarios, all planning units that use the scenario (including data) are deleted.

To create scenarios:

1. Right-click the Scenario dimension, and select Create Member > As Child.

2. Enter a name and click OK.

3. Set the following properties for the scenario member:

• Valid for Plan

• UDA

• Member Formula

• Alias

• Data Storage

• Two Pass Calc

• Enable for Process Management

N O T E

You cannot delete scenarios that are used in planning units and that are started or assigned to axes on data forms. You must first remove references to scenarios from data forms and assign different scenarios.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Smart List

• Data Type

• Start and End Year

• Start and End Period

• Use Beginning Balance

• Exchange Rate Table

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Version DimensionVersions are required for Planning applications, and must exist for successful deployment. You can create, for example, Best Case and Worst Case versions for use with any scenario. You can use the Version dimension for these purposes:

• Allow multiple iterations of a plan; for example, Preliminary and Final.

• Model possible outcomes based on more optimistic or less optimistic assumptions; for example, Best Case and Worst Case.

• Manage dissemination of plan data; for example, Internal and External.

• Facilitate target setting

You set up the Version dimension in EPM Architect. You can change the version name in EPM Architect and access permissions in Planning.


Version Dimension

Versions provide process flexibility by providing iterative planning cycles.Versions are independent of individual scenarios. For example, Preliminary and Final versions could be associated with any scenario.There are 2 version types:

—Standard Bottom-Up—Standard Target

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The permissions are independent of scenarios, so you could give users read-only access to the Final version but write access to the Working version. Then, if users want to enter data for Budget Final intersections, they cannot write to that intersection even though the Budget scenario may have write access. The read access to the Final version prevents write access to that intersection of data.

You can create hierarchies and use shared members in the Version dimension. If you assign children to bottom-up versions, these versions display as read-only parents on data forms.

N O T E

You cannot delete versions that are used in planning units and that are started or assigned to axes on data forms. You must first remove references to versions from data forms and assign different versions. You must have at least one version in the application view.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating VersionsYou create versions and set version properties in EPM Architect. There are two types of versions, Bottom-Up or Target. For Bottom-Up versions, you enter data into the bottom level members. The parent-level members are read-only. When you calculate the database, the values of parent members are aggregated from the bottom-level members. For example, if you enter data for Northern Europe and Southern Europe, the total for Europe is aggregated after the database is calculated.

Target versions allow you to enter data for members at any level in the hierarchy. You can use business rules to distribute values from parent members to their descendants. For example, you can enter the target for Total Expenses into the Europe member and use a business rule to distribute the target values to Northern and Southern Europe.


Creating Versions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Target versions enable you to set high-level targets for your plan. Planners working with bottom-up versions can then reference these targets when they enter plan data. For example, the Total Product Sales member has Retail, Wholesale, and Distributors for its children. A budget manager enters 10,000 into Total Product Sales for the California entity in a target version. This target sets California’s target for product sales. The budget preparer for California then enters values for the Retail, Wholesale, and Distributors children that total 10,000 in a bottom-up version to show how the target is met.

The functionality available with target versions is for top-down budgeting.

Guidelines for target versions:

• Workflow Tasks are not allowed for target versions.

• Children of target members must be blank (for example, #missing) for the data input to be allowed at the top level.

• Target members must be set to StoreData (DynamicCalc overrides data input with sum of children).

To create versions:

1. Right-click the Version dimension, and select Create Member > As Child.

2. Enter a name and click OK.

3. Set the following properties for the version member:

• Valid for Plan

• UDA

• Member Formula

• Alias

• Data Storage

• Two Pass Calc

• Enable Process Management

• Smart List

N O T E

Enable for Process Management can be selected only for bottom up versions.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Data Type

• Version Type

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe Planning time periods

• Customize time periods

• Create scenarios

• Create versions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 6

Setting Up the Entity Dimension 6


• Add members to the Entity dimension

• Modify members in the Entity dimension

• Delete members in the Entity dimension

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 6 Setting Up the Entity Dimension


Entities OverviewThe Entity dimension is a Planning dimension whose members can be loaded or manually added to an application.

You can use parent-child relationships among entities to mirror your budget review structure. You can define the types of units that your organization requires, such as geographical regions, departments, or divisions.

For example, your organization may have regional centers that prepare budgets that are reviewed at the country headquarters. The country headquarters may, in turn, prepare a plan that is reviewed at the corporate headquarters. To match this structure, you can create members for the regions, countries, and headquarters. You can set up the regions as children of the country members, and the country members as children of the headquarters member.


Entities Overview

Entities allow you to model the flow of budget information through your organization.You can create an entity for each group or responsibility center that submits a plan for approval.You can assign plan types to entities.Entities can have a currency property.— If no currency is defined, the application default currency is used. — The entity’s currency can be overwritten during data entry or data loads.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Entity Members and Plan TypesA plan type is a classification mechanism for data.

Your organization may require different entity members to prepare different plans. For example, all entity members in your organization may submit expense plans, but entity members that are cost centers do not submit revenue plans. When you define entity members, you specify the plan types for which they are valid.

Because data forms are associated with plan types, they enable you to control which entity members can enter data for each plan type. For example, Eastern US may be a cost center, so you assign it as valid for the IncStmt plan type, but not for the Revenue plan type. When you create data forms for the Revenue plan type, Eastern US cannot be selected on those forms.


Entity Members and Plan Types

When you define an entity member you assign plan types. If you do not assign a plan type to a parent, its children do not have access to that plan type.

RevenueBalSheetIncStmt

Plan TypesData Form

Eastern US

NY

FL

Assigned

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting a plan type for an entity member involves specifying how the data values should roll up for that plan type. An entity member’s plan types may change when you promote or demote the member in the dimension hierarchy: If the new parents’ associated plan types are different from those of the moved member, the member becomes valid for the plan types of the new parent.

If you move an entity member, and the new parent of that member is assigned to different plan types, the member remains assigned to the plan types that it has in common with the new parent.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Identifying the Currency Value for EntitiesIf your application is set up for multiple currencies, you must specify a currency for each entity. The default currency for all entities is the currency that you specify when you create your application view in EPM Architect.

The currency property value identifies the local currency in which data for the entity is entered. When you run a currency conversion calculation script or the Convert Currencies business rule, Planning uses the exchange rates entered for that entity’s currency to convert the local currency to the reporting currency. The currency property can be overridden during data entry or during a data load.

For example, you might specify Yen as the currency for the Japan entity, and US dollars for the United States entity. When you view a data form that has values on it for the Japan entity, if the form’s display currency is set to US dollars, Planning uses the rates in exchange rates table for the Yen to convert the values to US dollars.


Identifying the Currency Value for Entities

The default currency is the currency that you specify when you create the application view.

New York London Tokyo

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding and Modifying EntitiesYou add and modify dimensions and members in the EPM Architect Dimension Library. You can also set the properties for dimensions and members. When you modify dimension and member properties, this information populates the EPM Architect relational database. For these changes to be reflected in the Essbase database, you can deploy the application in EPM Architect or you can select the Manage Database option in the Administration menu in Planning.

You create members in the Dimension Library by right-clicking a dimension or dimension member and selecting Create Member. You can add a member as a child or sibling of the selected member.

You modify members by selecting the member and then modifying the member properties.


Adding and Modifying Entities

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To modify members:

1. Select the member.

The properties pane is displayed.

2. Set up the following properties for entities:

• Valid plan types

• Aggregation and storage options

• UDA and member formula

• Alias

• Two-pass calculation

• Smart lists

• Currency

• Data type

3. Click to save the changes.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Saving DimensionsWhen you add, modify, or delete dimensions and their members, you must save the changes before they take effect. When you save the changes, EPM Architect performs a validation check for the following reasons:

• To prevent two users from saving the same dimension or member at the same time.

• To prevent a user from assigning a member to a plan type for which it is not valid.

• To prevent a user from using the same name for different dimensions or members.

If the validation check fails, an error message is displayed.


Saving Dimensions

Save changes to the relational database.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Deleting EntitiesWhen you delete entities, remember the following points:

• If the entity member is used elsewhere, such as an application view, you must delete it there first.

• You must update and validate business rules, reports, and Hyperion Application Link adapter processes to reflect the deleted entity.

• Before you can delete an entity, you must remove it from data forms that contain the entity.

To show an entity’s application membership in the Dimension Library, right-click an entity member and select Application Membership.


Deleting Entities

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Add entity members to the Entity dimension

• Modify entity members in the Entity dimension

• Delete entity members in the Entity dimension

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 7

Setting Up the Account Dimension 7


• Describe account types and consolidation order

• Create account hierarchies

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 7 Setting Up the Account Dimension


Accounts OverviewThe Account dimension is used to specify the information gathered from budget planners. Accounts typically represent an accounting container that identifies the primary nature of the data.

Accounts are organized into hierarchies. You can create an account structure that lets budget preparers input data for budget items to the appropriate level of detail.

You can define calculations in your hierarchies. For example, your detailed operating expense accounts can automatically aggregate to Total Expenses, and Total Expenses can be subtracted from Total Revenue.

When you define an account member, you assign a plan type. If you promote or demote a member, and the new parent of the member has different associated plan types, then the member acquires the same plan types as the new parent.


Accounts Overview

You assign plan types to accounts.— If more than one plan type is assigned to an account, designate a source

plan type.— Other plan types pull their values from the source plan type.

Use aggregation options to define calculations in the account hierarchy.

RevenueBalSheetIncStmt

Plan TypesData Form

Profit

Total Revenues

Total Expenses

Salaries

Rent

Assigned

Detail Expense Accounts

Oracle In

ternal & O

racle Aca

demy

Use O

nly



If an account is associated with more than one plan type, you must specify a source plan type for the account. The source plan type determines which plan type’s database stores the account value. For example, if the source plan type for the Total Product Sales account is IncStmt, the value displayed for the account on forms for the Revenue plan type is the value entered for the IncStmt plan type.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Account TypesAccount types define how an account's value flows over time. Account types also determine the sign behavior for variance reporting with Essbase member formulas.

All account types have predefined settings for variance reporting and time balance behavior except for the Saved Assumption account type, which is user-defined. When you select an account type for an account, the Variance Reporting and Time Balance list boxes are populated with predefined settings.

On the slide, the variance, time balance, skip, exchange rate type, and data type are the default selections for the each account type. You can override the default selections, if required.


Account Types

NonCurrencyNoneN/AUser-definedNonExpenseSaved Assumption

CurrencyEndingNoneBalanceNonExpenseEquity

CurrencyEndingNoneBalanceNonExpenseLiability

CurrencyEndingNoneBalanceNonExpenseAsset

CurrencyAverageN/AFlowNonExpenseRevenue

CurrencyAverageN/AFlowExpenseExpense

Currency TypeExchange Rate TypeSkipTime BalanceVarianceAccount Type

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Time Balance OptionsOption DescriptionFlow Uses an aggregate of all data values for a summary time

period as a total for the period.

First Uses the beginning data value in a summary time period as the total for the period.

Balance Uses the ending value in a summary time period as the total for the period.

Average Uses the average of all children’s data values in a summary time period as the total for the time period.


Time Balance Options

Flow and Balance examples

Revenue

Asset

50 75 50 175

100 150 75 75

Jan Feb MarTotal Revenues

Cash on Hand

Quarter 1

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Skip Options for Missing ValuesIf you set the Time Balance property to First, Balance, or Average, you must specify how Planning should handle zeros and missing values:

An account’s variance reporting property determines if an account is tagged as an expense in Essbase member formulas or Financial Reporting variance functions. Here is how expense and nonexpense accounts behave for variance reporting:

• Expense—The actual amount is subtracted from the budgeted amount to determine the variance.

• Nonexpense—The budgeted amount is subtracted from the actual amount to determine the variance.

Weighted Average-Actual_Actual Uses a weighted daily average, based on the actual number of days in a year, to account for leap year when February has 29 days.

Weighted Average-Actual_365 Uses a weighted daily average based on 365 days in a year, assuming that February has 28 days; does not account for leap year.

Property DescriptionNone Zeros and #MISSING values are considered when

calculating the parent value.

Missing #MISSING values are excluded when calculating the parent values.

Zero Zero values are excluded when calculating the parent values.

Missing and Zeros #MISSING and zero values are excluded when calculating the parent values.

N O T E

When the time balance is set to Flow, skip options are not available and default to None.

Option Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Saved AssumptionsWhen you define a saved assumption account, you select the appropriate time balance and variance reporting properties. The following examples show how time balance and variance reporting properties are used with saved assumption accounts:

• You may create a saved assumption of an expense type for variance reporting. It assumes that the actual amount you spent on head count is less than the amount you budgeted. To determine the variance, Planning subtracts the actual amount from the budgeted amount.

• You make an assumption on the square footage of an office and you determine the square footage of the office for the time period by using a value for the end of the time period.

• You make an assumption about the number of product units sold at the end of the time period. You determine the final value for the time period by aggregating the number of units sold across the range of time periods.


Saved Assumptions

Use Saved Assumptions to:Centralize planning assumptionsIdentify key business driversEnsure consistency across the application

Examples of Saved Assumption accounts include:HeadcountSquare footage

Define business rules that reference these saved assumptions such as:Calculate office supplies by entity based on headcountCalculate facilities expense based on square footage per location

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data Types and Exchange Rate TypesData and exchange rate types determine how numeric values are stored and which exchange rate to use to calculate the value.

Data type options:

• NonCurrency—Stores and displays the value as a numeric value.

• Currency—Stores and displays the value in the default currency.

• Percentage—Stores and displays the value as a percentage.

• Smart List—Stores and displays the value as a smart list.

• Date—Stores and displays the value as a date.

• Text—Stores and displays the value as text.

• Unspecified —Stores and displays the value as unspecified.


Data Types and Exchange Rate Types

CurrencyNonCurrency PercentageData types

Average Ending HistoricalExchange rate types

Date Smart List Text

Oracle In

ternal & O

racle Aca

demy

Use O

nly



For accounts whose data type is Currency, you select an exchange rate type:

• Average—Valid for any time period; uses the average rate for the account.

• Ending—Valid for any time period; uses the ending exchange rate for the account.

• Historical—Valid for any time period.

Data types can have conflicting results on the face of a data form depending upon the cell intersections defined for the data form. For example, the intersection of a "percent" data type and a "currency" data type must be resolved based on how you define the order set. The Data Type Evaluation Order is the defined order. You set a dimension order by plan type to determine the precedence when multiple data types intersect. Data types associated with the first dimension in the list take precedence over data types associated with subsequent dimensions.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Account HierarchiesYou create and modify account hierarchies in the Dimension Library. You access the Dimension Library through the Navigate menu in EPM Architect. After you save changes to the hierarchy, your changes are saved to the EPM Architect relational database. You must deploy the application in EPM Architect or refresh the database in Planning to update the Essbase databases.

To create account members:

1. Right-click an account.

2. Select Create Member and one of the following:

- As Child

- As Sibling


Creating Account Hierarchies

Oracle In

ternal & O

racle Aca

demy

Use O

nly



3. In the properties pane, set up the account properties.

You can set up the following properties:

• Valid for plan type

• Aggregation options

• UDA, Member Formula

• Alias

• Data Storage

• Two Pass Calc

• Smart List

• Time Balance

• Skip Value

• Variance Reporting

• Account Type

• Exchange Rate Type

• Data Type

• Source Plan Type

Adding and Modifying AccountsIn the Dimension Library, you can build the account hierarchy by adding children and sibling members. You can also change member properties.

N O T E

When assigning plan types, you must set the plan type property for a parent member before you can set the plan type for its children. You cannot select a plan type for a child member if the plan type is not valid for the parent.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Consolidation OrderAfter creating the Essbase database outline, you should review the order of the dimensions and members. For each plan type, data is consolidated based on the order of the dimensions and members in the outline.

The order of calculation within each dimension depends on the relationships between members in the database outline. Within each branch of a dimension, level 0 values are calculated first, followed by their level 1, parent value. The level 0 values of the next branch are calculated, followed by their level 1, parent value. The calculation continues in this way until all levels are calculated.

By default, the outline consolidates based on addition. You can set any member’s aggregation option to addition, subtraction, multiplication, division, percent, or ignore.

When a new operator is set, the operation designates how a member consolidates to its parent. For example, you may want to subtract a member from its sibling, such as subtracting COGS (Cost Of Good Sold) from Sales, to define the value for Margin.


Consolidation Order

Account (Never Share)

Profit (+)

Margin (+)

Sales (+)

COGS (-)

Expenses (-)

Marketing (+)

Misc. (+)

Ratios (~) (Label Only)

Margin % (+) (Two Pass Calc) Margin % Sales;

Product Share (+) (Two Pass Calc) Sales % Sales -> Products;

10

73

1

26

4

5

8

9

Level 2Level 1

Level 0

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Consolidation Order ExampleIt is important to understand how members with different operators are calculated. When you use addition and subtraction operators, the order of members in the outline is irrelevant. However, when you use other operators, you must consider the member order and its impact on the consolidation. When siblings have different operators, the data calculates in top-down order.

Essbase calculates Member1 through Member4 as follows:

(((Member1 + Member2) + (-1)Member3) * Member4) = X(((10 + 20) + (-25)) * 40) = 200

If the result from Members 1-4 is X, then Member5 consolidates as follows:

(X/Member5) * 100 = Y(200/50) * 100 = 400

If the result of Member5 is Y, then Member6 consolidates as follows:

Y/Member6 = Z400/60 = 66.67 and Member7 is ignored in the consolidation.


Consolidation Order Example

Consolidation order is defined by the order of members in the outline.Essbase calculates data in top-down order.

Parent

Member 4

Member 2

Member 1

Member 3

Member 7

Member 5

Member 6

(+)

(+)

(-)

(*)

(%)

(/)

(~)

10

20

25

40

50

60

70

305

200400

6.67

25

40

50

60

6.67

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe account types and consolidation order

• Create account hierarchies

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 8

Creating User-Defined Elements 8

At the end of this lesson, you should be able to:

• Create user-defined dimensions

• Create attributes and assign attribute values

• Describe member formulas

• Add member formulas

• Create smart lists

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 2 Creating Application StructuresLesson 8 Creating User-Defined Elements


User-Defined DimensionsYou can add user-defined custom dimensions to meet the needs of your organization. User-defined dimensions can help you capture categories that your organization uses for planning.

For example, you may have a group of accounts for operating expenses. You may decide to add a dimension called Project so that you can budget operating expenses on a project basis.

Guidelines:

• Names must be unique and use proper naming conventions.

• Names and aliases can have up to 80 characters.

• Descriptions can have up to 255 characters.


User-Defined Dimensions

User-defined dimensions require:— Unique values across databases— Plan types assigned at the dimension level

Customer

Oracle In

ternal & O

racle Aca

demy

Use O

nly



For user-defined dimensions, you assign valid plan types at the dimension level, not at the member level. All members of custom dimensions are valid for plan types assigned at the dimension level.

You assign the Generic dimension type to user-defined custom dimensions. You set up user-defined custom dimensions by defining the following dimension properties: Name, Valid for Plan, Aggregation for each valid plan, UDA, Member Formula, Alias, Data Storage, Two Pass Calc, Smart List, Data Type, and Attributes.

N O T E

In order to assign access to members in a custom dimension, you must select Apply Security at the dimension level.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Attributes OverviewAttributes are characteristics of your data. For example, products can have attributes such as colors, sizes, or flavors. Attributes enable you to add another level of granularity to your data. You create attributes for a dimension when you want to group its members according to the same criteria.

For example, you might have a Product dimension with members for three product lines, some of which are sold in retail outlets and some only by catalog. When you are analyzing or reporting your data, you might need separate totals for retail and catalog sales.


Attributes Overview

LargeDoug Nichols

Customer

National Accounts

Your IT Source

ABC Company

Software Company

Sales Rep

Small

Medium

Company Size

Sandy Smith

Assad Akili

Attribute dimensionsBase dimension

Chris Jones

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can add attributes to sparse dimensions such as the Entity dimension and User-Defined dimensions. You can add attributes to the Account dimension if it is designated as a sparse dimension in all plan types.

Viewing, Aggregating, and ReportingYou use attributes to view, aggregate, and report on data. For example, you can view net sales by customer and sales rep.

Creating Attribute Crosstab ReportsIn many ways, attribute dimensions behave like regular dimensions: You can retrieve, pivot, and drill on attribute members. You can use them to create crosstab reports of attribute data for multiple attributes in the same dimension, or for attribute data from multiple dimensions. For example, Sales Reps are attributes of the Customer dimension.

N O T E

You can assign attributes only to sparse dimensions. For dense dimensions, you must change them to sparse for all plan types. When changing dimensions to dense, all attributes and attribute values for the dimension are automatically deleted. You cannot assign attributes to label-only members.

N O T E

In order to assign attributes to a user-defined custom dimension, you must associate the attribute dimension to the user-defined custom dimension. For example, if you want to assign salesreps to the Customers dimension, you associate the Salesrep attribute dimension to the user-defined custom dimension named Customers.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating AttributesYou create attribute dimensions and add attribute values in the Dimension Library. You can then assign attribute values to dimension members. When you create forms and reports, you can filter dimension members by their attribute values.

To create attributes:

1. In the Master Library, from the File menu, select New > Dimension.

2. Enter a name and description for the dimension.

3. From the Type drop-down list, select Attribute.

4. Right-click the attribute dimension, and select Create Member > As Child.

5. Enter the attribute value.


Creating Attributes

Create Attribute

Create values for the attribute

Oracle In

ternal & O

racle Aca

demy

Use O

nly



6. Repeat steps 4 and 5 to enter attribute values for the attribute dimension.

N O T E

Only sparse dimensions can contain attributes. If the dimension you select is not a sparse dimension, the Custom Attributes button is not available. To display the sparse/dense settings for dimensions, select the Performance Settings tab.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Examples of Attribute ValuesFor a Product dimension with the members Sodas, Juices, and Coffees, you could create a Size attribute with the following attribute values: Small, Medium, and Large. After creating the attribute and attribute values, you can assign a value to each member of the Product dimension.

When assigning attribute values to dimension members, you must assign all of them at the same level in the hierarchy, or an error occurs during the application refresh.


Examples of Attribute Values

The following are examples of attributes and their possible values.Channel (Attribute of the Product dimension)— Retail— Catalog sales

Size (Attribute of the Product dimension)— Small— Medium— Large

Sales Rep (Attribute of the Customer dimension)— John Brown— Sandy Kennedy

Region (Attribute of the Customer dimension)— East— South— West— North

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Assigning Attribute ValuesYou use the Dimension Library to assign and view attribute values. After creating attribute dimensions and values, you must associate it with a dimension (at the dimension level) before you can assign attribute values to a dimension member.

To associate dimension with attributes:

1. In Master View, select a dimension.

2. Right-click the dimension and select Create Association.

3. Select Existing Property or New Property.

4. Perform a task:

• If you selected Existing Property in step 3, select the property from the Property drop-down list.

• If you selected New Property in step 3, enter the new property.


Assigning Attribute Values

Oracle In

ternal & O

racle Aca

demy

Use O

nly



5. Enter a description.

6. From the Dimension drop-down list, select a dimension where that attribute is located.

7. Click OK.

The attribute dimension associated with a user-defined dimension is displayed as a property in the property grid.

8. Right-click a dimension and select View Associations to verify dimension associations.

To assign attribute values to dimension members:

1. Select the dimension member.

The properties pane is displayed.

2. Select the property for the attribute dimension, and click the ellipsis button .

3. From the Member Selector list, select an attribute value.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Member Formulas OverviewSo far you have set up calculations between members by using aggregation options. These aggregation calculations are built into the Essbase outline. The aggregation calculations are generally intuitive as you can drill down to see how a member is derived.

Calculation through aggregation operators has some limitations, as follows:

• Calculations can only be created between children of a common parent.

• Results of the calculation must be stored in the parent member.

You can use member formulas as an alternative method of calculation. Member formulas are attached directly to dimension members. They go beyond aggregation logic by letting you reference values in members anywhere in the outline, including in other dimensions or other databases. Member formulas also provide a wider range of operators.


Member Formulas Overview

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Member FormulasYou use the Memo Editor in the Dimension Library to create and save member formulas. You can define member formulas in the Properties Grid for Planning, Essbase, and Enterprise Analytics categories. You cannot create member formulas from Planning or Workspace.

When adding a formula to a member, you edit the Member Formula property for an account. Using the Memo Editor, you could create a member formula for Profit Percent, as in the following example:

Profit Percent = “Gross Profit”%”Net Sales”;


Adding Member Formulas

Oracle In

ternal & O

racle Aca

demy

Use O

nly



When creating member formulas, you can combine the following items to perform calculations on members:

• Operators, calculation functions, dimension and member names, and numeric constants

• Operator type, function, value, member name, UDA, and so on that are allowed in Analytic Services formulas

• Predefined formula expressions, including smart list values, that expand into a formula or value upon database refresh

To add member formulas:

1. Select a dimension member.

The Member Formula property has the following categories: Planning, Enterprise Analytics, and Essbase.

2. In the Properties Grid for the member, double-click Member Formula.

3. Click .

The Memo Editor dialog box is displayed.

4. Enter a formula.

5. Click Word Wrap to wrap the formula text.

6. Click Validate and click OK.

7. Click OK.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding User-Defined AttributesYou define user-defined attributes (UDAs) for members to further describe characteristics of those members. You can use UDAs within calculation scripts, member formulas, and reports. UDAs are words or phrases that describes a member. For example, you can apply a UDA such as New Market to selected members within Markets. You create, change, and select UDAs in the Dimension Library properties grid.

UDAs enable you to calculate and report on specific subsets of data. They essentially provide a way to group members. For example, in a report or calculation, you can request all states with a New Market UDA.

UDAs are specific to dimensions. For example, if you create a UDA for an Account member, that UDA is available only for nonshared Account members. If you delete the UDA, then it is removed for all Account members. If you want to make the UDAs available for multiple dimensions, you must create the same UDA for each dimension in which it is used.


Adding User-Defined Attributes

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To associate UDAs with members:

1. Select the dimension whose members you want to associate with the UDA.

2. Select a member in the dimension.

3. In the Property Grid for the member, double-click UDA.

4. Click .

5. Enter the UDA.

You can change a UDA by double-clicking the UDA and retyping the name. You can delete the UDA by double-clicking the UDA and deleting the entry.

T I P

Use a comma to separate multiple UDAs for a member.

N O T E

If you delete UDAs, you must update all member formulas, calculation scripts, and reports that reference those UDAs.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Smart Lists OverviewSmart lists are custom drop-down lists that you can access from data form cells in Planning applications. If a data cell is assigned a smart list, you can click on an arrow in the data cell to see a pick list of values. When you click in data form cells that contain members associated with smart lists, you can select an item from the drop-down list instead of entering data manually. You cannot type in cells that contain smart lists.

For example, you can create a smart list for customer service levels with the following values:

• Platinum

• Gold

• Silver

• Bronze


Smart Lists Overview

Customer_Service_Class uses a smart listNetwork Sales, Chip Sales, and ComputerSales use data values

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can associate the Customer Service Levels smart list with the Customer Service Class account member. On a data form, if you click in the account named Customer Service Class (which is associated with the Customer Service Levels smart list), you can choose from a drop-down list with these selections: Platinum, Gold, Silver, and Bronze.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Smart ListsYou create smart list dimensions and members in the Dimension Library. You also assign properties to smart lists in the Dimension Library.

Smart list creation process:

• Create a new dimension with Smart List selected as the dimension type.

• Create members in the dimension. (The members are the items that are displayed in the drop-down list, data form, or grid.)

• Assign properties to the smart list dimension and members.

• Optionally, you can do any of the following tasks:

- Set up smart lists on data forms

- Use smart lists values in member formulas and business rules.

- Set how #Missing cells associated with smart lists are displayed in data forms.


Creating Smart Lists

Smart List Dimension

Smart List Values

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Guidelines:

• Smart lists are associated with dimension members. Typically, the Account dimension is used to associate smart lists with members.

• After associating smart lists with dimension members, reserve those members to store only smart list values. These members should not be used to store other data values.

• Consider creating new members and setting up a separate rollup with the dimension.

• You can create reports to capture the smart list information. You must use planning details as your data source to report on smart list data.

• Smart lists can be associated with more than one member, but those members must be level 0 members.

• Smart lists are not plan type specific.

• Smart List names and aliases must begin with a letter, and can contain letters, numbers, underscore, and dollar sign characters. Smart List names cannot contain spaces, or be Java reserved words.

To create smart lists:

1. In the Dimension Library, select File > New > Dimension.

The Add New Dimension dialog box is displayed.

2. Enter the name and description.

3. From the Type drop-down list, select SmartList.

4. Click OK.

5. In Master View, right-click the Smart List dimension and choose Create Member > As Child.

The New Member dialog box is displayed.

6. In the Name text box, enter a name and click OK.

7. In Master View, select the member name.

8. In the Property Grid, from the category drop-down list, select Planning.

9. In the Label text box, type a label and click Save.

10. Create additional members, as necessary, for the dimension.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Modifying Smart Lists You modify the following smart list properties in the property grid:

Property DescriptionLabel Enter the text to display when the Smart List is selected. Spaces

and special characters are allowed. Smart List labels can reference a resource, which can be translated into different languages.

Start Value Populates the value property of the first member in the smart list.

Increment Enter the value that is appended to the value of the last member in the list to determine the value for the selected member.

Display Order Select to sort the smart list by ID, Name, or Label.


Modifying Smart Lists

Smart List Dimension Properties Smart List Value Properties

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Administrators can set the values that are displayed in smart lists and data cells, including what is displayed when no data is in the cell. When no data is in a cell, the cell can display no value, #Missing, or another value that you specify.

#Missing Data Form Label Select how #Missing values are represented in cells associated with the smart list.

#Missing Drop Down Label Enter a label to be displayed as an entry in the smart list whose value is #Missing.

Property Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Associating Smart Lists with MembersYou associate smart lists with members in the property grid. You can create a new dimension member or you can use an existing member, and then assign the smart list as a member property. Keep in mind that for the member whose member properties includes a smart list, you cannot key values into the cells on the data form.


Associating Smart Lists with Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Data Forms to Use Smart ListsIn order to work with smart lists on data forms, you must select the dimension member so that it is displayed on the data form. You must also set the data form properties so that you can work with smart lists on that data form.

Keep in mind the following key points:

• You can assign smart lists to the rows or columns.

• You cannot use smart lists in the pages.

• You must assign smart lists to level 0 members.


Setting Data Forms to Use Smart Lists

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Create user-defined dimensions

• Create attributes and assign attribute values

• Describe member formulas

• Add member formulas

• Create Smart Lists

Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 3

Loading Metadata 8

OverviewThe aim of this module is to load metadata used by Planning applications. Then you create application views and deploy those application views to the Planning server. You also set up Exchange Rates.


• Loading Metadata from a File

• Creating Application Views

• Deploying Applications

• Setting Up Exchange Rates

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 9

Loading Metadata from a File 9


• Format metadata files

• Load and extract metadata from flat files

• Create profiles

• Map dimensions and dimension properties

• Load metadata from interface tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 3 Loading MetadataLesson 9 Loading Metadata from a File


Metadata Load FilesYou can load metadata into the Dimension Library from interface tables or from flat files. If you load data from interface tables, you load data from a specific database. If you load metadata from flat files, you can include any combination of dimensions in the load file, and you can have multiple load files. For example, you could have one load file for the Account and Custom dimensions and another load file for the Entity dimension.


Metadata Load Files

You can load data from flat files or interface tables (staging area)Load files can contain metadata for:— Account, Entity, Scenario, Version, and Custom dimensions— Period, Year dimensions— Currency dimension

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Formatting Load FilesThe section for each type of metadata can be displayed only once in a metadata file. You need not include a column for every member property for dimensions. Properties for which columns are omitted are set to their default value. Do not use a character included in the actual metadata as the delimiter.

If you load metadata from flat files, keep the following points in mind:

• A line starting with an exclamation point (!) indicates the beginning of a new section in the flat file and must be followed by a valid section name (for example, Dimensions or DimensionAssociations).

• A line starting with an apostrophe ( ') sets the column order for the section.

• True and false values are represented as Y for true and N for false.

• You can use a pipe (|), semicolon (;), comma (,), space, or tab as the file delimiter.


Formatting Load Files

Load files are divided into sections with an exclamation point as the section delimiter.Load files sections can be in any order: Dimensions, Dimension Associations, Dimension Members, Dimension Hierarchies.The line defining the column names for the section begins with an apostrophe immediately under the section header.You can place the column names in any order.

!Members= Products'Name|DataType|SmartList|TwoPassCalc|UDA|Salesrep|Description|MemberFormulaTennis Rackets|Unspecified||||Thomas Brown|||Tennis Balls|Unspecified||||Sandy Spencer|||

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Load File SectionsYou specify the dimensions represented in the load file in the Dimensions section. To set up members with the load file, you create a !Members section for each dimension. You specify the member and the member hierarchy for a dimension in separate sections. If some properties have dimension associations, you specify them in the DimensionAssociations section.


Load File Sections

For each dimension:Add an entry to the Dimensions section to define the dimension.Add a !Members section to specify members and their properties.Add a !Hierarchies section to specify parent-child relationships.

Add entries to the DimensionAssociations section for each property with an association to another dimension.

!Section=DimensionAssociations'BaseDimension|Property|TargetDimensionFunctional Entity|Currency|Currency

!Hierarchies=Functional Entity'Parent|Child|DataStorage|MemberValidForPlan1|Plan1Aggregation#root|United States|StoreData|Y|+|United States|California|StoreData|Y|+|California|San Francisco|StoreData|Y|+|

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Formatting Members SectionsYou set up the metadata dimension members in a members section. You begin a members section by entering the following line, replacing the angle brackets (<>) with the dimension name:

!Members=<>

You need not include columns for all member properties for the dimension class, and you can set up the columns in any order.


Formatting Members Sections

Use a separate members section for each dimension.Use Y for Yes and N for No.

!Members=Scenario'Name|DataType|StartYear|EndYear|StartPeriod|EndPeriod|UseBegBalance|EnableProcessManagement|SmartList|ExchangeRateTable|TwoPassCalc|UDA|Description|MemberFormulaCurrent|Unspecified|FY06|FY09|Jan|Dec|N|N||A_FXRate|N||||Actual|Unspecified|FY07|FY07|Jan|Dec|N|N||A_FXRate||||Budget|Unspecified|FY08|FY10|Jan|Dec|Y|Y||B_FXRate||||

Oracle In

ternal & O

racle Aca

demy

Use O

nly



AccountValid Planning properties for the Account dimension class:

Name,DataType,SourcePlanType,AccountType,ExchangeRateType, VarianceReporting,TimeBalance,SmartList,UDA,TwoPassCalc, SkipValue,WeeksDistribution,MemberFormula,DataStorage, MemberValidForPlan1,MemberValidForPlan2,MemberValidForPlan3, MemberValidForWorkforce,MemberValidForCapex,Plan1Aggregation, Plan2Aggregation,Plan3Aggregation,WorkforceAggregation, CapexAggregation

EntityValid Planning properties for the Entity dimension class:

Name,DataType,Currency,MemberValidForPlan1,MemberValidForPlan2, MemberValidForPlan3,MemberValidForWorkforce,MemberValidForCapex, Plan1Aggregation,Plan2Aggregation,Plan3Aggregation, WorkforceAggregation,CapexAggregation,DataStorage

ScenarioValid Planning properties for the Scenario dimension class:

Name,DataType,StartYear,EndYear,StartPeriod,EndPeriod, UseBegBalance,EnableProcessManagement,SmartList,ExchangeRateTableTwoPassCalc,UDA,Description,MemberFormula,MemberValidForPlan1, MemberValidForPlan2, MemberValidForPlan3,MemberValidForWorkforce, MemberValidForCapex,DataStorage

VersionValid Planning properties for the Version dimension class:

Name,DataType,VersionType,EnableProcessManagement,SmartList, TwoPassCalc,UDA,Description,MemberFormula,MemberValidForPlan1,MemberValidForPlan2,MemberValidForPlan3, MemberValidForWorkforce, MemberValidForCapex,DataStorage

PeriodValid Planning properties for the Period dimension class:

Name,DataType,SmartList,TwoPassCalc,DTSGeneration,DTSEnabled, UDA,Description,MemberFormula,DataStorage,MemberValidForPlan1, MemberValidForPlan2, MemberValidForPlan3,MemberValidForWorkforce, MemberValidForCapex,Plan1Aggregation,Plan2Aggregation, Plan3Aggregation,WorkforceAggregation,CapexAggregation,PeriodType

Oracle In

ternal & O

racle Aca

demy

Use O

nly



YearValid Planning properties for the Year dimension class:

Name,DataType,SmartList,TwoPassCalc,UDA,Description,MemberFormulaMemberValidForPlan1,MemberValidForPlan2,MemberValidForPlan3, MemberValidForWorkforce,MemberValidForCapex,DataStorage

CurrencyValid Planning properties for the Currency dimension class:

Name,DataType,Symbol,Scale,ThousandSep,DecimalSep,NegativeSign,NegativeColor,ReptCurrency,TriangulationCurrency,CurrencyCode,SmartList,TwoPassCalc,UDA,Description,MemberFormula, MemberValidForPlan1,MemberValidForPlan2,MemberValidForPlan3, MemberValidForWorkforce,MemberValidForCapex,DataStorage

GenericValid properties for Generic dimension class:

Name,DataType,SmartList,TwoPassCalc,UDA,DataStorage,Description,MemberFormula,MemberValidForPlan1,MemberValidForPlan2, MemberValidForPlan3,MemberValidForWorkforce,MemberValidForCapex, Plan1Aggregation,Plan2Aggregation,Plan3Aggregation, WorkforceAggregation,CapexAggregation

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Formatting DimensionAssociation Sections You can associate dimension properties with members of another dimension. By setting dimension associations, you enable end users to set property values by selecting members from the associated dimension.

Required columns for the DimensionAssociation section:

Column DescriptionBaseDimension Dimension for which you want to set up the association

Property Property that you want to link to another dimension

TargetDimension Dimension to which to link the property


Formatting DimensionAssociations Sections

!Section=DimensionAssociations'BaseDimension|Property|TargetDimensionFunctional Entity|Currency|Currency

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can automate property association assignments by indicating the associations in the load file. The text on the slide is a sample section from a file that you can use to load metadata.

You can also add property associations later by creating lists in the Dimension Library. The illustration on the slide is one such example. Association-setting privileges are determined by role. For example, administrators set associations for Currency, Start and End Period, and Start and End Year. Business users can set associations for smart lists.

To associate dimension properties in the Dimension Library

1. Right-click a dimension and select Create Association.

The Create New Association dialog box is displayed.

2. Select options, enter text, and click OK.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Loading Metadata ProcessYou load metadata by creating and running import profiles. Profiles include important information about the dimensions to be imported, such as new dimensions, whether to merge or replace dimensions, and dimension properties.


Loading Metadata Process

You perform the following tasks to load metadata:Create an import profileSpecify load optionsMap dimensions in the load file to dimensions in the Master ViewMap fields for the load file to dimension properties in Master ViewRun the profile

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Import ProfilesYou create profiles to import metadata from flat files or interface tables.

To create import profiles:

1. Select File > Import > Create Profile.

The New Profile dialog box is displayed.

2. Enter a name for the profile.

3. From the Import Type drop-down list, select FlatFile or Interface Tables.

4. Optional: Enter a description for the profile.

5. Perform an action:

• Flat files: Click Upload to browse for the flat file, select it, and click Upload again.

• Interface tables: From the Data Source drop-down list, select a database.


Creating Import Profiles

Oracle In

ternal & O

racle Aca

demy

Use O

nly



6. Click OK.

7. Follow the wizard to complete the profile setup:

• Load files: Select options for column delimiters, removal of single quotation marks from strings, and removal of spaces from load files.

• Flat files and interface tables: Map dimensions and properties.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Mapping DimensionsYou map the dimensions in the load file to dimensions in Master View. For each dimension in the flat file, a drop-down list of dimensions of the same dimension class in Master View is displayed. You select the Master View dimension to which you want to map the flat file dimension.

When you map a dimension in the load file to a dimension in Master View, you can merge or replace members:

• Merge—Updates members with the information in the file. New members are added to the application.

N O T E

If a dimension name in Master View exactly matches a dimension name of the same dimension class in the load file, the matching dimension is the default selection.


Mapping Dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Replace—Replaces metadata with the metadata in the file. Removes members from the application if they are not present in the metadata file.

You can also choose to create a new dimension rather than map to an existing dimension.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Mapping PropertiesFor each column for a dimension in the flat file, a drop-down list of properties for the same dimension class in Master View is displayed. You select the property to which to map the column.

Select Ignore Nulls if you want blank values for a record in the load file to be ignored. Otherwise, blank values are treated as data, and the property status is changed from default to defined. A status of defined prevents the property from inheriting values from ancestors.

N O T E

If a property name in Master View exactly matches a property name in the load file, that property is mapped by default.


Mapping Properties

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Running Import ProfilesAfter creating a profile, you are prompted to execute the profile. If you want to run it at another time, you can initiate the import from the Import Dimensions dialog box (File > Import > Import Dimensions).

You must select a file to upload each time you run an import. The file you select populates the Name field. You also select the application into which to import the metadata. You can select Master View or an application view. If you select an application view, you can update existing members properties, but you cannot create new members. All new members must be added to Master View.


Running Import Profiles

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Viewing Job StatusYou can view job status by navigating to the Job Status page. After the import job runs, you can select the click here to navigate to jobs link. You can navigate to the Job Status page at any time by selecting Running Jobs from the File menu.


Viewing Job Status

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Viewing Import ErrorsYou can view import errors by selecting a job and clicking on the link for Import Results. You can select a specific error and view the details. After you correct the error, you can import the file again.


Viewing Import Errors

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Loading Metadata from Interface TablesEPM Architect interface tables are database tables used to import metadata from external systems into the Dimension Library. They represent an alternative to flat files.

Interface Tables Process1. Create a EPM Architect interface database by using a relational database such as

MS SQL Server or Oracle.

2. In the interface database, create tables that correspond to the sections in a metadata flat file. For example, you could create a database table for dimension associations, with fields for Base Dimension, Property, and Target dimension (similar to the DimensionAssociations section of a flat file). A database template script assists in creating the required tables.

3. Load metadata from the external systems into the tables.


Loading Metadata from Interface Tables

General Ledger System

InterfaceTables

InterfaceTables

Financial Management

Planning

Essbase

DimensionLibrary

DataSynchronization

EPM ArchitectDatabase

EPM Arcitect

Interface Table Import Process in Hyperion System 9

Process before Interface Table Import

ETL System

EPR System

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Import the metadata from the interface database into the Dimension Library by using an import profile and following the same procedure as flat files.

Setting Up Interface TablesTo import from Interface Tables, from the Import Type drop-down list, select Interface Tables.

You can set up two types of interface tables:

• System tables—Use these tables when you work with the import module for profile creation and execution.

• User-defined tables—Use these tables when you load dimensions, members, member properties, and member hierarchies. At a minimum, you must set up Member and Hierarchy tables. In the Member table, Name is required. In the Hierarchy table, Parent and Child are required.

If you no longer need the stored metadata, you can clear the information from the tables.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Format metadata files

• Load and extract metadata from flat files

• Create profiles

• Map dimensions and dimension properties

• Load metadata from interface tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 0

Creating Application Views 10


• Create application views

• Add dimensions to application views

• Configure application settings

• Remove dimensions

• Set up dimension associations

• Adjust performance settings

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 3 Loading MetadataLesson 10 Creating Application Views


Creating Application ViewsAn application view represents a selection of the Master View dimensions required for an application.

Application view types:

Type DescriptionGeneric A template that enables you to create an application view without

assigning a specific product. A generic application view displays properties for all products.

Planning Planning application view

Consolidation Financial Management application view

Enterprise Analytics Enterprise Analytics application view

Essbase Analytics Essbase application view


Creating Application Views

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The Application Library displays all application views in EPM Architect. You can create application views in the Application Library or Dimension Library provided you have been assigned the application creator role.

To create application views:

1. In EPM Architect, select Navigate > Administer > Application Library.

2. In the File menu, select New > Application View.

3. Enter the name for the application view.

Although the name can contain up to 50 characters, Planning application names can contain only 8 characters. Therefore, if you use the same name for the application view and the Planning application, the application view name can contain only 8 characters.

4. From the Type drop-down list, select Planning.

5. Optional: Enter a description for the application.

6. Click OK.

The Dimension Library is displayed with the application view in the middle pane. The application view does not contain dimensions.

After creating application views, you can perform these actions:

• Open views (In the Application Library, select File > Open Application View.)

• Display the application as an additional pane to the right of the Master View pane.

• Only display the application view pane by closing the Master View pane.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dimension Library Panes

You can navigate to the Application Library by selecting the tab located at the bottom of the window.

Pane DescriptionMaster View Lists all dimensions and members available in the Master Library

Application view Lists all dimensions and members that comprise the application view

Properties grid Shows the properties for the selected dimension or member


Dimension Library PanesMaster view Application view Properties grid

Application Library

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Dimensions to Application ViewsAfter creating an application view, you can add dimensions by dragging them from the Master View pane to the application view pane.

Planning application view requirements:

• Required dimensions are determined by the application type. For the Planning application type, an application view requires one dimension from each of these dimension classes: Account, Entity, Scenario, Version, Period, Year, Currency (for multicurrency applications).

• The Entity dimension requires an association with the Currency dimension to enter a value for the currency property.

• The Scenario dimension requires an association with the Period and Year dimensions to enter starting and ending time period values.


Adding Dimensions to Application Views

You can drag dimensions from Master View to an application view.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• If you want to assign attribute values or aliases to dimension members, you must associate the Attribute and Alias dimensions with those base dimensions. For example, if you want to assign attributes or aliases to the Entity and Account dimensions, you must associate the Attribute and Alias dimensions with their respective properties in the base dimensions, Entity and Account.

Dimension association guidelines:

• You need not associate a smart list with a main dimension to select a smart list in the Smart List property field.

• Dimensions created in the Dimension Library do not have default associations. You associate dimensions in Master View, not in application views.

• For dimensions loaded from flat files, you must specify associations in the flat file.

• If you upgrade an application to Planning 9.3, the associations may already be assigned.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Excluding MembersAfter adding dimensions to application views, you can exclude selected members from the dimensions. For example, for a revenue forecasting application, you could exclude all accounts except revenue accounts from the Account dimensions.

To exclude members from dimensions:

• Right-click a member and select Exclude Member.

If you exclude a parent member from a dimension, its descendants are excluded as well.

To show excluded members:

• Right-click the dimension and select Show Excluded Members.

A list of excluded members is displayed, and you can select members that you want to include in the dimension.


Excluding Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Member PropertiesWhen you add dimensions from Master View to application views, the member property values are inherited from Master View. If you modify member properties in Master View, the properties are also updated in all application views containing that member.

Member property rules:

• If you edit member properties in the application views, the Master View property values are overridden. Updates to member property values in Master View no longer update property values in the application views.

• If a member inherits a property value from Master View and from an ancestor in an application view, the ancestor value overrides the value inherited from Master View.


Member Properties

Inheritance from application view ancestor overrides inheritance from Master View.

Property values loaded or manually entered override both Master View and ancestor values.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Configuring Application SettingsYou configure application-wide settings in the application view.

Application-setting configuration process:

1. Select the Planning application view name to display its dimension properties in the Properties grid. Properties that you set at the highest level apply to all dimensions in the application view.

2. Select the Planning category.

3. Indicate up to five valid plan types: Plan1, Plan2, Plan3, Workforce, and Capex.

4. Set up names for the plan types. Plan type names can contain up to 8 characters.

5. Specify the default currency and indicate whether the planning application contains multiple currencies.


Configuring Application Settings

Select the application label to configure the application settings.Planning properties System properties

Oracle In

ternal & O

racle Aca

demy

Use O

nly



6. Set the base time periods (monthly, quarterly, or custom), weekly distribution, starting fiscal year and month, and total number of years.

7. Specify the default Alias Table for the application view.

You can also view or modify system properties for application views.

To view or modify system properties:

1. In the application view pane, select an application.

2. From the Category drop-down list, select System.

3. View or modify the settings.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Configuring Plan TypesIn the Properties grid, you can indicate up to five plan types for the application view. An Essbase database is created for each plan type. After creating an application view, you cannot change the name or number of plan types.

The number of plan types depends on the needs of your organization. For example, if the Sales Department has a yearly revenue plan, and the finance department has a P&L plan, you can define two plan types—Revenue and P&L.

As you create accounts, entities, and other elements of the application, you associate them with plan types. The association ensures that the database contains only relevant application dimensions, members, and data values, and that application design, size, and performance are optimized.


Configuring Plan Types

Essbase database created for each plan typeThree customizable plan typesData sharing between plan types

Budgeting Application

Capex= Plan Type 1 Plan Type 2 Plan Type 3 Workforce

Additional modules available for purchase

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can also share data between plan types, to ensure that the database remains small and efficient. For example, the Revenue plan may include several sales detail accounts that roll up into a Total Product Sales account. You can configure the P&L plan to include the Total Product Sales account, omitting sales detail accounts. Then, you can bring the data value for Total Product Sales into your P&L plan without account details.

N O T E

You can add WFP (Workforce Planning) and CAPEX (Capital Expense) plan types to an application view if you purchased these modules.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Specifying CurrencyYou specify the default currency for entities in the application view and establish if the application view supports currency conversions. Multiple currency support (also known as currency overrides) is available for level 0 members, regardless of their base currency.

If you select multicurrency for the application view, two dimensions are created in Essbase: Currency and HSP_Rates. You cannot change this option later.


Specifying Currency

Set default currency for entitiesSpecify whether multiple currencies are used

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up Time PeriodsYou select the base time period and the monthly distribution pattern based on the number of fiscal weeks in a month. The base time period options are the bottom-level time periods in the application. Predefined options are months or quarters. You can create custom base time periods, such as weeks or days.

You can select monthly distribution patterns to determine how data entered into a summary time period is distributed or spread among base time periods. During data entry, users can enter data into summary time periods, such as years or quarters. Planning distributes these values over the base time periods that constitute the summary time period.


Setting Up Time Periods

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can select a weekly distribution pattern other than Even Distribution. In that case, Planning treats quarterly values as if they were divided into 13 weeks and distributes weeks according to the pattern you selected. For example, if you select the 5-4-4 pattern, Planning treats the first month in a quarter as if it has five weeks, and the last two months in the quarter as if they have four weeks. The options for the weekly distribution pattern are available only if you select the 12 Months base time period option.

You specify the fiscal start year, the fiscal start month, and the total number of years in the application view. The fiscal start year determines the starting fiscal year for the application view. You cannot change the option later. When specifying the fiscal start year, consider how much historical data your organization needs in the application view.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Removing DimensionsIf you do not want to include dimensions in application views, you can remove them only before deploying the application views for the first time.

To remove dimensions from application views:

• In the application view pane, right-click the dimension, and select Remove Dimension.

The dimension is removed from the application view.


Removing Dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up Dimension AssociationsIn the Master Library, you create dimension associations for properties whose values refer to members of another dimension.

Examples:

• You can associate the currency property of the Entity dimension to the Currency dimension to ensure that the Currency dimension is accessed to retrieve the value for the currency members in the Entity dimension.

• When you assign Alias values to dimension members, you create Alias information in the Master Library and associate the Alias property member of the dimension (for example, the Alias property in the Account dimension with the Alias dimension.


Setting Up Dimension Associations

Associate currency property for the Entity dimension with the Currency dimensionAssociate Alias dimension with the alias property of a base dimension such as the Account or the Entity dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To set up dimension associations, you first create the association in the Master Library. Next, you activate the association within the application view. Because you activate the dimension associations for each application view for which it is valid, you can have different Planning application views set up with different dimension associations, and you can have some Planning application views set up with specific dimension associations that are different from the dimension associations set up for Financial Management application views.

N O T E

You can turn on all associations within an application view with one command. Select the application view, right-click, and select Activate all associations.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Choosing Performance Settings for Optimal PerformanceBefore you load and calculate data, you can optimize the Essbase database outline settings. Optimizing means analyzing the dense and sparse settings for dimensions to see their effect on block size. Use Performance Settings to make adjustments. You can modify the sparse and dense setting for a dimension and its order in the outline.

To categorize dimensions as dense or sparse and set evaluation order:

1. From the Application Library, right-click an application view and select Performance settings.

The Plan Type Performance Settings dialog box is displayed.


Choosing Performance Settings for Optimal Performance

Use Performance Settings to optimize the dimension order and set dense and sparse dimension settings.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



2. From the drop-down list, select a plan type.

Dimensions belonging to the plan type are displayed with the number of dimensions for the plan type.

3. In the Density column, double-click a cell and select one of the following:

• Sparse—Sparse dimensions lack data values for the majority of member combinations. A sparse dimension is a dimension with a low percentage of available data positions filled.

• Dense—For dense dimensions, there is a high probability that one or more data points is occupied in every combination of dimensions.

N O T E

Applications can have up to five plan types. If applications are created with a single currency, the HSP_Rates dimension is not displayed.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Dimension OrderOn the Plan Type Performance Settings screen, you can view and modify the order of the dimensions in the outline. The order of dimensions is critical in the structure and performance of Essbase databases. Dense dimensions calculate faster than sparse dimensions, so dimensions should be in order of most to least dense. You can speed calculation time by changing the order for calculating dimensions.

Separate sparse dimensions into aggregating and nonaggregating dimensions, with aggregating dimensions before non-aggregating dimensions.

N O T E

Aggregating dimensions aggregate children into the parent to create new data; non-aggregating dimensions do not create new data by the hierarchies (for example, a Scenario or Version dimension).


Dimension Order

Most Dense

Smallest

Smallest

Least Dense

Largest

Largest

Dense Dimensions

Aggregating Sparse Dimensions

Nonaggregating Sparse Dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can optimize performance by ordering dimensions according to the following guidelines:

• Make Period and Account dense.

• Order dense dimensions from the most to least dense. The most dense is usually Period (Time), followed by Account.

Separate sparse dimensions into aggregating and nonaggregating dimensions. Place aggregating dimensions before nonaggregating dimensions. Order sparse dimensions from smallest to largest.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Create application views

• Add dimensions to application views

• Configure application settings

• Remove dimensions

• Set up dimension associations

• Adjust performance settings

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 1

Deploying Applications 11


• Validate application views

• Compare application views

• Deploy applications views

• Review Planning outlines in Administration Services

• Redeploy application views

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 3 Loading MetadataLesson 11 Deploying Applications


Deploying Applications OverviewIn EPM Architect, you create application views to describe the dimensionality and other information required for an application. To create the application itself, you first validate, and then deploy the application view to a Planning server. The deployment process automatically creates an application on the application server. You validate and deploy application views from the EPM Architect Application Library.


Deploying Applications Overview

EPM ArchitectDimension Server


HYPlanapplication view

HYPlanapplication

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Deployment ProcessIn the EPM Architect Application Library, you deploy application views as follows:



• Deploy application views to a Planning server

• Create application files in relational and OLAP databases


Deployment Process

Validating application viewsDeploying application views to Hyperion productsCreating the application files in relational and OLAP databases

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Validating Application ViewsYou validate application views before deploying them to ensure that the following conditions are met:

• The Start Year property is defined and contains four digits (for example, 2006).

• Members in Year dimensions start with FY, followed by a two-digit year (for example, FY06).

• The Start Year property and first year in the Year dimension describe the same year in different formats. For example, if the Start Year is 2006, the first year must be FY06.

• The Start Month property is defined.

• The Default Alias Table property is defined.

• The Default Currency property is defined.


Validating Application Views

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Application view include predefined dimensions. Single-currency application views require Scenario, Version, Entity, Account, Period, and Year. Multicurrency application views require Scenario, Version, Entity, Account, Period, Year, and Currency.

• The Base Time Period and Weeks Distribution properties are defined.

• At least one plan type is set up. You can add plan types later and redeploy the application views; however, you cannot delete plan types after deploying the application views.

To validate application views:

1. In Workspace, select Navigate > Administer > Application Library.

2. Right-click an application view and select Validate.

The Validation Summary dialog box is displayed.

3. Perform an action:

• If validation errors occurred, proceed to step 4.

• If no validation errors occurred, skip to step 5.

4. Click Details to review the errors.

5. Click OK.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Comparing Application ViewsYou can compare application views to determine how they differ from those stored elsewhere.

Comparison methods:

• Compare to Master Library—Compares the dimensions and members in an application view to the dimensions and members in Master View in the Dimension Library

• Compare to Deployed Application—Compares an application view to a deployed application

• Compare to Application As-Of—Compares an application view to a prior version as of a specific date and time


Comparing Application Views

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The Compare window has three panes:

• Dimension Compare Results—Displays dimensions and members that were added or deleted. The Master View items are displayed in the left column, and the application view items are displayed in the right column. The number of differences (at or below the selected level) is displayed in parentheses. You can expand and collapse the dimensions as necessary. When you select an item, additional details are displayed in the panes on the right.

• Application Compare Summary—Displays a summary of all changes between the application views or between the application view and Master View, including Total Member Count, Total Differences, Additions, Removes, and Filters. The summary displayed depends on what you selected in the Dimension Compare Results pane.

• Property Compare Results—Displays changed member properties for the selected member.

To compare application views:

1. Right-click an application view, select Compare, and select a comparison method:

• Compare to Master Library

• Compare to Deployed Application

• Compare to Application As-Of

2. After the progress bar indicates 100% complete, click View Results.

The Compare window is displayed.

3. In the Dimension Compare Results pane, perform an action:

• Select a dimension to view the results in the Compare Summary pane.

• Select a member to view the results in the Property Compare pane

N O T E

When a member is added or deleted within Master View, the application view inherits the changes from Master View. You can determine that changes were made by noting the sync status, and you can run one of the comparison reports to determine the differences.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Deploying Application Views

To deploy application views:

1. Ensure that the Planning Application Server is started.

2. In Workspace, select Navigate > Administer > Application Library.

3. Right-click an application view and select Deploy.

N O T E

Ensure that the Planning Application Server is started before you deploy any Planning application views.


Deploying Application Views

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Optional: If validation errors occur, then you can view validation error details. To view the number of errors, click View Errors. Then to view the list of errors, click Details.

5. Enter the requested information.

Reminders:

• Planning instances are used to link EPM Architect to a Planning Application Server.

• If you are deploying a Planning application view for the first time, select Create Outline to create the Essbase outline.

6. Click Deploy.

In the Application Library, the status of the application view is updated to Deployment Pending.

7. Select Navigate > Administer > Library Job Console to view the status of the deployment.

The Library Job Console displays the current job status and the percent completion. You can click the Attachment link to view an error log. Should deployment of the application view fail, the error log contains value information about the reasons for the failure.

When the deployment is completed, the status and deployment timestamp are updated in the Application Library, and the application view is deployed to the Planning Web application server as a Planning application.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Essbase DatabasesYou can create Essbase databases either at the time of deployment or as a separate action. To create the database outline, you select the Create Outline option when you deploy the application view.

An Essbase database is created for each plan type defined in a Planning application to store and calculate its data. You can store the following objects in an Essbase database:

• Database outlines—Define the structure of the multidimensional database consisting of dimensions and member hierarchies. The file extension is .otl.

• Calculation scripts—Enable you to perform custom calculations in addition to the standard consolidations and the standard mathematical operations defined in the database outline. The file extension is .csc.

• Report scripts—Define reports based on data in one or more databases. The file extension is .rep.

• Data load rules—Define editing operations on data files that populate the database. The file extension is .rul.


Creating Essbase Databases

Load Rules .rul

Calculation Script .csc

Outline .otl

Report Script .rep

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Reviewing Planning OutlinesAfter deploying Planning applications, you can perform the following tasks in Administration Services Console:

• View the database outline

• Add formulas to members in the outline

• Create load rules for loading data

• Load data into databases

• Calculate databases (aggregate data)

• View log reports and other database server information for troubleshooting


Reviewing Planning Outlines

View Pane

Outline Editor

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Essbase Directory StructureApplications are created with their own directory with the same name as the application. Server-based applications are in a directory under the \Hyperion\AnalyticServices\App directory; for example, \Hyperion\AnalyticServices\App\CorpBud. The databases associated with the application are in a directory under the application’s directory; for example, \Hyperion\AnalyticServices\App\CorpBud\BalSheet. This directory structure is located on the Essbase server.

Essbase objects such as calculation scripts, load rules, and reports scripts are typically located in the database directory to which they are associated. However, they can also be located in a client directory on your local client machine; for example, \Hyperion\AnalyticServices\Client.


Essbase Directory Structure

Essbase applications are stored in the following directory structure:\Hyperion\AnalyticServices\App\<ApplicationName>\<DatabaseName>

Corporate Budgeting application

Balance Sheet database (plan type)

Income Statement database (plan type)

Revenue database (plan type)

CorpBud

BalSheet

IncStmt

Revenue

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Redeploying ApplicationsIf you change the metadata, you should redeploy the application view to update the relational and Essbase databases.

After deploying Planning application views, you cannot change the following properties:

• Whether the application view uses a single currency or multiple currencies. For example, after deploying with multiple currencies, you cannot later use a single currency. Likewise, with a single-currency application view, you cannot later select Multiple Currency.

• Default application currency. Data values might not be correct because existing currency values are not converted to the new currency.

• Type of calendar. For example, if you set base time period to 12 months, you cannot later change it to quarters.


Redeploying Applications

Change in dimension hierarchy - ReplaceChange in properties - Merge

EPM ArchitectDimension Server


HYPlanapplication view

HYPlanapplication

Redeploy

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Fiscal start month. After setting the start month, you cannot change it.

• Start year. For example, if you set the start year to 2006, you cannot change it to 2005. You can, however, add years after the first year.

• Added years. After adding years, you cannot remove them. For example, if the deployed application view includes FY06, you cannot remove this year.

• Weeks distribution pattern. For example, if you set weeks distribution to 445, you cannot later change it to 544 or Even.

• Plan type, such as Valid For Plan1. You can add plan types, but you cannot remove them. For example, if you deploy an application view with the properties Valid For Plan1 and Valid For Plan2, you can later add a property named Valid For Plan3. However, you cannot later remove Valid for Plan2.

• Added dimensions. You can add up to 20 dimensions, including the required dimensions. You can rename dimensions, but you cannot delete them.

• Required dimensions. You cannot delete required dimensions. Single-currency application views require these dimensions: Scenario, Version, Entity, Account, Period, and Year. Multicurrency application views require these dimensions: Scenario, Version, Entity, Account, Period, Year, and Currency.

Oracle In

ternal & O

racle Aca

demy

Use O

nly






• Deploy applications views

• Review Planning applications in Administration Services

• Redeploy application views

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 2

Setting Up Exchange Rates 12


• Create exchange rate tables

• Enter exchange rates

• Generate currency conversion calculation scripts

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 3 Loading MetadataLesson 12 Setting Up Exchange Rates


Currencies and Exchange RatesYou can plan, forecast, and analyze financial information in single or multiple currencies. If your application is enabled for multiple currencies, users can see values converted from the local currency to a reporting currency.

You use exchange rates to convert values from one currency to another. You can plan in a variety of currencies to:

• Enable budget preparers in various countries to create plans in their native currencies

• Show summary data in reports in a particular currency

• Summarize values from multiple currencies into a single currency

For example, the base currency for Japan is the Japanese yen and that for the United States is the U.S. dollar. When you view a data form that contains values for Japan, if the display currency is set to U.S. dollars, the exchange rate for the Japanese yen is used to convert the values to U.S. dollars.


Currencies and Exchange Rates

Enter values in local currencyUse exchange rates to convert values from one currency to anotherSet up currency conversions by:— Entering exchange rates for converting to reporting currencies— Generating currency conversion calculation scripts

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Exchange Rates Tables OverviewYou enter exchange rate values through exchange rate tables. You can create exchange rate tables to correspond to different business scenarios. Each table is typically associated with one or more scenarios. However, each scenario can be associated with only one exchange rate table.

For example, you can create exchange rate tables named Actual Rates and Budget Rates. You can then associate the Actual Rates table with the scenarios Actual and Budget at Actual Rates, and associate the Budget Rates table with the scenarios Forecast and Budget at Budget Rates.

Calculation scripts run business calculations for your application. Typically, you create calculation scripts for your application using Business Rules. However, Planning automatically generates the calculation scripts needed for currency conversion.


Exchange Rates Tables Overview

To use exchange rates:Select multiple currencies when creating application viewsSpecify base currency, currency code, and symbolSpecify triangulation currency and reporting currencySet the exchange rate type

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Exchange Rate TablesYou create exchange rate tables in EPM Architect by associating them with scenarios. After you deploy the application view, the exchange rate tables are created in the Planning relational database, and users can enter exchange rate values in Planning.

You can create as many exchange rate tables as the application requires, each representing a different business scenario. For example, you can name the tables Forecast, Actual, and Budget, and associate them with multiple scenarios. Each scenario can be associated with only one exchange rate table. After creating a scenario, you can select the exchange rate table to use for currency conversion.


2

Creating Exchange Rate Tables

1

4 5

3

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To create exchange rate tables:

1. From Workspace, select Navigate > Dimension Library and create or open a Scenario dimension.

2. Create or select a scenario.

3. In the Exchange Rate Table properties field, enter the Exchange Rate table associated with this Scenario and save your changes.

4. In Planning, select Administration > Manage Exchange Rates.

The Manage Exchange Rates page is displayed.

5. Select the newly created Exchange Rate table and click Edit.

You can now enter exchange rate values into the Exchange Rate table.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Entering Exchange RatesYou can enter conversion values between the default currency and all currencies set up in the currency module. When you set up exchange rate tables, only the default currency and triangulation currencies are available as destination currencies. You can enter exchange rates from all source currencies to the default or triangulation currencies.

Types of Exchange RatesThere are three types of exchange rates associated with a currency:

• Historical

• Average

• Ending


Entering Exchange Rates

Application default currency

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You specify the exchange rate type used for each account in the Planning dimension editor when you set up accounts. For average and ending rates, you can enter rates for each time period. For the historical rate type, you enter a single rate that is used for all time periods.

To enter exchange rate values:

1. Select the Exchange Rate table, and click Edit.

2. On the Rate Table tab, select values for the following display options:

• Average

• Ending

• BegBalance

• Historical

• Method

3. Click Next.

4. On the Exchange Rate tab, select values for the following options:

• To Currency

• Show Years

• Rate Table Name

5. From the Method drop-down list, select a method.

6. In the Historical, Beg Bal, Avg, and End columns, enter values.

7. Optional: Right-click to use the Fill Year or Fill Table option.

8. Click Save.

Each exchange rate table spans all time periods of the application, so that you can apply exchange rates to all scenarios. If you create a table or modify one, you must refresh the application for the new exchange rates to be stored in the plan types.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculating Implied Rates Through TriangulationYou enter exchange rates for converting the currency values to the application’s default currency, not to reporting currencies. Planning automatically derives the rates for converting to reporting currencies by triangulation through the application currency.

For example, suppose the U.S. dollar is the application currency and the European euro is a reporting currency. You enter 1.4 as the rate for converting British pounds to U.S. dollars and 1.2 as the rate for converting European euros to U.S. dollars. To determine the rate for converting British pounds to European euros, Planning divides the British pound rate by the European euro rate: 1.4/1.2 = 1.16.


Calculating Implied Rates Through Triangulation

1.2European euros to U.S. dollar

1.4British pounds to U.S.dollar

Rate

Assumptions:U.S. dollar is the default application currency.Euro is a reporting currency.British pound is a local currency available in the application.

1.4 / 1.2 = 1.16

Oracle In

ternal & O

racle Aca

demy

Use O

nly



When you set up currencies, you specify whether the currency has a triangulation currency that allows the currency to be translated to a different currency through a common third currency—the triangulation currency. You enter exchange rates for converting from the currency to its triangulation currency. The exchange rates between the currency and other currencies that triangulate through the triangulation currency are calculated automatically. These rates are called implied rates.

For example, the British pound and the Danish krone might both be set to triangulate through the European euro. After rates are entered for converting between the British pound and the European euro and between the Danish krone and the European euro, the rates for converting from the British pound to the Danish krone and from the Danish krone to the British pound are automatically calculated.

Determining the Calculation MethodWhen you enter exchange rates for converting from one currency to another, you select either Multiply or Divide as the calculation method. For example, if you enter 2 as the rate for converting British pounds to U.S. dollars, and you select Multiply as the calculation method, 1 British pound is converted to 2 U.S. dollars.

N O T E

If you modify a currency’s triangulation currency, you must reenter exchange rates for the triangulation currency property, and you must refresh the application so that the exchange rates are transferred and stored. You cannot select the application’s default currency as a triangulation currency.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Exchange Rates and the HSP_Rates DimensionMulticurrency applications store exchange rates in the HSP_Rates dimension. The HSP_Rates dimension is created in the Essbase databases for multicurrency applications and is not available in Planning. The HSP_Rates dimension has two sets of members: input members and currency rate members.

The input members are HSP_InputValue and HSP_InputCurrency. HSP_InputValue stored data values, and HSP_InputCurrency stores currency types for those data values. When you enter or load a data value in a cell for the local currency, it is stored at the intersection Local -> HSP_InputValue. The intersection Local -> HSP_InputCurrency stores the currency code for that value.

The currency members of the HSP_Rates dimension store the exchange rates for each currency. There is an HSP_Rates member for each currency added to the application.


Exchange Rates and the HSP_Rates Dimension

Input members

Currency (Rate) members

Draft 1

100.00 USD

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Generating Currency Conversion Calculation ScriptsTwo types of calculation scripts are associated with currency conversion: one that copies exchange rates to account members and one that executes the currency conversion. To generate these calculation scripts, you select options on the Manage Currency Conversion window. You run calculation scripts using the Launch Business Rules task in Planning.

When you generate the calculation script, you select the reporting currencies, scenarios, and versions for which you want the calculation to run. You can generate currency conversion calculation scripts to correspond to different business processing scenarios. Typically, you create a separate calculation script for each scenario.


Generating Currency Conversion Calculation Scripts

1. Select Administration > Manage Currency Conversion.2. Click Create.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Copy Rates Calculation ScriptsThe Copy Rates calculation script copies the appropriate exchange rate to the individual account members based on their exchange rate type. Performance is improved because Planning can retrieve the conversion rate for the account directly, without looking up the rate type.

Separate copy rate calculation scripts are generated for bottom-up and target versions. The name of the script is HspCRtB for bottom-up versions and HspCRtT for target versions. You run these scripts after you enter exchange rates and before you run the currency conversion calculation script for the first conversion. Subsequently, you run the copy rates calculation scripts only under these conditions:

• Exchange rates change.

• Account exchange rate types change.

• The exchange rate table assignment for a scenario changes.

• The metadata changes; for example, a new currency or account is added.

Currency Conversion Calculation ScriptPlanning generates a calculation script to convert values for local currencies to one or more reporting currencies. The calculation script converts values for all accounts and entities. The currency conversion calculation script generated by Planning converts only level 0 members for bottom-up versions and all levels for target versions. For bottom-up versions, you must run an aggregation to populate upper-level members with the new converted values.

Because the Currency Conversion calculation script runs for all entities and accounts in your application, it typically is run by budget administrators rather than end users. If end users need to see their data converted to a reporting currency, they should use the Calculate Currencies business rules associated with data forms.

Calculate Currencies Business RuleIn addition to generated currency conversion calculation scripts, a dynamically system-generated business rule is associated with data forms. It converts data from the local currency to the reporting currency for only the members currently displayed on the data form. This business rule enables planners to view converted values for the entered data.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Create exchange rate tables

• Enter exchange rates

• Generate currency conversion calculation scripts

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 4

Loading Data and Calculating the Database 12

OverviewThe aim of this module is to discuss the requirements for data load files, when to use data load rules, and how data is calculated within a dimension, data blocks calculation order, and using calculation scripts. You also load data using EPM Architect and using Administration Services and calculate the database.


• Loading and Calculating Data Overview

• Loading Data

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 3

Loading and Calculating Data Overview 13


• Define the requirements for data load files

• Set up data load rules and load data using data load rules

• Set up the data staging area using interface tables

• Identify how data is calculated within dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 4 Loading Data and Calculating the DatabaseLesson 13 Loading and Calculating Data Overview


Loading DataPlanning creates an Essbase database for each plan type in your application. You can load data directly into the Essbase database that corresponds to the plan type in your application. When you create your Planning application, the Essbase databases do not contain data.

You can load data values from external systems into your Planning application. For example, you might want to load data for actuals from your ERP system so that you can calculate variances.

You can use the following methods to load data:

• Data can be extracted to ASCII text files (flat files) from external systems and loaded using Essbase data load rules.

• Data can be loaded with EPM Architect interface tables.


Loading Data

You can:Load data directly into the Essbase database for each plan type.Use any of the following for loading data:— Administration Services— EPM Architect Interface Tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To load data, you must have:

• An Essbase database into which you load the data or in which you build an outline

• A connection to the Essbase Server

• Any of the following valid data sources:

- Microsoft Excel files (Version 4.0 and later) with the .xls extension (You must load Microsoft Excel files of Version 5.0 and later as client objects or files in the file system.)

- Lotus 1-2-3 files with the .wks, .wk1, .wk3, or .wk4 extension

- Spreadsheet audit log files

- Flat files from ASCII backups or external sources

- Essbase export files

• If you are not using a rules file for loading data, a data source correctly formatted for free-form data loading

• If you are using a rules file for loading data, a rules file validated for data loading

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Requirements for Data Load FilesThe first graphic shown on the slide is an example of a data load file that loads data values for the first quarter of 2007 for the Europe entity and the Gross Sales account in the Actual scenario and the Final version. If a dimension has the same value for all rows, you can place it in the header as a page dimension, as shown in the second graphic on the slide.

Requirements:

• Each data point must be tagged with a member from each dimension.

• Data must be for bottom-level members, unless you are loading data into a target version.

• Data is scanned from the top of the file and from left to right.

• Each field (item) in a record (row) must be separated by a delimiter.


Requirements for Data Load Files

Use Essbase to load data from flat files into your Planning application.

EUROPE GROSS SALES ACTUAL FINAL Jan 2007 1000EUROPE GROSS SALES ACTUAL FINAL Feb 2007 400EUROPE GROSS SALES ACTUAL FINAL Mar 2007 650

DataEntity Account Scenario Version Period Year

ACTUAL FINALEUROPE GROSS SALES JAN 2007 1000EUROPE NET INCOME FEB 2007 400ASIA NET INCOME FEB 2007 300ASIA GROSS SALES JAN 2007 200

BUDGET DRAFT 2008ENTITY PERIOD CUSTOMER 4000-100 4000-200 4000-300EUROPE FEB MY COMPANY 1500 1700 1200

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• A member name or alias must be enclosed in double quotation marks (" ") if it contains blanks, numeric characters (0–9), dashes, or unary operators. It must also be displayed exactly as it is in the outline.

• Members of the same dimension must be in the same column or row.

• Members of different dimensions can be together only on the page header. They cannot be used together in any other row or column.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Multicurrency ApplicationsApplications that support multiple currencies include an additional dimension called HSP_Rates. This dimension is used to store exchange rates. The HSP_Rates dimension includes the following members:

• HSP_InputValue—This member stores data values.

• HSP_InputCurrency—This member stores currency types for the data values.

• HSP_Rate_<XXX> —XXX represents a currency in a multicurrency application.

You load data to the HSP_InputValue member and the local currency. The HSP_InputCurrency member is not displayed in Planning. However, if the default currency is overridden, the new currency is stored along with its value in the database. By storing the new currency, Essbase can apply a different currency value to the data displayed for HSP_InputValue.


Multicurrency Applications

The HSP_Rates Dimension has the following members:HSP_InputValueHSP_InputCurrencyHSP_Rate_<XXX>

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up Data Load RulesYou use data load rules to delineate how data is loaded into Essbase databases. Load rules can perform certain actions on the data originating from external data sources as it is loaded into the Essbase database. For example, if the data file contains fields that are not needed, you can ignore those fields during the data load.

Create data load rules when any of the following criteria need to be applied during a data load:

• Ignore fields or strings in the data source.

• Change the order of fields by moving, joining, splitting, or creating them.

• Map the data in the data source to the database by changing strings.

• Change the data values in the data source by scaling the data values or adding them to existing values in the data source.


Setting Up Data Load Rules

Data load rules map the external data values to the Essbase database.

2008 Budget Draft 1 USREG Local 210-MICH N001 HSP_InputValue Jan2008 Budget Draft 1 USREG Local 210-MICH N001 HSP_InputValue Feb2008 Budget Draft 1 USREG Local 210-MICH N001 HSP_InputValue Mar

Raw data f ile

Rules applied

Data Prep Editor

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Set header records for missing values.

• Reject invalid records and continue loading data.

Data Prep Editor You can use the Data Prep Editor to create data load rules. You access the Data Prep Editor from the Administration Services Console.

The Data Prep Editor contains two areas. The upper area provides a view of the data source, called the raw data source. The lower area contains a grid showing the appearance of records after rules are applied (that is, as they will be loaded into the database). Data load rules do not modify the content of the raw data source.

The Data Prep Editor displays two fields: Data Load and Dimension Build.

Opening a Data Source After you open the Data Prep Editor, you can open data sources such as flat files, spreadsheet files, and SQL data sources.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Staging Data Using Interface Tables Interface tables in EPM Architect are database tables used to import data from external systems into EPM Architect.

You can create multiple EPM Architect interface databases. The EPM Architect database type can be different than the database for the interface tables. For example, the EPM Architect database can be Microsoft SQL, and the EPM Architect interface tables can use Oracle.


Staging Data Using Interface Tables

Interface tables enable you to:Stage data for import into PlanningCreate multiple tables for data importReuse staging areas for data loading

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data Calculation OverviewTypically, you load data into the level 0 members of a database. After loading data, you calculate the database. When you calculate the database, child member values are aggregated to derive parent member values. Calculating the database also applies member formulas defined in the outline.


Data Calculation Overview

There are three types of calculations in Planning:Calculations within dimensionsCalculations and data blocksCalculation scripts

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculations Within DimensionsThe calculation of a dimension follows the outline structure. Values for upper-level members are calculated based on values of lower-level members as defined by the parent-child relationships in the outline. The order in which members are calculated follows the order in the outline:

• Calculations start at the lowest level of a branch from top to bottom.

• Calculations move up to the next level when the end of a subbranch is reached.

The example on the slide depicts the order of a calculation in the Account dimension. Selected calculations occur in the following order:

• Within the Margin branch: Sales and then COGS

• Within the Profit branch: Margin and then Expenses

• Within the Measures branch: Profit, then Inventory, and then Ratios


Measures (Label Only)

Profit (+)

Margin (+)

Sales (+)

COGS (-)

Expenses (-)

Marketing (+)

Misc. (+)

Inventory (+) (Label Only)

Opening (+) (TB First)

Ending (+) (TB Last)

Ratios (+) (Label Only)

Margin % (+) (Two Pass Calc) Margin % Sales;

Product Share (+) (Two Pass Calc) Sales % Sales -> Products;

Calculations Within Dimensions

Level 2

Level 1

Level 0

7

3

1

2

6

4

5

8

9

10

11

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculations and Data BlocksEssbase databases are organized into data blocks. As you recall, a data block consists of all dense dimensions members in the outline for a unique combination of sparse dimension members. There is potentially a data block for each unique combination of sparse dimension members.

The order in which the data blocks are calculated follows the order in which the sparse dimensions are listed on the Performance Setting screen. You can view the performance settings for dimensions in an application view by right-clicking the application view, and selecting Performance Settings. The data blocks for the members of the first sparse dimension listed on the Performance Settings screen of the Planning Dimension Editor are calculated first, and so on down the list.


Calculations and Data Blocks

Sparse DimensionCalculation

Dense Dimension Calculation

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculation begins with level 0 data blocks. Level 0 data blocks are those for which each sparse dimension member is a level 0 member. To calculate the values for a data block, the Essbase Server calculates the dense dimension members of the data block. After calculating the values for the level 0 blocks, it aggregates them to derive the value for the upper-level blocks. This process is repeated for each level of data blocks until the top is reached.

The graphic shown in the slide depicts the following example:

• There are level 0 data blocks for the Los Angeles and San Francisco sparse dimension members, and an upper-level data block for California, their parent.

• The data blocks each have Account and Period dimensions as dense dimensions.

• Essbase calculates the Account members and the Period members for the Los Angeles and San Francisco data blocks, based on the outline structure for the Account and Period dimensions.

• Next, it aggregates the Los Angeles and San Francisco data blocks to derive the values for the California data block. If the California data block exists, the current values are overwritten. If it does not exist, the data block is created.

When Essbase calculates the dense dimension members for a data block, it first calculates the Account dimension, and then the Period dimension. The remaining dense dimensions are then calculated based on their order on the Performance Settings screen.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculation ScriptsEvery database needs at least one calculation script to aggregate unary operators and execute formulas in the outline. For most database calculations, the default outline calculation script provides the required results. You can run the default outline calculation script from Administration Services Console.

In certain cases, you may need to write a calculation script to control how Essbase calculates a database. You can use Business Rules as a graphical environment to create calculation scripts. You can also create native Essbase calculation scripts using a text editor or the calculation script editor provided by Essbase.


Calculation Scripts

Calculation scripts:Contain a series of calculation commands, equations, and formulas.Define calculations other than the calculations defined by the database outline.Specify how to calculate a database.

The default calculation script calculates the entire database.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Define the requirements for data load files

• Set up data load rules and load data using data load rules

• Set up the data staging area using interface tables

• Identify how data is calculated within dimensions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 4

Loading Data 14


• Create load rules for data files for Administration Services

• Load data using Administration Services

• Load data using interface tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 4 Loading Data and Calculating the DatabaseLesson 14 Loading Data


Loading Data Using Administration ServicesYou use Administrative Services to load data values into Planning applications. You load data directly into the Essbase databases that correspond to the plan types in the application.

To load data values:

1. In Administration Services, select the database where you want to load data, right-click, and select Load data.

2. Click Find Data File to select a file to load.

3. Optional: Click Find Rules File to select a rules file.

4. Click OK.


Loading Data Using Administration Services

32

1

4

Right-click database; Select Load data

Optionally: Select the rules fileSelect the file to load

Click OK

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Data Load RulesData load rules are sets of operations that are performed on data from external data sources when the data is loaded into an Essbase database. Data load rules map external data values to the Essbase database.

You specify these options when you create data load rules:

• Set file delimiters

• Associate the rules file with an outline

• Define header information

• Map fields to member names and column fields

• Manipulate column fields and replace text strings


Creating Data Load Rules

1 Right-click database; Select Create > Rules file

2 From the View menu, select Data load fields

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Opening Data SourcesAfter you select to create a rules file, the Data Prep Editor is opened. Next, open data sources to see what data needs to be changed. The data source can be located on the Essbase Server, locally, or on the network. Examples of valid data source files are Microsoft Excel and Lotus 1-2-3 spreadsheets, plain text files, and Essbase export files.

Setting File DelimitersFile delimiters are the characters that separate fields in the data source. By default, the rules file separates fields using tabs. You can set the file delimiter to be a comma, tab, space, fixed-width column, or custom value. Usually, the first thing you do after opening a data source is set the file delimiter.


Opening Data Sources

1 Open a data file 2 Select a file

3 Click OK

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Associating Rules Files with OutlinesYou associate the rules file with an Essbase database outline in order to populate list boxes with dimension and member names. Typically, you select the outline of the database into which you load the data. The rules file is not permanently associated with that outline, and you can associate it with another outline later. The rules file must be associated with an outline before you can validate the rules file.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Defining Header RecordsYou can use the Data Prep Editor to create header records in rules files. Data sources can contain data records and header records. Data records contain member and data fields. Header records describe the contents of the data source and how to load data values into the database.

A rules file contains records that translate the data in the data source to the database. As part of that information, the rules file can also contain header records.

Defining Header Information in Rules FilesHeaders are used only during data loads or dimension building. They do not change the data source. Header information in a rules file is not used if there is also a dynamic reference in the rules file pointing to a header record in the data source.


Defining Header Records

Headers in data source

Headers in rules file

1st quarter Budget DataJan Feb ...

New York ... 150 160 ...Albany ... 60 60 ...White Plains... 20 20 ...

Skip two lines and map to Budget

New York ... 150 160 ...Albany ... 60 60 ...White Plains... 20 20 ...

Entity ... Jan Feb ...

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Defining Header Information in Data SourcesIf the data source contains header information, you can specify its location in the rules file. The rules file then passes information to the Essbase Server to read the header information as a header record and not as a data record. You can also specify the type of header information in the header record. For example, the header record can contain data load field names.

If the data source does not have header information, you can add it to the data source by using a text editor or spreadsheet and then identifying those records as the header information in the rules file. Placing header information in the data source makes it possible to use the same rules file for multiple data sources with different formats: The data source format is specified in the data source header, not in the rules file.

N O T E

Header information defined in the data source takes precedence over header information defined in the rules file.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Associating Column Fields with Dimensions and MembersWhen loading data from a data source file, you must specify how the fields in the data source file map to the dimensions in the database. Data load rules refer to columns in the data source file. When setting up a data load rule, you must match each column of information to a specific dimension or a member within a dimension. Each column of information contains either a member label or a data element. In a data load, you must specify every dimension in the database in either the data source or the rules file. If the data source does not identify every dimension in the database, you must identify the missing dimensions in the rules file.

Mapping Fields to Member NamesA rules file can translate fields in the data source to match member names each time the data source is loaded without changing the data source. The rules file performs the following tasks:


Use the Field Properties dialog box to map column fields to dimensions and members.

Manipulate column fields to create unique member names.

Associating Column Fields with Dimensions and Members

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Maps member fields in the data source to members in the database

• Maps data fields in the data source to member names or member combinations (such as Jan, Actual) in the database

You can also define rules for these purposes:

• Name, or translate, the fields in the data source to match members in the database

• Replace strings or translate the fields in the data source to match members in the database

Mapping Column FieldsA column field can contain the name of a valid dimension member or an alias. Use one of the following methods to specify a field name:

• On the Data Load Properties tab of the Field Properties dialog box, in the Field name text box, enter the member name or member combination to which the current field maps.

From the Dimension node, select the field name that displays the names of the dimensions and members in the associated outline.

If a field represents information that is not data and is extraneous to the outline, you can ignore the field by selecting the “Ignore field during data load” check box. You use the Data Load Properties area of the Field Properties dialog box to define field names for the columns of the rules file.

Manipulating Column FieldsYour data source may not always have columns in the correct sequential order, or you may need to manipulate column details such as duplicating, parsing, or concatenating columns to create unique member names.

Action DescriptionMove Changes the sequential order of columns

Split Parses fields; used for segregating columns where the source file has fields of variable length and does not have field delimiters

Join Joins two or more columns

Create Using Join Creates a column or set of columns; used to duplicate a column

Create Using Text Creates a column that contains any text, including white spaces

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Replacing Text StringsYou can use a rules file to replace text strings so that the fields map to Essbase member names during a data load. The data source is not changed. For example, if the data source abbreviates New York to NY, you can have the rules file replace each NY with New York while loading the data.

Replace options:

Option DescriptionReplace Use the Replace text box to enter the text string to be replaced.

With Use the With text box to enter the text string to replace the one in the Replace text box.

Case-Sensitive Select Case-Sensitive to construct a condition based on a case-sensitive string.


Replacing Text Strings

You can:Use a rules file to replace text strings so that fields map to Analytic Services member names during a data loadReplace text strings without changing the data source

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Match Whole Word Select Match Whole Word to indicate that Essbase should replace the text string only when it occurs as an entire word. If the text string is embedded in another word, it is not replaced.

Replace All Occurrences

Select Replace All Occurrences to indicate that Essbase should replace all text strings that match the text string in the With field. By default, Essbase replaces the first occurrence.

New Click New to add a new line for additional changes entered in the Replace and With fields.

Delete Click Delete to remove items from action lists.

Original Select Original to leave existing fields in their original case. By default, this option is selected.

Lowercase Select Lowercase to change all characters of the field to lowercase.

Uppercase Select Uppercase to change all characters of the field to uppercase.

Prefix Use the Prefix field to enter a text string to be added at the beginning of the field values. (You cannot use parentheses in the Prefix text box.)

Suffix Use the Suffix field to enter a text string to be added to the end of the field values.

Drop leading/trailing spaces

Select “Drop leading/trailing spaces” to remove leading and trailing white spaces around fields. (A field with leading or trailing white spaces does not map to a member even if the name within the white spaces is an exact match.)

Convert spaces to underscores

Select “Convert spaces to underscores” to change white spaces in field values to underscores.

Option Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Validating and Saving Rules FilesYou can validate a rules file to ensure that the member and dimension mapping defined in the rules file maps to the outline. However, validation does not ensure that the data source will be loaded properly.

The rules file is validated against the associated outline. When the Essbase Server finishes the validation, the Validate Rules dialog box is displayed. It contains information about the validation process, including fields that did not map to the outline. If the rules file is validated without problems, you can use it to load data.

After validating the rules file, save it to the Essbase Server or locally. The name must be a valid name in your operating system. In addition, the rules file name that you specify must be eight or fewer alphanumeric characters in length. Essbase automatically adds the .rul extension.


Validating and Saving Rules Files

You should validate the rules file before saving it.You can save the rules file to a local file system or network or to the Essbase Server.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Fixing an Invalid Rules FileIf the rules file does not validate, you must fix it before loading data. Go to the field specified in the Validate Rules dialog box that did not pass validation. Check the following items:

• Is the field name spelled correctly?

• Are the file delimiters placed correctly?

• Is there a member name in the field name?

• Is the dimension name used in another field name or the header?

• Is a member used as a member combination in one place and as a single member in another?

• Is more than one field defined as a data field?

• Is the dimension used for transposing signs in the associated outline?

• Is the rules file associated with the correct outline?

After making the corrections, run the validation again.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Loading Data Using Rules FilesAfter the rules file is generated, you can load data using the rules file.

To load data:

1. From Enterprise View or a custom view, select the database. Right-click and select Load data.

The Data Load dialog box is displayed.

2. Select one or more data sources.

3. Click the Find Rules File button and select the rules file name.

The rules you selected are displayed on the Data Load dialog box in the Rules File column.


Loading Data Using Rules Files

1

2 3

4

5

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Optional: Specify where errors should be written.

By default, errors are written to the Hyperion\AnalyticServices\client directory.

5. Click OK to load the data.

Essbase runs the data load.

6. Check errors and status messages that are displayed in the Messages panel at the bottom of the console window as well as those written to the error file.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Interface TablesYou use Interface tables to create a staging area for loading data from outside systems (EPR, ETL, GL, and so on) into EPM Architect for use in Planning. Using interface tables to load data helps you to streamline the data load process. You can predefine a data set that you want to import into Planning and stage it for loading at any time.

You can create multiple Interface Tables for staging data.

N O T E

Before you can load data from interface tables, you must first have a relational database set up to store the information in the tables, and then you must run the Hyperion Configuration Utility to configure the tables in the new relational database.


Interface Tables

ETL Planning

EPM Architect

Interface Tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Interface TablesYou create Interface Tables within the Data Synchronization module of EPM Architect.

You can load data into the Dimension Library using interface tables.


Creating Interface Tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Loading Data Using Interface TablesOnce you stage data in your ETL system and you create interface tables, you can use the interface tables to load data into Planning.

To load data:

1. In EMP Architect, select a Planning application.

2. Right-click and select Action > Import.


Loading Data Using Interface Tables

Interface Table Import Process in Hyperion System 9

Process before Interface Table ImportEPRSystem

GeneralLedgerSystem

ETLSystem

InterfaceTables

InterfaceTables

DimensionLibrary

DataSynchronization

EPM Architect DB

FinancialManagement

Planning

AnalyticServices

EPM Architect

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Create load rules for data files for Administration Services

• Load data using Administration Services

• Load data using interface tables

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 5

Setting Up Security 14

OverviewThe aim of this module is to provide an overview of security in Planning. You learn how to provision users and user groups in the User Management Console of Shared Services for your Planning application. You also learn how to assign access rights to elements of your Planning application.


• Provisioning Users and Groups

• Setting Up Access Rights to Planning Applications Applications

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 5

Provisioning Users and Groups 15


• Describe security in Planning

• Describe user provisioning in Shared Services

• Provision users and groups for Planning

• Generate provisioning reports

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 5 Setting Up SecurityLesson 15 Provisioning Users and Groups


Planning Security OverviewSecurity in Planning is based on user privileges. User privileges are system roles and access rights that can be assigned to users or to groups.

Groups are sets of users who need similar access rights. After users and groups are defined, you can assign the users and groups access rights to application elements. For example, you can assign a user or a group access to Entity dimension members or data forms.

Access rights for users and groups can vary by application and can be assigned for the following application elements:

• Scenario, Version, Account, Entity, and user-defined custom dimension members

• Data forms

• Task lists

After you establish or update user and group security and assign member access, you must refresh the Planning application to update to the Essbase security filters.


Planning Security Overview

In Planning, you can perform the following security-related tasks:

Determine user privileges

Assign access rights to application elements

Create security filters

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Levels of SecurityPlanning provides security at four levels:

• Users must provide a valid ID and password to log on to the system.

• Users can launch only those tasks to which they have been given access. For example, you can give users the ability to create data forms but not dimension members.

• Users can open only those data forms and task lists (objects) to which they have been granted access.

• Users can view and modify data only for dimension members to which they have been granted access.


Levels of Security

There are four levels of security in Planning.

Object security

Data formsand task lists

Userauthentication

Tasksecurity

Datasecurity

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User AuthenticationUser login information for Hyperion applications is stored outside the applications in an authentication directory. The information is maintained by a central authentication directory.

An authentication directory is a centralized store of users and passwords, user groups, and perhaps corporate information, such as employee IDs or job tiles. The following types of authentication directories are supported:

• Windows NT LAN Manager (NTLM) on NT 4.0 or higher, Windows 2000, and Windows 2003

• Lightweight Directory Access Protocol (LDAP) version 3 or later

• Microsoft Active Directory (MSAD) server, Windows 2000 SP3 or later

You can grant access to your Planning applications to any user or group in an authentication directory. When you grant a group access to an application, the users in the group are also granted access to the application.

You grant access in the Shared Services User Management Console.


User Authentication

Users must provide a valid user name and password to access an application.Planning leverages external authentication providers such as LDAP, Microsoft Active Directory, and NTLM.Users and groups must exist in the authentication directory before they can be granted access to a Planning application.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Task SecurityTask security determines the tasks in an application that a user can access. You assign task security by assigning a role to a user. Each role is associated with a set of tasks. For example, interactive users cannot change dimension members, so the dimension change option is not available to interactive members.


Task Security

With task security, you can perform the following tasks: Specify the tasks that users and groups are authorized to performAssign roles to users to implement task securityRemove or disable menu items for certain users

Administration menu, administrator’s view Administration menu, interactive user’s view

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Object SecurityWithin your Planning application, you can assign security to specific objects, such as data forms and task lists. For example, you can allow all users to access the standard expenses data form but allow only payroll managers to use the salary expense data form.


Object Security

You can assign security to specific objects in your application.

Data form Task list

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data SecuritySetting up data security enables you to protect data and prevent unauthorized users from changing data. For example, you can restrict access to certain data elements in an application.


Data Security

You can assign users or groups read, write, or none access to data for specified dimension members.

Entity Members

East RegionWest RegionUnited KingdomSingapore

Assigned Access Level

WriteReadReadNone

RJackson

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User and Group Provisioning OverviewUser provisioning enables centralized management of users, their role assignments and their access rights to applications created under various projects of various products. To perform provisioning for Planning applications, you use User Management Console.

The provisioning process enables you to associate applications to projects. Then, users and groups, with their applicable roles, are associated to the applications.

To access User Management Console, select Start > Programs > Hyperion > Foundation Services > User Management. Any user with the Provisioning Manager or Administrator role in an application can perform provisioning.

The three main nodes of User Management Console:

• User Directories

• Projects

• Unassigned Applications


User and Group Provisioning Overview

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User DirectoriesIn User Management Console, you view user directories that consist of users and groups.

User directories can be provided (set up) natively or externally. External directories (LDAP, NTLM, and MSAD) hold users and groups in each directory. External directories are typically corporate directories.

You provision users and groups by assigning user roles in an application. A user can receive a combination of individual and group role assignments.


User Directories

User Directories list users from native and external directories.

User Directories: Native and NTLM

User list for selected directory

Oracle In

ternal & O

racle Aca

demy

Use O

nly



ProjectsBefore you can provision users or groups for a Planning application, the application must be registered in Shared Services and belong to a project. A project is an instance of Hyperion products that are grouped to compose an implementation. For example, a Planning project may consist of a Planning application, an Essbase application, and a Financial Reporting Server instance. You can add one or more applications to a project. You can add applications at the time the project is created or at a later time.

To create a project, right-click Projects, and select New > Project. You then give the project a name and description and assign applications as required.

N O T E

An application can be associated with only one project.

T I P

In a practical sense, you can think of a project as a type of folder.


Projects

Projects group instances of Hyperion products that compose an implementation.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Unassigned ApplicationsWhen you log on to your Planning application for the first time, you are prompted to register the application with Shared Services. When you register your application, you can assign it to an existing project, create a project and assign the application to it, or leave it as an unassigned application to be assigned to a project at a later time. You need to create at least one project in Shared Services and add your application to it before you can provision users and groups to the application.


Unassigned Applications

Before you can provision users or groups to an application, you must assign the application to a project.

Planning application that has been registered with Shared Services but not yet assigned to a project

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Provisioning Users and GroupsWithin a user directory, you provision users and groups to your Planning application. You provision users to enable them to access applications and perform application tasks. You can select Provision from the Administration menu, or you can right-click the user and select Provision.

To provision users or groups

1. Select Start > Programs > Hyperion > Foundation Services > User Management.

2. Log onto User Management.

User Management Console is displayed.

3. In the view pane, expand User Directories.


Provisioning Users and Groups

Select a role

Click SaveClick Add

9

1011

Expand an applicat ion8

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Select and expand Users, to provision and assign roles to users, or Groups, to provision and assign roles to groups.

5. Click Show All to display a list of users or groups.

6. Select the user or group that you want to provision.

7. Select Administration > Provision, or right-click a user or group and select Provision.

8. Expand the project that contains the application for which you want to provision the user or group and for which you want to assign roles.

9. Expand the application for which you want to provision the user or group and for which you want to assign roles.

10. Select the role or roles that you want to assign to the user.

11. Click Add.

12. Click Save.

13. Select File > Exit to return to Planning.

T I P

Users that are provisioned for a Planning application as either Administrator or Interactive User do not need to be provisioned separately for Business Rules.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



User RolesYou assign user roles to users and groups based on the tasks that users need to perform in applications. Planning provides user roles that can be assigned to users and groups.

The following global Shared Services roles are also used in Planning:

• Application Creator— Creates applications. This is a EPM Architect role.

• Dimension Editor — Creates profiles and imports dimensions. This is an EPM Architect role.

• Create Integrations — Creates Shared Services data integrations (the process of moving data between applications) using a wizard.

• Run Integrations — Views and runs Shared Services data integrations.


User Roles

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The following table summarizes Planning user profiles.

User Profile DescriptionProvisioning Manager Users who are assigned the Provisioning Manager role can

provision users and groups to applications.

Administrator Administrators can create applications; manage security; maintain metadata; initiate and manage the budget process; create and maintain Web-based data forms; create and manage task lists; create and maintain Smart View worksheets; create and launch business rules by using Business Rules; and enter, view, and delete data.

Manage Models Users assigned the Manage Models role can export and import Shared Services models.

Interactive User Interactive users can enable e-mail notification; create and maintain Web-based data forms; create and manage task lists; create and maintain Smart View worksheets; create and launch business rules by using Business Rules; enter, view, and delete data; and submit information and data for approval.

Planner Planners enable e-mail notification; input, submit, and view data; use reports that have been built by others; run data integration routines designed by others; execute business rules and other processes associated with validating and preparing data; view and use task lists; use Smart View; and submit information and data for approval.

View User View users have limited access to view data in a Planning application. Typically, the view user is an executive who wants to see business plans during and at the end of the budget process.

Offline User Users assigned the Offline User role can take planning data offline, work with data offline, and then synchronize data back to the planning server. Offline users can work offline only if the administrator has enabled Offline in Application Settings for the application.

Mass Allocation Users assigned the Mass Allocation role can spread data by using the Mass Allocation function. Mass Allocation spreads data either proportionally or relatively to other members in the outline. Even though you run Mass Allocation from data forms, data is spread to members even if they are not displayed on the data form. This role only should be assigned to a select few people because there is no undo functionality after spreading data by using Mass Allocation.

Essbase Write Access Users assigned the Essbase Write Access role can lock and send with write access to Essbase. If you assign this role to planners and interactive users, you give them write access directly to planning data in Essbase.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



P

Generating Provisioning ReportsYou can generate provisioning reports to list the details of the users, groups, and roles that are provisioned.

To generate the report, in User Management Console, select Administration > View Report.


Generating Provisioning Reports

Generate a provisioning report to list the provisioned users and groups.

Generate the report.

1

Specify a specific user, group, a role or all three.

Specify one or more items.

Group results by application or user.

3

4

2

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe security in Planning

• Describe user provisioning in Shared Services

• Provision users and groups for Planning

• Generate provisioning reports

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 6

Setting Up Access Rights to Planning Applications 16


• Assign access rights

• Import access rights

• Create security filters

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 5 Setting Up SecurityLesson 16 Setting Up Access Rights to Planning Applications


Assigning Access RightsYou assign access rights to Planning application elements to protect data from unauthorized users or groups. The level of security is determined by the access option that you assign to a user. You can assign access by using dimension member relationships or by assigning access directly to individual dimension members. You can define unique access rights for each Planning application.

You can assign access rights to the following application elements:• Scenario, Version, Account, and Entity dimension members• User-defined custom dimension members, if the Apply Security dimension property

is selected• Data forms• Task lists

You can use the dimension editor to assign access to dimension members, or you can use the ImportSecurity utility to import access rights information from a flat file.

You assign access to data forms in Form Management and to task lists in Task Management.


Assigning Access Rights

Use access rights to prevent unauthorized access to data.

Assign access

View access

Add access

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Access OptionsWhen you assign access rights to a dimension member, data form, or task list, you determine which access option to assign for each user or group. By default, for interactive users and planners, access is denied to all dimension members, data forms, and task lists.

The following table describes the access options for dimension members and data forms.

Option DefinitionRead Enables users to view the dimension member or data form

Write Enables users to view and modify access to the dimension member or data form

None Prevents users from accessing the dimension member or data form


Access Options

Member and data form access rights consist of the following options:— Read— Write— None

Task list access rights consist of the following options:— Assign— Manage— Manage and Assign— None

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The following table describes access options for task lists.

Option DescriptionAssign Enables users to view and use the task list

Manage Enables users to modify the task list

Manage and Assign Enables users to modify, view, and use the task list

None Prevents users from viewing the task list

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Inheritance OptionsYou can assign access rights to individual dimension members, or you can use an inheritance option to assign rights to multiple members.

It is more efficient to assign access rights by using an inheritance option. You should assign access to individual members only on an exception basis. For example, for the North America Sales group, you could assign Write access to North America and its descendants and Read access to North America Headquarters.

The following table summarizes the available inheritance options.

Option ResultMember The access right is assigned only to the currently selected

member.

Children The access right is assigned to all child members of the currently selected member.


Inheritance Options

The following inheritance options are available:MemberChildreniChildrenDescendantsiDescendants

Oracle In

ternal & O

racle Aca

demy

Use O

nly



iChildren The access right is assigned to the currently selected member and to all of its child members.

Descendants The access right is assigned to all descendant members of the currently selected member.

iDescendants The access right is assigned to the currently selected member and to all of its descendant members.

Option Result

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Precedence and Inheritance of Access RightsYou can assign access rights to a member in the following ways:

• The user can be assigned direct access to a member.

• The group can be assigned direct access to a member.

• The user or group can be assigned access to a member by relationship, by using an inheritance option.

Access rights from different sources can conflict with each other. For example, you might be assigned direct Read access to a member and Write access to the same member through membership in a group. The following sections explain the rules of precedence.


Precedence and Inheritance of Access Rights

Individual rights override group rights

For group rights, no access overrides write or read access. Write access overrides read access.

Direct member rights override relationship rights

United StatesUnited StatesLA

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Individual Rights Over Group RightsAccess rights that are assigned directly to a user override access rights that are inherited from associated groups. For example, if, for the Budget member, you inherit Read access through a group and are assigned direct Write access, you have Write access to the Budget member.

Group PrecedenceA user might belong to several groups that have conflicting access rights to a member. In this case, None access take precedence over Write or Read access. Write access takes precedence over Read access. Here are some examples:

• If you have Write access to the Budget member from one group and None access to Budget from another group, you have None access to Budget.

• If you have Read access to the Budget member from one group and Write access to Budget from another group, you have Write access to Budget.

Direct Member Rights Over Relationship RightsYou can assign access rights to members indirectly through relationships to a parent or ancestor member. Rights that are assigned directly to a member override rights that are derived from a member relationship. Here are some examples:

• You are assigned None access to children of the United States. You are assigned direct Read access to LA. You have Read access to LA.

• You are individually assigned Write access to children of the United States. Your group is assigned direct Read access to LA. You have Read access to LA.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Reporting on Access AssignmentsTo help you effectively view the current access assignments in an application, you can generate assigned access reports. You can also generate effective access reports to help resolve inheritance or precedence conflicts. You generate these reports from User Management Console.

When you generate an assigned access or an effective access report, you specify what information to include. You can specify whether to include the following information:

• Specific users and groups or all user and groups• Specific dimensions or all dimensions• Data forms• Matching access types: Read, Write, or None

You can choose to group results by users or by objects. You also can choose to report on assigned access by access relationship and inherited group or on effective access, including effective access origin.


Reporting on Access Assignments

12

3

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Importing Security Overview You can load access rights from a text file into Planning by using the ImportSecurity utility, which enables you to quickly assign access for many members, users, and groups. When you import access rights for a member, existing rights assigned to that member are overridden. Access to other members is not affected unless you specify the parameter that clears all existing access assignments, SL_CLEARALL. You can use this parameter alone to clear all existing access assignments, or you can use it with other ImportSecurity parameters to replace all existing access assignments with the import file assignments.

For example, Joe currently has Write access to OLAP Sales. The import file contains the following line:

Joe, eBusiness Sales, Write

After importing, Joe has Write access to both OLAP and eBusiness Sales.


Importing Security Overview

You can use the ImportSecurity utility to load access rights information.You create a text file named SecFile.txt and locate the file in the Hyperion\Planning\bin folder.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating the Secfile.txt FileWhen creating the import security text file, consider the following points:

• The name of the text file must be Secfile.txt, and the file must be saved in the Hyperion\Planning\bin folder.

• All users, user groups, and members must be defined in the application.

• You cannot import access assignments for data forms and task lists.

• Before importing security for a user-defined custom dimension, for the dimension, on the Property tab, you must enable the Apply Security option.

• When importing access rights for many users, you can improve performance by making sure that users’ full names are not used in Planning preferences.


Creating the Secfile.txt File

Use a text editor to create the Secfile.txt file with the following syntax:<User or Group Name>,<Member Name>,<Access Right>,<Inheritance Option>

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Items within lines must be separated by one of the following delimiters:

- Comma ( , )—the default

- Tab

- Semi-colon ( ; )

- Pipe ( | )

- Colon ( : )

- Space

• Items within lines cannot have any extra spaces between them.

• The import file cannot contain any blank lines.

• Each line must contain the items described in the following table:

For example, the Secfile.txt file might contain the following lines:

User1,Account1,read,@CHILDRENUser2,Entity2,write,@DESCENDANTSUser3,Version_1,write,MEMBERGroup1,Account101,write,@ICHILDREN

• Inheritance options must be in all capital letters.

Item DescriptionUser name or group The name of a user or user group that is provisioned for

the Planning application

Member name A member (Account, Entity, user-defined custom dimension, Scenario, or Version) in the application

Access rights Read, Write, or None (None is ignored. If there are duplicate lines for a combination of user name and member name, the line with Write access takes precedence.)

Inheritance options @CHILDREN, @ICHILDREN, @DESCENDANTS, @IDESCENDANTS, and MEMBER.

N O T E

If a member, user, or user group name contains a character that you are using as the delimiter, enclose the name in double quotation marks. For example, if you are using a space as the delimiter, enclose the name North America in double quotation marks (“North America”).

Oracle In

ternal & O

racle Aca

demy

Use O

nly



If you need to import security information into a group that has the same name as a user, in the Secfile.txt file, append the sl_group parameter to the line that pertains to the group.

For example:

admin,member1,read,MEMBERadmin,member1,read,MEMBER,sl_group

The first line imports security for a user named admin. The second line imports security for a group named admin. If you omit sl_group, security information is imported only for the user named admin.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Importing Access RightsUse the following procedure to import access rights from the security file (Secfile.txt).

To import access rights

1. From the Windows task bar, select Start > All Programs > Accessories > Command Prompt.

2. Navigate to the Hyperion\Planning\bin folder.


Importing Access Rights

Run the ImportSecurity utility from the command prompt.The file is located in the Hyperion\Planning\bin folder.The syntax is ImportSecurity.cmd“appname,username,password,[delimiter],[run_silent], [SL_CLEARALL].

For example: ImportSecurity.cmd “HYPlan,trnadmin,hyperion”

Oracle In

ternal & O

racle Aca

demy

Use O

nly



3. At the command prompt, type the following command and required parameters, separating the parameters with commas: ImportSecurity.cmd “appl”,admin,password, SL_TAB,1

4. After you execute the utility, view the importsecurity.log file in the bin folder to verify the results.

The new security information is now accessible from the Dimensions task on the Administration menu in Planning.

5. Optional: To see the new security information reflected on the Enter Data page, select the Security Filters option, and refresh the application databases.

You do not need to restart the application server.

Parameter Descriptiondelimiter Optional: SL_TAB, SL_COMMA, SL_PIPE, SL_SPACE,

SL_COLON, SL_SEMI-COLON If no delimiter is specified, the comma default is assumed to be the delimiter.

run_silent Optional: Whether to execute the utility silently or with progress messages:0 = Execute with messages1 = Execute silently, with no messagesIf this parameter is not included in the command line, the value is assumed to be 0, to display progress messages during execution.

[SL_CLEARALL] Optional: Whether to clear all existing access assignments when importing the new access assignmentsThis option must be in uppercase.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Security FiltersData access rights for data forms, task lists, and process management are read from the Planning relational database and take effect immediately. Essbase databases do not need to be refreshed.

If you have a very large number of users who need security filter updates, you can use the Manage Database task to update all filters at once. If you have one or just a few users who need security filter updates, you can use the Create Security Filters task. For example, when you promote an employee, the employee’s access rights may change. In that case, you need to update only one security filter rather than all security filters.

When you update security filters using the Manage Database task, you can select Shared Members, Validate Limit, or both:


Creating Security Filters

Create security filters for all users.

Create security filters for one or a few users.

Create security filters to provide access to Planning data.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Select Shared Members if you want to create security filters for shared members in Essbase. Access rights for shared members and their base members may be different. For example, user MSmith may not have access to the base entity London for the regional process management hierarchy but may have Read access to the shared entity London in the alternate corporate reporting hierarchy.

• Select Validate Limit if you want to identify any security filter that exceeds the Essbase security filter limit of 4 KB per row. The names of users who exceed the limit are displayed in a pop-up window.

N O T E

To validate security filters before updating Essbase, select only Validate Limit only.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Assign access rights

• Import access rights

• Create security filters

Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 6

Designing Data Forms 16

OverviewThe aim of this module is to define and manage data forms. You set user preferences, manage user variables, and create menus.


• Creating Data Forms and Folders

• Customizing Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 7

Creating Data Forms and Folders 17


• Manage data forms and folders

• Set up row and column properties

• Set up page and POV properties

• Assign business rules to data forms

• Set up display and precision options

• Create composite data forms

• Print data form definition reports

• Assign access rights to data forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 6 Designing Data FormsLesson 17 Creating Data Forms and Folders


Data Forms and Folders OverviewData forms are spreadsheet-like grids with rows and columns for entering data. You can create as many data forms as required to meet the needs of budget preparers. For example, you can create a data form that budget preparers in the finance department use for fixed assets and a separate data form that line managers use for expense accounts.

You manage data forms and folders by using the Data Form Management page. You can perform the following tasks from the Data Form Management page:

• Create, move, delete, or rename folders

• Create, edit, move, or delete data forms


• Assign access to data forms


Data Forms and Folders Overview

Each data form is associated with a plan type.You assign access to data forms.Data forms with target versions enable data entry into parent members.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data Form ElementsYou create a data form by selecting point of view, page, row, and column elements.

You create, edit, and manage data forms in the Manage Data Forms page. You can navigate to the page from the Administration menu.

The members you select for the dimensions that are assigned to the POV determine the context for the pages, rows, and columns. For example, if the Scenario dimension is set to Budget in the POV, then all of the data entered in the pages, rows, and columns goes into the Budget scenario. For each POV dimension, only one member can be selected. You cannot change the member selected for the POV. For the data form shown in the slide, the POV is set to Local for the Currency dimension and to No Customer for the Customer dimension.


Data Form Elements

Page

Columns

Rows

Point of ViewCurrency = Local

Customer = No Customer

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The page axis enables you to set up combinations of members that may span dimensions so that you can work with data in smaller, logical views. Each item on the page axis can have members selected from one dimension or from multiple dimensions. For example, you can assign the Version and Scenario dimensions to the page axis. For Version, you select the Worst Case and Best Case members. For Scenario, you select the Budget and Forecast members. You can then switch members by selecting them from the page axis.

Rows and columns define the grid into which you enter data. For example, you can assign Unit Sales to the row axis and January to the column axis. When you access data forms through Planning, you can enter data into the cell where the row for Unit Sales intersects with the column for January.

By default, data forms have a single row and column. You can add rows and columns to create data forms with asymmetrical combinations of row and column members.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Folder Structures for Data FormsYou use folders to help you organize your data forms. You can create as many folders as needed, and you can arrange the folders in a hierarchy. After you create folders, you can create data forms in those folders. To create a data form, you can build a data form with requirements that you specify, or you can edit an existing data form and then save it as a separate form.

T I P

You can search to find a data form on the Data Form Management page.


Creating Folder Structures for Data Forms

Remember the following points when working with folders:Move folders within the hierarchy as needed.Rename folders, including the top-level folder, called Forms.Access rights are not assigned to folders.Only empty folders can be deleted.You cannot move or delete the top-level folder, called Forms.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data Form RequirementsTo create data forms, you need to define data form properties, row and column layout, page and point of view (POV) definitions, other options, business rules, and access rights.

When you create a data form, you assign it to a plan type. Only members that are valid for that plan type can be included on the data form. For example, if you assign a data form to the Revenue plan type, you cannot add accounts that are not valid for the Revenue plan type. When you save data in a form, it is saved to the database that is associated with the data form’s plan type.

N O T E

You cannot change the plan type for a data form.


Data Form Requirements

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Considerations for Setting up Data FormsPrior to creating data forms, data form designers need to consider several factors. Most data forms are used for entering values; therefore, you set up most data forms to permit data entry. However, you can set up forms at a more summarized level, for example, to view the results of calculations.

If you want to enter data into the intersections of a data form, then you must set up the data form to meet certain conditions. For bottom-up versions, to permit data entry, dimensions on rows and columns must be set to bottom-level members. A bottom-level member is a member that has no child members below it. If a dimension on a row or column is set to a parent member, the row or column is read-only. If a dimension in the point of view or the Pages drop-down list is set to a parent member, all rows and columns on the data form are read-only.

Target versions allow data entry in both parent and bottom-level members.


Considerations for Setting up Data Forms

In order for a cell on a data form to accept data entry:All members in the POV and pages list must be bottom-level members (except with target versions).All members in the rows or columns must be bottom-level members (except with target versions).The Currency dimension must be set to the Local member.The user must have Write access to all members of the cell.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can use member relationships to select shared members. For example, to include all members of a rollup on a data form, you can select an alternate, functional rollup. Values entered into rows or columns that display shared members are saved to the base members in the database.

Another factor to consider in the setup of data forms is how to represent the Currency dimension. You set up the Currency dimension on a data form to determine how currency values are displayed. If a row or column on a data form has the Local member selected for the Currency dimension, no currency conversion takes place for the row or column, and you can enter data for the entities on the row or column in their native currency.

If you set a data form’s Currency member to something other than Local, then data values are displayed as converted to the selected currency, assuming that the currency calculation script has been run. The data form is read-only.

In target versions, you can enter data in rows or columns that have Currency or Local as the selected member. For applications that use a single currency, the currency selected when you created the application is used as the currency member for all entities.

To allow users to enter data in currencies other than an entity’s base currency, when selecting data-form members, you must perform one of the following actions:

• Select members from at least two currencies, in order to compare converted currencies.

• Assign the Currency dimension to the page axis, and select reporting currencies as members. To convert currencies for all members in the data form, you can select the Currency member from the page axis and then launch the Calculate Currencies business rule to view all values in the currency of the selected Currency member.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Data Form PropertiesYou set basic characteristics for data forms on the Properties tab. On the Properties tab, you assign the data form name and description and determine whether the data form permits data entry or is hidden from view. You prevent data entry by making a data form read-only. To work with forms offline, you must select Enable Offline Usage. You also can include instructions for business users who need to use the data form.

You can hide data forms by selecting the “Make data forms hidden” option. If you hide a data form, then business users cannot select the data form from the view pane. You may want to hide a data form that is part of a composite form or a data form that is displayed by a right-click menu.


Setting Data Form Properties

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Row and Column LayoutYou assign dimensions to the columns and rows of data forms by selecting the dimensions from the drop-down lists of the Row/Column Layout tab. For each dimension, you select the preferred members. You then set the properties of the dimensions and members on the columns and rows. For row and column members, you can select segment properties. Column and row properties include showing a member name or alias, starting with the hierarchy expanded, suppressing missing data, and setting column width. For rows, you can also select to suppress missing blocks, suppress missing data, and allow users to add rows dynamically.

When you are setting the data form layout, keep the following items in mind:

• You must select at least one member for each dimension.

• A data form must have at least one dimension assigned to the row axis and one dimension assigned to the column axis.


Setting Row and Column Layout

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• You cannot select the same dimension for more than one axis.

• To move a dimension from one axis to another, delete it from the source axis and select it for the destination axis.

Data form designers, when considering how to set up data forms, need to consider dimension composition. For columns, data form designers should use dimensions and members that business users are most likely to need to view. For example, the Period dimension—which represents months, quarters, years, or custom time periods—is typically set up on the columns. For rows, data form designers should use dimensions and members that contain a more expansive list of members. For example, the Account, Customer, and Product dimensions typically work well on the rows.

Setting Up Segment PropertiesSegments are areas of data forms with special properties, such as separator lines for columns and rows and hidden or read-only data. You can define segments for asymmetric rows and columns. For example, you can set segment properties in an asymmetric row or column to read-only or to hide members. You can also suppress the hierarchy so row definitions are not indented and columns do not include line breaks.

You can select options for segment properties as described in the following table:

Setting Column PropertiesThe following table shows the options for column width on a data form:

Option DescriptionHide Hide the segment so it is not displayed on the data form

Suppress Hierarchy For columns, do not display line breaksFor rows, do not display indentation

Read only Create a read-only segment in the data form to enable comparison of old, read-only data with new, editable data

Show Separator Create a bold border before the segment to visually distinguish parts of the data form

Apply to All Segments Apply these settings to all columns in segments

Column Width DescriptionSmall Displays columns 50 pixels wide (approximately 7 decimal places)

Medium Displays columns 75 pixels wide (approximately 10 decimal places)

Oracle In

ternal & O

racle Aca

demy

Use O

nly



If the selected column width is less than the width of the column contents, the excess data is hidden from view until the column is widened. While hidden, the data is stored and calculated in the data form in the same way as data that is not hidden.

Regardless of the column width setting that is selected in the data form properties, you can adjust column width while you are viewing a data form. Saving or refreshing the data form saves the adjusted column width for the remainder of the session.

When you print from the data form page, all columns, including minimized columns, regardless of their width setting, are printed at a width that is based on the printing options that are selected for page size and columns per page.

The following table describes column width tasks that are available for data forms when you are using Microsoft Internet Explorer:

Large Displays columns 100 pixels wide (approximately 13 decimal places)

Size-to-Fit Forces all column headings to fit in the displayed space

Custom Enables you to enter a pixel width value of up to 999 (greater than 13 decimal places)

Task ActionResize column width Drag the column heading.

Minimize column width Click the column heading and select Minimize, or double-click the column heading.

Restore a minimized column

Right-click the minimized column heading and select Restore,or double-click the minimized column heading.

Restore all minimized columns

Right-click any column heading, and select Restore All.

Reset all column widths to the data form definition default property setting

Right-click any column heading, and select Reset All to Default.

Column Width Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Row PropertiesYou can set row properties for data form rows. The following table describes the options that you can set on rows in data forms:

Option DescriptionSuppress missing blocks When suppressing a large number of rows, such as 90% or

more, select this option to enhance performance of the “Suppress missing data” setting. If few or no rows are suppressed, the “Suppress missing blocks” setting can degrade performance. Hyperion recommends that you test data forms before and after using this setting to determine whether performance is improved. You should also test data forms whenever you make significant changes to your application.With this setting, data forms may not display attributes. Also, certain suppressed blocks may ignore Dynamic Calc members.

Suppress missing data Select this option to suppress missing data. Selecting this option hides rows without data. If at least one cell of a row has a data value, then the row is not suppressed. Clear this option to display rows that contain only cells for which data is missing; the cells display #missing. You cannot simultaneously select “Suppress missing data” and “Allow users to dynamically add rows.”

Allow users to dynamically add rows

Select this option to enable users who have Write access to the data form to dynamically change and refresh the data form’s definition by adding rows. Members that users can access are displayed on the data form. You cannot simultaneously select “Allow users to dynamically add rows” and “Suppress missing data.”

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting MembersYou select members for the current dimension on the Member Selection page. You can select specific members, or you can select members based on relationships. The following table describes the existing relationships and the members that are included on the data form for each relationship:

Relationship Members Included on the Data FormMember The selected member

Descendants All members below the selected member, excluding the selected member

Descendants (Inc) The selected member and all of its descendants

Ancestors All members above the selected member, excluding the selected member

Ancestors (Inc) The selected member and all of its ancestors


Selecting Members

Member DescendantsDescendants (Inc)

Ancestors

Ancestors (Inc)

Siblings

Siblings (Inc)

Parent

Parent (Inc)

Children

Children (Inc)

Level 0 Descendants

Descendants plus North America

Worldwide

Worldwide plus North America

200, 205, 210, 220, 225, 230, 240, 245, 250, 255, 270, 275, 280

Europe, PacRim, Corporate

Europe, PacRim, Corporate, North America

Worldwide

Worldwide and North America

Central, South, East, West

Central, South, East, West, North America

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Siblings All members in the level of the selected member, excluding the selected member

Siblings (Inc) The selected member and all of its siblings

Parent The member in the level above the selected member, excluding the selected member

Parent (Inc) The selected member and its parent

Children All members in the level immediately below the selected member, excluding the selected member

Children (Inc) The selected member and all of its children

Level 0 Descendants

All descendants of the selected member that have no children

T I P

You can search to find a specific member to include on your data form.

Relationship Members Included on the Data Form

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Substitution and User VariablesAdministrators can create and define substitution variables (references to values). Typically, you use substitution variables for financial reporting. Substitution variables are commonly used in situations where a value (such as current month) references a member name (such as Mar) across multiple data form references. The benefit of using substitution variables is that the variable is maintained in one place at one time, rather than across the multiple data form references.

Similarly, you can set up user variables to filter members in data forms, thus enabling planners to view only the dimension members with which they are working. User variables can be created by administrators and interactive users.

You can navigate to the Manage User Variables page from the Administration menu. After a variable is created, it must be selected as a member in the data form layout. If a user variable is assigned to a data form, business users cannot access the data form until they select a member for the user variable. This task is performed in User Variable Options, accessed from the Preferences option of the File menu.


Creating Substitution and User Variables

Substitution variables are created in Administration Services Console and reference a member that is assigned to a variable value; forexample:— BudYear = FY08— ActYear = FY07— CurrMonth = March

User variables filter members displayed in data forms; for example MYCostCenter = East (Descendants inclusive).

No user variable User variable

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Asymmetric Columns and RowsYou can create data forms with asymmetric columns or rows. Asymmetric columns or rows contain different sets of members selected across the same dimension. You create asymmetric columns or rows by using the Add Row or Add Column button on the Data Form Layout page.


Creating Asymmetric Columns and Rows

Example of asymmetric columns:Column A: Scenario = Actual, Time Period = Q1Column B: Scenario = Budget, Time Period = Q2, Q3, Q4

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Page and Point of ViewOn the Page/Point of View Layout tab, you set up dimension members for pages and point of view. You can select dimensions and members for the page axis. You can choose to display member names or aliases, and you can define the POV dimensions and members for any dimension that is valid for the data form plan type and that is not assigned to a page, column, or row axis. The POV toolbar enables you to set the unique set of dimension members that defines specific intersections of data.

You can clear the Visible option for the dimensions on the point of view so that members for the POV dimension are not displayed on the data form. Not showing dimensions in the point of view is especially helpful if the member for the point of view is No Customer, No Scenario, or something similar.

You can select the option Enable Dynamic User Variables to prompt the user to select the POV member to use on the data form.


Setting Page and Point of View

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Options on the Other Options TabOn the Other Options tab, you can set options for the data form’s display, functionality, and printing. For example, you can select to display missing values as blank rather than as #missing.

Enable account annotationsYou can enable account-level annotations. In a data form, users can add annotations to accounts. However, a user must have Write access to the individual Account, Entity, Scenario, and Version members. Account-level annotations can vary, as combinations of Scenario, Version, and Entity dimensions vary.

To enable annotations for the account dimension, you must follow these rules:

• Account must be selected as a row dimension.

• Scenario and Version must be selected as page or POV dimensions.


Setting Options on the Other Options Tab

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Entity must be selected as a page, POV, or row dimension.

• The Scenario, Version, Account, and Entity dimensions cannot be selected as a column dimensions, because the annotation is unique to scenario, version, account, and entity.

Allow multiple currencies per entityFor applications that support multiple currencies, you select this option to allow entities to support multiple currencies, regardless of base currency. Then, within data forms, business users can select the currency in which cell values are displayed.

Enable mass allocationIn order to ensure that business users can spread data across dimensions, you select the “Enable Mass Allocate” option. Selection of this option enables business users to use the Mass Allocation option for the data form.

Enable grid spreadingIn order to ensure that business users can spread data across dimensions, you select the “Enable Grid Spread” option. Selection of this option enables business users to use the Grid Spreader option for the data form.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Identifying Missing ValuesYou can write #missing to the database from a data form. Instead of entering a number, enter #missing; or delete the contents of the cell, leaving it empty. When you save the data form, the cells are set to #missing in Essbase. Data entry cells that are blank or that contain the term #missing have no data value.

In certain cases, when conversion to a selected currency is attempted, parent entities display #missing. On a data form or report, make sure that a currency rate is entered for each combination of local currencies and selected currencies. Also make sure that currency combinations exist for all mixed-currency child entities and their parent members.

N O T E

When a data form that is designed to suppress missing data is reloaded, rows that contains only cells with #missing are not displayed.


Identifying Missing Values

Cells with #missing have no data value.Write #missing to the database in one of three ways:— Leaving cells blank— Deleting contents of cells— Entering #missing

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting Business RulesYou can create business rules by using a graphical user interface in Administration Services. These business rules can be launched directly from Planning, or they can be associated with data forms.

Both designers of data forms and users entering data into data forms can see and launch only business rules to which they have access.

Administrators and interactive users can define business rules that prompt users for input when the rules are launched.

Planning includes two default business rules: Calculate Data Form and Calculate Currencies. Calculate Data Form is programatically created for each data form, to calculate subtotals. Calculate Currencies is created for data forms that include multiple currencies, to enable the conversion of values among the available currencies.


Selecting Business Rules

Oracle In

ternal & O

racle Aca

demy

Use O

nly



By default, the Calculate Data Form and Calculate Currencies business rules are selected.

In the Business Rule Properties dialog box, you can set whether or not each business rule that is associated with a data form is automatically launched when data is saved. If a business rule has runtime prompts, you can also set whether or not the default member selection in the runtime prompt window matches the current member selection in the page and POV axes.

After you enter data in a data form (or through a data form in Hyperion Smart View), you must calculate new totals for parent members, using the Calculate Data Form business rule. The rule calculates totals only for the members in the data form. For example, if West and its children California and Oregon are in a data form, after you save, calculate, and refresh the data form, a new total is displayed for West. Because North America, the parent of West, is not in the data form, a new total for North America is not calculated.

Administrators and interactive users can set up business rules that, when launched from Planning, prompt users for such variables as members, text, or numbers. Here are some examples of runtime prompts:

• Please select an account.

• Select a month.

• Enter the expected number of customer visits per quarter.

• What percentage change in earnings do you expect next month?

Create prompts that are specific and that let the user know what type of data is expected.

N O T E

When launching a business rule with a runtime prompt, Planning validates the value entered, but it does not validate the business rule.

N O T E

The order in which business rules are launched is important and may affect the data. If you are launching both conversion and subtotal business rules, the currency conversion rules must be run before the subtotal rules.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Previewing Data FormsYou can review the data form on the Preview tab. During the design of a data form, you can preview its structure and continue to make changes. The preview shows which dimensions are assigned to the POV, column, row, and page axes.

Preview does not display data associated with the data form, member attributes, or aliases.


Previewing Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Composite Data FormsYou can create composite data forms to view several data forms, even forms associated with different plan types, simultaneously. Business users can perform data entry and see the results aggregated to an upper-level intersection, such as Total Revenue, Total Departmental Expenses, or Net Income.

You can use composite data forms to accomplish the following tasks:

• Combine two or more data forms on one screen

• Perform real-time impact analysis by entering data in one data form (for one plan type) and viewing calculated results in another data form (for the same or another plan type)

• Choose the order that data forms are displayed on the screen and whether to combine the POV and page dimensions


Composite Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating Composite Data FormsSome of the tasks for creating composite data forms are the same as for creating regular data forms. You set up the following parameters:

• Data form properties

• Row and column layout

• Business rules selection and properties

• Access permissions

You create composite data forms from the Manage Data Forms option on the Administration menu. To create a composite data form, you select Create Composite.

You can set options for the POV, the pages, and the number and layout of columns and rows. You also select the data forms to display on the composite data form.


Creating Composite Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Selecting Business Rules on Composite Data FormsYou select business rules for composite forms on the Business Rules tab. You can include all business rules of the base forms or specific business rules.

If you select an individual business rule, you can click Properties to set the properties for that rule. On the Business Rules properties screen, you set whether the business rule runs when the data form is loaded; whether the rule runs when data is saved; whether, if the rule contains a prompt, the members on the data form are used; and whether to hide prompts, if the rule contains any.


Selecting Business Rules on Composite Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Printing Data Form Definition ReportsTo enable better data form management, administrators can print a data form definition report. The report can include information on dimension members, business rules, and access rights associated with the data form, as well as other standard data form components.


Printing Data Form Definition Reports

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Assigning Access Rights to Data FormsBy assigning access to a data form, you control which users can access and change the data form design (for example, data form properties such as formats, layout, and instructions), and which users can access the data form for data input. A user or group can have only one of the following access rights: Read, Write, or None. However, the access rights for a user can be combined with the user’s group rights.

You create and change data form designs by using the Manage Data Forms option on the Administration menu. Administrators and interactive users have access to this task.

When you are designing a data form in Planning, the selection list to set properties is filtered based on access rights. For example, when you set up the data form layout for page, column, row, and point of view, you select from the list of dimension members to which you have Read or Write access.


Assigning Access Rights to Data Forms

Read: Enables users to view and use the data form for data entry.Write: Enables users to change the data form’s design and to view and use the data form for data entry.None: Prevents users from viewing the data form.

To get the latest set of users and groups from the User Management Console, click Migrate Identities.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Access to specific data forms created by administrators or interactive users is based on access rights. For example, if you have Read access to a data form, you can view the data form in a list and select it. Whether you can change data in a data form depends on whether you have access to the members of the form.

In order to edit a data form, you must have access to at least one member of each secured dimension on the form. For example, if you have Read access to the Europe entity, all rows and columns on the data form that include the Europe entity are displayed in read-only format.

By assigning access to data forms, administrators and interactive users determine the following access rights:

• Who can view and change various data form designs. By default, administrators have Write access to all data forms. Based on access rights, interactive users have Write access to certain data forms.

• Who can access data forms for view or data input. By default, administrators have Write access to all data forms. Based on access rights, interactive users and planners have access to certain data forms. Whether users have access to the data in a data form depends on whether they have access to the members of the form..

N O T E

Access rights are assigned to data forms, not to data form folders. You can assign access to only one data form at a time.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Manage data forms and folders

• Set up row and column properties

• Set up page and POV properties

• Assign business rules to data forms

• Set up display and precision options

• Manage data forms


• Print data form definition reports

• Assign access rights to data forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 8

Customizing Data Forms 18


• Export and import data forms

• Create menus

• Specify application default settings

• Manage user variables

• Set up user preferences

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 6 Designing Data FormsLesson 18 Customizing Data Forms


Exporting and Importing Data FormsYou can use the FormDefUtil.cmd Planning utility to export and import a data form definition from and into an XML-based file. You can move data form definitions from one Planning application to another. For example, use the FormDefUtil utility to move data forms from a development environment to a production environment.

Planning includes the FormDefUtil.cmd utility for use through a command line interface. This utility is installed in the bin directory.

Only administrators can run this utility.

N O T E

If you installed Planning to the default location, the bin directory is located in the following path: x:\Hyperion\HyperionPlanning\bin.


Exporting and Importing Data Forms

To export a single form to an *.xml file, type

FormDefUtil.cmd export <data form name> <planning server name> <user name> <password> <application>

To import a single form from an *.xml file, type

FormDefUtil.cmd import <file name.xml> <planning server name> <user name> <password> <application>

To export all data form definitions, type

FormDefUtil.cmd export -all <planning server name> <user name> <password> <application>

To import all data form definitions, type

FormDefUtil.cmd import -all> <planning server name> <user name> <password> <application>

Oracle In

ternal & O

racle Aca

demy

Use O

nly



The following table describes the parameters of the utility:

Parameter Descriptionimport or export

Specify whether to import or export the data form definition.

file name or data form name

Use file name to specify the name of the XML file to import into the Planning application.Use data form name to specify the Planning data form to export to XML.

planning server name

Specify the name of the application server that Planning is using (for example, localhost).

user name Enter the name that you use to log on to the Planning application (for example, smith).

password Enter the password that you use to log on to the Planning application (for example, pass1).

application Enter the name of the Planning application (for example, FYPlan).

Oracle In

ternal & O

racle Aca

demy

Use O

nly



MenusMenus are displayed when business users right-click data-form rows or columns. Business users can use right-click menus to perform separate and distinct actions. For example, after entering data, a business user can move to the Manage Process page by using a right-click menu. A predefined scenario and version can be passed for use on the Manage Process page.

Administrators create right-click menus and associate them with data forms. By creating right-click menus, administrators enable business users to click rows, columns or pages in a data form and select menu items to accomplish various tasks:

• Launch another application, URL, or business rule, with or without runtime prompts

• Move to another data form

• Move directly to the Manage Process page, with a predefined scenario and version


Menus

1. Create the menu.2. Set up menu Item properties

for the menu.3. Associate the menu

with data forms.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



To support context-sensitive actions, the context of the right-click is relayed to the next action. Planning passes this context: the POV and the page, the member on which the user clicked, and the members to the left (if a row was clicked), or the members above (if a column was clicked).

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating MenusAdministrators use the Manage Menus page to create, edit, and delete menus. The Manage Menus page lists menus defined in the application.

To create menus:

1. Select Administration > Manage Menus.

2. Click Create.

3. Enter a name for the menu, and then click OK.

4. To further define the menu, select the menu, and click Edit.

5. To add the first item to the menu, click Add Child, and Save.


Creating Menus

Oracle In

ternal & O

racle Aca

demy

Use O

nly



6. Continue building the menu by selecting a menu item and performing one of the following actions:

• To add menu items below the selected item, click Add Child (available for Menu Header menu types).

• To add menu items at the same level as the selected item, click Add Sibling.

• To edit menu items, click Edit, and then follow step 8 to set up menu item properties.

• To delete menu items, click Delete.

• To change the order of menu items within the same level, select one or more items, and click the up or down arrow.

7. Set up the menu items.

The following table describes the choices that you can apply for each item.

Item DescriptionMenu Item Enter a unique name that contains only alphanumeric and

underscore characters (for example: Position) and no extended characters, special characters, or spaces.Note: Labels can contain spaces, special characters, and extended characters.

Label Enter the text to be displayed when the menu is selected. Spaces and special characters are allowed. Menu labels are displayed on the user interface. Labels can be text or they can reference a resource variable by name. For example, to set a menu’s label to File, set it to File directly or set it to the name of a resource—such as LABEL_FILE.

Icon Optional: In context of the Planning server, enter the path to and name of a graphic (for example, /Planning/Images/globe.gif),to be displayed next to the menu.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



8. To set up characteristics for menu items, select the menu item, and click Edit.

Menu item properties differ, depending upon the menu item’s type. The following table describes the choices that you can apply for each item.

Type Select the menu item type. Your selection determines the available properties. For example, no properties are available for the Menu Header type. Choose from the following types:• Data Form—Launch a selected data form. When users right-

click in the source data form, the member selection context for the member, page, and POV is retained. If the target data form contains the dimension members identified by the context, the target data form’s page is set to match the context.

• URL—Navigate to the specified URL.• Business Rule—Launch the selected business rule.• Workflow—Move to the Manage Process page to work with a

planning unit.• Menu Header—Create a menu under which you can create child

menu items. To distinguish the header from other menu items, insert a separator bar by entering one hyphen as the label for the header item. For menu headers, the Required Dimension list is not available.

Required Dimension Select the dimension for which the menu item is displayed. For example, if, for a menu item, you select Account, when users right-click Account members, the menu item is available. Selecting No Required Dimension makes the menu available wherever the user right-clicks in the data form.

Item DescriptionData Form a. From Data Form Folder, select the folder that contains the

destination data form.b. From Data Form, select the data form.

URL a. In URL, enter the complete URL to which to direct the user. b. Select Use Single Sign-on to append the SSO token to the URL.c. Select Launch in a Separate Window to launch the URL in window other than the Planning main window.

Item Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



9. Click Save.

Business Rule a. From Plan Type, select the plan type for which the business rule is available.b. From Business Rules, select the business rule to launch.c. From View Type, select how to display runtime prompt pages:• Classic View—Use the default Planning view.• Streamline View—Display each runtime prompt on a different

line, instead of in a different section; eliminate icons; and reduce screen text.

d. Optional: In Window Title, enter a title to be displayed, instead of Runtime Prompts.e. Optional: In OK Button Label, enter the text to be displayed for the OK button.f. Optional: In Cancel Button Label, enter the text to be displayed for the Cancel button.g. Optional: Select Launch in a Separate Window to launch the business rule in window other than the Planning main window.

Workflow Specify the planning unit to which the user is directed by selecting a scenario and a version.

Item Description

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Associating MenusWhen designing a data form, use the Other Options tab to select which menus are available for the data form. As you update applications, update the appropriate menus. For example, if you delete a business rule that a menu references, remove it from the menu.


Associating Menus

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Advanced SettingsAdministrators have access to Advanced Settings, which includes the System Settings and Custom Tools tabs. The Show drop-down list has a second option which lists the current application defaults for application settings and display options. The Advanced Settings options are available through the Administration menu.

Administrators can specify settings to use across the current application. Non-administrators cannot access application-wide settings.

Because application owners must set up certain options before business users can make their selections, the Application Settings tab is displayed differently for the application owner than for other application users. For example, before users can enable an e-mail notification, the application owner must set up the application's e-mail server. Only the application owner can set two of the system settings: E-mail Server and Password for Synchronizing With Essbase.

Business users can override the application-wide default settings by setting preferences.


Advanced Settings

Only administrators and application owners can view and set Advanced Settings.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



System Settings TabThe following table describes the options on the System Settings tab:

Custom Tools TabYou can customize Planning to include links to commonly used tools for analyzing, tracking, and reporting on planning data. Users can access these links from the Planning Tools menu.

Component DescriptionE-mail Server Type the name of the server that hosts e-mail services for the application

users; for example, mail.hyperion.com.Available only to the application owner.

E-mail Character Set

Specify the character set used for e-mail messages:• UTF-8: Use the Unicode encoding format (the default).• Regional Setting: Use the system's regional setting.

Shared Services URL

Type the URL for the Shared Services server, and click Register Shared Services.

Display Users’ Full Names

Select Yes to show the users’ full names (for example, John Smith) in addition to their user names (for example, JSmith).Select No to suppress the display of the users’ full names.Note: If the Display Users' Full Names check box is selected, you cannot have two users with identical full names. If you try to add a user with the same full name as an existing user, an error message is displayed.

Enable Use of the Application for

Specify whether users can access the application when it is in maintenance mode, such as during backups. Select Owner, Administrators, or All Users to give access to the application owner, to administrators, or to all users.

Enable display option of Substitution Variables

Set how substitution variables display in the Member Selection dialog box when users respond to runtime prompts in business rules:• Display All: Display all substitution variables• Display None: Do not display substitution variables• Enable Filtering: Display only substitution variables that are valid for

the runtime prompt

Select User Assign an administrator to be the application owner. (By default, the person who creates the application is the application owner. However, the owner may grant ownership to another administrator.)

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Current Application DefaultsSelect Current Application Defaults, and click Go to access the Application Settings tab and the Display Options tab.

When you save, the values specified in these tabs become the application defaults. Other users can override the defaults and revert to the defaults—by selecting the Use Application Defaults check box on the Preferences tabs.


Current Application Defaults

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Managing User VariablesYou can limit the number of dimension members that are displayed on a data form by setting user variables. Using user variables increases performance and enables planners to focus on those members with which they want to work. For example, for the Entity dimension, you can set up a user variable called Division, and then, for Division, planners can select the members that represent their specific division. You can set up as many user variables as you want for each dimension. User variables can be selected for any axis in the data form: row, column, page, or point of view (POV).


Managing User Variables

Here is the typical sequence of steps to set up and use user variables:1. Create the appropriate parent-level

members in the dimension outline (if they do not already exist). For example, the parent levels could correspond to the business unit divisions.

2. Create user variables for each dimension that you want planners to be able to filter.

3. When designing the data form, associate the user variables with the data form.

4. Notify planners that they can select members for the user variables that are associated with the data form.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Creating User VariablesYou add or delete user variables from the Manage User Variables option on the Administration menu or from the New User Variable option on the File menu. You select the dimension for which the user variable will be used and then create a user variable name.


Creating User Variables

1

2

3

4 5

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Applying User VariablesAfter you create a user variable, you associate the new user variable with a data form.

You can either create a new data form or edit an existing data form and select the member relationship for the dimension that contains the new user variable. In the example shown in the slide, the Division user variable is in the Entity dimension, which is placed on the Pages drop-down list for this data form. Furthermore, you select the descendants inclusive option for Division.

To associate a user variable with a data form:

1. In the Member Selection dialog box, select a user variable.

2. From the relationship drop-down list, select the relationship, and then use the right arrow to move the user variable to the Selected Members list.

When a user variable is selected, it is preceded by an ampersand.

3. Click Submit.


Applying User Variables

1

2

3

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up User PreferencesOn the Preferences page, for the current application, all users can set individual preferences. Administrators and application owners can also specify certain global settings for the current application. Non-administrators do not have access to application-wide settings. Only the application owner can set the following system settings: E-mail Server and Password for Synchronizing with Essbase.

All users have access to a Preferences page that has four tabs: Application Settings, Display Options, Printing Options, and User Variable Options. Each preference can be enabled and configured.

In the Application Settings tab, you configure e-mail notification, select the alias setting, and set workflow options.


Setting Up User Preferences

All users can set preferences.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Up E-mail for Workflow NotificationsWhen e-mail is set up and notification is enabled, Planning notifies users when they become the new owner of a planning unit.

The subject of the e-mail is in the format NEW OWNER: XYZ Plan (Scenario, Version, Entity).

Applying Alias TablesYou can assign alternate names, or aliases, for Account, Entity, and user-defined dimensions and members. You can select aliases for displaying member and dimension names. For example, an alias table called French could display members in French, and another alias table called German could display members in German.

Setting Member Selection and Workflow OptionsIn the Member Selection Options area, you can set whether aliases and descriptions are displayed in the Member Selection dialog box.

In the Workflow Options area, you can control the following aspects in Process Management:

• Whether to display members’ actual names or aliases, if they have them

• Whether planning units that are not started are displayed with those that are started

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Individual Display OptionsYou set individual display options on the Display Options tab.

Your number-format selections apply to all currency values that are displayed in all data forms that are within the current application and that you can access. These selections can override default settings.

If you select Currency Setting, the currency values in the data form are displayed using the formatting initially set for each individual currency. If you select any other option, your selection applies to all currency values that are displayed in all data forms that are within the current application and that you can access.

Use the Display Options tab to perform the following tasks:

• Change how numerical values are displayed in the data form

• Enable retention of page dimensions


Setting Individual Display Options

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Set the indentation of members on a page

• Set aspects of page selection, such as remembering the last page selected when navigating among data forms and allowing a search facility when the number of pages exceeds a certain number

• Enable warning for large data forms

• Set how many members to be displayed on each page

• Increase the contrast of the Planning interface

• Set the date format

Keep in mind the following points about display options:

• The options listed on the Display Options tab depend on the type of user. Only administrators can set the number of members to be displayed on each page.

• Formatting selections take effect when you leave the data cell.

• If you select a setting other than the Use Application Default setting for either the thousands separator or the decimal separator, then you must change both separators from the Use Application Default setting option. However, you cannot select the same option for both the thousands and decimal separators.

Page Selection OptionsThe most recently used dimension members from the page of the last data form that you used are remembered and compared to the members of each data form that you select. If there is a match, that member name is displayed in the drop-down list of the new data form that you select.

When you are working with a large number of pages, you can select among the pages more easily by using a Search drop-down list that Planning adds to the data form when the number of pages exceeds a value that you specify.

N O T E

For the current application, the “Page retention” setting applies both within a session and between sessions.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Warning on Large Data FormsUnusually large data forms with numerous cells may require significant time to open. You can choose to display a warning when data forms that are larger than a specified number of cells are opened. When you try to open a data form that exceeds the specified size limit, a warning is displayed about the time needed to open the data form, so that you can choose whether or not to open it.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Individual Printing OptionsYou set printing options directly from the data form when you are ready to print; or you can use Preferences to set printing options. The options that you set from the Preferences page apply to all data forms to which you have access.

N O T E

You can accept the default settings or set your own options for creating PDF files. To print to a PDF file, you must have Adobe Acrobat Reader 4.0 or later installed. Printing options for a data form are set by the data form designer when the data form is created.


Setting Individual Printing Options

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Setting Individual User Variable OptionsBy acting as filters that reduce the number of members that are displayed on a form, user variables help you to open and navigate large data forms that contain many members. You can select dimension members, such as entities in your own region, on which to focus.

If a data form contains a user variable, you must select a value for the variable on the User Variable Options tab before you can open the data form. If you do not set the user variable, you receive an error message when you attempt to open the data form.

User variables are not related to security. If you want to see different members on your data forms, you can change the user variable at any time.


Setting Individual User Variable Options

Oracle In

ternal & O

racle Aca

demy

Use O

nly



For example, if your company has many cost centers, you can create a data form that includes a user variable called MyRegion. Then, by selecting a member for MyRegion, you can limit the number of pages that are displayed in the Page drop-down list. In this case, before you can open the data form, you must select a value, such as Central, for MyRegion. At any time, you can select a different value, such as South, for MyRegion.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Export and import data forms

• Create menus

• Specify application default settings

• Manage user variables

• Set up user preferences

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

M O D U L E 7

Entering Data in Planning 18

OverviewThe aim of this module is to provide an overview of how to enter and adjust plan data in Planning and Smart View. You learn how to enter, adjust, annotate, and calculate data using data forms in Planning as well as in Smart View. In addition, you learn how to take Planning data offline, work with data offline and then synchronize data to the server.


• Entering Data

• Entering Data in Smart View

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 1 9

Entering Data 19


• Submit data in data forms

• Adjust and annotate plan data

• Calculate data in data forms

• Enter data with smart lists

• Navigate data forms with menus

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 7 Entering Data in PlanningLesson 19 Entering Data


Submitting Data in Data FormsYou use Planning to enter plan data in data forms. You can enter data from the start page in Advanced mode by selecting forms in the view pane to work on in the content area. In Basic mode, you can enter data only if your administrator sets up a task that includes a form. In both modes, you can enter and edit only data to which you have access. These are the data-entry tasks that you can perform:

• Type data directly into cells on a data form

• Spread data from summary to base periods automatically

• Adjust existing data and add supporting details

• Annotate planning units, accounts, or cells

• Export data to a spreadsheet

• Launch business rules to perform predefined calculations on data that you enter


Submitting Data in Data Forms

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Elements on the Enter Data PageThere are several areas on the enter data page that assist you with navigation, data selection, and data entry.

View PaneThe view pane lists the form folders that are set up for your application. Data forms are contained within the folders. After you select a folder, a list of data forms within the selected folder is displayed on the view pane as well as in the content area. You can select a data form from this list. After you select a data form, it is displayed in the content area.

Content AreaData forms are displayed in the Planning content area. A data form provides an intuitive layout for you to work with the data in your plan from the Web. Data forms displayed in the content area reflect the access rights that you have to the dimension members on the data forms.


Elements on the Enter Data Page

View Pane

Content Area

Row Headings Point of View Toolbar Icons

Page ListColumn Headings

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Elements of the Content Area for Data EntryThe following table summarizes elements of the content area for data entry:

Element DescriptionToolbar icons The toolbar includes icons to save, refresh, print, adjust, lock cells, grid

spread, mass allocate, cut, copy, and paste data. The toolbar provides a quick way of entering cell text and supporting detail as well as exporting spreadsheets and logging off.The toolbar also provides immediate access to task lists, task list status, and help.

Row and column headings

Row and column headings show the members available on a data form. To make the data form easier to work with, you can choose to hide or view the children of a parent member.

Point of view Across the top of the data form is the point of view (POV) for the form. The members displayed in the point of view show the context of the data in the pages, rows, and columns.

Page list The page list is a drop-down list of members from one or more dimensions to be selected for data entry. The rows and columns on the form show values for the currently selected page member.

Data-entry cells You enter data in the cells at the intersection of rows and columns. Cells with existing data display data values. You can enter data in cells that are not shaded, whereas shaded cells are read-only.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Data-Entry Menu OptionsFrom the File menu, you can save data values or print data forms. You can also export data values to spreadsheets.

You can use the Edit menu to adjust, grid spread, mass allocate, cut, copy, and paste data values. From the Edit menu, you can also launch business rules associated with the data form, annotate planning units, add or view cell text, add or view supporting detail, and lock or unlock cells. If you have purchased workforce and capex, you can initialize workforce and capex from the Edit menu.

From the View menu, you can refresh data values, view data form instructions, view currencies for data forms that allow currency overrides, and edit account annotations. You can use the View menu to switch between Basic and Advanced modes and work with task lists.

From the Tools menu, you can launch business rules to which you have access.


Data-Entry Menu Options

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Viewing Form InstructionsWhen you define a data form, you can include information to help planners use the form to prepare plan data. You can access the form instructions in two ways:

• Select a data form from the list of forms contained within a selected folder in the content area. Then you can select the link to view form instructions. You see the instructions view link only if there are instructions for the form.

• Select View > Instructions when working with an open data form.


Viewing Form Instructions

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Recognizing Cell Color CuesYou enter data in Planning applications by typing values into the cells of a data form. Cells in which you can enter data do not have a shaded background. If data exists for a cell, it is displayed in the cell, and you can type over it. If data does not exist for the cell, the cell displays the text #missing, and you can replace the text with a value. When you define data forms, you have the option of displaying cells containing no data as blank.

Planning data forms use color cues to indicate whether a specific action was performed on a cell. Color cues are provided for cells when:

• Data was modified since the last save.

• The cells are locked.

• The cells are read-only.

• The cells contain supporting details.

• The cells contain cell text.


Recognizing Cell Color Cues

Cells with Supporting Details

Cell with Cell Text

Cell with Modif ied Data

Locked Cell

Display Only Cells

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculated CellsThe values for some cells are calculated automatically. When you enter a value into a bottom-level period, the totals for summary periods are updated immediately. For example, when you enter a value into the cell for a month, the totals for the quarter and year are updated immediately.

When you enter values into children of a parent member for dimensions other than Period, the updated totals for the parent are not calculated until you save the data or calculate the data form. For example, if you enter values for Sales and Cost of Goods Sold, you do not see updated totals for their parent Gross Margin until you save the data.

Display-Only CellsCells that are display-only are shaded. You cannot type values in display-only cells. The following conditions can cause cells to be display-only:

• One of the dimension members associated with the cell is a parent. Because parent values are calculated from child values, you cannot enter values for parents unless the version is a target version.

• You do not have write access to one of the members associated with the cell.

• The currency for the cell is not set to Local.

• The planning unit associated with the cell may be under review and owned by another user. You cannot modify data for a planning unit that is under review unless you are the current owner of the planning unit or a budget administrator.

• The periods may be outside the range that is valid for the current scenario.

N O T E

Administrators can set up members so that text can be entered into cells on data forms. In EPM Architect, administrators can set up members as a data type of Currency to enable business users to key numerical values. In addition, administrators can set up members to enable the input of percentages, smart lists, date, or text values.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Navigating Data FormsThe following table summarizes the special keys that you can use during data entry.

Key ResultEnter Enters the value that you typed and moves the cursor to the cell below the current

cell

Tab Enters the value that you typed and moves the cursor to the next cell in the row

Shift+Tab Enters the value that you typed and moves the cursor to the previous cell in the row

Esc Cancels the value that you typed and restores the previous value

Ctrl+z Cancels the value that you typed and restores the previous value

Ctrl+c Copies the selected range of cells to the clipboard


Navigating Data Forms

Special Keys:EnterTabShift +TabEscCtrl + zCtrl + cCtrl + xCtrl + v

#missing

3000

90000

Q1

#missing

3000

90000

Q1

#missing

1000

30000

Apr

#missing#missing#missing

100010001000

300003000030000

MarFebJan

Showing children Hiding children

Expanded Collapsed

Expand and Collapse:

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can choose to hide or view children of parent members. Showing and hiding children enables you to navigate forms more easily when the data forms contain a large number of members in the rows or columns.

Ctrl+x Cuts the selected range of cells to the clipboard

Ctrl+v Pastes content from the clipboard

Key Result

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Copying and Pasting DataIf your Web browser is Microsoft Internet Explorer 5.5 or later, you can copy and paste data values from one data form to another data form or from another application such as Microsoft Excel. The following rules apply when you paste data into a form:

• If the size of the selected destination area is an exact multiple of the size of the copied area, data is repeatedly pasted into the destination area. For example, if you copy the contents of two rows and then select six rows to paste the data into, Planning pastes the contents of the two rows three times, to fill the six destination rows.

• You cannot paste data in display-only cells.

• Planning copies and pastes the actual stored values of cells, not the values that are displayed based on the precision setting.

• Data that is copied and pasted from Excel to Planning retains the formatting that is set up in Excel.


Copying and Pasting Data

Copy and paste data values from within one data form to another data form.Copy and paste data values from other applications such as Excel to a data form.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• When you paste data to summary periods, Planning applies spreading rules for each cell in succession, starting from left to right and top to bottom. So, the data resulting from a paste operation may not match the original copied data.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Working with Non-Aggregated DataAdministrators can flag members as non-aggregating. If you flag members so that they do not aggregate, then totals are not calculated on data forms. In addition to being able to set members for input of numerical values, you can set members for input of text or date input.

For example, you can flag Asset Description, Asset Units, and Asset Rate members as non-aggregating members and therefore totals will not appear for those cells.

You flag cells by selecting the non-aggregating option property 'Never' in EPM Architect.


Working with Non-Aggregated Data

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Saving and Refreshing DataAfter entering or editing values in a data form, you save the information to the Planning application database. After you save the data, the form totals are recalculated to reflect the new data for members that are calculated dynamically.

If you want to clear entered values without saving them, you use the Refresh button. When you click the Refresh button, the form is refreshed with the last saved values from the applications database; the last saved values replace all values that you entered but did not save.


Saving and Refreshing Data

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Spreading DataTo make data entry more efficient, Planning automatically distributes values from summary periods to base periods. Base periods are the bottom-level members of the Period dimension. When you enter a value into the Year Total member, it is automatically distributed to the quarters and months. When you enter a value into a quarter, it is automatically spread to the months. How values are spread depends on the account type and the data type.

Revenue and Expense AccountsIf no data currently exists or if data is all zeros, a value entered in a summary period is divided evenly among the children of the summary period. For example, if you enter 300 into Year Total, the quarters in the year are automatically set to 75, and the months in each quarter are automatically set to 25.


Spreading Data

You can spread data from summary periods to base periods

30001154923923

25252525

1000

3000

Q1

100010001000

100010001000

MarFebJan

Revenue or Expense (Flow)

Asset, Liability, or Equity (Balance)

Percentage

W eekly Distribution (4-4-5)

1000

400

Q1

600300100

200100100

MarFebJanJan Cell Locked

Before

After 1000

400

Q1

500250250

200100100

MarFebJanJan Cell Not Locked

Before

After

Type ! (Shift + 1) to lock or unlock a cell or group of cells.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



If values exist for the base time periods, the existing proportional spread is preserved. For example, your current distribution might be January=100, February=100, March=200, and Q1=400. If you change the value of Q1 to 200, the new monthly values are January=50, February=50, and March=100.

Asset, Liability, and Equity AccountsIf no data currently exists or if data is all zeros, the value entered in a summary period is set for each of the base periods. For example, if you enter 1000 into Q1, then January, February, and March are set to 1000.

If values exist for the base periods and you enter a new value for the summary period, the base period affected is determined by the time balance option associated with the account. The time balance options available are First, Average, Balance, Weighted Average-Actual_365, and Weighted Average-Actual_Actual. The time balance options and their effect on spreading data values is covered in greater detail in the next topic in this lesson.

PercentagesSome accounts have the data type Percentage. For these accounts, the value is allocated to each base time period, regardless of the account type or of whether data exists. For example, if you enter 25 in quarter 1, January, February, and March are all set to 25.

Weekly DistributionSome accounts in your application might be set up to use the weekly distribution option. When the weekly distribution option is selected for an account, Planning treats quarterly values as if they were divided into 13 weeks and, using the pattern specified by your budget administrator, distributes values to the weeks. For example, if the 5-4-4 distribution option is selected, Planning treats the first month in a quarter as if it has five weeks and the last two months as if they have four weeks.

N O T E

You can temporarily lock the values of one or more cells to preserve existing values when spreading data, during which time Planning calculates and fills in values for the remaining base period cells. You can spread data across periods based on various calculations and visually review the changes before saving them to the database.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Time Balance OptionsThe following time balance options can be used with Asset, Liability, and Equity account types: Balance, First, Average, Weighted Average-Actual_Actual, and Weighted Average-Actual_365. Revenue and Expense account types typically use the time balance option of Flow.

BalanceThe Balance time balance option (also referred to as time balance last) displays the value of a summary period equal to the value of the last base period. For example, if the balance for Inventory for March is 200, the Quarter 1 balance is 200.


Time Balance Options

200200150100

200200300100

150200150100

150200150100

100

450

Q1

200150100

200150100

MarFebJan

Flow

First

Balance

Average

Weighted Average-Actual_365

Weighted Average-Actual_Actual

Weighted Average-Actual_365(100*31 + 150*28 + 200*31)/90 = 150

Weighted Average-Actual_Actual* (100*31 + 150*29 + 200*31)/91 = 150 *29 Days in Feb during a leap year

Oracle In

ternal & O

racle Aca

demy

Use O

nly



FirstThe First time balance option displays the value of a summary time period equal to the value of the first base period. For example, if the balance for Inventory for January is 100, the Quarter 1 balance is 100.

AverageThe Average time balance option displays the value of a summary period equal to the average of the base periods. For example, if the Inventory values are January=100, February=300 and March=200, the Quarter 1 balance is 200—the average of the three months’ balances.

Weighted Average-Actual_365 and Weighted Average-Actual_ActualThere are also weighted average time balance options. If you select Weighted Average-Actual_365, each month assumes the actual days of a non-leap year. February always has 28 days and Year always has 365 days. If you select Weighted Average-Actual_Actual, each month assumes the actual days of the current year. When Weighted Average-Actual_Actual is selected and the year is a leap year, February has 29 days.

FlowThe Flow time balance option displays an aggregate of all data values for a summary time period as a total for the period. For example, if the sales for January is 100, February is 150, and March is 200, the Quarter 1 balance is 450.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Spreading Data Using Grid SpreaderUsing Grid Spreader, business users can specify an amount or percentage by which Planning increases or decreases values across multiple dimensions on data forms. The spread is based on the existing values in the targeted cells. After you run grid spread, the grid is reloaded with the changed cells displayed. You have the option to view and validate results before saving data.

Keep the following points in mind when using the Grid Spreader:

• Grid Spread must be enabled on the data form in order to use it.

• Grid Spreader supports proportional spreads, evenly split and fill.

• The Grid Spreader ignores read-only, locked, and supporting detail cells.

• Users can use the Grid Spreader only to spread data to the cells to which they have access.


Spreading Data Using Grid Spreader

Enable Grid Spreader on the Other Options tab of Data Forms

#missing#missing#missing#missingAll Channels

818.18272.73272.73272.73Special Events

818.18272.73272.73272.73Retail

818.18272.73272.73272.73Online818.18272.73272.73272.73Mail Order

818.18272.73272.73272.73Indirect818.18272.73272.73272.73Government818.18272.73272.73272.73Education818.18272.73272.73272.73Distributor818.18272.73272.73272.73Direct818.18272.73272.73272.73Commercial818.18272.73272.73272.73CatalogQ1MarFebJan

FY07

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Spreading Data Using Mass AllocationMass Allocation enables predefined users (in Shared Services) to allocate across multiple dimensions.

Mass Allocation executes calculation scripts and business rules against the Essbase server and all dimension combinations. After the rule is run, the grid is reloaded, and the mass allocation results are displayed. The results are saved to the database.

Keep the following points in mind when using Mass Allocation:

• In order for users to spread data using Mass Allocate, the data form property for Mass Allocate must be enabled.

• Mass Allocation supports proportional and relational spreads.

• With updates to the spread pattern table, Mass Allocation supports fill; 4-4-5; and evenly split, pattern-based allocation.


Spreading Data Using Mass Allocation

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• Mass Allocation security is based on roles similar to business rules.

• Mass Allocate spreads data to all the source cell’s descendants, even those descendants that are not displayed on the data form.

• You do not need to have access to target cells in order to use Mass Allocate.

• After you spread data using Mass Allocate, you cannot undo this action.

• Mass Allocate is processed with dynamically-created calculation scripts.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adjusting and Annotating Plan DataAfter entering your starting point plan data, you may need to adjust data values due to a change in market conditions, revised performance expectations, or new corporate assumptions. You may need to document these changes in the form of annotations or supporting details. Planning provides several options to assist you with this task. You can adjust data values by percentages, perform ad hoc analysis through flexible data-entry commands or by locking data values when you spread data, and enter supporting details. You can also annotate your assumptions at three levels: cell, account, and planning unit.

During the data-entry and review process, you may need to adjust some values on a percentage basis, perhaps due to a change in market conditions or due to revised performance expectations. You can use the Adjust Data feature to increase or decrease by a percentage or value the current value in any cell or range of cells that contains data.


Adjusting and Annotating Plan Data

Increase or decrease plan data by a percentage or valuePerform ad hoc analysis— Spread data with

cell locking— Use flexible

data-entry operators

Add annotations— Cell text— Account annotation— Planning unit annotation

Enter supporting detail

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Performing Ad Hoc AnalysisYou can apply what-if scenarios to existing values to see the impact of various conditions before saving data. This capability is especially useful for manipulating values in specific accounts to produce desired results.

You can manipulate and experiment with data values in one of the following ways:

• Lock a value when you spread data

• Change existing values by entering an operator (flexible data entry)

• Export data to a spreadsheet

Before committing data by saving it, you can perform various what-if calculations and visually review the changes. You can change an existing value by using the operators: Add +, Subtract + -, Multiply *, Divide /, and Percentage %. The table shown in the slide provides examples of the impact of using the flexible data-entry operators.


Performing Ad Hoc Analysis

Ad hoc analysis is especially useful for manipulating values in specific accounts to produce desired results.Before committing data:— Perform what-if calculations and visually review the changes.— See the impact of various scenarios before saving the data.

100

100

100

100

100

Initial Value

%25

/5

*5

+-50

+50

Input Text

25

20

500

50

150

Result

Divide /

Percentage %

Multiply *

Subtract + -

Add +

Operation

Flexible Data Entry

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Exporting Data to SpreadsheetsYou can export data from a Planning data form to Excel to explore what-if scenarios in Excel before copying and pasting values back to Planning.

Keep in mind the following information about exporting data from a form:

• Planning does not export numerical formatting to Excel. Also, the application name, user name, form folder name, member aliases, dimension attributes, account annotations, currency tags, and percentages are not exported to Excel.

• Values pasted back to Planning from Excel must be nonformatted data.

• Excel supports the Internet Explorer browser.

• Every time you click Spreadsheet Export, a new instance of Excel is opened in the browser. Use the Close button to close any instances that you do not need.


Exporting Data to Spreadsheets

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding AnnotationsYou can add documentation to your plan in the form of annotations. You can add annotations at different levels depending on how general or specific the explanation needs to be. For example, very specific annotations can be entered at the cell level; this is referred to as cell text. General comments can be added at the Planning Unit level; this is referred to as a Planning Unit annotation.

Annotations and supporting details are stored in the Planning relational repository; they are not refreshed in the Essbase database.

You can print the data contained in a data form, including cell text, account annotations, and supporting detail. Planning unit annotations can be printed by budget administrators through Administration > Reporting or through Financial Reporting.


Adding Annotations

Cell textAccount annotationsPlanning unit annotationsSupporting details

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Cell Text and Account AnnotationsIf you have read access to a cell, you can add annotations called cell text to the cell at any level. You can add cell text at the summary time period level and across multiple dimensions at any level. You can also add cell text for non-level-zero members (in bottom-up versions), calculated cells (Dynamic Calc), and read-only cells.

You can use supporting detail and account annotations in addition to cell text to add comments to data. With supporting detail, you can build and communicate bottom-up values; with account annotations, you can add comments to accounts.

You can add account annotations or comments during data entry. You can view comments that other users have entered. Account annotations are displayed in a column on the data-entry form.

Account annotations are associated with a specific account for a planning unit.


Adding Cell Text and Account Annotations

Account Annotation

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Planning Unit AnnotationsYou can add annotations to a planning unit. A planning unit is a combination of a scenario, a version, and an entity member. Planning unit annotations are general comments that pertain to the planning unit as a whole, rather than to individual rows, columns, or cells on the data form. The table on the slide summarizes the sections on the Annotations window.


Adding Planning Unit Annotations

View the existing record of annotations associated with the planning unitExisting AnnotationsEnter and submit the text for the new annotation for the planning unit.Enter TextEnter a name for the annotation.Enter Title

Select the scenario, version, and entity that compose the planning unit for which you want to add or view annotations.

Scenario, Version, EntityDescriptionSection

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Supporting DetailYou can use supporting detail as a built-in calculator for developing data that is not in the member outline. It also provides a way for you to drill down into data and to better understand the basis of the data.

Supporting detail helps you build and communicate bottom-up values when planning corporate expenses, such as travel, salary, and projects, for which you need to calculate aggregate values. Supporting detail can include text, values, and operators that define how data is aggregated.

Additional information about supporting detail:

• Supporting detail does not change members in the Essbase outline structure.

• To create, change, or delete supporting detail, you must have write access to cells. You must have read access to view supporting detail.


Adding Supporting Detail

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• To protect values, you cannot enter, adjust, spread, or save data in aggregate values (summary periods) that have supporting detail. The aggregate values are read-only. You can add supporting detail only to base periods.

• You can add supporting detail to both target and bottom-up versions.

• Any number and precision formatting that is set up is not reflected in the Supporting Detail window.

• The sequence of operators in supporting detail follows the logic that Essbase uses to process multiple operators in a complex calculation.

• When you use Copy Versions, you can copy supporting detail from one version to another. You can also copy supporting detail using the Copy Data task.

• When you delete supporting detail for a cell, you can set how the information is synchronized with Essbase. The information can be set in Essbase to #MISSING or left it as it was before the supporting detail was deleted.

• When you enter or change supporting detail, you can copy and paste the information to multiple cells simultaneously.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculating Data in Data FormsAfter you enter data in data forms, new totals need to be calculated for parent members. By default, two calculation scripts are associated with data forms—Calculate Data Form and Calculate Currencies calculation scripts. In addition to these two default calculation scripts, you can launch any business rule to which you have access. You can associate user-defined business rules with a data form.

The following points describe how values are subtotaled and totalled in data forms:

• Dimension member subtotals are calculated based on factors such as the hierarchies and logic of the Essbase outline and the member properties.

• When data is saved, Essbase automatically calculates members that are set to be calculated dynamically. Parent members that are not set to be calculated dynamically are not updated.


Calculating Data in Data Forms

Edit > Launch Rules (associated with data form)

Tools > Business Rules

Oracle In

ternal & O

racle Aca

demy

Use O

nly



• For calculated parent members on a data form that are not set to be calculated dynamically, you need to run the Calculate Form calculation script. All subtotals in the data form are recalculated based on their member’s aggregation properties and the form’s design and layout.

• Calculations are based on stored values, which are not necessarily the same as the displayed values. For example, the values that you see on the form might be based on scaling or precision settings.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculate Data Form Calculation ScriptLaunching the Calculate Data Form calculation script from Planning requests that an Essbase calculation script calculate new totals for just the members displayed on the data form. For example, if Northern Europe and its children Germany and Nordics are on a data form, when you save the data and launch the Calculate Data Form calculation script, a new total is displayed for Northern Europe. Since Europe, the parent of Northern Europe, is not on the data form, a new total for Europe is not calculated

The Calculate Data Form calculation script can be set to automatically run when you save data.

N O T E

If you have read but not write access to some members, subtotals correctly include the members’ values even if the members are read-only.


Calculate Data Form Calculation Script

Data Saved Before <Calculate Data Form>Parent Member Not Updated

After <Calculate Data Form>Parent Member Updated

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculate Currencies Calculation ScriptIf the data form includes base and reporting currencies, you need to run the Calculate Currencies calculation script to convert base currency values to reporting currency values. Launching the Calculate Currencies calculation script from Planning requests that Essbase run a calculation script to convert base currency values to reporting currencies only for members displayed on the form.

For example, if the reporting currencies USD and EUR are on a data form, when you save the data and launch the Calculate Currencies calculation script, the converted values for USD and EUR are calculated. If you also have JPY defined as a reporting currency, its values are not calculated because it is not on the form.

The Calculate Currencies calculation script can be set to automatically run when you save data.


Calculate Currencies Calculation Script

Data Saved Before <Calculate Currencies>Reporting Currencies Not Converted

After <Calculate Currencies>Reporting Currencies Converted

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Business RulesIf you need to allocate or calculate values based on drivers or assumptions, you can set up business rules. You must have access rights to the business rule to be able to launch it. You can launch business rules by selecting Tools > Business Rules if you are in Advanced Mode. If you are in Basic Mode, you have access to business rules only if they are defined in your task list.

Business rules can also be associated with data forms. To launch business rules associated with a data form, select Edit > Launch Rules. Business rules associated with data forms can be set to automatically run when you save data. You can also launch business rules associated with a data form by clicking on the business rules listed in the view pane.

N O T E

Creating business rules is covered in detail in a subsequent lesson.


Business Rules

New Computer Expense

Headcount of New Employees

Price per New Computer =X

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Entering Data with Smart ListsSmart lists are custom drop-down lists that you can access from data form cells. For cells whose members are associated with smart lists, data cannot be entered by typing a value. Instead, you select a value from a drop-down list.

After you click in a cell that is associated with a smart list, you can click the arrow to expand the smart list. You can then select one of the smart list options as the value for the cell.

After setting up smart lists and associating them with data forms, you can enter data on data forms by selecting from a drop-down menu. Remember that if you use smart lists to choose values from a drop-down list for certain data cells, no data values can be keyed into those cells.


Entering Data with Smart Lists

Customer_Service_Class uses a smart list

Network Sales, Chip Sales, andComputer Salesuse data values

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Navigating Data Forms with MenusAfter creating a menu and associating the menu with a data form, you can use the menu by right-clicking on the data form. If you specified a required dimension for your menu item, you can right-click in the area on the data form that contains that dimension.

For example, if you select Account as the required dimension, then the menu is available when you click on Account members on the data form. Selecting none as the required dimension makes the menu available when you right-click in the data form.


Navigating Data Forms with Menus

1. Add Headcount (Account 6000)

2. Enter T&E Rate (Account 6010)

3. Enter Software Rate (Account 6020)

4. Right-click on the Account column

5. Click Headcount business rule to calculate accounts 5240 and 5350 3

12

4

5

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Submit data in data forms

• Adjust and annotate plan data

• Calculate data in a data form

• Enter data with smart lists

• Navigate data forms with menus

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

L E S S O N 2 0

Entering Data in Smart View 20


• Describe Smart View

• Enter, adjust, calculate, and analyze Planning data using Smart View

• Work with Planning data

Oracle In

ternal & O

racle Aca

demy

Use O

nly

Module 7 Entering Data in Hyperion System 9 PlanningLesson 20 Entering Data in Smart View


Smart View OverviewYou can use Smart View to enter and analyze data from a single Excel interface. Smart View provides integration with Microsoft Office not only for Planning but also for Financial Management, Essbase, Web Analysis, Financial Reporting, Interactive Reporting, and Production Reporting. Tasks that previously were repeated across products are now performed only once. The use of a single interface enables you to utilize multiple products simultaneously. Tight integration of Smart View enables you to perform the following tasks:

• Import content into the Microsoft products Excel, Word, PowerPoint, and Outlook

• Utilize Office smart tags to add single data values and import reports

• Distribute and share Office documents by logging on only once to the data source

• Expose functions for Financial Management and Essbase content in Word, PowerPoint, and Outlook


Smart View Overview

Planning Financial Management

Hyperion System 9 Applications+

Essbase

Hyperion System 9 BI+

Interactive ReportingProduction ReportingFinancial Reporting

Web Analysis

Smart View Client

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Integrating Smart View with OfficeYou can use Smart View to import BI+ content from Financial Reporting, Interactive Reporting, Production Reporting, and Web Analysis into Excel, Word, or PowerPoint. BI+ content can consist of reports, dashboards, and charts from the following products:

• From Financial Reporting and Web Analysis, you can import reports.

• From Interactive Reporting, you can import charts, dashboards, and reports (first page only).

• From Production Reporting, you can import reports. Importing charts is not supported in Release 9.0.


Integrating Smart View with Office

Excel:Data-entry formsAd hoc analysisFunctionsBI+ content

Word, PowerPoint, and Outlook:FunctionsBI+ content

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Smart View ArchitectureSmart View incorporates powerful architectural features to handle a wide range of analytic applications across large multiple-user environments. The slide provides a high-level view of the integrated information flow between source data and the Smart View client.

The slide shows that Planning and Financial Management have their own Web servers built into the application tier. Essbase does not have its own application server. As a result, Essbase requires a separate installation for Smart View Provider.


Smart View Architecture

HTTP(s)

Smart View Client

Data Source Connection Data Model

XML

Client Tier

Analytic Provider Service

Java API

Infrastructure

Planning Provider Financial ManagementProvider

Financial Management Application Server

Planning Application Server

Web Tier

Application Tier

Essbase RDBMS Data Tier

TCPIP / DCOM

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Establishing Data Source ConnectionsBefore you can analyze data using Smart View, you must establish connections to your data sources. To manage your data source connections, use Connection Manager. You can add, delete, and modify connections per Excel instance. The connections managed by Connection Manager have no relationship to worksheets. You can establish multiple connections per Excel instance. After you add data sources in Connection Manager and they are displayed, you can use Connection Manager to connect to the data sources.

You can add data sources for Planning, Financial Management, Essbase, Financial Reporting, Web Analysis, Interactive Reporting, and Production Reporting. You can connect to a data source directly, if you know the URL, or you can use Shared Services, which displays a list of providers to which you have access.


Establishing Data Source Connections

2

3

1

Oracle In

ternal & O

racle Aca

demy

Use O

nly



You can see whether a data source is connected or disconnected by viewing the icon next to the data source name in Connection Manager. If you try to connect to a data source that is disconnected, you are prompted to log on. If you are authenticated by external authentication, you are not prompted to log on.

To add a data source connection:

1. In Office, select Hyperion > Connection Manager.

The Connection Manager dialog box is displayed.

2. Click Add, and select URL Provider.

The Add Data Source dialog box is displayed.

3. Perform the following actions:

a. From the Provider drop-down list, select Hyperion Provider.

b. From the Location drop-down list, select the Smart View provider URL. Alternatively, enter the URL in the list, using the following format:

Analytic Services - http(s)://<servername>:<portnumber>/aps/SmartView

Planning - http(s)://<servername>:<portnumber>/HyperionPlanning/SmartView

c. Optional: Select Create as default connection to make this connection your default database connection.

d. Click Next.

The Connect to Data Source dialog box is displayed.

N O T E

The default URL is http://localhost:13080/aps/SmartView.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Establishing Data Source Connections (Cont.)4. Enter your user name and password, and click Connect.

The Select Database or Repository dialog box is displayed.

5. Select a database from the list, and click Next.

The Add a Connection Name dialog box is displayed.

6. Enter a name and description for the connection, and click Finish.

The connection is now available for selection in Connection Manager.


Establishing Data Source Connections (Cont.)

4

5

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Planning and Smart ViewYou can work with Planning features when using Smart View. You can open Planning data forms in Excel, and you can work with online data forms while connected to the Planning server or offline data forms for additional flexibility.

When you use data forms with Smart View, you have the same functionality as you have with data forms in Planning. You can view form instructions, adjust data, manipulate data by using ad hoc adjustments, lock and spread values to base periods, enter supporting detail and cell text, and launch business rules.

The Planning server performs validity checks involving user security, metadata access, and form definition changes in order to synchronize data. The server then saves only incremental changes to the cells that were changed or modified after the data form was opened in Excel.


Planning and Smart View

Open Planning data forms in ExcelWork online or offline— Use Planning data forms even when disconnected from the Planning server— Synchronize data back to the Planning server with validity checks

View instructionsAdjust dataEnter cell textLock and spread values to base periodsEnter supporting detailCalculate dataEnter and preserve formulas

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Opening Data Forms in Smart ViewAfter connecting to a Planning data source, you can select a data form to work within Excel to enter and adjust data using Smart View. Many functions that you use during data entry in Planning are also available when you work with data forms in Smart View. You have access to the same data forms that you have access to in Planning.


Opening Data Forms in Smart View

To open a Planning data form in Smart View, selectHyperion > Forms > Select Form

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Navigating Data Forms in Smart ViewAfter you open a data form in Smart View, you can use the arrow keys to move forward, backward, up, or down. Press Tab to move to the next cell in a row. Press Shift+Tab to move to the previous cell in the row. Press Enter to move to the next cell in a column and Shift+Enter to move to the previous cell in the column.

If you want to work with a specific slice of data, you can change the page selections and then click Go in the same manner as you would in Planning. Functions are available from the Hyperion menu, and there are shortcuts on the Smart View toolbar.


Page ListToolbar

Navigating Data Forms in Smart View

Column Headings

Cells with Supporting Detail

Data Input Cells

Parent Member

Row Headings

Point of View

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Entering Data in Smart View Using Data FormsYou can utilize the full functionality of Excel with Planning data forms both online and offline when you work in Smart View. You can use Excel functionality to view data and text, create formulas, and format data.

You cannot modify the structure of a Planning data form, but you can set up user-modified areas on a spreadsheet. This customization is not lost when you refresh the data form or when you open a new Planning data form in Excel. You can define and save numeric analyses and calculations for the data in a Planning data form. In other words, you have greater analytic capability on the fly, especially when data forms are offline.


Entering Data in Smart View Using Data Forms

Utilize full Excel functionality.Set up customized areas of the spreadsheet.Add or modify data values.Spread data values.Adjust, copy, and paste data values.Add or view cell text and supporting detail.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Entering DataYou can add data values by entering them in input cells. You can modify data values by typing over existing values. You can spread values from summary periods to base periods. The same rules apply when you spread values using Smart View as when you use Planning. You cannot use cell locking when you spread data in Smart View.

Adjusting DataTo adjust values in Smart View, you use the Adjust Data dialog box. Flexible data-entry operators are not available in Smart View. You can increase or decrease values by a percentage or numeric value as well as multiply or divide by a fixed value. In Smart View, you cannot adjust a data value if a cell is read-only or contains supporting detail.

If you want to eliminate data from a cell that has a data value, replace the data value with #missing. Another way to replace a data value with #missing is to select the cells that you want to replace with #MISSING and press the Delete key.

You can select a range of cells by using the same techniques that you use for data entry in Planning. You can also copy and paste data values in a grid. The rules for copying and pasting apply in all situations in grids except one: If you copy and paste a value with supporting detail, only the value—not the supporting detail—is copied and pasted.

Annotating Plan DataYou can add cell text to a cell at any level. You can also add supporting detail to build and communicate bottom-up values. You cannot add account annotations or annotate planning units from Smart View.

Submitting Plan DataAfter entering and adjusting data, you need to save your changes in the Planning application. You do this by selecting Hyperion > Submit Data. Data values are updated directly to the Essbase database; supporting detail and cell text are updated directly to the Planning application relational database.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Adding Formulas to Data FormsYou can create Excel formulas to manipulate or analyze the data in data forms. You can save the formulas with the Excel workbook so that they are preserved when you use the workbook again.

Formulas interact with other functionality in the following ways:

• You can spread data values using a formula in a summary parent cell. Spreading logic ignores formulas in child cells. For example, you could enter a formula in Q1 whose calculated value is spread over Jan, Feb, and March. However, if you enter a formula in Feb, that cell is ignored when the value for Q1 is spread.

• If you move a referential formula, its cell references are updated to reflect its new location.

• If you use the Suppress #Missing Rows feature on a cell that has a referential formula, the cell references are not updated; the cell relationship is absolute, not relative.


Adding Formulas to Data Forms

You can create formulas— inside or outside data form grids— on cells that contain cell text

You cannot create formulas— on read-only cells or cells that are locked— on cells that have supporting detail

Formulas are preserved even when you— refresh data forms— open saved .xls worksheets in the future— expand or collapse rows or columns

Oracle In

ternal & O

racle Aca

demy

Use O

nly



If you create formulas in a data form, you are prompted to save the workbook as an .xls file with the new formulas under the following conditions:

• You change the current page.

• You take the data form offline.

• You select a different data form.

• You connect to a different data source.

You lose temporary access to the formulas even if you save the formulas with the workbook when:

• You change the current page, data form, or data source.

• You take the data form offline.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Calculating Data in Smart ViewAfter entering data in a data form, you need to calculate new totals for parent members. You have the same data calculations options available to you in Smart View as you have during data entry in Planning.

You can launch business rules and calculation scripts that recalculate data in Essbase. The data form in Excel is updated with the new data. You see the calculation scripts that you have access to listed by plan type. If a runtime prompt is part of a business rule, you are prompted to enter information.

After the business rule is executed, the values in the Essbase database reflect the results of the calculation.


Calculating Data in Smart View

Hyperion > Calculation Options > Business Rules

Hyperion > Calculation Options > Rules on Form

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Offline Planning OverviewYou can work with Planning data forms from remote locations when you are not connected to a Planning server. You can disconnect from the Planning server and work offline and still be able to use comparable online functionality. Working offline, you can enter and save data to the Planning server. For example, you can take data forms offline, enter and adjust data, view instructions, add supporting detail, run business rules, and create formulas to manipulate data.

Working offline allows you to take a Planning data form in Excel and establish an impromptu local connection to a data source without being connected to the Planning server. Thus, you can continue to work on plan data and perform what-if scenarios when you do not have access to the Planning server. When you take a data form offline, the Planning server flags the data form status as offline. Data forms associated with a connection are saved locally on your hard drive. By synchronizing the locally saved data with the server, you ensure that the data form uses the most recent information.


Offline Planning Overview

Offline Planning - work with data while not connected to the Planning applicationWork with Offline MyAnalytics cubeRobust support for Web-based Planning functionality, including offline calculationsand business rules

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Taking Data Forms OfflineYou use the Take Offline Wizard to take data forms offline.

To take data forms offline:

1. Select Hyperion > Forms > Take Offline.

The Take Offline Wizard is launched.

2. Select the data forms to take offline, and click Next.

3. Select the dimensions and members to take offline.

The dimensions and members are those displayed in the Page drop-down lists of the forms you take offline.


Taking Data Forms Offline

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Create an offline connection, giving it a unique name, and click Finish.

The Download Status window displays the names of the outline, forms, dimensions, and members that are being downloaded for the offline connection.

When the download process is complete, the message “Forms are successfully downloaded,” is displayed.

5. Click OK.

6. Close Excel.

N O T E

To take a data form or group of data forms offline, you must select them and give them an offline connection name. You can select the offline connection name over multiple Excel sessions.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Working with Planning OfflineYou can work within Excel using the offline connection that you created. Most client-side capabilities, such as viewing form instructions, adjusting data, entering cell text, and adding supporting detail, remain available when you work offline. There are some differences in the capabilities for performing some tasks. For example, to add supporting detail, you can select a range of contiguous cells in a row or column if you are working online. (You cannot select a section of cells that include a combination of rows and columns.) However, in offline mode, to add supporting detail, you can select cells only on a cell-by-cell basis.

To work with Planning offline:

1. Launch Excel.

2. Select Hyperion > Connection Manager, and select the offline connection.


Working with Planning Offline

Oracle In

ternal & O

racle Aca

demy

Use O

nly



3. Select the data forms and members with which you want to work.

4. Select Hyperion > Submit Data to save the changed data to your computer.

You can save data forms in the local data source when you work offline. You have the option of saving a single worksheet or multiple worksheets when you work offline. Whether you are working offline or online, it is recommended that you submit data to the data source so that the server is updated with the latest data from the worksheet.

The following rules apply when data is submitted:

• Dimensions must be displayed in the axis in which they were displayed before the data was synchronized. This stipulation is true for all axes (rows, columns, pages, and points of view).

• Pages must be displayed in the order in which they were displayed when the form was loaded.

• The order of the dimensions in the rows or columns can be changed.

N O T E

Saving data forms using an offline connection saves the changes locally to your computer. If you also save the Excel workbook, you save only the data at the currently selected dimension member combination.

N O T E

If some submitted cells are no longer on the data form, only the cells to which you have write access and that exist on the new data form definition are saved.

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Synchronizing Data to the ServerYou can save changed data to the Planning server by synchronizing your data. When you synchronize your data, you can synchronize at the workbook level or at the worksheet level. Synchronization is important because updated data is sent back to the server so that the Planning application reflects the work performed remotely.

To synchronize data to the server:

1. Use Connection Manager to connect to the same offline connection.

2. Select Hyperion > Forms > Sync Back To Server to save the changed data to the Planning server.

The Sync Back Wizard dialog box is displayed.

3. Log on to the server by typing your login ID and password, and click Next.


Synchronizing Data to the Server

Oracle In

ternal & O

racle Aca

demy

Use O

nly



4. Select the data forms whose data you want to save to the Planning server, and click Next.

5. Select the page members to synchronize back to the server, and click Next.

6. Optional: Select to delete offline data and application after synchronization, and click Finish.

A message, “Sync back to server was successful,” confirms that your changed data was saved to the Planning application.

7. Click Done.

N O T E

If someone else changed data for the same cells, only the most recent data is saved.

Oracle In

ternal & O

racle Aca

demy

Use O

nly




• Describe Smart View

• Enter, adjust, calculate, and analyze Planning data using Smart View

• Work with Planning data

Oracle In

ternal & O

racle Aca

demy

Use O

nly



Oracle In

ternal & O

racle Aca

demy

Use O

nly

planning- oracle bootcamp 1

Documents