Oracle® Hyperion Planning

Administrator's Guide

Release 11.1.2.1

Updated: June 2014

Planning Administrator's Guide, 11.1.2.1

Copyright © 2001, 2014, Oracle and/or its affiliates. All rights reserved.

Authors: EPM Information Development Team

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respectiveowners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used underlicense and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and theAMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademarkof The Open Group.

This software and related documentation are provided under a license agreement containing restrictions on use anddisclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement orallowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit,perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilationof this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you findany errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf ofthe U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS:

Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/ordocumentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicableFederal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure,modification, and adaptation of the programs, including any operating system, integrated software, any programs installedon the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is notdeveloped or intended for use in any inherently dangerous applications, including applications that may create a risk ofpersonal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take allappropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliatesdisclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

This software or hardware and documentation may provide access to or information on content, products, and servicesfrom third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of anykind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsiblefor any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Contents

Documentation Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 1. Using Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

About Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Planning Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Performance Management Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

EPM Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Lifecycle Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Web Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

User Licensing for Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Planning Usage Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Setting Up Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Building Plans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Launching Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Starting the Budget Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Post-Planning Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Chapter 2. Getting Started with Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Starting Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Considerations for Working with Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Understanding Implied Sharing in Planning Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . 35

Connecting to Multiple Instances of Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Starting the Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Optimizing SQL Relational Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Setting Planning Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Contents iii

Changing the JDBC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Configuring JDBC Connection Pooling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Configuring Data Synchronization on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Setting Offline Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Controlling Smart View Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Setting Background Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Setting Data Validation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Setting the Maximum Length for Text Values and Comments in Cells . . . . . . . . . . . . 43

Logging On to EPM Workspace and Accessing Planning . . . . . . . . . . . . . . . . . . . . . . . . . 44

Working with Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Suppressing Password Prompts in Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . 46

About Text Files for Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Running Planning Utilities on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

About EPM Oracle Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Using Application Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

About Updating Instances and Clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Closing Planning and Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Chapter 3. Setting Up Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Levels of Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Planning Elements That Can Be Assigned Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Types of Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Enabling Access Permissions for Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Assigning Access to Members and Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Adding Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Editing Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Deleting Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

About Effective Access Permissions to Shared Members . . . . . . . . . . . . . . . . . . . . . . 55

Managing Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Assigning Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Adding Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Changing Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Importing Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Improving Performance When Importing Access Permissions . . . . . . . . . . . . . . . . . . . . . 61

Exporting Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Reporting on Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Selecting Reporting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Selecting Reporting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Working With Access Permissions Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

iv Contents

Setting up Audit Trails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Managing Security Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Synchronizing Users and Groups With the UpdateUsers Utility . . . . . . . . . . . . . . . . . . . . 69

Synchronizing Users With the Provision Users Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Migrating User and Group Identities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Migrating Business Rule Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Removing Stale User Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Setting Up Access Permissions in Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Chapter 4. Managing Planning Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Opening Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Unlocking Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Using Broadcast Messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Viewing Usage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Creating and Refreshing Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Managing Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Creating Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Editing Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Deleting Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Managing Currency Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Working with Currency Conversion Calc Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Optimizing Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

About Reordering Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Allocating Memory for Supporting Detail Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Configuring the Data and Index Cache Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Other Performance Optimization Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Backing Up Applications and Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Chapter 5. Loading Data and Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Overview of Loading Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Working with the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Loading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Loading Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Command Line Parameters for the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . 93

Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Load File Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Exporting Metadata with the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Data Integrator Adapter for Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Using DIM Adapter for Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Enabling Data Load of Essbase Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Contents v

Loading from Administration Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

File Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Loading with Performance Management Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Loading with FDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Chapter 6. Managing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

About Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Data Forms and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Data Forms and Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Data Forms and Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Designing Data Forms for Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Designing Data Forms for Drill-Through Information . . . . . . . . . . . . . . . . . . . . . . 123

Designing Data Forms with Formula Rows and Columns . . . . . . . . . . . . . . . . . . . . 123

Designing Data Forms with Data Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Data Forms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Data Forms and Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Data Forms and Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Data Forms and Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Understanding Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Page Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Selecting and Opening Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Creating Simple Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Setting Row and Column Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Setting Data Form Grid Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Setting Data Form Precision, Display Properties, and Other Options . . . . . . . . . . . . 131

Creating Asymmetric Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Adding Formula Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Including Data Validation Rules in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Defining Simple Data Form Page and Point of View . . . . . . . . . . . . . . . . . . . . . . . . 136

Editing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Creating Composite Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Setting Composite Data Form Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Setting Composite Data Form Section Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Setting Composite Data Form POV and Page Properties . . . . . . . . . . . . . . . . . . . . . . . . 141

Using Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Selecting Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

vi Contents

Setting Business Rule Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

About Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Understanding Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Launching Business Rules With a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Customizing Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Previewing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Managing User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Selecting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Deleting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Printing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Searching for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Moving Data Forms and Ad Hoc Grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Deleting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Renaming Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Overview of Importing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Preparing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Preparing Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Importing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

ImportFormDefinition Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Importing and Exporting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Planning Offline Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Offline Data Form Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Offline User Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Business Rule Considerations for Offline Calculations . . . . . . . . . . . . . . . . . . . . . . . 159

Chapter 7. Using the Member Selector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Selecting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Using Wildcards in Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

About Selecting Attribute Values as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

About Selecting Members for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

About Selecting Substitution Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

About Selecting User Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Chapter 8. Managing Data Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Creating and Updating Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Formatting Cells and Setting the Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Viewing Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Order of Evaluation and Execution for Data Validation Rules . . . . . . . . . . . . . . . . . . . . 175

Conditions Supported by the Rule Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

If Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Contents vii

Then Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Range Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Data Validation Conditional Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Data Validation Rule Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Scenario 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Scenario 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Scenario 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Scenario 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Scenario 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Chapter 9. Managing the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

About the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Planning Unit Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Setting Up E-mail for Approvals Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Defining the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Approvals Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Approvals Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Starting and Supporting the Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Printing Planning Unit Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Managing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Creating Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Assigning Planning Unit Hierarchy Scenario and Version Combinations . . . . . . . . . 205

Selecting Planning Unit Hierarchy Scenario and Version . . . . . . . . . . . . . . . . . . . . . 205

Editing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Deleting Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Viewing Planning Unit Hierarchy Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Renaming Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Synchronizing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Exporting Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Importing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Planning Unit Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

Modifying the Planning Unit Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Design Considerations for Planning Unit Promotional Path Data ValidationRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Managing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Creating Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

viii Contents

Renaming Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Renaming Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Moving Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Deleting Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Creating Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Adding Instructions to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Adding and Defining Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

Editing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Linking Tasks to Planning Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Assigning Access to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Importing and Exporting Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Copying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Clearing Cell Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Chapter 10. Working With Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Managing Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Creating Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Moving Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Deleting Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Renaming Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

About Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Setting Personal Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Setting Application Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Specifying System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

Assigning Applications to Shared Services Application Groups . . . . . . . . . . . . . . . . . 234

Limiting Use of Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Specifying Custom Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Setting Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Setting Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Mapping Applications for Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

About Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Creating Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Mapping Planning Applications to Reporting Applications . . . . . . . . . . . . . . . . . . . 237

Defining Application Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

Defining Dimension Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

Setting the Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Validation Rules for Default Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Pushing Data to Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Pushing Data with a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Contents ix

Unsupported Features with Mapping Applications . . . . . . . . . . . . . . . . . . . . . . . . . 241

Mapping Applications and Substitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Adding an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . 242

Editing an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . 242

Removing an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . 243

Deleting Application Information Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Deleting Account Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Deleting Supporting Detail Associated With a Scenario . . . . . . . . . . . . . . . . . . . . . . 244

Chapter 11. Working with Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Creating and Updating Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Working with Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Adding or Changing Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Chapter 12. Working with Classic Application Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

About Creating Applications with Performance Management Architect and ClassicAdministration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

Setting Up Classic Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

Creating Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Managing Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Managing Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Selecting Application Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Setting up the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Setting up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Specifying Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Reviewing Application Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Registering Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Deleting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Working with Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

About Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Creating Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Editing or Renaming Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Deleting Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Clearing Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Copying Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Setting a Default Alias Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Working with Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Dimension Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Working with Dimension Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Viewing a Member’s Ancestors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

x Contents

Determining Where Members Are Used in Applications . . . . . . . . . . . . . . . . . . . . . 270

About Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

About Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Base Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

About Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

Accounts, Entities, and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

About User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Adding or Editing User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . 277

Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Setting Dimension Density and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Setting the Evaluation Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Working with Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Working with Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Creating Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Working with Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Working with Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

Customizing Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Enabling Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Specifying Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

Setting Up Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Specifying Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Sorting Version and Scenario Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Moving Scenario and Version Members in the Dimension Hierarchy . . . . . . . . . . . . 304

Setting up Dynamic Time Series Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Additional Supported Essbase Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Considerations for Alternate Hierarchies in Period Dimensions . . . . . . . . . . . . . . . . 307

Working with Classic Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Refreshing Application Databases Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Refreshing Databases with Level 0 Members Set to Dynamic Calc . . . . . . . . . . . . . . . 308

Working With Essbase Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Sorting Members Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

Deleting Shared Descendants Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

Using Smart Lists, UDAs, and Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Working with Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Working with UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

Working with Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Contents xi

Chapter 13. Customizing Planning Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Customizing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Customizing the Planning Tools Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Customizing Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Location of Cascading Style Sheet Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Modifying Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Customization Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

Customizing the Style of Row and Column Members in Data Forms . . . . . . . . . . . . . . . 327

About Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Customizing Text in Non-Latin Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

Restricted Characters in Customized Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

Customizing Colors, States, and Actions for Process Status . . . . . . . . . . . . . . . . . . . . . . 331

Customizing Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

Customizing States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

Customizing Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

Creating Spreading Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Examples of Spreading Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Creating Instructions for Planners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

Chapter 14. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

Calculation Script is Too Long or Complex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

Cannot Find Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

Cannot Process Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

Conflicting Change by Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Copy Version Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Currency Conversion Calc Script Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

Data Form Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

Database Locked by Another Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

FDM Drill Through Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

500 Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Implied Sharing Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

Invalid Value When Entering Date Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Manage Database Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Maximum Number of Applications Already Connected or Database is Locked . . . . . . . . 344

Optimizing WebLogic Server Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Optimizing Windows Network Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Registering a Restored Application with Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Session Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

xii Contents

Slow Performance When Opening Data Forms Using a Dial-Up Connection . . . . . . . . . 347

Slow Performance When Opening Large Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Unable to Create Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Appendix A. Customizing Data Forms with JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

About Customizing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

Modifying JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

customCellEnterPre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

customCellEnterPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

customCellValidatePre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

customCellValidatePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

customOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

drawCustomButtons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

validateForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Deploying Custom JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Appendix B. Naming Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Restrictions for Applications and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Restrictions for Dimensions, Members, Aliases, and Data Forms . . . . . . . . . . . . . . . . . . 358

Dimension and Member Names in Calc Scripts, Report Scripts, Formulas, Filters, andSubstitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

Restrictions for User Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Appendix C. Data Form Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Using Formulas and Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Creating Formulas Using the Formula Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Editing Formulas Using the Formula Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Deleting Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

AverageA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

CountA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Difference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

Eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

IfThen, If . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

Contents xiii

Mod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

PercentOfTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

Pi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Sqrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Truncate / Trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Variance / Var . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

VariancePercent / VarPer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Appendix D. Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

Enabling Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

Using Keyboard Equivalents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

General Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Administration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

xiv Contents

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website athttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle SupportOracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

15

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacchttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trshttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

16 Documentation Accessibility

Documentation Feedback

Send feedback on this documentation to: epmdoc_ww@oracle.com

Follow EPM Information Development on these social media sites:

LinkedIn - http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051

Twitter - http://twitter.com/hyperionepminfo

Facebook - http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642

Google+ - https://plus.google.com/106915048672979407731/#106915048672979407731/posts

YouTube - http://www.youtube.com/user/OracleEPMWebcasts

17

http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051http://twitter.com/hyperionepminfohttp://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642https://plus.google.com/106915048672979407731/#106915048672979407731/postshttp://www.youtube.com/user/OracleEPMWebcasts

18 Documentation Feedback

1Using Planning

In This Chapter

About Planning ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

Smart View... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Planning Web Client .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Performance Management Architect .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

EPM Workspace ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Lifecycle Management.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Financial Reporting .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Business Rules .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Web Analysis .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

User Licensing for Third-Party Software ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Planning Usage Scenario.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

About PlanningOracle Hyperion Planning is a Web-based budgeting and planning solution that drivescollaborative, event-based operational planning processes throughout the organization for awide range of financial and operational needs. It enables a complete and closed-loop planningprocess that drives continuous business improvement. Decision makers and managers cancommunicate the course of action and collaborate with budget holders to optimize the planningprocess. Planners have the flexibility to adapt rapidly, ensuring plans are relevant and useful.Planning:

l Facilitates collaboration, communication, and control across multi-divisional globalenterprises

l Provides a framework for perpetual planning, to manage volatility and frequent planningcycles

l Provides ease of use and deployment through the Web or Oracle Hyperion Smart View forOffice

l Lowers the total cost of ownership through a shorter roll out and implementation phase,and easier maintenance for applications

l Enhances decision-making with reporting, analysis, and planning

l Promotes modeling with complex business rules and allocations

About Planning 19

l Integrates with other systems to load data

Smart ViewSmart View is the Microsoft Office interface to Planning, where users can perform their planningand forecasting activities. Smart View also enables users to work offline in disconnect mode.They can analyze Planning data in Microsoft Outlook, Excel, Word, and PowerPoint. Ad hocgrids in Smart View enable Planning users to personalize focused data slices that they frequentlyaccess and share them with others through Smart View or Planning. See the “Working with AdHoc Grids” chapter in the Oracle Hyperion Planning User's Guide and the Oracle Hyperion SmartView for Office User's Guide.

Planning Web ClientPlanning provides complete functionality for Web users. Use the Web interface to roll outapplications to large, distributed organizations without installing software on client computers.All software resides on the server. Many administrative features that were formerly in thePlanning Desktop are now available through Planning Web. Other administrative features, suchas creating and administering applications and dimensions, are now available through OracleHyperion EPM Architect.

Performance Management ArchitectPerformance Management Architect is a component of Planning installation and configuration.You use it to create and work with Planning applications and dimensions, Smart Lists, UDAs,member formulas, and other features. You can also create business rules.

With Performance Management Architect, you can view, create, and validate PerformanceManagement Architect applications, and deploy them to create Planning applications.Deploying applications from Performance Management Architect to Planning is a long-runningoperation. The initial deployment may take more time than subsequent re-deployments.

Performance Management Architect applications can contain business rules created using theOracle Hyperion Calculation Manager module in Performance Management Architect. Forassistance on tasks performed in Performance Management Architect, see the Oracle HyperionEnterprise Performance Management Architect Administrator’s Guide. For information oninstalling and configuring Performance Management Architect, see the Oracle HyperionEnterprise Performance Management System Installation and Configuration Guide.

EPM WorkspacePlanning is available within Oracle Hyperion Enterprise Performance Management Workspace.For information on EPM Workspace features, such as EPM Workspace preferences, see theOracle Enterprise Performance Management Workspace User's Online Help or Oracle Enterprise

20 Using Planning

Performance Management Workspace Administrator's Online Help. To log on to EPM Workspace,see “Logging On to EPM Workspace and Accessing Planning” on page 44.

Lifecycle ManagementOracle Hyperion Enterprise Performance Management System Lifecycle Management providesa consistent way for Oracle Enterprise Performance Management System products to migratean application, a repository, or individual artifacts across product environments and operatingsystems. Generally, the Lifecycle Management interface in Oracle Hyperion Shared ServicesConsole is consistent for all EPM System products that support Lifecycle Management. However,EPM System products display different artifact listings and export and import options in theLifecycle Management interface.

Lifecycle Management features:

l Viewing applications and folders

l Searching for artifacts

l Migrating directly from one application to another

l Migrating to and from the file system

l Saving and loading migration definition files

l Viewing selected artifacts

l Auditing migrations

l Viewing the status of migrations

l Importing and exporting individual artifacts for quick changes on the file system

In addition to providing the Lifecycle Management interface in Shared Services Console, thereis a command-line utility called Lifecycle Management Utility that provides an alternate way tomigrate artifacts from source to destination. The Lifecycle Management Utility can be used witha third-party scheduling service such as Windows Task Scheduler or Oracle Enterprise Manager.

Lastly, there is a Lifecycle Management Application Programming Interface (API) that enablesusers to customize and extend the Lifecycle Management functionality.

For detailed information about Oracle Hyperion Enterprise Performance Management SystemLifecycle Management, see the Oracle Hyperion Enterprise Performance Management SystemLifecycle Management Guide.

EssbasePlanning leverages Oracle Essbase analytic and calculation capabilities, security filters, APIs, pre-built financial intelligence, calculation functions, and multi-database application support.Planning stores the application definition in a relational database, and creates Essbase databasesand security privileges for applications.

Lifecycle Management 21

Data sources are used to link the relational database and the Essbase server, and are associatedwith each Planning application. For information on creating data sources for Classic Planningapplications, see “Managing Data Sources” on page 252. For information on data sources forPlanning applications created in Performance Management Architect, see the Oracle HyperionEnterprise Performance Management Architect Administrator’s Guide.

Financial Reporting Oracle Hyperion Financial Reporting is a management reporting tool that transforms data intomeaningful business information through highly formatted reports. Planning users can useFinancial Reporting to manage reporting tasks and implement plan review and analysis. Userscan create reports featuring text, grids of data, charts, graphs, and images. They can use real-time, ad hoc variance reporting, and produce a variety of sophisticated financial reports that canbe viewed online or printed with production-quality formatting.

Business Rules Business rules perform complicated calculations through predefined formulas, variables,calculation scripts, macros and sequences (for Oracle Hyperion Business Rules) and rulesets andtemplates (for Calculation Manager). See “Using Business Rules” on page 142.

Web AnalysisOracle Hyperion Web Analysis is an analysis, presentation, and reporting solution. It allowsorganizations to deliver information to large user communities at a low cost.

User Licensing for Third-Party SoftwareTo use Planning, you must purchase licenses from third-party vendors, for example, for arelational database and Web application server.

Planning Usage ScenarioYou create applications using Performance Management Architect application administration,and deploy them to create Planning applications. Applications contain dimensions anddimension attributes designed to meet Planning needs, such as accounts, entities, scenarios, andother dimension elements. You can create an unlimited number of applications. For informationabout Performance Management Architect, see the Oracle Hyperion Enterprise PerformanceManagement Architect Administrator’s Guide.

These topics outline how Planning is used:

l “Deployment” on page 23

22 Using Planning

l “Setting Up Applications” on page 24

l “Building Plans” on page 28

l “Launching Business Rules” on page 29

l “Starting the Budget Review Process” on page 29

l “Post-Planning Activities” on page 31

DeploymentAn IT professional installs and configures Planning on server computers and client workstations.The IT professional should have experience administering relational databases, installing client/server and Web server software, and configuring user directories.

Table 1 Server Installation

User Task

IT professional Installs Planning system requirements, including operating systems, relational database, Web server, application server,and Web browser

IT professional Installs Essbase

IT professional Sets up the data source name (DSN) for the OLAP and relational databases

IT professional Installs Planning, Financial Reporting, and (for Classic Planning applications) Business Rules

IT professional Creates relational databases and connections

IT professional Configures the Web server

IT professional Sets up users in an external user directory

IT professional Optional: Creates a test application with users

IT professional Tests installation and configuration

Table 2 Client Installation Users and Tasks

User Task

IT professional Installs the Planning remote Windows client, Smart View, Microsoft Excel, Financial Reporting, and (for Classic Planningapplications) Business Rules

IT professional Installs a Web browser

IT professional Tests connections to the Web and network

Planning Usage Scenario 23

Setting Up Applications

Subtopics

l Creating Metadata

l Defining Users and Access Permissions

l Creating and Refreshing Applications

l Designing Data Forms

l Designing Worksheets

l Populating Applications with Data

l Creating Business Rules

l Setting Targets

l Creating Tasks Lists

l Reporting

l Initializing Planning Cycles

Setting up applications includes the tasks listed in this section. Administrators can also set upapplications using Performance Management Architect application administration, and deploythem to Planning. See the Oracle Hyperion Enterprise Performance Management ArchitectAdministrator’s Guide.

Creating MetadataConsulting partners and the Planning administrator design applications and create anapplication framework with Performance Management Architect application administration.There is only one application owner per application. The owner can grant ownership to anotheradministrator. The application framework includes:

l Application name

l Number and names of plan types

l Calendar structure

l Whether the application is a multicurrency application

l Default currency

After the application framework is created, dimensions and members are added to theapplication and assigned to the plan type in Performance Management Architect. There are upto eight required dimensions in an application:

l Currency (for multicurrency applications)

l HSP_Rates (for multicurrency applications)

l Account

l Entity

l Scenario

l Version

l Period

24 Using Planning

l Year

Table 3 Creating Metadata

User Task

Administrator Designs and creates applications

Administrator Defines metadata (currencies, scenarios, versions, calendar)

Administrator Enters exchange rates

Administrator Defines attributes and attribute values

Administrator Loads custom dimensions

Defining Users and Access PermissionsAn IT professional defines users and groups and configures a user directory before users canaccess Planning applications. For detailed information, see the Oracle Hyperion EnterprisePerformance Management System User and Role Security Guide. Within Planning, you assignusers or groups to secured objects.

Table 4 Setting Up Users and Access Permissions

User Task

IT professional Sets up Planning users with a supported user directory

Administrator Synchronizes users in the user directory with a Planning application

Administrator Assigns access permissions to users and groups

Administrator Assigns access permissions to dimensions, members, data forms, folders, and task lists in Planning (see Chapter 3,“Setting Up Access Permissions”)

Creating and Refreshing ApplicationsAdministrators create and periodically refresh the Essbase outline and security structure for thePlanning application. The outline and security structure are created based on metadata storedin the Planning application’s relational database. Planning creates:

l An Essbase application

l Multiple Essbase databases (one per plan type)

l Essbase access permissions filters

l Essbase outlines (all metadata):

m Members

m Shared members

m User-defined attributes and attribute values

Planning Usage Scenario 25

m Exchange rates

Table 5 Generating Databases

User Task

Administrator Creates and refreshes Planning applications based on metadata stored in the application’s relational database

Designing Data Forms

Table 6 Designing Data Forms

User Task

Administrator and interactive user Creates and maintains data forms in Planning

Administrator and interactive user Creates and manages folders in Planning for data form management

Administrator Assigns access permissions to data forms and folders

Designing WorksheetsPlanning users can install Smart View to work with data forms in Excel to leverage Excelworksheet models, build custom formulas, format reports, and work disconnected fromPlanning.

Populating Applications with DataAdministrators and interactive users use Performance Management Architect applicationadministration to pre-populate Planning applications with data. See the Oracle HyperionEnterprise Performance Management Architect Administrator’s Guide.

Table 7 Populating Applications with Data

User Task

Administrator Use Copy Data to copy plans from one dimensional intersection to another, including relational dataand supporting detail

Administrator and interactive user Performs bulk loads

Any user Enters values for global saved assumptions referenced in business rules

Any user Enters data into the Planning application through data forms or Smart View

Any user Calculates and creates data using business rules or Copy Version

26 Using Planning

Creating Business Rules

Table 8 Creating Business Rules

User Task

Administrator Assigns users access permissions to business rules

Administrator and interactive user Creates business rules. See the Oracle Hyperion Enterprise PerformanceManagement System User and Role Security Guide for information on CalculationManager roles and rights.

Administrator, interactive user, and planners who areassigned launch access permissions by anadministrator

Launches business rules for Planning applications

For information on administering business rules, see:

l For business rules created with Business Rules: Hyperion Business Rules Administrator’sGuide.

l For business rules created with Calculation Manager: Oracle Hyperion EnterprisePerformance Management Architect Administrator’s Guide.

See also: “Using Business Rules” on page 142.

Setting TargetsAdministrators set target type versions for Planning applications. User access to target data isdetermined by access permissions. Typically, target data is stored in the upper levels of metadata,such as Business Unit. Administrators configure the Essbase database so target data is notreplaced by lower-level #MISSING values.

Target data is typically used as guidance for data entry and analysis. Create it, for example,though:

l Manual data entry

l Modeling with business rules

l Pushing targets down to lower-level members using business rules

Table 9 Setting Targets

User Type Task

Administrator Adds a standard target-type version

Administrator Assigns users access permissions (typically, read-only) to the target version

Administrator Configures the Essbase database so target data is not replaced by lower-level #MISSING values

Any user Creates target data

Administrator Publishes targets using Financial Reporting

Planning Usage Scenario 27

User Type Task

Any user Displays targets on data forms for guidance or input

Creating Tasks ListsTable 10 Task Lists

User Type Task

Administrator Creates task lists that structure the budgeting process for users

Administrator and Task List Access Manager Assigns access permissions to task lists and tasks

ReportingUse Financial Reporting to create reports for Windows or Web-enabled clients. FinancialReporting uses Essbase databases and adheres to Essbase access permissions filters generated byPlanning.

Table 11 Reporting

User Type Task

Administrator and interactive user Creates and launches reports using Financial Reporting

Any user Prints reports

Any user Views reports throughout the planning cycle

Initializing Planning CyclesTable 12 Initializing Planning Cycles

User Type Task

Administrator Selects planning units for iterative review, analysis, and approval

Any user Specifies whether to receive e-mail after becoming planning unit owners

Building PlansAdministrators define task lists to guide users through the planning process. Planning users startthe planning cycle by logging into an application and opening data forms. Users read data forminstructions and review historical or target data for guidance when preparing plans. Foradditional user tasks, see the Oracle Hyperion Planning User’s Online Help.

Users can save data in data forms, and can refresh currently stored data values in data formsbefore saving. Users can restore data to the last saved version, and save a personal version usingCopy Version. When users save:

28 Using Planning

l Data is saved to the Essbase database.

l Subtotals on data forms are calculated and stored if the Calculate Data Form business ruleis selected to run on save when data forms are created. (By default, this business rule is notselected to run on save.)

l Business rules are launched to calculate data.

Launching Business RulesThe business rules available to users depend on access permissions. Administrators can assignlaunch access permissions to Calculation Manager business rules from within Planning (seeChapter 3, “Setting Up Access Permissions”). For more information on business rule accesspermissions, also see:

l For Calculation Manager: Oracle Hyperion Enterprise Performance Management System Userand Role Security Guide

l For Business Rules: Hyperion Business Rules Administrator's Guide

l Oracle Hyperion Enterprise Performance Management System User and Role Security Guide

Users with launch permissions can launch business rules from Planning or Smart View.

Starting the Budget Review ProcessThe administrator initializes review processes by placing planning units in the First Pass state.Data is typically promoted for review after users enter data, calculate, and save. When userspromote planning units, they enter annotations that record assumptions and select the nextowners or reviewers. Promoting planning units:

l Assigns ownership to the selected user

l Overrides access permissions on the planning unit to read-only for non-owners

l Changes planning unit status from First Pass to Under Review

l Updates status for upper-level (or lower-level) planning units to Under Review as necessary

l Records an audit entry in the process history

l Optionally sends e-mail notifications to the application owner and new planning unit owner

Reviewers can make modifications and annotations. Read-only users can enter planning unitannotations and account annotations, but cannot enter data values. Users can keep a personalcopy of the original data to track modified data. When planning units are promoted, the revieweris the new owner and typically:

l Receives e-mail notifications and is directed to the Process Definition page

l Sorts the status page by entity, process state, or current owner

l Reviews annotations and planning unit history

l Opens data forms and reviews, analyzes, modifies, and calculates data

Planning Usage Scenario 29

l Makes annotations (including account annotations)

l Promotes or rejects the planning unit, with iterations until the planning unit is approved

After planning units are approved, the application owner becomes the planning unit owner.Only administrators can reject planning units. To close the review cycle, the application owneror administrator changes the scenario or version to read-only for all users.

Table 13 Starting the Budget Review Process

Users Tasks

Administrators Starts the planning unit for the planning cycle

Users with access Enters data

Users with access Calculates data

Users with access Optionally, creates a copy of submissions

Users with access Promotes data for review

Users with access Enters annotations to support the review process. Until an owner is established for a planning unit,multiple users can update it. Access permissions for non-owners are changed to read-only whenthe planning unit is promoted to the next reviewer.

Users with access Notifies reviewers that the planning unit is ready for review

Users with access Reviews data in the promoted planning unit

Users with access Reads and modifies promoted data through data forms

Users with access Runs business rules

Users with access Reads promoted data using Financial Reporting, Oracle Hyperion Web Analysis, Smart View, or third-party reporting tools

Users with access Modifies data values, enters annotations, signs off on planning units, and promotes, rejects, andapproves planning units

Administrators Checks the planning process status

Administrators Reads supporting annotations

Administrators Views the audit trail

Administrators Completes the planning cycle

Administrators Changes user access of scenarios and versions in Essbase to read-only

Administrators and interactive users Publishes reports using Financial Reporting

30 Using Planning

Post-Planning ActivitiesTable 14 Post-Planning Activities

Users Tasks

Administrators and interactiveusers

Upload planning data by scenario to other applications, a general ledger, or an ERP

Users with access Copies a version of the completed plan to a new version or copies data from one dimensional intersectionto another

Administrator and interactiveuser

Performs bulk loads of the latest actuals data to report on actual performance versus plan

Users with access Accesses data forms, Financial Reporting, Smart View, Oracle Hyperion Performance Scorecard, or third-party reporting tools to read updates to actuals and analyze performance to plan

Planning Usage Scenario 31

32 Using Planning

2Getting Started with Planning

In This Chapter

Overview ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

Starting Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Considerations for Working with Essbase... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Understanding Implied Sharing in Planning Data Forms ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Connecting to Multiple Instances of Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

Starting the Relational Database... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

Optimizing SQL Relational Databases ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

Setting Planning Properties .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Logging On to EPM Workspace and Accessing Planning ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Working with Planning Utilities.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

Using Application Servers .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

About Updating Instances and Clusters .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

Closing Planning and Essbase... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

OverviewPlanning applications are a related set of dimensions and dimension members used to meet aset of planning needs. Each application has its own accounts, entities, scenarios, and other dataelements.

You can work with applications using Performance Management Architect and Classicapplication administration. See the Oracle Hyperion Enterprise Performance ManagementArchitect Administrator’s Guide for these Performance Management Architect applicationadministration tasks:

l Create an application in Performance Management Architect and deploy it to create aPlanning application.

l Create entities to reflect your organization’s budget structure.

l Create accounts and dimensions for gathering planning data.

l Create scenarios and versions.

l Modify the calendar with any custom summary time periods needed by your organization.

l For multicurrency applications, specify the base currency, currency code and symbol,triangulation currency, reporting currency, and exchange rate type.

Overview 33

l Create business rules in Calculation Manager.

See this guide for Classic application administration tasks, including:

l Create, delete, and register Classic applications.

l Create data forms, task lists, and menus.

l Assign access permissions for dimension members, task lists, data forms, and data formfolders. See Chapter 3, “Setting Up Access Permissions” and the Oracle Hyperion EnterprisePerformance Management System User and Role Security Guide and its information onPla