hp_admin
TRANSCRIPT
-
Oracle Hyperion Planning
Administrator's Guide
Release 11.1.2.1
Updated: May 2013
-
Planning Administrator's Guide, 11.1.2.1
Copyright 2001, 2013, 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.
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 RIGHTS:
Programs, software, databases, and related documentation and technical data delivered to U.S. Government customersare "commercial computer software" or "commercial technical data" pursuant to the applicable Federal AcquisitionRegulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, andadaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, tothe extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, CommercialComputer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
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
Chapter 1. Using Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
About Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Planning Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Performance Management Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
EPM Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Lifecycle Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Web Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
User Licensing for Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Planning Usage Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Setting Up Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Building Plans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Launching Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Starting the Budget Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Post-Planning Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chapter 2. Getting Started with Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Starting Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Considerations for Working with Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Understanding Implied Sharing in Planning Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . 33
Connecting to Multiple Instances of Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Starting the Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Optimizing SQL Relational Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Setting Planning Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Changing the JDBC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Contents iii
-
Configuring JDBC Connection Pooling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Configuring Data Synchronization on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Setting Offline Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Controlling Smart View Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Setting Background Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Setting Data Validation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Setting the Maximum Length for Text Values and Comments in Cells . . . . . . . . . . . . 41
Logging On to EPM Workspace and Accessing Planning . . . . . . . . . . . . . . . . . . . . . . . . . 42
Working with Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Suppressing Password Prompts in Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . 44
About Text Files for Planning Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Running Planning Utilities on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
About EPM Oracle Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Using Application Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
About Updating Instances and Clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Closing Planning and Essbase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 3. Setting Up Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Levels of Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Planning Elements That Can Be Assigned Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Types of Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Enabling Access Permissions for Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Assigning Access to Members and Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Adding Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Editing Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Deleting Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
About Effective Access Permissions to Shared Members . . . . . . . . . . . . . . . . . . . . . . 53
Managing Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Assigning Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Adding Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Changing Access to Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Importing Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Improving Performance When Importing Access Permissions . . . . . . . . . . . . . . . . . . . . . 59
Exporting Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Reporting on Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Selecting Reporting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Selecting Reporting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Working With Access Permissions Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Setting up Audit Trails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
iv Contents
-
Managing Security Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Synchronizing Users and Groups With the UpdateUsers Utility . . . . . . . . . . . . . . . . . . . . 67
Synchronizing Users With the Provision Users Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Migrating User and Group Identities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Migrating Business Rule Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Removing Stale User Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Setting Up Access Permissions in Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Chapter 4. Managing Planning Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Opening Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Unlocking Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Using Broadcast Messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Viewing Usage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Creating and Refreshing Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Managing Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Creating Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Editing Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Deleting Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Managing Currency Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Working with Currency Conversion Calc Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Optimizing Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
About Reordering Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Allocating Memory for Supporting Detail Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Configuring the Data and Index Cache Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Other Performance Optimization Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Backing Up Applications and Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Chapter 5. Loading Data and Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Overview of Loading Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Working with the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Loading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Loading Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Command Line Parameters for the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . 91
Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Load File Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Exporting Metadata with the Outline Load Utility . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Data Integrator Adapter for Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using DIM Adapter for Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Enabling Data Load of Essbase Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Loading from Administration Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Contents v
-
File Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Loading with Performance Management Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Loading with FDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Chapter 6. Managing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
About Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Data Forms and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Data Forms and Access Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Data Forms and Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Designing Data Forms for Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Designing Data Forms for Drill-Through Information . . . . . . . . . . . . . . . . . . . . . . 121
Designing Data Forms with Formula Rows and Columns . . . . . . . . . . . . . . . . . . . . 121
Designing Data Forms with Data Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Data Forms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Data Forms and Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Data Forms and Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Data Forms and Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Understanding Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Page Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Selecting and Opening Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Creating Simple Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Setting Row and Column Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Setting Data Form Grid Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Setting Data Form Precision, Display Properties, and Other Options . . . . . . . . . . . . 129
Creating Asymmetric Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Adding Formula Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Including Data Validation Rules in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Defining Simple Data Form Page and Point of View . . . . . . . . . . . . . . . . . . . . . . . . 134
Editing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Creating Composite Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Setting Composite Data Form Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Setting Composite Data Form Section Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Setting Composite Data Form POV and Page Properties . . . . . . . . . . . . . . . . . . . . . . . . 139
Using Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Selecting Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Setting Business Rule Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
vi Contents
-
About Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Understanding Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Launching Business Rules With a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Customizing Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Previewing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Managing User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Selecting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Deleting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Printing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Searching for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Moving Data Forms and Ad Hoc Grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Deleting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Renaming Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Overview of Importing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Preparing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Preparing Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Importing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
ImportFormDefinition Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Importing and Exporting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Planning Offline Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Offline Data Form Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Offline User Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Business Rule Considerations for Offline Calculations . . . . . . . . . . . . . . . . . . . . . . . 157
Chapter 7. Using the Member Selector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Selecting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Using Wildcards in Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
About Selecting Attribute Values as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
About Selecting Members for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
About Selecting Substitution Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
About Selecting User Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Chapter 8. Managing Data Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Creating and Updating Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Formatting Cells and Setting the Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Viewing Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Order of Evaluation and Execution for Data Validation Rules . . . . . . . . . . . . . . . . . . . . 173
Conditions Supported by the Rule Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
If Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Then Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Contents vii
-
Range Condition Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Data Validation Conditional Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Data Validation Rule Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Scenario 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Scenario 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Scenario 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Scenario 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Scenario 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Chapter 9. Managing the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
About the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Planning Unit Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Data Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Setting Up E-mail for Approvals Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Defining the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Approvals Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Approvals Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Starting and Supporting the Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Printing Planning Unit Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Managing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Creating Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Assigning Planning Unit Hierarchy Scenario and Version Combinations . . . . . . . . . 203
Selecting Planning Unit Hierarchy Scenario and Version . . . . . . . . . . . . . . . . . . . . . 203
Editing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Deleting Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Viewing Planning Unit Hierarchy Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Renaming Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Synchronizing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Exporting Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Importing Planning Unit Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Planning Unit Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Modifying the Planning Unit Promotional Path . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Design Considerations for Planning Unit Promotional Path Data ValidationRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Managing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Creating Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Renaming Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
viii Contents
-
Renaming Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Moving Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Deleting Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Creating Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Adding Instructions to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Adding and Defining Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Editing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Linking Tasks to Planning Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Assigning Access to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Importing and Exporting Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Copying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Clearing Cell Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Chapter 10. Working With Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Managing Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Creating Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Moving Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Deleting Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Renaming Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
About Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Setting Personal Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Setting Application Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Specifying System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Assigning Applications to Shared Services Application Groups . . . . . . . . . . . . . . . . . 232
Limiting Use of Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Specifying Custom Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Setting Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Setting Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Mapping Applications for Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
About Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Creating Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Mapping Planning Applications to Reporting Applications . . . . . . . . . . . . . . . . . . . 235
Defining Application Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Defining Dimension Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Setting the Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Validation Rules for Default Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Pushing Data to Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Pushing Data with a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Unsupported Features with Mapping Applications . . . . . . . . . . . . . . . . . . . . . . . . . 239
Contents ix
-
Mapping Applications and Substitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Adding an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . 240
Editing an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . . . 240
Removing an Essbase Server for Reporting Applications . . . . . . . . . . . . . . . . . . . . . 241
Deleting Application Information Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Deleting Account Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Deleting Supporting Detail Associated With a Scenario . . . . . . . . . . . . . . . . . . . . . . 242
Chapter 11. Working with Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Creating and Updating Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Working with Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Adding or Changing Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Chapter 12. Working with Classic Application Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
About Creating Applications with Performance Management Architect and ClassicAdministration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Setting Up Classic Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Creating Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Managing Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Managing Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Selecting Application Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Setting up the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Setting up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Specifying Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Reviewing Application Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Registering Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Deleting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Working with Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
About Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Creating Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Editing or Renaming Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Deleting Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Clearing Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Copying Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Setting a Default Alias Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Working with Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Dimension Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Working with Dimension Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Viewing a Members Ancestors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Determining Where Members Are Used in Applications . . . . . . . . . . . . . . . . . . . . . 268
x Contents
-
About Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
About Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Base Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
About Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Accounts, Entities, and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
About User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Adding or Editing User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . 275
Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Setting Dimension Density and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Setting the Evaluation Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Working with Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Working with Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Creating Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Working with Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Working with Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Customizing Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Enabling Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Specifying Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Setting Up Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Specifying Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Sorting Version and Scenario Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Moving Scenario and Version Members in the Dimension Hierarchy . . . . . . . . . . . . 302
Setting up Dynamic Time Series Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Additional Supported Essbase Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Considerations for Alternate Hierarchies in Period Dimensions . . . . . . . . . . . . . . . . 305
Working with Classic Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Refreshing Application Databases Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Refreshing Databases with Level 0 Members Set to Dynamic Calc . . . . . . . . . . . . . . . 306
Working With Essbase Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Sorting Members Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Deleting Shared Descendants Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Using Smart Lists, UDAs, and Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Working with Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Working with UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Working with Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Chapter 13. Customizing Planning Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Customizing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Contents xi
-
Customizing the Planning Tools Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Customizing Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
Location of Cascading Style Sheet Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Modifying Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Customization Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Customizing the Style of Row and Column Members in Data Forms . . . . . . . . . . . . . . . 325
About Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Customizing Text in Non-Latin Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Restricted Characters in Customized Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Customizing Colors, States, and Actions for Process Status . . . . . . . . . . . . . . . . . . . . . . 329
Customizing Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Customizing States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Customizing Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Creating Spreading Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Examples of Spreading Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Creating Instructions for Planners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Chapter 14. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Calculation Script is Too Long or Complex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Cannot Find Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Cannot Process Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Conflicting Change by Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Copy Version Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Currency Conversion Calc Script Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Data Form Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Database Locked by Another Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
FDM Drill Through Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
500 Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Implied Sharing Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
Invalid Value When Entering Date Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Manage Database Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Maximum Number of Applications Already Connected or Database is Locked . . . . . . . . 342
Optimizing WebLogic Server Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Optimizing Windows Network Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Registering a Restored Application with Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Session Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Slow Performance When Opening Data Forms Using a Dial-Up Connection . . . . . . . . . 345
Slow Performance When Opening Large Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . 347
xii Contents
-
Unable to Create Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Appendix A. Customizing Data Forms with JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
About Customizing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Modifying JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
customCellEnterPre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
customCellEnterPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
customCellValidatePre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
customCellValidatePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
customOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
drawCustomButtons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
validateForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Deploying Custom JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Appendix B. Naming Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Restrictions for Applications and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Restrictions for Dimensions, Members, Aliases, and Data Forms . . . . . . . . . . . . . . . . . . 356
Dimension and Member Names in Calc Scripts, Report Scripts, Formulas, Filters, andSubstitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Restrictions for User Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Appendix C. Data Form Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Using Formulas and Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Creating Formulas Using the Formula Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Editing Formulas Using the Formula Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Deleting Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Formula Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
AverageA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
CountA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Difference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
IfThen, If . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
Min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
Mod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
PercentOfTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Contents xiii
-
Pi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Sqrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Truncate / Trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Variance / Var . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
VariancePercent / VarPer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Appendix D. Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Enabling Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Using Keyboard Equivalents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
General Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Administration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
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
-
16 Documentation Accessibility
-
1Using Planning
In This Chapter
About Planning ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Smart View... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Planning Web Client .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Performance Management Architect .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
EPM Workspace ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Lifecycle Management.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Financial Reporting .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Business Rules .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Web Analysis .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
User Licensing for Third-Party Software ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Planning Usage Scenario.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
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 17
-
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 Administrators 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
18 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 42.
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 19
-
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 250. For information on data sources forPlanning applications created in Performance Management Architect, see the Oracle HyperionEnterprise Performance Management Architect Administrators 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 140.
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 Administrators Guide.
These topics outline how Planning is used:
l Deployment on page 21
20 Using Planning
-
l Setting Up Applications on page 22
l Building Plans on page 26
l Launching Business Rules on page 27
l Starting the Budget Review Process on page 27
l Post-Planning Activities on page 29
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 21
-
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 ArchitectAdministrators 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
22 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 applications 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 23
-
m Exchange rates
Table 5 Generating Databases
User Task
Administrator Creates and refreshes Planning applications based on metadata stored in the applications 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 Administrators 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
24 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 AdministratorsGuide.
l For business rules created with Calculation Manager: Oracle Hyperion EnterprisePerformance Management Architect Administrators Guide.
See also: Using Business Rules on page 140.
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 25
-
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 Users 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:
26 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 27
-
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
28 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 29
-
30 Using Planning
-
2Getting Started with Planning
In This Chapter
Overview ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Starting Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Considerations for Working with Essbase... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Understanding Implied Sharing in Planning Data Forms ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Connecting to Multiple Instances of Essbase ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Starting the Relational Database... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Optimizing SQL Relational Databases ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Setting Planning Properties .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Logging On to EPM Workspace and Accessing Planning ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Working with Planning Utilities.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Using Application Servers .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
About Updating Instances and Clusters .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Closing Planning and Essbase... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
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 Administrators 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 organizations 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 31
-
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 onPlanning.
l Manage currency conversion and exchange rate tables.
l Identify the review and approval process, requirements, and participants, and manage thebudgeting process.
For information on installing and configuring Planning and Performance ManagementArchitect, see the Oracle Hyperion Enterprise Performance Management Architect SystemInstallation and Configuration Guide.
Starting EssbaseThe data for Planning applications resides on the Essbase server. Essbase must be running beforeyou can open Planning applications. After Essbase is started, it can be minimized and run in thebackground or as a service.
Considerations for Working with EssbaseCreating and refreshing on the Manage Database page affects data in the Essbase database. Whenyou click Create, data is erased and Planning plan types are rebuilt. When you click Refresh, datamight be replaced. For important information, see Creating and Refreshing ApplicationDatabases on page 75.
If you are not using Performance Management Architect, you work with applications usingClassic application administration. If you upgrade an application created in Classic applicationadministration to Performance Management Architect, you cannot return to working with thatapplication in Classic application administration. Modifying Essbase outlines directly throughOracle Essbase Administration Services is not supported.
When you refresh Planning applications, the Essbase database makes these changes:
l If a member does not exist in the Planning relational database, the member and its properties,attributes, and User-Defined Attributes (UDAs) are not retained in Essbase on Refresh.
l Planning first retrieves member properties from any existing member in Essbase, then setsand overrides any member property definable in Planning.
32 G