Professional Documents
Culture Documents
HP Admin
HP Admin
HP Admin
PLANNING
RELEASE 9.2.0.3
AD M I N I S T R AT O R S GU I D E
Copyright 20012007 Hyperion Solutions Corporation. All rights reserved. Hyperion, the Hyperion logo, and Hyperions product names are trademarks of Hyperion. References to other companies and their products use trademarks owned by the respective companies and are for reference purpose only. No portion hereof may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other than the recipients personal use, without the express written permission of Hyperion. The information contained herein is subject to change without notice. Hyperion shall not be liable for errors contained herein or consequential damages in connection with the furnishing, performance, or use hereof. Any Hyperion software described herein is licensed exclusively subject to the conditions set forth in the Hyperion license agreement. Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the applicable Hyperion license agreement and as provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14, as applicable. Hyperion Solutions Corporation 5450 Great America Parkway Santa Clara, California 95054 Printed in the U.S.A.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Document Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Where to Find Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Help Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Additional Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Education Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Consulting Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx CHAPTER 1 Using Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 About Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Benefit to Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Key Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Planning Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Additional Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Analytic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Hyperion System 9 BI+ Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Hyperion System 9 Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Hyperion System 9 BI+ Web Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 User Licensing for Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Planning Usage Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Setting Up the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Building a Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Launching Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Starting the Budget Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Post-Planning Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Contents
iii
CHAPTER 2 Getting Started with Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Starting Analytic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Connecting to Multiple Instances of Analytic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Starting the Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Optimizing an SQL Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating the Properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring JDBC Connection Pooling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 43 43 46
Starting Planning on the Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Using the Toolbar, Status Bar, and Navigation Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Starting Planning on the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Logging On without Browser Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Using Application Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Registering a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Unregistering a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Closing Planning and Analytic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 CHAPTER 3 Creating an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Creating Applications with the Setup Application Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Select Workspace Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Saving the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 55 56 58 58 59
Creating Additional Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 UDL Encryption Enhancement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Using Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Opening Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Closing Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unlocking Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 61 61 63 63
Using Broadcast Messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Viewing Usage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Creating Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Optimizing the Performance of Currency Conversion Calc Scripts . . . . . . . . . . . . . . . . . Refreshing Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Database Restructures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working With Analytic Services Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling Application Databases to be Refreshed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples of Scheduling an Application Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 68 69 71 72 72 76
iv
Contents
Changing the Order of the Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Allocating Memory for Supporting Detail Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Clearing Options when Creating or Refreshing an Application Database . . . . . . . . . . . . . 79 Backing Up Applications and Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 CHAPTER 4 Setting Up Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 About Access Rights and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Configuring DCOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 About Security in Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Creating Security Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 About Assigning Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Setting Up Security in Financial Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Importing Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Tips When Importing Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Reporting on Access Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Selecting the Reporting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Selecting the Reporting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Working With the Report on Access Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Setting up Audit Trails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 CHAPTER 5 Setting Up Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 About Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Creating Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Editing or Renaming an Alias Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Deleting Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Clearing Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Copying Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Setting a Default Alias Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 CHAPTER 6 Setting Up the Calendar and Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Customizing the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Defining How Calendars Roll Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Creating and Editing Summary Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Deleting Summary Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Working with Years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Setting the Fiscal Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Renaming Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Assigning Aliases to Summary Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Editing the BegBalance Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Enabling Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Working with Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 About the Calculate Currencies Business Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Contents
Exchange Rate Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reporting Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Seeing How a Currency is Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hsp_Rates Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Triangulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calculation Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Exchange Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
111 111 111 112 112 113 115 116 117 118 118 119 119 119 121 122
CHAPTER 7 Setting Up Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Working with Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Dimensions and Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Sparse and Dense Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Dimension Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with a Dimension Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Aggregation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Storage Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unmarking Members That are Pending Deletion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 124 124 125 126 132 132 132 135
About the Entity Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Entity Members and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Base Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 About the Account Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Account Members and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Account Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Saved Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Type and Exchange Rate Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 138 139 142 143
About User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Adding or Editing User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Working with Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding or Editing Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assigning Access to Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting a Parent Member and Its Descendants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 146 149 152 153
vi
Contents
Creating Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Assigning Access Rights to Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Working with Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 About Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Creating Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 Renaming Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Deleting Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Working with Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Creating Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Assigning Attribute Values to Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Modifying Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Deleting Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Using Attributes and Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Using Attributes and Attribute Values in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Using Attributes and Attribute Values in Hyperion Application Link . . . . . . . . . . . . . . . 164 CHAPTER 8 Setting Up Scenarios and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 Setting Up Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 About Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Creating a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Editing a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Deleting a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Copying a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Setting Up Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 About Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Creating a Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 Editing a Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 Deleting a Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Displaying Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Copying Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Sorting Version and Scenario Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Moving Scenario and Version Members Within the Dimension Hierarchy . . . . . . . . . . . . . . 176 CHAPTER 9 Loading Members and Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Importing Custom Dimension Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Quick Steps for Importing Custom Dimension Members . . . . . . . . . . . . . . . . . . . . . . . . 178 Using Hyperion Application Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Using Flow Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Using the Hyperion Planning Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Loading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Using the Hyperion Essbase Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Using the Flat File Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Connecting Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Contents
vii
Running an Adapter Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Loading from Essbase Administration Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Data Load File Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Sorting Members Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 CHAPTER 10 Managing Shared Services Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 About Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Registering Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Assigning an Application to a Shared Services Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 About Managing Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 About Sharing Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 About Sharing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Working with Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Private Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Shared Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Applications for Metadata Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Synchronizing Models and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sync Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Model Naming Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Comparing Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compare Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing and Editing Model Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Renaming Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filtering the Content of Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tracking Model History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Permissions to Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing and Setting Model Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prerequisites for Moving Data Between Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assigning Access to Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accessing Data Integration Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filtering Integration Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating or Editing a Data Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Scheduled Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Grouping Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 196 196 197 200 201 203 205 205 206 207 212 213 215 217 219 224 226 226 227 227 228 229 236 237 238 241
viii
Contents
CHAPTER 11 Using Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 About Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Plan Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Designing a Data Form for Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Forms and Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding the Composition of a Data Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Point of View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Data Form Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting the Row and Column Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Column and Row Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding Column Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding Row Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Column Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Row Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting Attribute Values as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting Substitution Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting User Variables as Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Asymmetric Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enabling Users to Dynamically Add Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining the Page and POV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting a Data Forms Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Properties of Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Runtime Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assigning Access to Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding Access to Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Access to a Data Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selecting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting User Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
246 246 246 247 247 247 248 248 248 248 248 249 249 249 250 250 251 251 252 252 255 256 256 257 257 258 259 260 261 262 262 263 264 267 268 269 270 271 271 272 273 273 274
ix
Printing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Searching for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Modifying Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Moving Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Deleting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Importing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Preparing the Data Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Preparing the Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing the Data Form Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ImportFormDefinition Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 277 278 279 280
Importing and Exporting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 CHAPTER 12 Managing the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 About the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Planning Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting the Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Entity Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up E-mail for Workflow Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printing Planning Unit Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Task List Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding Instructions to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding and Defining Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Linking Tasks to Planning Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assigning Access to Task Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 284 286 287 287 287 289 289 290 290 291 291 292 295 299 300
Copying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 CHAPTER 13 Working With Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 Moving an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving a Planning Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Business Rules Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Reporting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Personal Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Application Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specifying System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Limiting Use of an Application During Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 306 308 311 314 314 315 316 317
Contents
Specifying Custom Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 Setting Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Setting Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Deleting Application Information Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Deleting Account Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Deleting Supporting Detail Associated With a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Deleting Shared Descendants Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 CHAPTER 14 Menus, Smart Lists, UDAs, and Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 Working with Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 Working with Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 Adding or Changing Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 Working with Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Adding or Changing Smart List Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 Adding or Changing Smart List Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 Previewing Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Setting the Evaluation Order of Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Displaying #Missing with Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 Working with UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Creating UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Changing UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Deleting UDAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Working with Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Viewing Details of Formula Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Working with Formula Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 CHAPTER 15 Customizing Planning Web Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Customizing the Planning Tools Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Customizing Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Default Location of Cascading Style Sheet Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Modifying Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Customization Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 Customizing the Style of Row and Column Members in Data Forms . . . . . . . . . . . . . . . . . . . 345 About Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Customizing Text in Non-Latin Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 Restricted Characters in Customized Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 Customizing Planning When Using WebLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 Customizing Planning When Using WebLogic and UNIX . . . . . . . . . . . . . . . . . . . . . . . . 351 Customizing the Colors, States, and Actions for Process Status . . . . . . . . . . . . . . . . . . . . . . . 352 Customizing the Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Customizing the States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Customizing the Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Contents
xi
CHAPTER 16 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Calculation Script is Too Long or Complex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Cannot Find Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Cannot Process Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Conflicting Change by Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Copy Version Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Currency Conversion Calc Script Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Database Locked by Another Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Exiting Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 500 Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 Manage Database Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 File Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Maximum Number of Applications Already Connected or Database is Locked . . . . . . . . . . 361 Missing Planning Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 Session Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Slow Performance When Opening Large Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Slow Performance When Opening Data Forms Using a Dial-Up Connection . . . . . . . . . . . 364 Unable to Create Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Unable to Refresh Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Unsuccessful Log On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Unable to Find Properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 APPENDIX A Customizing Data Forms with JavaScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 About Customizing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 Modifying JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . customCellEnterPre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . customCellEnterPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . customCellValidatePre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . customCellValidatePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . customOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . drawCustomButtons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . validateForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 390 391 392 393 394 394 395
Deploying Custom JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 APPENDIX B Naming Restrictions for Analytic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Naming Restrictions for Applications and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 Naming Restrictions for Dimensions, Members, Aliases, and Data Forms . . . . . . . . . . . . . . 399 Using Dimension and Member Names in Calculation Scripts, Report Scripts, Formulas, Filters, and Substitution Variable Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Naming Restrictions for User Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
xii
Contents
APPENDIX C Common Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Configuration Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Account Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Account Type Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Entity Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Scenario Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Version Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Year Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Consolidation Method Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Container Model Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Element Model Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 APPENDIX D Reference Application for Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 About the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 About the Dimension Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 Dimension Members in Planning DatabaseSmall Application . . . . . . . . . . . . . . . . . . . 411 Dimension Members in Planning DatabaseLarge Application . . . . . . . . . . . . . . . . . . . 411 About the Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 About the Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 Data Forms in Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 About the Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 Business Rules in Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 About Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 About Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Creating the Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Initializing the Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Creating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Loading Data into the Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 Upgrading to a Large Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Contents
xiii
xiv
Contents
Preface
Welcome to the Hyperion System 9 Planning Administrators Guide and help system. This preface discusses the following topics:
Purpose on page xv Audience on page xv Document Structure on page xvi Where to Find Documentation on page xvii Help Menu Commands on page xviii Conventions on page xviii Additional Support on page xix Documentation Feedback on page xx
Purpose
This documentation shows you how to create and maintain planning applications in Hyperion System 9 Planning, as well as set up dimensions, the calendar, currencies, exchange rates, alias tables, data forms, task lists, reports, budgeting assumptions, and access rights. The Hyperion System 9 Planning Administrators Guide and help system also step you through uploading data from and downloading data to Planning. It explains the Planning concepts and procedures that you need to use the software. Included is information on optimizing performance, troubleshooting, and details on how Planning interacts with and is enhanced by other Hyperion products.
Audience
This documentation is for Planning administrators who are responsible for the following tasks:
Creating and maintaining planning applications Setting up dimensions, scenarios, versions, currencies, exchange rates, alias tables, the calendar, task lists, and access rights Initiating and managing the budget process Creating data forms, Hyperion System 9 Smart View for Office worksheets, and reports
Preface
xv
Uploading data to and downloading data from Planning Customizing the Web interface
Document Structure
This document contains the following information: Chapter 1, Using Planning, introduces Planning and other Hyperion products that are used to enhance and extend Plannings functionality and performance. Chapter 2, Getting Started with Planning, describes how to start Hyperion System 9 BI+ Analytic Services server, start and navigate Planning, and register application servers for use with Planning. Chapter 3, Creating an Application, describes how to create an application in Planning using the Setup Application task on the Hyperion Planning Desktop and how to schedule a refresh of existing applications. Chapter 4, Setting Up Security, describes how to assign access rights to users and groups. Chapter 5, Setting Up Alias Tables, describes how to set up and maintain multiple alias tables within a Planning application. Chapter 6, Setting Up the Calendar and Currencies, describes how the calendar rolls up, which currencies are used in an application, and how currencies are converted. Chapter 7, Setting Up Custom Dimensions, describes how to work with the Entity dimension, the Account dimension, user-defined custom dimensions, and the members, attributes, and attribute values within each of the dimensions. Chapter 8, Setting Up Scenarios and Versions, describes how to create scenarios to group the application into separate plans with their own review cycles. This chapter also describes how to create versions, which allow for many iterations of a plan. Chapter 9, Loading Members and Data, describes how to populate Planning applications with members and data from external systems. Chapter 10, Managing Shared Services Models, describes how to use Hyperion System 9 Shared Services to share metadata and data between Hyperion applications. Chapter 11, Using Data Forms, describes how to create, modify, and manage data forms and the folders in which they are stored. Chapter 12, Managing the Budgeting Process, describes the concept of a planning unit and its life cycle through the review process. It also describes how to set up and manage task lists, and copy data with supporting detail. Chapter 13, Working With Applications, describes how to set individual preferences and global settings for various aspects of the application, copy Planning data, and delete certain application information using SQL. Chapter 14, Menus, Smart Lists, UDAs, and Formulas, describes how to create and use menus, Smart Lists, UDAs, and member formulas.
xvi
Preface
Chapter 15, Customizing Planning Web Client, describes how to customize different aspects of the Planning Web interface. Chapter 16, Troubleshooting, describes common errors when using Planning and potential resolutions for those errors. Appendix A, Customizing Data Forms with JavaScript, describes how programmers can use JavaScript to customize Web data forms. Appendix B, Naming Restrictions for Analytic Services, describes the rules for naming applications, databases, dimensions, members, and aliases in Analytic Services. Appendix C, Common Member Attributes, lists the common member attributes used in Shared Services and the equivalent member attributes in the Hyperion product. Appendix D, Reference Application for Planning, provides an overview and set up instructions for the Reference Application for Planning. The Glossary defines terms related to Planning. The Index contains a list of Hyperion Planning terms and their page references.
The HTML Information Map is available from the Help menu for all operating systems; for products installed on Microsoft Windows systems, it is also available from the Start menu.
For Planning Desktop, start the product, and then select Start > Programs > Hyperion System 9 > Planning > Planning Information Map. For Planning Web, start the product, and select Help > Information Map.
Online help is available from within Planning. After you log on to the product, you can access online help by clicking the Help button or selecting Help from the menu bar. The Hyperion Download Center can be accessed from the Hyperion Solutions Web site.
2 In the Login ID and Password text boxes, enter your e-mail address and password. 3 In the Language list box, select the appropriate language and click Login. 4 If you are a member on multiple Hyperion Solutions Download Center accounts, select the account that you
want to use for the current session.
xvii
5 To access documentation online, from the Product List, select the appropriate product and follow the
on-screen instructions.
Help Menu Commands Description Launches a help topic specific to the window or Web page Launches the Planning Contents page Launches the Planning Information Map, which provides the following assistance:
Online help in PDF and HTML format Links to related resources to assist you in using Planning
Launches the Hyperion Technical Support site, where you submit defects and contact Technical Support. Launches the Hyperion Developer Network site, where you access information about known defects and best practices. This site also provides tools and information to assist you in getting starting using Hyperion products:
Sample models A resource library containing FAQs, tips, and technical white papers Demos and Webcasts demonstrating how Hyperion products are used
Hyperion Home
Launches Hyperions corporate Web site, where you access a variety of information about Hyperion:
Sample models A resource library containing FAQs, tips, and technical white papers Demos and Webcasts demonstrating how Hyperion products are used
Launches the About Hyperion System 9 Planning dialog box, which contains copyright and release information, along with version details
Conventions
The following table shows the conventions that are used in this document:
Table ii
Conventions Used in This Document Meaning Arrows indicate the beginning of procedures consisting of sequential steps or one-step procedures. In examples, brackets indicate that the enclosed elements are optional.
Item
Brackets [ ]
xviii
Preface
Table ii
Conventions Used in This Document (Continued) Meaning Bold in procedural steps highlights user interface elements on which the user must perform actions. Capital letters denote commands and various IDs. (Example: CLEARBLOCK command) Keystroke combinations shown with the plus sign (+) indicate that you should press the first key and hold it while you press the next key. Do not type the plus sign. For consecutive keystroke combinations, a comma indicates that you press the combinations consecutively. Courier font indicates that the example text is code or syntax. Courier italic text indicates a variable field in command syntax. Substitute a value in place of the variable shown in Courier italics. When you see the environment variable ARBORPATH in italics, substitute the value of ARBORPATH from your site. Italic n stands for a variable number; italic x can stand for a variable number or a letter. These variables are sometimes found in formulas. Ellipsis points indicate that text has been omitted from an example. This document provides examples and procedures using a right-handed mouse. If you use a left-handed mouse, adjust the procedures accordingly. Options in menus are shown in the following format. Substitute the appropriate option names in the placeholders, as indicated. Menu name > Menu command > Extended menu command For example: 1. Select File > Desktop > Accounts.
Ctrl+Q, Shift+Q
ARBORPATH
Additional Support
In addition to providing documentation and online help, Hyperion offers the following product information and support.
For details on education, consulting, or support options, click the Services link at the Hyperion Solutions Web site.
Additional Support
xix
Education Services
Hyperion offers instructor-led training, custom training, and e-Learning covering all Hyperion applications and technologies. Training is geared to administrators, end users, and information systems professionals.
Consulting Services
Experienced Hyperion consultants and partners implement software solutions tailored to clients particular reporting, analysis, modeling, and planning requirements. Hyperion also offers specialized consulting packages, technical assessments, and integration solutions.
Technical Support
Hyperion provides enhanced telephone and electronic-based support to clients to resolve product issues quickly and accurately. This support is available for all Hyperion products at no additional cost to clients with current maintenance agreements.
Documentation Feedback
Hyperion strives to provide complete and accurate documentation. Your opinion on the documentation is of value, so please send your comments by going to
http://www.hyperion.com/services/support_programs/doc_survey/index.cfm.
xx
Preface
Chapter
Using Planning
1
This topic introduces Planning and other Hyperion products that are used to enhance and extend Plannings functionality and performance.
In This Chapter About Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Planning Web Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Smart View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Additional Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 User Licensing for Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Planning Usage Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Using Planning
21
About Planning
Planning is a Web-based budgeting and planning solution that drives collaborative, eventbased operational planning processes throughout the organization for a wide range of financial and operational needs. Planning is a comprehensive approach for the complete and closedloop planning process that drives continuous business improvement. With Planning, all decision makers and front-line managers can communicate which course of action to take and get budget holders to collaborate so that the planning process is optimized and efficient. When a material event occurs that causes a change in direction, planners have the flexibility to adapt rapidly, ensuring that plans are relevant and useful. More specifically, Planning:
Facilitates collaboration, communication, and control across multi-divisional global enterprises Provides a framework for perpetual planning, with attention to managing volatility and frequent planning cycles Provides ease of use and deployment through the Web or Smart View Lowers the total cost of ownership through a shorter roll out and implementation phase, and easier maintenance for existing applications Enhances decision-making with reporting, analysis, and planning Promotes modeling by including complex business rules and allocations Integrates with other systems to load data (through Hyperion Application Link)
Smart View
Smart View provides a common Microsoft Office interface for Analytic Services, Hyperion System 9 Financial Management, Planning, Hyperion System 9 BI+ Interactive Reporting, Hyperion System 9 BI+ Production Reporting, Hyperion System 9 BI+ Financial Reporting, and Hyperion System 9 BI+ Web Analysis. Tasks that previously were repeated across products are now performed only once. The single interface also enables users to leverage multiple products simultaneously. Smart View replaces the Spreadsheet Add-in versions earlier than Hyperion Financial Management Release 4.0 and Hyperion Planning Release 4.0. Smart View replaces all versions of Essbase Spreadsheet Services Release 7.1.3 and earlier. Essbase Spreadsheet Add-in for Analytic Services continues to be supported with this release. Smart View provides tighter Microsoft Office integration by offering the following BI+ content features:
Import content into Excel, Word, PowerPoint, and Outlook Expose functions for Financial Management and Analytic Services content in Word, PowerPoint, and Outlook
22
Using Planning
Using menu-driven options in Microsoft Office, you can import data and images from Hyperion products into Microsoft Office. Smart View enables you to take advantage of Microsoft Office features, such as smart tags, to add functions and import reports. The end user must log in to the data source within Microsoft Office, enabling easy distribution and sharing of the Microsoft Office document. However, if you log in to a data source connection in Microsoft Word, then you must log in again to access data in Excel or PowerPoint. To view imported data within Microsoft Office, each user in an organization must install Smart View. The following topics provide more information about Smart View:
Benefit to Users on page 23 Ad Hoc Analysis on page 24 Data Forms on page 25 Functions on page 25 BI+ Content Import on page 26 Smart Tags on page 26
For more information on using Smart View, see the Hyperion System 9 Smart View for Office Users Guide or Online Help that is installed with Smart View.
Benefit to Users
Smart View provides the following benefits:
A common Microsoft Office interface for Analytic Services, Financial Management, Planning, Financial Reporting, Interactive Reporting, Production Reporting, and Web Analysis New and improved features compared with the former Financial Management and Planning Add-ins and Essbase Spreadsheet Services Ability to import content from Financial Reporting, Interactive Reporting, Production Reporting, and Web Analysis Ability to use smart tags to import BI+ content and functions Auto deployment to notify end users when a newer version of Smart View is available.
Note: Auto deployment is installed with Release 9.0, but is only activated to upgrade client machines with releases after 9.0.
Smart View
23
Key Features
Smart View includes the key features described in the following topics:
Ad Hoc Analysis on page 24 Data Forms on page 25 Functions on page 25 BI+ Content Import on page 26 Smart Tags on page 26
Ad Hoc Analysis
Smart View provides the following Ad Hoc features:
Double-click to invoke the Ad Hoc analysis grid Display Point of View member selector Drag and drop members from the POV to the grid Set the default POV by the user Support duplicate member names Zoom in and zoom out capabilities on dimension members and hybrid members Drill-through Pivot dimension members to columns or rows Display cell text Submit data Keep only or remove only certain data cells Adjust data values in cells Calculate and consolidate data Support asymmetric grids and free form mode Save formatting Preserve formulas Undo and redo last actions Select members, including Dynamic Time Series members Suppress rows Indent columns Navigate without data Zoom in levels Specify member retention Enable or disable double-clicking
24
Using Planning
Enable or disable undo feature Specify labels for missing and no access data cells Specify member display options Specify data display options Display messages Apply cell styles VBA functions, which support customization and automation of Smart View commands using Visual Basic for Application functions
Data Forms
Smart View provides the following data forms features:
View instructions Adjust data Manipulate existing data by performing unary operations Lock and spread back values to base periods (Planning only) Enter supporting detail (Planning only) Enter cell text Work offline Synchronize with Financial Management, Planning, and Hyperion System 9 Workforce Planning applications Launch Business Rules (Planning only) View Business Rules with runtime prompts (Planning only) Preserve formulas Apply cell styles Select Smart List options
Functions
Smart View provides the following function features:
Use Function Builder, an interface that guides the end user when creating functions Support the following functions:
HsGetValue HsSetValue
Smart View
25
HsDescription HsGetText (not supported in Analytic Services) HsSetText (not supported in Analytic Services) HsCurrency (not supported in Analytic Services) HsLabel (not supported in Analytic Services)
Refresh the active worksheet or the entire workbook Migrate existing Financial Management spreadsheet add-in functions to the new syntax
Query the Hyperion product repositories to import BI+ content as an image in Microsoft Excel, Word, and PowerPoint Refresh previously inserted images and data Export formatted images for Word and PowerPoint (Office 2002 and 2003 only) Export formatted grids for Excel
Note: Importing charts from Production Reporting is not supported in this release.
Smart Tags
Smart tags are predefined properties that associate available actions with a keyword. For example, if the end user types smartview in an Excel cell, the smart tag icon is displayed next to Smart View. Smart View provides the following smart tag features with Office 2003:
Display functions:
HsGetValue HsGetText (not supported in Analytic Services) HsCurrency (not supported in Analytic Services) HsDescription
Import BI+ content into Microsoft Office 2003 (Excel, Word, PowerPoint, and Outlook, if Word is the e-mail editor) Refresh previously inserted BI+ content.
26
Using Planning
Additional Products
To extend the power and flexibility of Planning, you can use it with additional products.
Analytic Services
Planning leverages Hyperion System 9 BI+ Analytic Services analytic and calculation capabilities, security filters, APIs, pre-built financial intelligence, calculation functions and multi-database application support. Planning capitalizes on OLAP and data warehouse technologies by embedding powerful analysis, enhanced scalability, and data management functionality into a purpose-built planning application. Planning stores the application definition in a relational database and then uses this information to create the necessary Analytic Services databases and security privileges for your application.
Additional Products
27
Planning users can use Financial Reporting to manage reporting tasks and carry out all aspects of plan review and analysis. Users can easily create reports featuring text, grids of data, charts, graphs, and images. Financial Reporting makes it easy to carry out real-time, ad hoc variance reporting and quickly produce a variety of sophisticated financial reports, which can be viewed online or printed with production-quality formatting.
Macros simplify the creation of business rules and sequences, and save business rule designers time by enabling them to reuse pieces of business rules in other business rules or macros. Variables of the saved selection type can be used not only at runtime, but also during design time to make business rules easier to design. The logical organization of business rules, sequences, macros, and variables into projects makes them easier for you to maintain. Enhanced calculation scripts that contain runtime prompts ensure valid inputs from, and provide guidelines for, budget preparers. In Business Rules, predefined and reusable formulas that define unique cost and revenue calculations save business rule designers time during the design process.
28
Using Planning
Relational database such as Oracle, IBM DB2, or Microsoft SQL Server Web application servers (such as WebLogic and WebSphere)
Deployment on page 29 Setting Up the Application on page 30 Building a Plan on page 36 Launching Business Rules on page 38 Starting the Budget Review Process on page 38 Post-Planning Activities on page 40
Deployment
The IT professional at the customer site is responsible for the installation and configuration of Planning on both the server computers and the client workstations. The IT professional should have experience administering relational databases, installing client/server and Web server software, and configuring authentication security. The following table lists the installation and configuration tasks that need to be performed on the server computers.
Table 3
Server Installation Users and Tasks Task Installs all Planning system requirements, including operating systems, relational database, Web server, application server, and Web browser Installs Analytic Services Sets up the data source name (DSN) for the OLAP and relational databases Installs Planning, as well as Financial Reporting, Hyperion Application Link, and Business Rules (available by installing Hyperion System 9 BI+ Analytic Administration Services) Creates necessary relational databases and connections Configures the Web server Sets up users in an external authentication provider
29
Table 3
Server Installation Users and Tasks (Continued) Task Optional: Creates a test application and adds users Tests the installation and configuration
The following table lists the installation and configuration tasks that need to be performed on the client computers.
Table 4
Client Installation Users and Tasks Task Installs the Planning remote Windows client, Smart View, Microsoft Excel 2000, Business Rules (available by installing Analytic Administration Services), Financial Reporting, and Hyperion Application Link Installs a Web browser Tests the connection from both the Web and the network
IT professional IT professional
Creating Metadata on page 31 Setting Up Users and Security on page 32 Creating and Refreshing the Application on page 32 Designing Data Forms on page 33 Designing Worksheets on page 33 Populating the Application with Data on page 34 Creating Business Rules on page 34 Setting Targets on page 35 Reporting on page 36 Initializing the Planning Cycle on page 36
The following topics provide more detail on each aspect of setting up the application.
30
Using Planning
Creating Metadata
Hyperion consulting partners and the Planning administrator work together to design an application. Once a design is agreed upon, an application framework is created using the Setup Application task on the Planning Desktop. The person who creates the application is by default the application owner. There is only one application owner per application. However, the owner may grant ownership to another administrator. The application framework includes:
Application name Number of plan types and the names of the plan types Calendar structure Whether or not the application is a multi-currency application Default currency
After the application framework is created, dimensions and members are added to the application and assigned to the appropriate plan type. There are up to eight required dimensions in an application:
Currency (for multi-currency applications) HSP_RATES (for multi-currency applications) Account Entity Scenario Version Period Year
Some examples of additional custom dimensions include Products, Customers, Employees, Sales Channels, and Projects. Dimensions can be added manually through the Planning Web. However, the metadata typically exists in another external system, such as a general ledger, and can be transformed and uploaded into Planning using Hyperion Application Link and the Planning Adapter. The administrator is involved in creating the metadata for Planning applications.
Table 5
Creating Metadata - Users and Tasks Task Designs and creates an application in Planning Defines metadata (currencies, scenarios, versions, calendar) Enters exchange rates Defines attributes and attribute values Loads custom dimensions using Hyperion Application Link
31
Scenarios Versions Accounts Entities Custom dimensions Web data forms Business rules Task lists
Setting Up Users and Security - Users and Tasks Task Sets up all Planning users with a supported external authentication provider Synchronizes externally-authenticated users with a Planning application Assigns users and groups to secured objects
Table 6
An Analytic Services application Multiple Analytic Services databases (one per plan type) Analytic Services security filters Analytic Services outlines (all metadata)
Members Shared members User-defined attributes and attribute values Exchange rates
32
Using Planning
Table 7
Generating the Database - Users and Tasks Task Creates and refreshes the Planning application based on the metadata that is stored in the applications relational database
Naming and describing the data form Determining the layout of the data form (for example, which dimensions are assigned to which axis: columns, rows, POV, and page) Setting the precision of the displayed values Determining other data form properties, including annotations on accounts, displaying missing data as blank cells, suppressing missing data, and showing the data form fully expanded Selecting which members are assigned to the data form Selecting members by their attributes Creating asymmetrical columns or rows Associating business rules to a specific data form Creating data form instructions Setting up the display or printing properties Assigning data form access to Planning users and groups
Designing Data Forms - Users and Tasks Task Creates and maintains data forms in Planning Creates and manages folders in Planning for data form management Assigns access rights to data forms
Table 8
User Type Administrator and interactive user Administrator and interactive user Administrator and interactive user
Designing Worksheets
Any Planning user can install Smart View to work with data forms in Excel. These forms enable users to leverage their existing Excel worksheet models, build custom formulas, and report formats in a spreadsheet environment, or to work in a disconnected mode from Planning. For more information about Smart View, see Smart View on page 22.
33
Populating the Application with Data - Users and Tasks Task Performs bulk loads of actuals data, previous forecasts, and so forth, directly into Planning databases using Hyperion Application Link with the Essbase Adapter or Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2. Enters values for global saved planning assumptions that are referenced in business rules Enters data directly into the Planning application through a Web-based data form or Smart View Calculates and creates data using business rules or by using the Web-based copy version or copy data capabilities
Business rules can be designed with runtime prompts and can also be set up to run as a sequence. Business rules that reside in the Business Rules repository can be launched from Planning Web and from Smart View.
34
Using Planning
Table 10
Creating Business Rules - Users and Tasks Task Assigns users access to business rules Creates models using Business Rules
User Administrator Administrator and interactive user Administrator, interactive user, and planner who have been assigned access by the Administrator
Launches certain business rules to further populate the Planning application (for example, Budget2 = Actual x 15%)
For information on creating and using business rules, see the Hyperion System 9 Business Rules Administrators Guide and the Hyperion System 9 Business Rules Web Launcher Users Guide. For more information on using business rules with Planning, see Using Business Rules on page 267.
Setting Targets
Administrators need to set up target type versions for the Planning application. A users access to target data is determined by their access assignments. Typically, target data is stored in the upper levels of metadata, such as Business Unit, Product Family, or regional levels. The administrator needs to configure the Analytic Services database so that the target data is not replaced by lower-level #Missing values. Target data is typically used as guidance for data entry and analysis. Target data can be created by any type of user through various methods:
Manual data entry Hyperion Application Link with the Essbase Adapter Modeling with Business Rules Pushing targets down to lower-level members using business rules.
Setting the Target - Users and Tasks Task Adds a standard target-type version Assigns users access to the target version (typically, read-only access) Configures the Analytic Services database so that target data is not replaced by lower-level #Missing values Creates target data Publishes targets using Financial Reporting Displays targets on data forms for guidance or input
Table 11
User Type Administrator Administrator Administrator Any user Administrator Any user
35
Reporting
Financial Reporting allows you to create reports that can be used on a Windows client or a Web-enabled client. Web-enabled reports are available to all Planning users who are using the Web Viewer. Financial Reporting works directly against the Analytic Services databases and adheres to the Analytic Services security filters that are generated by Planning.
Table 12
Reporting - Users and Tasks Task Creates and launches management reports using Financial Reporting Prints reports to verify the bulk data loads and calculations Views reports through the Financial Reporting Web Viewer throughout the planning cycle
User Type Administrator and interactive user Any user Any user
Initializing the Planning Cycle - Users and Tasks Task Selects which planning units are available for the iterative review, analysis, and approval process Any user can indicate as a user preference whether or not they want to receive an e-mail when they become an owner of a planning unit
Building a Plan
Administrators can set up task lists, which guide users through the planning process by listing tasks that need to be completed, along with instructions and due dates. Planning users start the planning cycle by logging into an application and opening the Web data forms to which they have access. Users read any data form instructions and review any historical or target data for guidance when preparing the plan. Users can enter data directly into the data form using a variety of techniques, including:
Entering data into summary time periods and spreading data values back to base time periods Adjusting existing data values by a percentage value Copying data from one grid area to another area Copying data from one dimensional intersection to another dimensional intersection
36
Using Planning
Copying data from one version to another version Using the supporting detail feature, which serves as a built-in calculator for developing data that is not in the member outline
Users can also collapse or expand subtotals and scroll horizontally or vertically and maintain their point of reference. Users can enter annotations to document assumptions at the planning unit level or on accounts. Certain Web data forms, based on the data form design, provide for shorter text annotations. For example, these may be used to describe variances to targets or actuals. Once data has been entered, users can save the data. Users can also select to restore the data they have entered to the last saved version of the data. In this case, all data that has been entered since the last save was performed is lost. Users may also save a personal version of the data by using the copy version feature before promoting the data for review and potential modifications. When data is saved, the following events occur:
The data is saved to the Analytic Services database. The subtotals on the data form are calculated and stored if the Calculate Data Form business rule is selected to run on save when the data form is created. By default, the Calculate Data Form business rule is not selected to run on save. Business rules are run that are set up to calculate automatically when users select to save.
The currently stored data values can be refreshed in the data form prior to saving the data. Users can also click the Launch Business Rules button to display all the associated business rules that can be launched from the data form either before, or after the data is saved.
Table 14
Building a Plan - Users and Tasks Task Accesses a task list that provides guidance to expected actions Accesses Web-based data forms Reads data form-level instructions for planning guidelines, and reviews any historical or target data for guidance when preparing a plan Enters data Adjusts data values Enters annotations (for example, assumptions) for planning units Calculates business rules Prints reports and analyses using Smart View, Financial Reporting, Web Analysis, or third-party reporting tools Copies the version of data to another version within the same scenario Saves the data
User Type Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access
Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access
37
Launching Business Rules - Users and Tasks Task Launch business rules from Business Rules (available from the Analytic Administration Services Console) Launch business rules from Business Rules (available from the Analytic Administration Services Console)
User Administrator who has granted himself launch privileges, for each Planning application Interactive user who has been granted launch privileges for each Planning application by the Business Rules Admin Any user (administrator, interactive user or planner) with launch privileges
Assigns ownership to the selected user Overrides the security on the planning unit to read-only for non-owners Changes the planning units process status from First Pass to Under Review Updates the status of the upper-level (or lower-level) planning units to under review as necessary Records an audit entry in the process history Optionally sends an e-mail notification to the new owner of the planning unit Optionally sends a copy of the e-mail to the application owner
During the review phase, the reviewer can make additional modifications or annotations. Read-only users can continue to enter planning unit annotations and short account annotations, but cannot enter data values. When the user keeps a personal copy of the original data, it is easier to track the data that has been modified. When a planning unit is promoted, the reviewer is the new owner and typically does the following:
38
Using Planning
Receives and opens e-mail notification and is directed to the Process Definition Web page in the Planning application Sorts the status page by entity, current process state, or current owner Reviews annotations and planning unit history Opens the data form and reviews, analyzes, modifies, and calculates data Makes additional annotations (including short account annotations) Promotes or rejects the planning unit; the system supports iterations until the planning unit is approved
Once a planning unit is approved, the application owner becomes the planning unit owner. An administrator is the only user who can reject a planning unit. To close the review cycle, the application owner or administrator changes either the scenario or version to read-only for all users so that no other data can be entered.
Table 16
Starting the Budget Review Process - Users and Tasks Task Starts the planning unit for the planning cycle Enters data Calculates data Optionally, creates a copy of their submission Promotes data for review Enters additional annotations to support the review process
Note: Until an owner is established for a planning unit, multiple users with security access can update the same planning unit. The system changes data access rights of the non-owners to read-only when the planning unit is promoted to the next reviewer.
User Administrator Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access
Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access Any user with appropriate security access
Notifies the reviewer that the planning unit is ready for review Reviews data values of the promoted planning unit Reads and modifies promoted data through a Web-based data form Saves and runs the business rules Reads promoted data using Financial Reporting, Web Analysis, Smart View, or third-party reporting tools
39
Table 16
Starting the Budget Review Process - Users and Tasks (Continued) Task Takes one or more of the following actions:
Modifies data values Enters additional annotations Signs off on a planning unit, without changing ownership Promotes the planning unit Rejects the planning unit Approves the planning unit
Checks the status of the planning process, by the planning unit Reads supporting annotations Views the process history (audit trail) Completes the planning cycle Changes user access of scenarios and versions in Analytic Services to read-only Publishes reports using Financial Reporting
Post-Planning Activities
The administrator and the interactive user are involved during the post-planning phase.
Table 17
Post-Planning Activities - Users and Tasks Task Uploads planning data by scenario to other applications, such as Financial Management, a general ledger, or an ERP. Copies a version of the newly-completed plan to a new version or copies data from one dimensional intersection to another dimensional intersection.
User Type Administrator and interactive user All users with appropriate security access Administrator and interactive user All users with appropriate security access
Performs a bulk load of the new actual data into a Planning application to report on actual performance versus plan (for example, actual results versus budget). Accesses a Web-based data form, Financial Reporting, Smart View, Hyperion System 9 Performance Scorecard or third-party reporting tools to read updates to actuals and analysis of performance to plan.
40
Using Planning
Chapter
2
This section describes how to start Analytic Services server, start and navigate Planning, and register application servers for use with Planning.
In This Chapter Starting Analytic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Connecting to Multiple Instances of Analytic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Starting the Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Starting Planning on the Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Using the Toolbar, Status Bar, and Navigation Frame. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Starting Planning on the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Logging On without Browser Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Using Application Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Closing Planning and Analytic Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
41
Note: You can install more than one instance of the Analytic Server on the same computer. For information about how to install and configure an additional instance of the Analytic Server, see Running Analytic Servers, Applications, and Databases in the Hyperion System 9 BI+ Analytic Services Database Administrators Guide.
42
Optimizing an SQL Relational Database on page 43 Creating the Properties File on page 43 Configuring JDBC Connection Pooling on page 46
If the Timeout registry key exists in the right pane, then the timeout value is set to a corresponding value. If the Timeout registry key does not exist, the value is set to the default.
Note: Its type must be DWORD.
Select Start > Hyperion System 9 Shared Services > Configuration Utility. Double-click the configtool.bat file from the following location:
C:\HYPERION_HOME\common\config\9.0.0
The Hyperion welcome screen for the Hyperion Configuration Utility is displayed.
2 Click Next.
The Hyperion products installed on your computer are displayed.
3 Select Planning from the list of Hyperion products to configure, and click Next.
43
4 Select Create the Planning Properties File from the list of configuration tasks to perform, and click Next. 5 Deselect the Regenerate Planning properties file checkbox. 6 Make changes, if necessary, to the displayed destination path for the properties file. 7 Make changes, if necessary to the displayed Shared Services information (Server Name, Port Number,
User Name and Password). This information is used to store the Planning properties file in Shared Services.
8 If you are using Hyperion System 9 Business Rules (HBR), perform the following tasks:
a. Select the Enable HBR check box. b. Make any necessary changes to the default information for your Hyperion System 9 BI+ Analytic Administration Services (AAS) server name, port number, user name and password. c. Make any necessary changes to the default RMI port number. If you make a change, you have to manually update the RMIRegistry.
9 If you are using Oracle as your RDBMS, enter the name of the Oracle Server name used for Planning and
the Oracle Database Name.
10 Click Next.
The Planning properties file (HspJSHome.properties) is generated and uploaded to the Shared Services server. When the Planning properties file generation process is complete, the Configuration Utility prompts: Do you want to go back to the Product Selection Panel?
Select Yes to return to the product selection screen to perform configuration tasks for other products. Select No to proceed to the configuration status screen, then click Finish to exit.
The HspJSHome.properties file is generated and uploaded to the Shared Services server. For information on the default location of the properties file, see Default Location of the Properties File on page 45.
44
You can customize the properties file (for example, to view generated calculations or to add fonts). If you customize the properties file after creating it, your changes are preserved even if you regenerate the file using the Configuration Utility.
Default Location of the HspJSHome.properties File Default Path <drive letter>:\Hyperion\HyperionPlanning\AppServer\ InstalledApps\Tomcat\5.0.28\Webapps\HyperionPlanning\ Web-Inf\classes <drive letter>:\Hyperion\HyperionPlanning\AppServer\ InstalledApps\Weblogic\<version>\<domain name>\applications <drive letter>:\WebSphere\AppServer\installedApps\ <server name>\HyperionPlanning.ear\HyperionPlanning.war
BEA WebLogic
IBM WebSphere
2 Modify the following two lines in the properties file to reflect the updated JDBC driver, using the values in
the following table:
<application name>_JDBC_DRIVER= <application name>_JDBC_URL=
Table 19
Values for JDBC Lines in the Properties File JDBC_Driver Value oracle.jdbc.driver.OracleDriver COM.ibm.db2.jdbc.app.DB2Driver COM.ibm.db2.jdbc.net.DB2Driver JDBC_URL Value jdbc:oracle:thin:@%SERVER_NAME%: 1521:%DB_NAME% jdbc:db2:%DB_NAME% jdbc:db2://myhost.mydomain.com:6 789/%DB_NAME"
JDBC Driver Type Oracle Thin DB2 native DB2 native for remote DB2 server
45
3 Save the modified properties file. 4 Locate the necessary .jar file (for Oracle) or .zip file (for DB2):
If you are using Oracle, find the following file: classes12.jar. It is located in the OraHome\jdbc\lib directory. If you are using DB2, find the following file: db2java.jar or db2java.zip file. It is located in the \Program Files\sqllib\java directory.
5 Copy the .jar or .zip file in Step 4 to the appropriate destination directory, which depends on the Web
application server you are using:
Table 20
Destination Directory for Each Web Application Server Destination Directory <drive letter>:\Hyperion\HyperionPlanning\AppServer\ InstalledApps\Tomcat\5.0.28\Webapps\HyperionPlanning\ Web-Inf\classes Take the following steps:
BEA WebLogic
Extract the .ear file. Copy the .jar or .zip file in Step 4 to the HPDomain\applications directory. Add the file to the CLASSPATH in startHPServer.cmd
IBM WebSphere
46
JDBC_MIN_CONNECTIONS=2 JDBC_MAX_CONNECTIONS=10
To start the Planning Desktop from the Start menu: from the Microsoft Windows Desktop,
select Start > Programs > Hyperion System 9 > Planning > Planning.
The top-level nodes contain category nodes. Planning is an example of a top-level node. The category nodes contain groupings of task nodes. Manage Dimensions is an example of a category node in the Planning navigation frame. The task nodes appear underneath category nodes. Task nodes can be Hyperion applications, external applications, or external documents. Calendar is an example of a task node.
47
Figure 1
Select View > Navigation Frame > Show/Hide, or click the Navigation Frame toolbar button to show or hide the navigation frame. Select View > Toolbar to show or hide the toolbar. Select View > Status Bar to show or hide the status bar.
To expand or collapse all tasks in the Desktop navigation frame, do one of the following:
Select View > Navigation Frame > Expand All, or click the Expand All toolbar button to expand all tasks on the navigation frame. Select View > Navigation Frame > Collapse All, or click the Collapse All toolbar button to collapse all tasks on the navigation frame.
To expand or collapse some of the tasks on the desktop navigation frame, select one of the
category nodes and do one of the following:
Select View > Navigation Frame > Expand Selected to expand the selected category node. Select View > Navigation Frame > Collapse Selected to collapse the selected category node.
48
To launch Planning on the Web, make sure the Web server is started and the Web application server is running. To do this, select Start > Control Panel > Services. As an alternative for logging on to Planning on the Web, you can enter or select the following URL address if Web users are not using Microsoft Windows, where <server's IP address> is the IP address of the computer hosting the Planning application server. The URL is case-sensitive.
//<server's IP address>/HyperionPlanning/LogOn.jsp
Note: You must set up a Properties file for Java components for each Planning application to make it available to the Web. The Properties file must be regenerated whenever you upgrade applications from an earlier release of Planning or delete existing applications. For existing Planning applications, this is done automatically when the upgrade utility is used to migrate to the latest release. However, for each Planning application deleted, you must recreate the Properties file. See Creating the Properties File on page 43.
Note: Planning support users on a variety of network bandwidths, including users that access their networks through 56K dialup connections. The performance on a 56K dialup connection can be enhanced by using HTTP compression on the Planning server. See Slow Performance When Opening Large Data Forms on page 363.
For Application, select a Planning application to use. For User Name, enter your system user ID. For Password, enter your system password.
49
Registering a Server
To register a server:
1 From the left navigation frame on the Hyperion Desktop, double-click Planning > Open Application. 2 In the Server drop-down list, type the name of the server that you want to register.
Note: A server must exist in the Windows NT domain before it can be registered.
Unregistering a Server
To unregister a server:
1 From the left navigation frame on the Hyperion Desktop, double-click Planning > Open Application. 2 From the Server drop-down list, select the server that you want to unregister. 3 Click the Unregister Server button.
This unregisters the server and removes the server name from the drop-down list.
To close Planning from the Desktop, select File > Exit. To close Analytic Services Server:
1 Maximize the Analytic Services window. 2 Type Quit.
50
To log off from a Planning Web page, select File > Log Off. You are returned to the Log On
page. You can log on again or log on to another application.
To close Planning on the Web, select File > Exit. You are returned to your desktop.
51
52
Chapter
Creating an Application
3
This section describes how to create an application in Planning using the Setup Application assistant and how to schedule a refresh of existing applications.
In This Chapter Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Creating Applications with the Setup Application Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Creating Additional Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Using Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Using Broadcast Messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Viewing Usage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Creating Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Optimizing Application Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Backing Up Applications and Application Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Creating an Application
53
Prerequisites
Before you create an application, complete the following tasks:
Create a relational database. Create and configure a Microsoft Data Link (.UDL). Create a data source name (DSN). Set System Properties for the Microsoft Data Link. Set the System Folder in Hyperion Server to a valid system folder.
For detailed instructions on performing these tasks, see the Hyperion System 9 Planning Installation Guide.
Overview
An application is a related set of dimensions and dimension members that you use to meet a specific set of planning needs. Each application has its own accounts, entities, scenarios, and other data elements. For example, you might want to create an application for your cost centers for budgeting operating expenses. You might create a separate application that the finance department uses for revenue planning. Creating an application involves several steps and uses most of the Planning modules. The following is a list of the steps involved in creating an application:
Create an application with the Setup Application task. Create entities to reflect your organizations budget structure. Create the accounts and additional dimensions required to gather planning data. Create scenarios and versions. Create appropriate data forms to meet the needs of various users and groups. Assign access rights to users and user groups. Set up the currencies and corresponding exchange rates for currency conversions. Modify the calendar with the custom summary time periods your organization needs. Use Business Rules to build customized business rules. Use Hyperion Application Link to load data and copy versions from other sources. Identify the review and approval process, its requirements, and its participants. Create management reports. For more information about creating management reports, see the Hyperion System 9 BI+ Financial Reporting Studio Users Guide.
This chapter covers only the first task. The remaining tasks for creating an application in Planning are covered in subsequent chapters.
54
Creating an Application
Using the Select workspace Frame (see Using the Select Workspace Frame on page 55) Creating the calendar (see Creating the Calendar on page 56) Defining the base time period and weekly distribution (see Defining the Base Time Period and Monthly Distribution Spread on page 56) Defining the calendar range (see Defining the Calendar Range on page 57) Setting up currencies (see Setting Up Currencies on page 58) Setting up plan types (see Setting Up Plan Types on page 58) Saving the application (see Saving the Application on page 59)
2 From the Server drop-down list, select the server for the application.
Note: The server must first be registered for it to display in the Server drop-down list. If the desired server is not listed in the Server drop-down list, you may need to register the server by clicking the Ellipsis button. For more information about registering a server, see Registering a Server on page 50.
55
4 In the Data Source text box, highlight the data source you want to use for this application.
Note: A data source must be set up in advance for each new application. Data sources cannot be shared among applications or relational databases.
Note: Hyperion highly recommends that you not name an application Planning. Doing so may cause issues when you upgrade to a future release.
6 In the Description text box, enter a description for the application. 7 Click Next.
56
Creating an Application
If you select a weekly distribution pattern other than Even Distribution, Planning treats quarterly values as if they were divided into 13 weeks and distributes the weeks according to the pattern you selected. For example, if you select the 5-4-4 pattern, Planning treats the first month in a quarter as if it has five weeks, and the last two months in the quarter as if they have four weeks.
Note: The options for the weekly distribution pattern are available only if you select the base time period option 12 Months.
In the Prefix text box, enter a prefix for the custom base time period. For example, if you create a weekly base time period, you may want to enter WK- as the prefix. The week number will be added to the prefix automatically. In the Periods per Year text box, enter the number of periods per year in the custom base time period.
3 From the 445 Weekly Distribution area, select a weekly distribution pattern.
Note: The options in the Weekly Distribution area are available only if you have selected the 12 Months base time period.
2 From the Fiscal Start Month drop-down list, type the month or select the month in which the fiscal year
will start for the application.
57
3 In the Total Years text box, type the years or use the scroll arrows to select the total number of years you
want the application to contain.
4 Click Next.
Setting Up Currencies
The Currency workspace frame allows you to specify the default currency for the entities in the application and to establish if the application will support currency conversions. Multiple currency support (also known as currency over-rides) is available for level 0 members, regardless of their base currency. For more information about currencies and currency conversions, see Working with Multiple Currencies on page 109.
To set up currencies:
1 From the Default Application Currency drop-down list, select the default currency for the application. 2 Do one of the following:
Select Yes to indicate that the application will support more than one currency. Once specified, you cannot change this option. Select No to indicate that the application will not support more than one currency, and will only support the default currency you previously selected.
Note: If you specify that the application will support multiple currencies, two additional dimensions are created, Currency and HSP_RATES dimensions.
3 Click Next.
58
Creating an Application
accounts. This allows you to bring the data value for the Total Product Sales into your P&L plan, without all of the account detail. This makes the database for your P&L plan smaller and more efficient. You must set up at least one plan type, and you cannot change the number of plan types or the plan type names after the application has been created.
Note: If Analytic Services is installed on a UNIX server, the plan type name cannot contain the underscore character.
3 Optional: Repeat these steps for Plan Types 2 and 3. 4 Click Next.
To save an application:
1 Click Finish. 2 In the Password text box on the Login dialog box, enter your Windows NT password.
Note: When you generate or refresh the application using the Manage Database task, the Analytic Services dimensional outlines and alias tables are created and/or updated, and exchange rate values are repopulated into the Analytic Services outlines.
59
Create a relational database. Create a data source name (DSN). Create and configure a Microsoft Data Link (UDL). Create the application using the Setup Application task, described in Creating Applications with the Setup Application Task on page 55.
Using Applications
After you create an application, you can then open, delete, or close the application, as described in the following topics:
Opening Applications on page 61 Deleting Applications on page 61 Closing Applications on page 63 Unlocking Applications on page 63
60
Creating an Application
Opening Applications
You can open an application to work with its data or run reports. You can have multiple applications that reside on the same server open at the same time. However, this has the potential to slow performance, depending on the servers configuration, the processor speed of your computer, and the amount of memory available. For further assistance on determining server configuration, contact your Hyperion consultant.
To open an application:
1 From the navigation frame on the Planning Desktop, double-click Planning > Open Application. 2 From the Server drop-down list, select the server on which the application resides.
If the server on which the application resides is not displayed in the drop-down list, enter the name of the server in the Server text box.
4 From the Applications list box, select the application you want to open. 5 Click Open Application. 6 In the Password text box on the Logon dialog box, enter your Windows NT password. 7 Click Logon.
Note: When you are logged on, the server and application names are displayed in the Connected To text box on the Open Application dialog box.
Deleting Applications
Only the application owner can delete a Planning application. When the application owner deletes an application, the Analytic Services application is also deleted and the application is no longer available to any Planning user. Before deleting an application, the application owner must be sure that no other user is currently using the application. Hyperion recommends that you back up the applications system tables before you delete the application. Before deleting an application, you must also unregister it with Shared Services. (For more information on registering and unregistering an application with Shared Services, see Registering Applications on page 192).
Tip: The default application owner is the administrator that created the application. The
Using Applications
61
2 Select Start > Programs > Microsoft Server 7.0 > Enterprise Manager. 3 In SQL Server Enterprise Manager, expand the database name until the Databases folder is displayed. 4 Right-click the Databases folder and select All Tasks > Restore Database. 5 On the General tab, type Sysdat in the Restore as database text box.
You can use any name you want, but it should be one that indicates where the system tables are stored.
6 In the Restore area of the dialog box, select the Database option. 7 In the Parameters area of the dialog box, from the Show backups of database drop-down list, select the
SQL database from which you want to copy all the tables.
8 Click OK.
You should receive the message: Restore of Database <name of database> completed successfully.
9 Create a UDL that links to the Sysdat database. 10 Change the System Data Link file to the Sysdat UDL as described in the Hyperion System 9 Planning
Installation Guide.
To delete an application:
1 From the navigation frame on the Planning Desktop, double-click Planning > Open Application. 2 From the Server drop-down list, select the server on which the application resides.
Note: The server must first be registered for it to display in the Server drop-down list. If the desired server is not listed in the Server drop-down list, you may need to register the server by clicking the Ellipsis button. For more information about registering a server, see Registering a Server on page 50.
3 Click Connect to Server. 4 From the Application list box, select the application you want to delete.
Note: You must be logged on to the application for it to display in the Application list box.
5 Click Delete Application to delete the selected application from the server. 6 Click Yes to confirm the deletion. 7 In the Password text box on the Specify Administrator dialog box, enter your Windows NT password. 8 Click OK.
62
Creating an Application
Closing Applications
You can close a Planning application at any time.
To close an application:
1 Close all the open windows on the Planning Desktop (for example, the Exchange Rates task). 2 Click Close Application to close the selected application.
Unlocking Applications
Occasionally a Planning application can become locked. This can be caused by an event such as abnormally exiting the application and Planning. The Unlock Application utility lets you clear all records in the HSP_LOCK table, which unlocks the application if there has been an interruption to the Planning application. You must run the unlock application utility from the Planning application server. You can run it from the command line or you can invoke the executable directly. It is a good idea to make sure there are no users in the Planning Desktop before running the utility. You can confirm this by launching the task manager on the Planning server and making sure there are no processes called hsxser~1 (hsxserver) or hspds.
2 Double-click UnlockApp.exe. 3 Select the application to be unlocked, then click OK. 4 Check the application event logs using the Event Viewer in Administrative Tools to see whether a success or
failure event has been reported.
Alternatively, you can launch the utility from the command line by navigating to the Utils folder and entering the following command:
unlockapp.exe [<application name>]
where: <application name> is the name of the application you want to unlock.
63
you can schedule the broadcast message, using standard operating system mechanisms. Broadcast messaging is helpful if you need to send periodic messages about system availability or periodic maintenance, such as application back ups. For all users who are logged on to the application through the Windows client (for example, remote administrators and Smart View users), the broadcast message displays as a pop-up message box on their desktop. For all users who are logged on to the application through the Web client, the broadcast message displays in their browser the next time they refresh the page or go to a different page. This behavior applies whether you send the broadcast message through the Planning Desktop or the command line utility. Only users who are currently logged on to the application see the broadcast message. Users who are logged on to the application through Financial Reporting, Hyperion Application Link, Business Rules, Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2, Web Analysis, or any other third-party reporting tools do not receive broadcast messages. For information on:
Sending an announcement when scheduling an application refresh, see Scheduling Application Databases to be Refreshed on page 72. Forcing users off the system, see Limiting Use of an Application During Maintenance on page 317.
2 Click Message. 3 In the Broadcast Message dialog box, type the message you want to broadcast. 4 Click Send.
To send a broadcast message using the broadcast message command line utility:
1 Use the Microsoft Windows Scheduled Tasks tool (or another scheduler that accepts command line
prompts) to enter the Broadcast Message command line.
Note: The BroadcastMessage.exe is installed in the UTILS directory when you install Planning. BroadcastMessage.exe must be run on a server that is registered by the Planning application for which you want to send a broadcast message.
64
Creating an Application
2 The format and required arguments in the BroadcastMessage command line are:
broadcastmessage Server Name,Application Name,User Name, Password,Message
Where:
Server Name is assumed to be the localhost name. Application Name is the name of the application to whose logged-on users you want to
send a message.
User Name is the user who has rights to send a broadcast message. This is always an
administrator.
Password is the password for the user you previously specified. Message is the text message of up to 127 characters that you want to send to the users of the specified application.
3 View the results of the broadcast message, including any errors, in the Windows Event Viewer Application
Log.
The following is an example of a typical command line used to send a broadcast message to all logged on users of a specified application:
broadcastmessage ABCserver, ,testapp,Jsmith001,admin,Please log off the application immediately for routine maintenance.
65
Optimizing the Performance of Currency Conversion Calc Scripts on page 68 Refreshing Application Databases on page 69 Working With Analytic Services Partitions on page 72 Scheduling Application Databases to be Refreshed on page 72 Examples of Scheduling an Application Refresh on page 76
You can create Analytic Services databases for the application before completing the structure of the application. However, when the structure is complete, you need to refresh the Analytic Services databases. When you make changes to the application structure (for example, when you modify properties of an Entity member, add a scenario, or change access assignments), those changes are stored in Plannings relational database until you refresh the Analytic Services databases for the application. Planners using the Web client for data entry and workflow tasks do not see the changes you make to an application until you refresh the Analytic Services databases for the application. When you initially create the application databases, you can select to include all information. Otherwise, you must select the information to include in the following manner:
If you include security information, you must include database information. If you include currency conversion calc scripts, you must include database information.
After the initial creation of the databases, you can refresh the information separately. However, if you have made changes to the database, Hyperion recommends that you always select to refresh the database information in conjunction with both the security information and the currency conversion calc script information.
Note: All users must be logged off from the Planning application before the Analytic Services databases can be refreshed. For information on forcing users off the system, see Limiting Use of an Application During Maintenance on page 317.
Caution! When you follow the steps below, the data in existing databases is erased and the Planning plan
types are rebuilt. Hyperion recommends that you back up the existing application before proceeding. See Backing Up Applications and Application Databases on page 79.
66
Creating an Application
2 To prevent users from logging on to the application while Planning prepares to create the databases, select
the Lock Current Application From Other Users option.
Select All to automatically include databases, security filters, and currency conversion calc scripts. Select Database to create the Analytic Services multidimensional databases that store the application data. Select Security Filters to store security information in an encrypted data file (Essbase.sec).
Tip: To generate security filters for all users in the application, select this check box, but do not
select the Validate Limit check box. You might want to select this option and not the other options, which may affect data and metadata in the existing databases, if you updated access assignments in Planning and want to synchronize the entire security state to Analytic Services.
Select Shared Members if you are applying security directly to shared members in addition to base members. If you are applying security only to base members, clear this option. Select Validate Limit to identify which, if any, security filters exceed the Analytic Services security filter limit of 64 KB per row. Users who exceed the security filter limit display in the Failed Security Filters dialog box. This option validates the size of the security filters to make sure they do not exceed the size limit before actually building the security filters in Analytic Services. Selecting Validate Limit does not generate security filters; to do so, select only the Security Filters check box.
Select Currency Conversion CalcScript to create a user-defined currency conversion calc script. Selecting the Currency Conversion CalcScript option does not launch the calc script.
4 If you select the Currency Conversion CalcScript option, the Currency Conversion CalcScript Parameters
area is enabled. You can select from among the following options:
In the CalcScript Name text box, enter a name for the application currency conversion calc script. In the Version Type area, select either Bottom-Up or Target. The selection you make affects the versions that are listed in the Versions text box. In the Currencies text box, select one or more currencies as parameters for the application currency conversion calc script. Or select All to include all currencies. The selected currencies are target currencies to which you want to convert.
67
In the Scenarios text box, select one or more scenarios as parameters for the application currency conversion calc script, or select All to include all scenarios. The selected scenarios are the scenarios you want to include for currency conversions. In the Version text box, select one or more versions as parameters for the application currency conversion calc script. Or select All to include all versions. The selected versions are the versions you want to include for currency conversions.
5 Click Create.
To correctly convert currencies, the first time a currency conversion is launched, administrators must run both the copy currency rates calc script and the currency conversion calc script. After you launch the HSPCrtB.csc or the HspCrtT.csc copy calc script, you do not need to launch either one again unless you change the database outline (for example, by adding or changing exchange rates, account rate types, versions, scenarios, accounts, or userdefined dimension members). To create the copy currency calc script for existing calc scripts, you need to regenerate currency conversion calc scripts in the Manage Database task on the Planning Desktop. See Creating Application Databases on page 66.
68
Creating an Application
Caution! When you follow the steps below, data may be removed, depending on the changes to the
application. Hyperion recommends that you back up the existing application before proceeding. See Backing Up Applications and Application Databases on page 79.
2 Select the Lock Current Application From Other Users option to prevent new users from logging on to the
application while Planning prepares to refresh the databases.
Select All to automatically include databases, security filters, and currency conversion calc scripts. Select one of the Database options to refresh the Analytic Services multidimensional databases that store the application data:
Incremental Update of Database Refreshes the information in the Analytic Services database that has changed since the last time it was saved (that is, its last time stamp). The functionality for this option is the same as for the Database check box in previous Planning releases. Full Update of Database Refreshes the entire Analytic Services database. Planning ignores which aspects have changed since the database was last saved (that is, it ignores the time stamps) and refreshes the entire database. You might use this option after performing a complex load of dimensions and members using Hyperion Application Link.
Select Security Filters to store security information in an encrypted data file (Essbase.sec). To optimize performance, refresh checks for and updates security filters based on the changes made since the last time the databases were refreshed. The Security Filters option works in conjunction with the other Create/Refresh options in these ways:
69
If both Security Filters and Database are selected and refresh determines that the Analytic Services hierarchy was changed and needs to be updated (for example, if a member was added), all security filters are rebuilt. If Security Filters is selected and the status of the Shared Members selection has changed since the last refresh, then all security filters are rebuilt. If Security Filters is selected and a user or groups access has changed, then only the security filters for the user or group whose access has changed are rebuilt.
Note: To update only a few user security filters, use the Create Security Filters task.
Select Shared Members if you are applying security to shared members in addition to base members. If you are applying security only to base members, clear this option. Select Validate Limit to identify which, if any, security filters exceed the Analytic Services security filter limit of 64 KB per row. Users who exceed the security filter limit display in the Failed Security Filters dialog box. This option can be used to validate security filter size limit before actually building the security filters in Analytic Services. To do so, select only this option.
Select Currency Conversion CalcScript to create a user-defined currency conversion calc script. Selecting the Currency Conversion CalcScript option does not launch the calc script.
4 If you select the Currency Conversion CalcScript option, the Currency Conversion CalcScript Parameters
area is enabled. Set the following options:
In the CalcScript Name text box, enter a name for the application currency conversion calc script. In the Version Type area, select either Bottom-Up or Target. The selection you make affects the versions that are listed in the Version text box. In the Currencies text box, select one or more currencies as parameters for the application currency conversion calc script, or select All to include all currencies. The selected currencies are target currencies to which you want to convert. In the Scenarios text box, select one or more scenarios as parameters for the application currency conversion calc script, or select All to include all scenarios. The selected scenarios are the scenarios you want to include for currency conversions. In the Versions text box, select one or more versions as parameters for the application currency conversion calc script, or select All to include all versions. The selected versions are the versions you want to include for currency conversions.
5 Click Refresh.
70
Creating an Application
Multiple outline changes are batched into a single database restructure. During a restructure, either an attribute-only restructure or a full restructure is performed. An attribute-only restructure is performed when only attribute-related changes occurred since the last restructure; otherwise, a full restructure is performed. The advantage of attribute-only restructures is that they can be executed concurrently with calc scripts and data entry operations, while full restructures cannot. By default, Planning checks for restructure requests from the server every 5 seconds. You can reset this time interval so that Planning checks for restructures either less or more frequently than every 5 seconds.
To configure the time interval between which Planning checks the server to determine the need
for a restructure and, if finding changes, performs the appropriate restructure of the database:
where:
APPLICATION NAME is the name of the application affected by this setting. Only the named
database restructure based on changes. At the time of the check, if outline-related changes have occurred since the last check, the changes are batched and the database is restructured. If no changes have occurred since the last check, then Planning waits another n milliseconds before checking again. The parameter _OLAP_BATCH_UPDATE must be in all uppercase.
71
Analytic Services security filters Currency conversion calc scripts Accounts or any associated properties are propagated from the relational database to the Analytic Services database Custom attributes and access rights are added, modified, or deleted in the Analytic Services database The exchange rate values are repopulated in the Analytic Services outline to incorporate additions, modifications, and deletions Member formulas for certain accounts are generated or updated
72
Creating an Application
Additions or changes to alias tables and their association to dimensions or members are updated The Analytic Services database is restructured
The amount of time it takes for an application to refresh depends on factors such as the number of entities, users, and so on, that are in the application. As the number of total users and security filters increases, the length of time it takes to perform a refresh also increases. Keep the following points in mind:
The application refresh utility verifies only the syntax of the arguments you supply to run the utility. It does not perform a check to verify that the members you supply in the arguments are valid. If you supply an invalid scenario, version, or currency for the application or if you supply a nonreporting currency, the calc script is still generated, but running it produces an error. Therefore, you must supply valid parameters in the argument list for the calc script to run successfully. Planning does not log Web users out of their applications during a scheduled refresh. However, if an administrator launches the appscheduler.exe utility using /CL or /RL, any connections to the specified application from Smart View or Planning Desktop are terminated. The appscheduler.exe utility must be run from a computer where Planning Client has been installed. Installing Planning Server is not necessary to run this utility. Hyperion recommends that administrators first send a broadcast message to all users to save their work and close the application before they refresh the Analytic Services application.
To create a batch file that creates or refreshes a Planning application into a Analytic Services
database:
1 Start Analytic Services. 2 Use the Microsoft Windows Scheduled Tasks tool (or another scheduler that accepts command line
prompts) to enter the AppScheduler command line.
The appscheduler.exe is installed in the Utils directory on the server computer when you install Planning.
The optional parameters are necessary only if you select to generate currency conversion calc scripts or security filters during the application refresh.
73
[Server Name] is optional. If you substitute a comma for this parameter, the server name
Application Name is the name of the application on which the application Create or
Refresh is to be run.
User Name is the user who has rights to create or refresh the application. This is always an
administrator.
User Password is the password for the user you previously specified. Create/Refresh Specification or Broadcast Message is the function to be
Use /C to create an application. Use /R to refresh the aspects of the application database that have changed since it was last saved. Use /RA to refresh the entire application database, regardless of which aspects of the database have changed since it was last saved. Use /CL to shut down the current instance of the Planning application, terminating any existing Planning Desktop and Smart View connections, launch a new locked version of the Planning application, and then create the databases for the specified Analytic Services application. The Planning application remains locked until the appscheduler.exe utility exits. Use /RL to shut down the current instance of the Planning application, terminating any existing Planning Desktop and Smart View connections, launch a new locked version of the Planning application, and then refresh the databases for the Analytic Services application. The Planning application remains locked until the appscheduler.exe utility exits. Use /M to broadcast a message to all users logged in to the specified application name. You do not need to enter delimiters around the message text. The Message text cannot include a comma ,. For example: Appscheduler Hyperion,HPApp, user1, password,/M,Please save your work and exit the application.
Use 1 to specify the database. Use 2 to specify the security filters. Use 3 to specify the generation of application currency conversion calc scripts. When specifying multiple options, use a semicolon as a delimiter. For example, to specify the database and security filters, use 1;2.
Currency Conversion CalcScript Name is the name of the application currency conversion calc script and is necessary only if you specified to generate an application currency conversion calc script.
If you include the Currency Conversion CalcScript Name parameter, you must also include the following four parameters.
74
Creating an Application
Currency List is the list of currencies to be included in the application currency conversion calc script and are reporting currencies. This option is necessary only if you specified to generate an application currency conversion calc script. Be sure that the currencies you specify exist in the application.
When specifying multiple currencies, use a semicolon as a delimiter. For example, currency1;currency2;currency3.
conversion calc script. This option is necessary only if you specified to generate an application currency conversion calc script. Be sure that the scenarios you specify exist in the application. When specifying multiple scenarios, use a semicolon as a delimiter. For example, scenario1;scenario2;scenario3.
Version List is the list of versions to be included in the application currency conversion
calc script. This option is necessary only if you specified to generate an application currency conversion calc script. Be sure that the versions you specify exist in the application. When specifying multiple versions, use a semicolon as a delimiter. For example, version1;version2;version3.
Version Type Specification is the indicator for the type of versions that are included
Security on Shared Members is the indicator for whether or not you want to enforce
security on shared members. Include this parameter if you are applying security to shared members in addition to base members. If you are applying security only to base members, ignore security on shared members. To specify this parameter, you must have selected to specify security filters in the Create\Refresh Options parameter.
Use 0 to ignore security on shared members. Use 1 to enforce security on shared members.
4 View the results of the application refresh, including any errors, in the Windows Event Viewer Application
Log.
If you are using a batch file to run appscheduler.exe, you may want to capture whether the refresh was successful or not. An error code 1 indicates that the application refresh failed and a zero indicates that the refresh was successful. To see examples of some typical command lines, see Examples of Scheduling an Application Refresh on page 76.
75
Create Application and Generate Currency Conversion CalcScripts for Bottom-up Versions with Security on Shared Members enforced
appscheduler HYPERION,HypApp,User,password,/C,1;2;3, currencyconvcalcname,currency1;currency2;currency3,scenario1; scenario2,version1;version2;version3,0,1
Refresh Application and Generate Currency Conversion CalcScripts for Target Versions with Security on Shared Members enforced
appscheduler HYPERION,HypApp,User,password,/R,1;2;3, currencyconvcalcname,currency1;currency2;currency3,scenario1; scenario2,version1;version2;version3,1,1
For more information on the APPSCHEDULER.EXE utility, see Scheduling Application Databases to be Refreshed on page 72.
Assigning dimensions as either dense or sparse. See Assigning Dense and Sparse Dimensions on page 77. Changing the order of the dimensions from most dense to least dense. See Changing the Order of the Dimensions on page 77. Allocating memory for supporting detail cache. See Allocating Memory for Supporting Detail Cache on page 78. Clearing certain options when creating or refreshing an application database. See Clearing Options when Creating or Refreshing an Application Database on page 79.
76
Creating an Application
For more information about dense and sparse dimensions, see About Sparse and Dense Dimensions on page 124.
77
3 From the Select Plan Type drop-down list, select a plan type.
The dimensions that belong to the plan type are displayed along with the number of dimensions for that plan type. Each application can have up to three plan types.
Select Sparse to designate the dimension as a sparse dimension. A sparse dimension contains data values that are not smoothly and randomly distributed, and that do not exist for the majority of member combinations in the database. Select Dense to designate the dimension as a dense dimension. A dense dimension contains data values that are smoothly and randomly distributed, and that exist for the majority of the member combinations in the database.
Click Click
to move the dimension up in the list. to move the dimension down in the list.
A validation check is performed to ensure that you have designated at least one dense dimension in each plan type. If the validation fails, an error message displays and you can change the performance settings.
2 Change the PLAN_SUPPORTING_DETAIL_CACHE_SIZE entry. 3 Save and close the properties file.
For instructions on viewing the supporting detail cache usage, see Viewing Usage Statistics on page 65.
78
Creating an Application
Before refreshing an existing application (Planning prompts you to perform a backup first) Before moving an application to a new server Before upgrading an application As your business dictates (for example, at key planning milestones)
Backing up an application and its related application databases is a three-part process, consisting of the steps described in the following topics:
Backing up the application in Analytic Services Backing up the relational database for Planning and Hyperion System 9 BI+ Financial Reporting Studio Backing up the required components of Planning
For more information on backing up an application, see the Hyperion System 9 Planning Installation Guide.
79
80
Creating an Application
Chapter
Setting Up Security
4
This section describes how to assign and report on access in Planning. For information on setting up external authentication, see the Hyperion System 9 Shared Services Installation Guide. For information on setting up users and groups, see the Hyperion System 9 Shared Services User Management Guide.
In This Chapter
About Access Rights and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Configuring DCOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 About Security in Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 About Assigning Access Rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Importing Access Rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Reporting on Access Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Setting Up Security
81
Authentication by an external provider. For information on configuring external authentication, see the Hyperion System 9 Shared Services Installation Guide. The provisioning of users and groups in the Hyperion System 9 Shared Services User Management ConsoleTM. For information on setting up users and groups, see the Hyperion System 9 Shared Services User Management Guide. An appendix on Planning provides information that is specific to Planning. Note that Shared Services supports a number of roles that each have certain privileges in managing projects, users, and groups. For example, a user with the Project Manager role can create and manage projects in Shared Services. A user with the role of Provisioning Manager can provision users and groups to applications.
Assigning users and groups access to the various aspects of the application. After users and groups are provisioned in the Shared Services User Management Console, you assign them access to the appropriate aspects of the Planning application. For more information, use this chapter and the Planning appendix in Hyperion System 9 Shared Services User Management Guide.
Before using Planning, you must configure the applications Distributed Component Object Model (DCOM) settings. See Configuring DCOM on page 82.
Configuring DCOM
Before using Planning, the application servers Distributed Component Object Model (DCOM) settings must be configured. DCOM enables network-based component interaction and enables sharing of processes across a network. With DCOM, components operating on a variety of platforms can interact, as long as DCOM is available within the environment. The following items are set using DCOM security:
Typically, DCOM security is configured by an IT professional at your company. For more information about setting up DCOM security, see the Hyperion System 9 Planning Installation Guide.
82
Setting Up Security
Scenario dimension members Version dimension members Account dimension members Entity dimension members User-defined custom dimension members Data forms Task lists Business rules
After you establish or update user and group security, the Planning application needs to be refreshed to complete the update to Analytic Services security filters. However, before doing this, you can validate that the size of the security filters does not exceed the Analytic Services limit of 64 KB per row. For more information about validating the security filters, see Creating Application Databases on page 66. Additionally, if you need to update only a few user security filters, you can do that with the Create Security Filters task. For more information about updating individual user security filters, see Creating Security Filters on page 83.
Note: When you change the user type for a user, the user has full read/write access to the application through Smart View and through Analytic Services until you refresh the Analytic Services database. Once the database has been refreshed, the appropriate access rights are applied to the user.
For information on assigning access rights in Planning, see About Assigning Access Rights on page 84.
83
You can assign access rights to a dimension member, data form, or task list when you add or modify that dimension member, data form or task list. In each instance, there is an Assign Access option where you can assign access rights.
Note: Before you can assign access to a user-defined custom dimension, you must select the dimension property Apply Security. See Setting Dimension Properties on page 145. Also, to generate a correct security filter for a particular user in Analytic Services, that user must have access assigned to members of all secured Planning dimensions. By default, the secured dimensions are Account, Entity, Version, and Scenario. In addition, if any user-defined dimensions have been secured, the user must then also have access assigned to members of these dimensions. If access has not been assigned in any one of these dimensions, the security filter built for this user in Analytic Services is set to None.
ReadAllows view access to the dimension member, data form, or task list for the specified user or group WriteAllows view and modify access to the dimension member, data form, or task list for the specified user or group NoneProhibits access to the dimension member, data form, or task list for the specified user or group
Note: The default access is None and does not need to be specified.
84
Setting Up Security
You can specify only one access right for each user or group. However, when you assign a user to a group, that user acquires the access rights of the group. If an individual user is assigned to a group and the access rights of the individual user conflict with those of the group, the individual users access rights take precedence. If there is no access right specified for a user or group to an Entity, Account, or user-defined custom dimension member, an inheritance option may determine the user or groups access rights. However, an access right assigned to the member takes precedence over any inherited security access. When assigning access rights to a specific member, you can also specify an attribute that causes the children or descendants of that member to inherit its access rights. In addition, when specifying inheritance attributes, you can include or exclude the actual member from the access rights setting. The following table describes inheritance options.
Table 21
Options for Inheriting Access Rights Result The access right is assigned only to the currently selected member. The access right is assigned to all children members in the level below the currently selected member. The access right is assigned to the currently selected member and all children members in the level below it. The access right is assigned to all descendant members below the currently selected member. The access right is assigned to the currently selected member and all descendant members below it.
User Authentication
Application Rights
Data Rights
Access to data source data such as members and values Access to Financial Reporting objects such as reports and folders
85
The name of the text file must be Secfile.txt and it must be saved in the Utils directory. If you installed Planning to the default location, the Utils directory is located in the following path: <driveletter>:\Hyperion\HyperionPlanning\Utils. All users, groups, and members must already be defined in the application. Access assignments to data forms are not imported. Before importing security on a user-defined custom dimension, you must first allow security to be set on it by selecting the Apply Security check box on the dimensions Property tab. If this check box has not been selected for a user-defined custom dimension, security for it cannot be imported. See Setting Dimension Properties on page 145. Each line in the secfile.txt file must specify security information. Each line must contain the following items, separated by one of the following delimiters: , tab ; | : space. Comma is the default.
Description The name of a user or the name of a group that is already defined in the User Management Console. A member (account, entity, user-defined custom dimension, scenario or version) in the application. Read, Write or None. If there are duplicate lines for a username/member name combination, the line with Write access takes precedence. For example, consider the following two lines: User1,Member1,Read,@IDESCENDANTS User1,Member1,Write,@ICHILDREN In this case, the security applied is User1, Member1, Write, @ICHILDREN.
Item
86
Setting Up Security
Note: If a member, user, or group name contains a character that you are also using as the delimiter, enclose the name in double quotes. For example, if you are using a space as the delimiter, enclose the name South America in double quotes: South America.
To import security information into a group that has the same name as a user, append the following to the line in the Secfile.txt file that pertains to the group:
sl_group
For example:
admin,member1,read,member admin,member1,read,member,sl_group
The first line imports security for a user named Admin. The second line imports security for the group named Admin. If you omitted sl_group, security information would be imported only for the user named Admin.
2 From the Command Prompt, type the following command, one space, and the parameters, separating each
parameter with a comma:
importsecurity UDL,[delimiter],[run_silent],[SL_CLEARALL]
where:
Parameter Explanation The full path and name of the Planning UDL file that points to the application for which you are importing security. Optional: SL_TAB, SL_COMMA, SL_PIPE, SL_SPACE, SL_COLON, SL_SEMI-COLON. If no delimiter is specified, the comma default is assumed to be the delimiter. Optional: Whether to execute the utility silently or with progress messages: 0 = execute with messages 1 = execute silently, with no messages If this parameter is not included in the command line, the value is assumed to be 0, to display progress messages during execution. Optional: Specify to clear all existing access assignments when importing the new access assignments. This option must be in uppercase.
[SL_CLEARALL]
87
For example:
importsecurity c:\Hyperion\HyperionPlanning\Utils \MyUDL.udl,SL_TAB,1
3 After you execute the utility, check the log file importsecurity.log in the Utils directory to verify
the results.
The new security information is now accessible from the Dimensions tab on the Web. To see the new security information reflected on the Enter Data page, refresh the application databases with the Security Filters option checked. You do not need to restart the application server.
If you plan to import the access for many users, you can improve performance by making sure that their full names are not used. On Planning Web, select Preferences > Advanced Settings option > System Settings tab and then clear the check box Display Users Full Names. If you are running both the ImportSecurity utility and AuthSrvr.bat, you can avoid a warning about the RMI port already being in use by taking these steps:
On the client computer, run AuthSrvr.bat from the command prompt, with the new port number as a parameter. On the server computer, update the HspJSHome.properties file with the following line: Authentication port=<authentication port number>. (For information on locating the properties file, see Default Location of the Properties File on page 45.)
Select a Planning application under Projects and right-click. From the menu, select Access Control Report. Select a Planning application under Projects and select Administration > Access Control Report.
88
Setting Up Security
2 On the Select User or Group tab, from the drop-down list, select whether you want to report on users, on
groups, or on both users and groups by selecting one of the following:
Available Usersto report on the users in the Planning application. Available Groupsto report on the groups in the Planning application. Available Users and Groupsto report on both the users and groups in the Planning application.
3 From the left panel of Available users or groups, select the users and groups you want to report on by
taking any of the following actions:
, to move the highlighted users and groups from the Available Users
Click the Remove icon, , to move the highlighted users and groups from the Selected Users and Groups list to the Available Users and Groups. Click the Add All icon, , to move all the users or groups from the Available Users and Groups list to the Selected Users and Groups list. Click the Remove All icon, , to move all the users and groups from the Selected Users and Groups list to the Available Users and Groups list.
4 Click Next.
The Select Objects tab is displayed. For information on using this tab, see Selecting the Reporting Objects on page 89.
Click the Remove icon, , to move the highlighted objects from the Selected Objects list to the Available Objects list.
89
Click the Add All icon, Objects list. Click the Remove All icon, Available Objects list.
, to move all the objects from the Available Objects to the Selected
, to move all the objects from the Selected Objects list to the
3 Click Next.
The Report Options tab is displayed. For information on using this tab, see Selecting the Reporting Options on page 90.
Readto view Read access assignments Writeto view Write access assignments Noneto view access assignments of None
3 From the Group the Results By, select how you want the results of the report grouped, by either:
Usersto view the report sorted by the users names Objectsto view the report sorted by the assigned objects
4 From the Report Type sections, select the Assigned Access check box or the Effective Access check box,
as described in the following table:
90
Setting Up Security
Table 22
Access Report Types Description Summarizes the access assignments that an administrator has explicitly assigned Options You can include information on whether the access is assigned by member selection relation or by belonging to a group. Select the following check boxes to reflect your choices:
Select the Show Matching Access of Relation check boxes to include which access assignments by member relationships you want to view: Member, Children, Children (inclusive), Descendants, or Descendants (inclusive). Select the Show Inherited From Group check box to include information on those access assignments that are inherited by users belonging to a group.
Effective Access
Summarizes the access assignments as Planning evaluates them (for example, by member selection relation such as Children or by belonging to a group). This report is especially useful where there are conflicts in access assignments.
To include information that describes the origin of the effective access, select the Show Effective Access Origin check box. For example, a user named JSomebody may be assigned Write access to Entity1 and also belong to a group named Sales that is assigned Read access to Entity1. Selecting this check box would show that JSomebody has Write access to Entity1 because individual assigned access supersedes access that is inherited by belonging to a group.
5 Click Finish.
Adobe Acrobat launches, displaying the report online. For information on the displayed report, see Working With the Report on Access Assignments on page 91.
91
To specify the aspects of the application for which you want Planning to record changes:
1 Perform one of the following actions:
Select Administration > Reporting. Select File > New > Report.
2 Select the Auditing tab. 3 On the Auditing tab, select which actions Planning tracks:
Tip: To avoid affecting performance, be selective in which application elements you audit.
Table 23
Changes to a dimension hierarchy: adding a member or dimension, moving, deleting, changing properties, renaming a member or dimension Changes to performance settings: resetting a dimension's dense or sparse setting, changing the order of dimensions Changes to currencies: adding or deleting a currency, setting a triangulation or reporting currency Changes caused by utilities that affect Planning Web (for example, importing a data form design with the ImportFormDefinition utility)
Changes to alias tables: creating, copying, renaming, deleting, and clearing an alias table
When calc scripts and business rules are launched (including runtime prompts) Changes to data forms: creating and modifying a data form, adding a row from the Enter Data page
Note: The audit record does not record specifically how a data form design changed.
Change in the owner of a planning unit Change in the status of a planning unit Whether a planning unit is started or excluded
Copy Version
When a version is copied, including the copy option (include supporting detail and annotations)
Note: The audit record does not record the details (for example, the data, supporting detail, and annotations) of the copied version.
Security
92
Setting Up Security
Table 23
Actions That Can be Audited Tracked Actions Adding, changing, or deleting users Adding, changing, or deleting groups; adding or removing users from groups
Note: For corresponding examples of tracked changes, see Examples of Tracked Actions on page 93.
5 Restart the Web application server. 6 At any time, view the results in the HSP_AUDIT_RECORDS table using any RDBMS report writer.
Note: If anyone resets the audit options, those changes are also recorded.
93
For example, use the following SQL command to delete all entries from the audit records table:
DELETE FROM HSP_AUDIT_RECORDS
For example, to view audit records, sorted by the time they were posted:
SELECT * FROM HSP_AUDIT_RECORDS ORDER BY TIME_POSTED
94
Setting Up Security
Chapter
5
This section describes how to set up and maintain alias tables in a Planning application.
In This Chapter About Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Creating Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Editing or Renaming an Alias Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Deleting Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Clearing Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Copying Alias Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Setting a Default Alias Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
95
English, French, German, Spanish, and Italian Japanese and English Korean and English Turkish and English
You can then set which alias table to use for the display of members in the application. For example, each time you open the Dimensions tab, either the default alias table or the alias table you selected as a preference is selected. The name of the selected alias table is displayed in the Alias column header on the Dimensions tab. Planners can also set their preferred alias table by selecting File > Preferences. See Setting a Default Alias Table on page 99.
96
Select Administration > Alias Tables. Select File > New > Alias Table.
2 Click Add. 3 In the Explorer User Prompt text box, enter a name of up to 30 characters for the alias table.
Note: The alias table name cannot contain the tab, double quote , or backslash \ characters. The alias table name cannot start with any of the following characters: \<|,=@_+-{}().
4 Click OK.
Select Administration > Alias Tables. Select File > New > Alias Table.
2 Select the alias table you want to edit or rename. 3 Click Edit. 4 In the Explorer User Prompt text box, enter a name of up to 30 characters for the alias table.
Note: The alias table name cannot contain the Tab, double quote , or backslash \ characters. The alias table name cannot start with any of the following characters: \ < | , = @ _ + - { } ( ) .
5 Click OK.
97
Select Administration > Alias Tables. Select File > New > Alias Table.
3 Click Delete. 4 When you are prompted to confirm your intention to delete the alias table, click OK.
Select Administration > Alias Tables. Select File > New > Alias Table.
3 Click Clear Values. 4 When you are prompted to confirm your intention to clear the contents of the alias table, click OK.
Select Administration > Alias Tables. Select File > New > Alias Table.
98
4 From the drop-down list, select the destination alias table to which you want to copy the aliases.
Note: The destination alias table must be an existing table because the copy does not create a new table.
5 Click Copy.
To save the current selections, click Save. To reset the selections to those last saved, click Reset.
For information on setting other system defaults, see Setting Application Defaults on page 315 and Specifying System Settings on page 316.
99
100
Chapter
6
In This Chapter
This section describes how the calendar rolls up, which currencies are used in an application, and how currencies are converted from one to another.
Customizing the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Setting Up Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Setting Up Exchange Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
101
Defining How Calendars Roll Up on page 102 Creating and Editing Summary Time Periods on page 103 Deleting Summary Time Periods on page 104 Working with Years on page 105 Setting the Fiscal Year on page 106 Renaming Time Periods on page 106 Assigning Aliases to Summary Time Periods on page 107 Editing the BegBalance Member on page 107
The following table summarizes the various functions and options available on the Dimensions tab when the Period dimension is selected, with links to the sections that discuss them in more detail.
Table 24
Calendar Tasks Topic See Defining How Calendars Roll Up on page 102. See Creating and Editing Summary Time Periods on page 103. See Deleting Summary Time Periods on page 104. See Working with a Dimension Hierarchy on page 126. See Setting the Fiscal Year on page 106. See Finding Dimensions or Members on page 128.
Task Define how years roll up. Create and edit Summary Time Period. Delete Summary Time Periods. Work with the Period dimension hierarchy. Set the fiscal year. Search for a Time Period member.
Calendar Roll Up Roll Up Four quarters are created per year. Months roll up into their parent quarter and quarters roll up into a year.
102
Table 25
Calendar Roll Up (Continued) Roll Up Quarters roll up into a year. There are no default rollup structures. Instead, a flat list of the custom base time periods is displayed.
After the calendar in the application is created, you cannot change the base time period or reduce the number of years in the calendar. As the administrator, you can change the names, descriptions, aliases, and ranges of the summary time periods in the hierarchy. You can have up to 100 calendar years and 500 time periods in an application. Actual limits are a function of both calendar years and time periods. How many time periods and years you can set also depends on whether your application uses multiple currencies. Hyperion recommends these practical limits for an application:
400 time periods per year and 27 years 360 time periods per year and 30 years
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Period. 3 Perform one of the following actions:
To add a time period, select the level in the dimension hierarchy above which you want to add the time period and click Add.
Note: You must work from the top of the hierarchy to the bottom when you create summary time periods. Otherwise, Planning views the rollup structure as asymmetrical and you cannot continue. The new summary time period displays in the hierarchy as a parent of the selected item. Also note that to enforce a balanced hierarchy, all base members must be the same number of levels from the root.
To edit a time period, select the time period and click Edit.
103
4 In the Name text box, enter or change the name for the summary time period. 5 Optional: In the Description text box, enter a description of up to 255 characters for the summary time
period.
6 Optional: From the Alias drop-down list, select an alias table to be used for the summary time period.
Enter an alias in the text box.
7 From the Start Period drop-down list, select the starting period.
Some points to know about changing the range of a summary time period:
The range cannot extend beyond the current fiscal year. For information on resetting the current fiscal year, see Setting the Fiscal Year on page 106. If you select a summary time period with no sibling above it, then the Start Period dropdown list displays its first child. If you select a summary time period that has a sibling above it, then the Start Period dropdown list displays all children except the first child of the sibling above it.
8 From the End Period drop-down list, select the ending period.
If you select a summary time period with no sibling below it, the End Period drop-down list displays its last child. If you select a summary time period with a sibling below it, the End Period drop-down list displays all children from the Start Period through the next siblings children, except for the last child.
9 Click Save.
If you delete the first summary time period in the hierarchy, the children are moved into the next sibling of the summary time period. If you delete the last summary time period in the hierarchy, the children are moved into the previous sibling of the summary time period. If you delete a summary time period from the middle of a hierarchy, the children are moved into the previous sibling of the summary time period.
Select Administration > Dimensions. Select File > New > Dimension Member.
104
3 From the Period hierarchy, select the summary time period that you want to delete.
Note: You cannot delete a base time period.
Year Tasks Topic See Adding Years to the Calendar on page 105. See Setting the Fiscal Year on page 106. See Working with a Dimension Hierarchy on page 126. See Finding Dimensions or Members on page 128.
Task Add years to the calendar. Set the fiscal year. Work with the Year dimension hierarchy. Search for a Year.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Year. 3 Click Add Years.
105
4 In the Number of Years to Add text box, enter the number of years you want to add to the calendar.
For information on the practical limits on the number of years in an application, see Defining How Calendars Roll Up on page 102.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select either Year or Period. 3 Click Options. 4 On the Set Current Time Period and Year dialog box, from the Current Year drop-down list, select the
current year.
Note: The Current Month and Current Year selections set the defaults for the Month and Year drop-down lists when a new scenario is created. For example, if the Current Year is set to FY08 and the Current Month is set to Aug, when a user creates a new scenario, these values are displayed as defaults in the Start Yr, Start Period, End Yr, End Period fields in the Create Scenario dialog box.
5 From the Current Time Period drop-down list, select the current period. 6 Click Save.
106
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Year. 3 Select the year for which you want to assign an alias. 4 Click Edit Year. 5 On the Edit Aliases dialog box, from the Alias Table drop-down list, select the alias table you want to use. 6 In the text box, type an alias name. 7 Click Save.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimensions drop-down list, select Period. 3 Select the first member, BegBalance. 4 Click Edit. 5 In the Edit Period dialog box, take any of these actions:
In the Name text box, type a new name for the BegBalance member. In the Description text box, type a description of up to 255 characters. From the Alias drop-down list, select an alias table to be used for the BegBalance member, then enter an alias to be used.
6 Click Save.
107
Setting Up Currencies
You can plan, forecast, and analyze your financial information in a single currency or in multiple currencies, as described in the following sections:
Enabling Multiple Currencies on page 109 Working with Multiple Currencies on page 109 About the Calculate Currencies Business Rule on page 110 Exchange Rate Types on page 111 Scaling on page 111 Number Formatting on page 111 Reporting Currencies on page 112 Seeing How a Currency is Used on page 112
Which currencies an application uses Which currencies an application uses for reporting purposes How currencies display in reports and data forms How one currency is translated into another currency Whether a third currency (also known as a triangulation currency) is used for converting between currencies When currency conversions occur
The following table summarizes the various functions and options available on the Dimensions tab when the Currency dimension is selected, with links to the topics that discuss them.
Task Create currencies. Edit Currencies. Delete Currencies. Show Currency Usage. Topic See Creating Currencies on page 113. See Editing Currencies on page 115. See Deleting Currencies on page 116. See Seeing How a Currency is Used on page 112.
108
When the local currency is selected on a data form, the default stored and displayed currency for each cell is the entitys base currency (which you set up). Think of the local currency members and values as source currencies. Users can enter data values only into local currency members. If the local currency member is selected, then all the currencies that are set up for the application are available as valid input types. Currencies can be converted only to reporting currencies. Think of reporting currencies as target currencies in that they are read-only. Users cannot enter data into cells that are displayed in a reporting currency. The applications main currency is by default a reporting currency. You can change which currencies are reporting currencies as described in Creating Currencies on page 113. You can load values (from historical scenarios, for example) into a reporting currency by using the Essbase Adapter to populate values directly into Analytic Services.
Currencies that are defined for the application, including reporting and non-reporting currencies, are valid currencies for data entry. The valid currencies for data entry are displayed in a list that users can access by clicking the Currency link on the Enter Data page. To get meaningful results, roll up values in one common reporting currency. If members of a subtotal have mixed currencies, the currency type is blank and the currency symbol does not display. For example, adding 10 US dollars and 10 Japanese yen to a subtotal value of 20 does not make sense. Applications with 500 time periods can successfully run currency conversion calc scripts only if the time periods have default names, TP 1 through 500. Otherwise, the conversion calc script you are trying to create exceeds the 64K limit.
Setting Up Currencies
109
User-defined currency conversion calc scripts created when a database is created or refreshed may be made available in Smart View, depending on user access. If a user-defined currency conversion calc script is selected to run in a worksheet, Hyperion recommends that the user change the order so that the currency conversion calc script is placed first, before the Calculate Data Form script. Because currency codes associated with input values are stored as numeric values in Analytic Services, these codes are also calculated in dimension formulas, calc scripts, and business rules. The calculated values of these currency codes may translate to currency codes that are incorrect or invalid. As a result, where there are children with mixed currencies, it is important to review the calculated results on the upper levels. If a parent has multiple children, of whom only one child has an overridden currency, the parent inherits the overridden currency code in Analytic Services (which is not displayed on a Web data form). In certain cases, parent entities display #MISSING when trying to convert to a selected currency. Make sure that a currency rate is entered for each combination of local currencies and selected currencies on a data form or report. Also ensure that currency combinations exist for all mixed-currency children entities and their parent member. Input of multiple currencies to a single entity is not supported in Smart View. As such, if there are mixed currency types on a worksheet, the user could inadvertently enter values in the wrong currency.
It does not calculate subtotals. To subtotal values, run the Calculate Data Form business rule (or a customized business rule that includes aggregation) after converting currencies. It ignores #missing values. It can be turned on or off by associating or disassociating it with a data form (a data form design option). It is by default set to not run when saving data.
For information on converting currencies for the application as a whole, see step 4 on page 67.
110
The exchange rate type used for each account is specified in the Member Property dialog box when you set up accounts. For average and ending rate types, you can enter values for all time periods. For the historical rate type, you can enter a single rate value that is used for all time periods, including the Beginning Balance period. For the Beginning Balance period, you can enter a single rate value that is always used for that time period for average and ending rate types. Planning supports currency conversion by triangulation through an interim currency, called the triangulation currency. See Triangulation on page 119.
Scaling
You can specify that data values be scaled when they are displayed in certain currencies. For example, you might set the scaling for Yen to Thousands. You could enter 10,000 as a value for the Japan entity on a data form with the Local member selected for the Currency dimension. When you select Yen as the currency member for the data form, the scaling is applied and 10 displays as the value for Japan.
Number Formatting
You can determine how numerical values display in a data form. This applies to non-currency as well as currency data types. However, users can override these settings on an individual basis in data forms. You can determine the initial display of these items:
Setting Up Currencies
111
Reporting Currencies
A reporting currency is the currency in which your company prepares its financial statements. Planning supports currency conversion from local currencies to one or more reporting currencies. The converted reporting currency values are stored and are read-only for all users. An applications default currency is also the default reporting currency. You can disable a currency as a reporting currency.
Is the default currency. Is used as a triangulation currency. Is used by an entity. Has a conversion or exchange relationship set up with other currencies.
Select Administration > Dimensions. Select File > New > Dimension Member.
112
3 From the list of currencies, select the currency for which you want information. 4 Click Show Usage.
Creating Currencies
You can create currencies in an application as needed. You can select from a predefined list or create your own. You can specify the following properties when you create a currency:
The three-letter code The symbol A description of up to 256 characters The scaling factor to use, if any, when values are displayed in the currency The triangulation currency, if any, to use for currency conversion The alias table to use to display aliases for this currency The number formatting, including thousands separator, decimal separator, negative sign, and negative color Whether or not it is a reporting currency
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Currency. 3 Click Add. 4 Take one of the following actions:
To add a predefined currency to the application, select Select Standard Currencies. To add a currency to the application, select Create New Currency and specify the following properties:
In the Code text box, enter an abbreviation or key identifier of up to three characters for the new currency. Optional: In the Description text box, enter a descriptive name for the new currency. For example, Japanese yen. Either enter a symbol in the Symbol text box or select a predefined symbol from the Symbol drop-down list. Optional: From the Scale drop-down list, select how the new currency is entered and displayed (in whole numbers, tens, hundreds, thousands, ten thousands, and so on). For example, 3 yen represents 3000 Japanese yen if scaling is set to thousands.
Setting Up Currencies
113
Optional: From the Triangulation Currency drop-down list, select a currency for converting the new currency to a different currency through a common third currency, which is the triangulation currency. Optional: From the Alias Table drop-down list, select the alias table to be used for this currency. The default table is used if you do not make a specific choice. Optional: In the Alias text box, enter a descriptive name for the alias you want to assign to this currency. Optional: From the Thousands Separator drop-down list, select an option to display numbers with thousands values:
Use Default Setting to use the applications default setting. None to display members with no thousands separator, for example, 1000. Comma to display numbers with a comma separating thousands values, for example, 1,000. Dot to display numbers with a dot separating thousands values, for example, 1.000. Space to display numbers with a space separating thousands values, for example, 1 000.
Optional: From the Decimal Separator drop-down list, select an option to display numbers with decimal values:
Dot to display the decimal separator as a dot, for example, 1000.00. Comma to display the decimal separator as a 1000,00.
Optional: From the Negative Sign drop-down list, select one of the following options to display numbers with negative values:
Prefixed minus to display a minus sign in front of negative numbers, for example, -1000. Suffixed minus to display a minus sign behind negative numbers, for example, 1000-. Parentheses to display parentheses around negative number, for example, (1000).
Optional: From the Negative Color drop-down list, select a color option to display numbers with negative values:
Black to display negative numbers in black. Red to display negative numbers in red.
Optional: Select the Reporting Currency option to designate the currency as a reporting currency.
114
5 Click Save.
Editing Currencies
To change the properties of a currency, follow the steps in this topic.
To modify a currency:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Currency. 3 Select the currency you want to edit. 4 Click Edit. 5 Modify the properties as necessary:
To change the currencys symbol, either enter the new symbol in the Symbol text box or select a symbol from the Symbol drop-down list. In the Description text box, enter a descriptive name for the currency. From the Scale drop-down list, select how the currency is entered and displayed (in whole numbers, tens, hundreds, thousands, ten thousands, and so on). For example, 3 yen represents 3000 Japanese yen if scaling is set to thousands. From the Triangulation Currency drop-down list, select a currency for converting the currency to a different currency through a common, third currency, which is the triangulation currency. From the Thousands Separator drop-down list, select an option to display numbers with thousands values:
Use Default Setting to use the applications default setting. None to display members with no thousands separator, for example, 1000. Comma to display numbers with a comma separating thousands values, for example, 1,000. Dot to display numbers with a dot separating thousands values, for example, 1.000. Space to display numbers with a space separating thousands values, for example, 1 000.
Setting Up Currencies
115
From the Decimal Separator drop-down list, select an option to display numbers with decimal values:
Dot to display the decimal separator as a dot, for example, 1000.00. Comma to display the decimal separator as a 1000,00.
From the Negative Sign drop-down list, select an option to display numbers with negative values:
Prefixed minus to display a minus sign in front of negative numbers, for example, - 1000. Suffixed minus to display a minus sign behind negative numbers, for example, 1000-. Parentheses to display parentheses around negative numbers, for example, (1000).
From the Negative Color drop-down list, select a color option to display numbers with negative values:
Black to display negative numbers in black. Red to display negative numbers in red.
From the Alias Table drop-down list, select an alias table to be used, and modify the alias for the currency, if necessary. Select or deselect the Reporting Currency option.f The Marked for Delete check box enables you to see which dimension members are out of sync between the Planning application and Shared Services before they are actually deleted. For more information on this property, see Unmarking Members That are Pending Deletion on page 135.
6 Repeat steps 3 through 5 for each currency that you want to modify. 7 Click Save.
Deleting Currencies
You may select one or more currencies to delete. However, you may not delete the default currency.
To delete a currency:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
116
2 From the Dimension drop-down list, select Currencies. 3 From the Currency area, select the currency you want to delete. 4 Click Show Usage to see if the currency is the default currency, is used as a triangulation currency, or is
associated with an entity. You cannot delete a currency that meets any of these criteria. Additionally, if you delete a currency that is defined in the exchange rate table, it is also deleted from that table. For more information on viewing where a particular currency member is used in the application, see Determining Where Members Are Used in the Application on page 131.
5 Click Close to close the Member Usage window. 6 Click OK. 7 Click Delete. 8 When prompted to confirm the deletion, click OK.
Note: After deleting a currency, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes.
When you want to enable budget preparers in various countries to create plans in their native currencies When you want to show summary data in reports in a particular currency When you want to summarize values from multiple currencies into a single currency
For example, you might specify yen as the base currency for the Japan entity and US dollars for the United States entity. When you display a data form that has values on it for the Japan entity and the data forms display currency is set to US dollars, the exchange rates for the yen is used to convert the values for Japan to US dollars. If the display currency is set to yen, it uses the exchange rates for US dollars to convert values for the Unites States entity to yen.
Note: When you create an application, you must have selected the option for using multiple currencies for the Exchange Rates task to be available. If you selected to create the application using one currency, the Exchange Rates task is not available.
About Exchange Rate Tables on page 118 Hsp_Rates Dimension on page 118 Triangulation on page 119 Calculation Method on page 119
117
Setting Up Exchange Rate Tables on page 119 Modifying Exchange Rate Tables on page 121 Deleting Exchange Rate Tables on page 122
Hsp_Rates Dimension
Applications that support multiple currencies include an additional dimension called Hsp_Rates. This dimension is used to store exchange rates. It includes these two members (besides others, which store rates for existing currencies):
Hsp_InputValue, which stores data values Hsp_InputCurrency, which stores currency types for the data values
When you generate reports or load data, you need to refer to the Hsp_InputValue member. Additionally, when you load data, you need to load the data against the local currency. You do not need to refer to the Hsp_InputCurrency member. By default, the Hsp_Rates dimension is set to Dense. You can change this setting using the Performance Settings option. For more information about changing performance settings, see Optimizing Application Performance on page 76.
118
Triangulation
Planning supports currency conversion by triangulation through an interim currency. The interim currency is called the triangulation currency. For example, if you know Euro/US dollar exchange rate and the Euro/Japanese yen exchange rate, you can calculate the US dollar/Japanese yen exchange rate by using the Euro as the triangulation currency. If currency A is set to triangulate through another currency B, then the exchange rates between currency A and any other currencies that triangulate through currency B are calculated automatically. You can also modify a currencys triangulation currency. Doing this requires you to re-enter exchange rates relative to the triangulation currency property. You must then refresh the application for the new exchange rates to be transferred and stored to the plan types.
Note: The applications default currency cannot be selected as a triangulation currency.
Calculation Method
When you input exchange rates for converting from one currency to another, you select either Multiply or Divide as the calculation method. For example, if you select 1.5 as the rate for converting British Pounds to US dollars, and select multiply as the calculation method, 1 British Pound is converted to 1.5 US dollars.
Exchange Rate Table Window Options Select the currency from the list for which you want to enter conversion rates (either the default currency or any triangulation currency). For example, if you want to specify a rate for converting French Francs to the default currency of the application, select the default currency in the Currency column. Select the currency to enter rates from which to convert (source currency). The mathematical operator (either multiply or divide) that determines how values are calculated between the source and destination currencies. For all time periods, this value sets the exchange rate for accounts whose Exchange Rate Type is set to Historical (in the Custom Dimension task). The accounts Data Type must be set to Currency. Historical is typically used for balance sheet account types. A historical exchange rate may reflect a calculated rate over time, a rate for a point in time prior to the applications calendar, or a rate that was in effect when an event occurred.
Currency
119
Table 27
Exchange Rate Table Window Options (Continued) The value of balance sheet accounts (for example, Asset, Liability, and Equity). There is one beginning balance time period, which is the first time period in the application. Rates for the Beginning Balance time period are populated for each year in the application. Scenarios that do not include the first year of the application can still include a Beginning Balance time period. For any time period, this value sets the exchange rate for accounts whose Exchange Rate Type is set to Average (in the Custom Dimension task). Average is typically used for Revenue and Expense account types, or for Saved Assumption account types whose Time Balance option is set to Flow. The accounts Data Type must be set to Currency. For any time period, this value sets the exchange rate for accounts whose Exchange Rate Type is set to Ending (in the Custom Dimension task). Ending is typically used for Asset and Liability account types, or for Saved Assumption account types whose Time Balance option is set to Balance. The accounts Data Type must be set to Currency. Lets you control which columns display in the grid by clicking the check boxes for Average Rates, End Rates, Method, Historical, and BegBalance. Click to specify the time periods shown in the grid. By default, the time periods shown in the grid are the current year of the application calendar. Click to select another Exchange Rate table to edit.
BegBalance
Average
Ending
In the Exchange Rate Tables area on the right, click New Rate Table. From the menu, select Task > New Rate Table.
3 In the Name text box, enter the name of the new exchange rate table.
The name may be up to 32 characters.
4 In the Description text box, enter a description for the new exchange rate table.
The description may be up to 128 characters.
5 Click OK. 6 Highlight the exchange rate you created, and then click Open Rate Table. 7 From the Currency list, select the default currency or triangulation currency you want to set up. 8 Place the cursor in the row of the currency you want to convert from, and in the cell for which you want to
enter a value.
9 Enter values in the other columns of the row to reflect the relationship that you want to set up when
Planning converts from that currency to the default or triangulation currency.
10 In the Method column of the row, specify whether multiplication or division should be used as the
calculation method.
120
11 Enter values into the cells for the desired time periods:
Planning stores values with up to six places to the right of the decimal separator. If you enter more than six digits to the right of the decimal separator, the value is rounded off to six digits. To automatically enter the same exchange rate for all following average or ending periods in a year, place the cursor in the cell to be copied and select Task > Fill Year. To enter the value for all the average or ending exchange rate cells in the row, select Task > Fill Table. To set which years display, click Years and select the desired years.
12 Optional: From the Show Columns For section, select the columns you want to display in the data form. 13 Optional: Click Years to set which years the grid displays.
Note: To undo your changes since you last saved the exchange rate table, click Restore.
14 Click Save.
2 From the Exchange Rates Tables list, select the table whose exchange rates you want to modify. 3 Click Open Rate Table. 4 From the Currency list, select the destination currency you want to modify.
Note: By default, the currencies are listed by the abbreviations set up by the three character ISO currency standard.
6 Click Save.
Note: Launch the currency conversion calc script to recalculate values.
121
2 From the Exchange Rate Tables list, select the table you want to delete. 3 Do one of the following:
Right-click and select Delete Rate Table. Select Task > Delete Rate Table.
122
Chapter
7
This section describes how to work with user-defined custom dimensions, the Entity dimension, the Account dimension, and the members, attributes, and attribute values within each of the dimensions.
In This Chapter Working with Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 About Custom Dimensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 About the Entity Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 About the Account Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 About User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Adding or Editing User-Defined Custom Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Setting Dimension Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Working with Members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Working with Shared Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Working with Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Working with Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Using Attributes and Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
123
About Dimensions and Members on page 124 About Sparse and Dense Dimensions on page 124 About Dimension Hierarchies on page 125 Working with a Dimension Hierarchy on page 126
Data values are not smoothly and randomly distributed throughout the database. Data values do not exist for the majority of member combinations in the database.
When these two conditions exist for any given dimension in the database, that dimension is said to be a sparse dimension. A sparse dimension is a dimension that contains a low percentage of occupied data values in each combination of dimensions that occurs. For example, a database might include the Product, Market, and Account dimensions. The Product dimension represents the product units, the Market dimension represents the geographical regions in which the products are sold, and the Account dimension represents the Account data. Because not every product is sold in every geographical region, accounts data does not exist for all products in all regions. In this case, the Account dimension is a sparse dimension. Most multidimensional databases also contain dense dimensions. A dense dimension is a dimension that contains a high percentage of occupied data values in each combination of dimensions that occur. In the previous example, if every (or nearly every) product is sold in every (or nearly every) region, then accounts data exists for almost all products in all regions. In this case, the Account dimension is a dense dimension. To optimize the performance of the database, you can designate the dimensions as sparse or dense. If a dimension is sparse, and you designate it as such, Planning searches for only those data values that are occupied in each dimension combination that occurs, and then calculates those data values. This optimizes performance by decreasing calculation time and lowering disk usage. By default, Planning designates the Account and Period dimensions as dense and
124
the remaining dimensions as sparse. You can modify these settings as the application requires. For more information about optimizing the performance of the application, see Optimizing Application Performance on page 76.
In any dimension hierarchy, members of the same level that belong to the same dimension or member are known as siblings. In the previous example, Q1, Q2, Q3, and Q4 are siblings because they are at the same level in the hierarchy, and are members of the same member: YearTotal. However, Jan and Apr are not siblings because, though they are at the same level in the hierarchy, Jan is a member of Q1 and Apr is a member of Q2. The members that belong to a particular dimension are known as the children of that dimension. This is also true of members as well. Members that belong to a particular member are known as the children of that member. In the previous example, the member YearTotal is a child of the Period dimension, the members of Q1, Q2, Q3, and Q4 are children of the member YearTotal, and the members Jan, Feb, and Mar are children of the member Q1. Conversely, Q1 is the parent of Jan, Feb, and Mar, YearTotal is the parent of Q1, Q2, Q3, and Q4, and Period is the parent of YearTotal. This is because the data values of Jan, Feb, and Mar are consolidated to produce the data value for Q1, and the data values for Q1, Q2, Q3, and Q4 are consolidated to produce the data value for YearTotal.
125
Set up or change dimension properties such as description, alias, or data storage type. Add a dimension. Search for a dimension member. Expand or collapse the dimension hierarchy. Add or edit a dimension member. Move a dimension member. Delete a dimension member.
Assign access to a dimension member. View a members ancestors. Navigate to another part of the dimension hierarchy.
Expanding and Collapsing a Dimension Hierarchy on page 127 Navigating the Dimension Hierarchy on page 127 Finding Dimensions or Members on page 128 Sorting Members on page 128 Moving Members Within the Dimension Hierarchy on page 129 Minimizing and Restoring Columns on page 130 Viewing a Members Ancestors on page 131 Determining Where Members Are Used in the Application on page 131
126
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension you want to expand. 3 Select the dimension or member you want to expand. 4 Do one of the following:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension you want to expand. 3 Select the dimension or member you want to collapse. 4 Do one of the following:
Press the Up Arrow to move to the previous member in the dimension hierarchy. If you are currently at the top of the member list and there is a previous page, you move to the last member of the previous page. Press the Down Arrow to move to the next member in the dimension hierarchy. If you are currently at the bottom of the member list and there is a next page, you move to the first member of the next page.
127
In the Page text box at the bottom of the list, enter the page of the dimension hierarchy you want to view and click Go or press Enter. Click Start to view the first page of the dimension hierarchy. Click Prev to view the previous page. Click Next to view the next page. Click End to view the last page of the dimension hierarchy.
Tip: By default, 14 members are displayed per page. You can set a smaller or larger number of
members per page by selecting File > Preferences > Display Options tab, then specifying a desired value for Show __ Members on Each Dimensions Page.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose member you want to find. 3 From the Search drop-down list, select an option to search for a name, alias or both. 4 In the Search text box, enter the name or alias of the member for which you want to search.
Note: You can enter a partial string to find a match.
Sorting Members
You can sort members in ascending or descending order, and by children or descendants. Sorting members affects the Analytic Services outline itself.
To sort members:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
128
2 From the Dimension drop-down list, select the dimension whose members you want to sort. 3 On the Dimensions tab, select the members whose children or descendants you want to sort. 4 From the Sort drop-down list, select whether you want to sort the Children or Descendants.
Sorting by children affects only the members in the level immediately below the selected member. Sorting by descendants affects all the descendants of the selected member.
5 Click
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose members you want to move. 3 On the Dimensions tab, select the member or branch you want to move. 4 Do one of the following:
Click Click
to move the member up one position. to move the member down one position.
To move members, including parents and their children, within the dimension hierarchy:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose members you want to move. 3 On the Dimensions tab, select the member or branch that you want to move.
129
4 Click Cut or type Ctrl + X. 5 Place the cursor on the destination level under which you want to move the members. 6 Click Paste or type Ctrl + V. 7 When prompted to confirm the move, click OK.
Note: After moving members within the dimension hierarchy, you must update and validate business rules, reports, and Hyperion Application Link Adapter processes.
It remembers a cut member even if you expand, collapse, sort, search, or change pages in the dimension hierarchy. It also remembers a cut member if you add a child or sibling member, edit or delete a member, assign access to a member, or click the View link. It does not remember a cut member if you add or edit a dimension, navigate to a page other than the Dimensions tab, delete the member, or log off Planning. It is not available for root dimension members.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the column you want to minimize or restore. 3 Take one of the following actions:
To minimize a column, double-click its column heading, or right-click it and select Minimize. To return a column to its original width, double-click any minimized column heading, or right-click it and select Restore. To restore all previously minimized columns to their original widths, right-click a column heading and select Restore All.
Note: Because each dimension page displays different columns, Planning saves column widths for each dimension independently. Column widths are saved for the duration of the session whenever you add, edit, or delete a dimension member, or whenever you select another dimension using the Dimension drop-down list.
130
Select Administration > Dimensions. Select File > New > Dimension Member.
2 On the Dimensions tab, from the Dimension drop-down list, select the dimension whose members
ancestors you want to view.
3 Select the member in the dimension hierarchy. 4 Click Show Ancestors. 5 When you are done viewing the information, click Close.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 On the Dimensions tab, from the Dimension drop-down list, select the dimension whose members usage
you want to view.
3 Click Show Usage. 4 From the drop-down list at the bottom of the Member Usage window, select where in the application you
want to view the member's usage.
The drop-down list choices are appropriate for the dimension member selected. For example, if you selected a currency member, the drop-down list includes Data Forms, Exchange Rates, Entity, and Triangulation Currencies.
5 Click Go. 6 When you are done viewing the information, click Close.
131
You use the Entity dimension to model the flow of planning information in your organization and establish a plan review path. You use the Account dimension and user-defined dimensions to specify the data you want to gather from planners.
Aggregation Options on page 132 Storage Options on page 132 Unmarking Members That are Pending Deletion on page 135
Aggregation Options
You can define calculations within dimension hierarchies using aggregation options. Aggregation options determine how values of child members are aggregated to the parent member. The following is a list of available aggregation options:
For example, Sales and COGS may be children of the member Net Income. If you set the aggregation option for the Sales member to addition and the aggregation option for COGS to subtraction, then the aggregated value for the Net Income member represents the Sales member minus the COGS member.
Storage Options
To optimize performance and disk usage, you can select from several storage and calculation options for dimension members. The following table describes the available options:
Table 28
Storage Options Impact Calculates the data values of the member, then stores these values. See Dynamic Calc Versus Dynamic Calc and Store on page 133. Stores the data values of the member. See About Store Data Storage on page 134.
132
Table 28
Storage Options (Continued) Impact Calculates the data values of the member, then disregards these values. See Dynamic Calc Versus Dynamic Calc and Store on page 133. Prohibits two or more members in the same dimension from sharing data values. See About Never Share Data Storage on page 134. Allows two or more members in the same dimension to share data values. See About Shared Data Storage on page 134. Has no data associated with the member. See About Label Only Data Storage on page 134.
The Analytic Services limit is 100 children under a dynamic calc parent. Changing a member's storage option to Dynamic Calc may result in loss of data, depending on how that data was originally derived. You may need to update outlines, calculations, or both to get the dynamically calculated value.
A sparse member with a complex formula A sparse member that users retrieve frequently
For members of dense dimensions, use Dynamic Calc for your calculation. Using Dynamic Calc and Store provides only a small decrease in retrieval time, and in the regular calculation time. In addition, the disk usage is not lowered significantly. For data values that are being accessed concurrently by many users, use Dynamic Calc. In this situation, the retrieval time may be significantly lower than for Dynamic Calc and Store. You should keep the following points in mind when selecting storage options:
You should not use Dynamic Calc for base-level members for which users enter data. Data values are not saved for Dynamic Calc members. You should not use Dynamic Calc for a parent member if you enter data for that member in a target version. Parent members set to Dynamic Calc are read-only in target versions.
133
You cannot assign level 0 members as label-only. Even though a label-only member has no data associated with it, it can still display a value. Making a dimension member label-only helps minimize database space by decreasing the block size. You cannot assign attributes to label-only members. In multi-currency applications, you cannot apply the label-only storage option to members of the following dimensions: Entity, Versions, Currencies, and user-defined custom dimensions. To store exchange rates, these members should remain Never Share. The Data Storage option for children of label-only parents is set to Never Share by default.
Caution! Do not design a data form in which a label-only parent follows its first child member, because
you will not be able to save data in the first child member. Instead, set up the data form with the label-only parent selected before its children or omit selecting the label-only parent for the data form.
134
Deleting them from Planning Unmarking them for deletion and then exporting them to Shared Services so they exist in both places. (For more information on using Shared Services, see Chapter 10, Managing Shared Services Models.)
Members that are marked for delete are preserved and their associated data remains intact until you specifically delete the members. You can also unmark members set for deletion by resetting the property value. Some points to know about the marked for delete state:
The Dimensions tab indicates with icons which members are marked for deletion:
indicates that the member is marked for deletion. indicates that the member is marked for deletion because its ancestor is specifically marked for deletion.
When a parent member is marked for delete, its descendants are also marked for deletion. However, when a base member is marked for delete, any associated shared members are not marked for deletion. Members that are marked for deletion (and their descendants) behave like other members. For example, you can modify, move, sort, and search for members that are marked for delete, and you can select them when creating a data form or working with planning units. When using Shared Services, you can see which members are marked for deletion, or out of sync between Planning and Shared Services. You must resolve these inconsistencies before you import metadata. Deleting a member that is marked for deletion follows the same rules as deleting any other member. For example, deleting a parent also deletes its children and any associated shared members. For more information on deleting members, see Deleting Members on page 152. Differences in dimension hierarchies between Planning and Shared Services do not matter when dimension members names are compared. A dimension member that is renamed in Shared Services is considered a new member and not a duplicate of its previously named counterpart in Planning. Thus, when the model is imported from Shared Services to Planning, the renamed dimension member is imported and not marked for deletion.
135
Attribute members can be marked for deletion. Year and Period dimension members are not marked for deletion. If you import Year or Period dimension members from Shared Services, members that exist in Planning but not in Shared Services are not deleted during the import.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 On the Dimensions tab, from the dimensions drop-down list, select the dimension with whose member you
want to work.
3 Click Edit. 4 On the Member Properties tab, clear the Marked for Delete check box. 5 Click Save.
To unmark a large number of members, you use the Manage Members Marked for Delete page.
3 At the Manage Members Marked for Delete dialog box, from the dimensions drop-down list, select the 4 Click Go. 5 Take any of the following actions:
To select members individually, select the check box by the members name and then click Unmark. To select all the marked members, select the check box next to the Select Members to Unmark title and click Unmark. To unmark all the listed members, click Unmark All. To view the member in the dimension hierarchy on the Dimensions tab, click the members name. To view the Custom Attribute page, click on the attribute members name.
6 Click OK to confirm the unmarking. 7 Click Cancel to close the Manage Members Marked for Delete page.
136
Entity Members and Plan Types on page 137 Base Currency on page 138
137
Base Currency
If the application is set up for currency conversion, you specify a base currency for each entity member. The default base currency for all entity members is the currency you specify when you create the application using the Setup Assistant. For example, if U.S. Dollars is the default currency, you may specify Yen as the base currency for the Japan entity and U.S. Dollars for the United States entity. When you display a data form that has values on it for the Japan entity and the data forms display currency is set to U.S. Dollars, the values are converted to U.S. Dollars per the rates in the exchange rate table (this example assumes that Yen is the local currency and U.S. Dollars is the reporting currency).
Account Members and Plan Types on page 138 Account Types on page 139 Saved Assumptions on page 142 Data Type and Exchange Rate Type on page 143
138
You can also add accounts by performing a bulk load using Hyperion Application Link. For more information about bulk loading accounts, see Loading Members and Data on page 177.
Account Types
The account type defines an accounts time balance, or how an accounts value flows over time. It also determines the accounts sign behavior for variance reporting with Analytic Services member formulas (that is, whether the account is treated as an expense that gets subtracted from the budgeted amount or whether the account is treated as a non-expense where the budgeted amount is subtracted from the actual amount). With certain time balance properties, you can also set whether database calculations include or exclude missing or zero values. See the following topics
Examples of How Account Types are Used on page 139: Summary of Account Types on page 140 Time Balance Property on page 140 Account Types and Variance Reporting on page 141 Setting Account Calculations for Zeros and Missing Values on page 141
Using Account Types Purpose Represents a cost of doing business. For example, when you plan your budget for travel expenses, you may have account members for sales trips, trade shows and seminars. Represents a source of income. For example, when you receive revenue from the sales of different products, you may have separate account members for each product. Represents a resource that belongs to your company. For example, when you plan accounts receivable, you may have separate account members for each customer. Both represent a residual interest or a single outside obligation to an outside creditor. Represents the planning assumptions that you make. Examples include floor space, headcount, rates, prices, and so on. Saved assumptions enable you to centralize your planning assumptions to ensure consistency across the application.
Account Type Expense Revenue Asset Liability and Equity Saved assumption
139
Summary of Account Types Time Balance Flow Flow Balance Balance Balance User-defined Variance Reporting Non-Expense Expense Non-Expense Non-Expense Non-Expense User-defined
The variance reporting and time balance settings are predefined for all account types except the Saved Assumption type, which is user-defined.
Time Balance Properties Description Uses an aggregate of all of the data values for a summary time period as a total for the period. Example Jan: 10 Feb: 15 Mar: 20 Q1: 45 Jan: 10 Feb: 15 Mar: 20 Q1: 10 Jan: 10 Feb: 15 Mar: 20 Q1: 20 Jan: 10 Feb: 15 Mar: 20 Q1: 15 Jan: 10 Feb: 15 Mar: 20 Q1: 15
First
Uses the beginning data value in a summary time period as the total for the period.
Balance
Uses the ending data value in a summary time period as the total for the period.
Average
Uses an average for all the child values in a summary time period as a total for the time period.
Uses a weighted daily average, based on the actual number of days in a year. This accounts for leap year, in which February has 29 days. In the example, the average for Q1 is calculated as follows: (1) Multiply the value for each month in Q1 by the number of days in the month, (2) Sum these values, and (3) Divide the total by the number of days in Q1. Assuming it is a leap year, the result is calculated as follows: (10 * 31 + 15 * 29 + 20 * 31) / 91 = 15
140
Table 31
Time Balance Properties (Continued) Description Uses a weighted daily average, based on 365 days in a year, assuming that February has 28 days. This does not account for leap years. In the example, the average for Q1 is calculated as follows: (1) Multiply the value for each month in Q1 by the number of days in the month, (2) Sum these values, and (3) Divide the total by the number of days in Q1. Assuming it is not a leap year, the result is calculated as follows: (10 * 31 + 15 * 28 + 20 * 31) / 90 = 15 Example Jan: 10 Feb: 15 Mar: 20 Q1: 15
Note: You can use the Weighted Average - Actual_Actual and Weighted Average - Actual_365 time balance properties only with a standard monthly calendar that rolls up to four quarters.
For information on how Planning calculates and spreads data with the different Time Balance settings, see the Hyperion System 9 Planning Users Guide.
Expense - The actual amount is subtracted from the budgeted amount to determine the variance. Non-Expense - The budgeted amount is subtracted from the actual amount to determine the variance.
Effect of Skip Options When Time Balance is Set to First Description Indicates that zeros and #missing values are considered when the parent value is calculated. This is the default. In the example, the value of the first child (Jan) is 0, and zeros are considered when the parent value is calculated, so the value for Q1 is 0. Excludes #missing values when calculating parent values. In the example, the value of the first child (Jan) is #missing, and #missing values are not considered when the parent value is calculated, so the value for Q1 is the value of the second child (Feb), or 20. Example Jan: 0 Feb: 20 Mar: 25 Q1: 0 Jan: #missing Feb: 20 Mar: 25 Q1: 20
Missing
141
Table 32
Effect of Skip Options When Time Balance is Set to First (Continued) Description Excludes zero values when calculating parent values. In the example, the value of the first child (Jan) is 0, and zero values are not considered when the parent value is calculated. Therefore, the value for Q1 is the value of the second child (Feb), or 20. Excludes #missing and zero values when calculating parent values. In the example, the value of the first child (Jan) is zero, and the value of the second child (Feb) is missing. Because missing and zero values are not considered when the parent value is calculated, the value for Q1 is the value of the third child (Mar), or 25. Example Jan: 0 Feb: 20 Mar: 25 Q1: 20 Jan: 0 Feb: #missing Mar: 25 Q1: 25
Saved Assumptions
Saved assumptions enable you to centralize your planning assumptions to identify key business drivers and to ensure consistency across the application. When you define a saved assumption account member, you select the appropriate time balance and variance reporting properties.
Variance reporting - For each saved assumption you create, you can determine the variance between budget data and actual data. To do so, you need to define the saved assumption as expense or non-expense. When you define a saved assumption as expense, Planning calculates the variance by subtracting the actual amount from the budgeted amount. When you define a saved assumption as a non-expense, Planning calculates the variance by subtracting the budgeted amount from the actual amount. Time balance - For each saved assumption you create, you can determine the ending value for the summary time period either by aggregating all values for the summary time period, or by using the ending value for the summary time period.
The following list contains examples of how time balance and variance reporting properties are used with saved assumption account members:
You may create a saved assumption of an expense type for variance reporting that assumes that the actual amount you spent on headcount is less than the amount you budgeted for headcount. To determine the variance, Planning subtracts the actual amount from the budgeted amount. You may make an assumption on the floor space of an office and you determine the floor space of the office for the time period by using whatever value you have for the end of the time period. You may make an assumption about the number of product units that are sold at the end of the time period. You would therefore determine the final value for the time period by aggregating the number of units sold across the range of time periods.
142
Currency - Stores and displays the account members data value in the default currency. Non-currency - Stores and displays the account members data value as a numeric value. Percentage - Stores as a numeric value and displays the account members data value as a percent.
For accounts with Currency as the data type, the following Exchange Rate types are available:
Average - Valid for any time period; uses the average exchange rate for the account. Ending - Valid for any time period; uses the ending exchange rate for the account. Historical - Valid for any time period; uses the exchange rate that was in effect for the account when, for example, the earnings for a Retained Earnings account were earned or the assets for a Fixed Assets account were purchased.
Caution! You cannot delete custom dimensions after you have created them.
User-defined custom dimensions differ from the Entity and Account dimensions in that you assign valid plan types for user-defined custom dimensions at the dimension level. You do not assign plan types to the members of a user-defined custom dimension. All members of a userdefined custom dimension are valid for the plan types assigned at the dimension level. You can also add user-defined custom dimensions by performing a bulk load using Hyperion Application Link. For more information about loading dimensions, see Importing Custom Dimension Members on page 178.
143
Select Administration > Dimensions. Select File > New > Dimension Member.
2 On the Dimensions tab, click Add Dimension. 3 Set or change the following property options:
Table 33
Properties for User-Defined Custom Dimensions Value Enter or change the name of the dimension. The name can contain up to 80 characters and must be unique across all dimensions. The dimension name cannot contain the tab, double quote , or backslash \ characters. The name cannot start with any of the following characters: \<|,=@_+-{}().
Property Dimension
Alias
Optional: From the Alias drop-down list, select an alias table. In the Alias text box, enter an alternate name for the dimension. The alias can contain up to 80 characters and must be unique across all dimensions. The alias must follow the naming conventions for dimension names, described above. Optional: Enter a description of up to 255 characters. Select the plan types for which the dimension is valid.
Note: When changing the properties of a user-defined dimension, deselecting this option for the dimension makes all the members of that dimension invalid for the plan type that was deselected.
Apply Security
Select the Apply Security check box to allow security to be set on custom dimension members. If you do not select this check box, there is no security on the dimension; that is, all users can access its members without restriction. You must select this check box before you can assign access rights to the dimension members. Select a data storage option. The default is Never Share. See Storage Options on page 132.
Data Storage
4 Click Save.
Custom Attributes is not enabled until you save the dimension.
5 When asked to confirm that you want to add a new dimension, click OK.
Note: Click Refresh to revert to the previous values on the page and keep the page open. Click Cancel to revert to the previous values on the page and close the page.
144
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension you want to set up or change. 3 Click Edit. 4 On the Dimension Properties dialog box, set the following property options:
Table 34
Dimension Properties Value Enter or change the name of the dimension. The name can contain up to 80 characters and must be unique across all dimensions. The dimension name cannot contain the tab, double quote , or backslash \ characters. The member name cannot start with any of the following characters: \<|,=@_+-{}().
Property Dimension
Alias
Optional: From the Alias drop-down list, select an alias table. In the Alias text box, enter an alternate name for the dimension. The alias can contain up to 80 characters and must be unique across all dimensions. The alias must follow the naming conventions for dimension names, described above. Optional: Enter a description of up to 255 characters. Select the plan types for which the dimension is valid. This option is not available for Entity or Account dimensions. Select the Apply Security check box to allow security to be set on custom dimension members. If you do not select this check box, there is no security on the dimension; that is, all users can access its members without restriction. You must select this check box before you can assign access rights to the dimension members. Select data storage options. See Storage Options on page 132. Select to display the available and selected attributes for dimensions with associated attributes. Selecting this option enables custom attribute display for all dimensions with attributes. Likewise, clearing it disables the display for all dimensions with attributes.
5 Click Save to save the new information to the relational database and see the changes reflected in the
dimension hierarchy.
Note: Click Refresh to revert to the previous values on the page and keep the page open. Click Cancel to revert to the previous values on the page and close the page.
145
Adding or Editing Members on page 146 Assigning Access to Members on page 149 Deleting Members on page 152 Deleting a Parent Member and Its Descendants on page 153
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose member you want to add or edit. 3 From the dimension hierarchy:
To add a child member, select the parent level of the dimension hierarchy to which you want to add a member and click Add Child. A child member displays one level below the selected member in the hierarchy. To add a sibling, select the level of the dimension hierarchy to which you want to add a sibling and click Add Sibling. A sibling member displays at the same level in the hierarchy as the selected member. To edit an existing member, select that member from the dimension hierarchy and press Enter or click Edit.
4 On the Member Properties tab, set or change the properties for the selected member:
Table 35
Member Properties Value Enter or change the member name. The name can contain up to 80 characters and must be unique across all dimensions. The member name cannot contain the Tab, double quote , or backslash \ characters. The member name cannot start with any of the following characters: \<|,=@_+-{}().
Property Name
Description
146
Table 35
Member Properties (Continued) Value Optional: From the Alias Table drop-down list, select the alias table to store the alias name. Optional: In the Alias text box, enter an alternate name for the entity member. The alias can contain up to 80 characters and requires the same naming conventions as described above for the member name. From the Account Type drop-down list, select the account type. See Account Types on page 139. If the account type is Saved Assumptions, from the Variance Reporting drop-down list, select one of the following options:
Property Alias
For Account members only: Account Type For Account members only: Variance Reporting
Expense - Designates the saved assumption as an expense account. The actual amount is subtracted from the budgeted amount to determine the variance. Non-Expense - Designates the saved assumption as a revenue, asset, liability, or equity account. The budgeted amount is subtracted from the actual amount to determine the variance.
From the Time Balance drop-down list, select one of the following options:
Flow - Uses an aggregate of all the data values for a summary time period as a total for the period. Balance - Uses the ending data value in a summary time period as the total for the period.
For Account members only: Exchange Rate Type For Account members only: Data Type Distribution
From the Exchange Rate Type, select one of the options. See Data Type and Exchange Rate Type on page 143. From the Data Type drop-down list, select a data type. See Data Type and Exchange Rate Type on page 143. Sets the weekly distribution (for example, 4-4-5, 5-5-4). Leaf Account members have the Distribution option if the corresponding option was selected when creating the application and if the base Time Period option is 12 months. See Defining the Base Time Period and Monthly Distribution Spread on page 56.
Data Storage
From the Data Storage drop-down list, select a data storage property used in building a Analytic Services cube. The default Data Storage setting for new custom dimension members (except root members) is Never Share. See Storage Options on page 132. Selecting this option causes Planning to re-calculate the data values of any members that are based on the data values of the parent member or other members.
Note: This option is available for all account and entity members with the Dynamic Calc or Dynamic Calc and Store properties.
Select the base currency for the entity member. See Base Currency on page 138.
147
Table 35
Member Properties (Continued) Value Select one or more plan types for which the member is valid. For more information about plan types, see Account Members and Plan Types on page 138 and Entity Members and Plan Types on page 137. From the drop-down list, select an aggregation option for each selected plan type. See Aggregation Options on page 132.
Note: You can select a source plan only if more than one plan type is valid for the member. Only the plan types and aggregation options for which the members parent is valid are available. If the parent is not valid for a particular plan type or aggregation option, then neither is the child member. Deselecting a plan type for either an account or entity parent member also deselects that property for all the descendents of that parent. CAUTION! Deselecting a plan type for any dimension member after data is entered into the application may result in loss of data when the application is refreshed. For an account member, data is lost if the deselected plan type is the source plan type.
Marked for Delete For Entity members only: Base Currency For Account members only: Source Plan Type
Clear to unmark the member for deletion. For more information on this option, see Unmarking Members That are Pending Deletion on page 135. From the Base Currency drop-down list, select the base currency for the entity member. Select the source plan type for the member. See Account Members and Plan Types on page 138.
Note: Because a shared member is basically a pointer to the base member and is not stored in Analytic Services, the source plan type is disabled for shared members. Note: The Source Plan Type of a shared account member displays as matching the source plan type of the base member, even though the Source Plan field is unavailable because it does not apply to shared members.
Smart Lists
Optional: Select a Smart List to associate with the member. See Working with Smart Lists on page 327.
Tip: If you do not see the new member on the current page, click Next. The number of members
per page may have been exceeded with the new member.
5 Click Save to save the new information to the relational database and see the changes reflected in the
dimension hierarchy.
Refresh the database from the Planning Desktop to make an edited member visible to planners entering data.
Assign access to it. For more information about assigning access rights to members, see Assigning Access to Members on page 149. Set up any attributes for it. For more information about using attributes and attribute values, see Working with Attributes on page 155 and Working with Attribute Values on page 159.
148
Note: After adding a member to a dimension, refresh the database. Then, to view the new member in a data form that selects the member by relationship (for example, Children), select another form on the Data Form Management page, then select the form with the new member.
About Access Rights on page 149 Adding Access on page 150 Editing Access on page 151 Deleting Access on page 151
Note: Before you can assign access to members of user-defined custom dimensions, you must first allow security to be set on it by selecting the Apply Security check box on the dimensions Property tab.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for whose members you want to assign access. 3 From the dimension hierarchy, select the member for which you want to assign access. 4 Click Assign Access.
The Assign Access page displays any existing access assignments.
149
When assigning access rights to a specific member, you can also specify an attribute that causes the children or descendants of that member to inherit its access rights. In addition, when specifying inheritance attributes, you can include or exclude the actual member from the access rights setting. The following table explains the available inheritance options.
Table 36
Access Rights Inheritance Options Result The access right is assigned only to the currently selected member. The access right is assigned to all children members in the level below the currently selected member. The access right is assigned to the currently selected member and all children members in the level below it. The access right is assigned to all descendant members below the currently selected member. The access right is assigned to the currently selected member and all descendant members below it.
Adding Access
The Add Access page lets you specify which users and groups can access the selected member.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for whose member you want to add access. 3
Click Assign Access.
4 Click Add Access. 5 Optional: To get the latest set of users and groups from the User Management Console, click Refresh
Users and Groups.
6 From the Users and Groups list on the Add Access dialog box, select the users and groups you want to
have access to the selected member.
7 For the selected member, select the type of access you want to assign to the users or groups.
Read - Permits read access to this particular member for the user or group. Write - Permits read and write access to this particular member for the user or group. None - Prevents access to this particular member for the user or group.
150
Editing Access
Tip: You can quickly access the Edit Access page for a member by clicking View in the Security
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for whose member you want to add access. 3
Click Assign Access. User/Group Lists.
4 Optional: To get the latest set of users and groups from the User Management Console, click Refresh 5 Click Edit Access. 6 For the selected member on the Edit Access dialog box, select the type of access you want to assign to the
displayed users or groups.
Read - Permits read access to this particular member for the user or group. Write - Permits read and write access to this particular member for the user or group. None - Prevents access to this particular member for the user or group.
Deleting Access
To remove access rights for a member:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for whose member you want to remove access. 3
Click Assign Access.
151
4 On the Assign Access dialog box, from the Users and Groups list, select the users and groups for whom
you want to remove access to the selected member.
5 Click Remove Access. 6 When you are prompted to confirm the deletion, click OK. 7 Click Close.
Deleting Members
Caution! Each data value is identified by a set of dimension member values and a plan type. Deleting any
of the dimension members or deselecting the plan type results in loss of data when the application is refreshed. Deleting an entity member also deletes all planning units (including data) that are associated with it.
Before you delete a member, you should understand where in the application it is currently used (in which data forms, planning units, exchange rates, and so on). The Show Usage button on the Dimensions tab provides this information. See Determining Where Members Are Used in the Application on page 131. You must delete the entity member throughout Planning before deleting it from the Dimensions tab. For example, if the entity member you want to delete is used in a data form, you must delete it from the data form before deleting it from the Dimensions tab.
Tip: When deleting a large subtree of entities, you can greatly improve the performance of the delete
operation if the planning units for the subtree are excluded (by excluding the root member) for all scenarios and versions, before executing the delete. See Starting the Review Process on page 286.
To delete a member:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose member you want to delete. 3 From the dimension hierarchy, select the entity member you want to delete. 4 Click Delete or press Delete.
Note: Deleting a base member also deletes its shared members.
152
of the dimension members or deselecting the plan type results in loss of data when the application is refreshed.
To delete a parent member and all its descendants from the dimension hierarchy:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension whose member and descendants you want to
delete.
3 Select the member whose branch you want to delete. 4 Click Delete. 5 When you are prompted to confirm the deletion, click OK.
153
Shared members cannot be moved to a different parent member. Rather, you must delete the shared member and re-create it under a different parent member. Shared members must be at the lowest level (which is level zero) in the hierarchy and cannot have children. (The base member, however, does not have to be a level zero.) Therefore, data can be entered to a shared member, and the value is stored with its base member. Renaming a base member renames all shared members. Shared members are displayed the same as base members in the dimension hierarchy for member selection in Business Rules and Smart View. For Business Rules, because there is no labeling distinction, selecting shared members for certain action components (for example, Copy Data) may not be applicable.
For information on creating shared members, see Creating Shared Members on page 154.
The base member cannot be the parent of the shared member. You can create the shared member anywhere else in the dimension hierarchy. You must give the shared member the same name as its base member. You can give it a different description, however. You must select Shared as the Data Storage option for the shared member.
From the security assigned directly to the base member From the security assigned at the parent or ancestor of the shared member
The existing inheritance access rights apply to shared members. The precedence order for access rights is checked at each level, first by user and then by group based on the members access right inheritance relationship. However, if there is more than one access assignment, inheritance rules are additive, so that the highest access right is applied. For more information about inheritance relationships, see About Assigning Access Rights on page 84. The following example assigns access rights to shared members by assigning access to the parent of the shared member. The security filters with the effective access described in the table below is generated only if the database is refreshed or created with both the Security and Shared Members check boxes selected in the Manage Database task on the Desktop.
154
Example Entity United States CA (base) NY West CA (shared) NV Sales Region 1 CA (shared)
Table 37
Example of Access with Shared Members Access Assignment CA (base) = None iDescendants (West) = Read Effective Access for CA Read
Case Case 1
Case 2
iDescendants (United States) = None iDescendants (West) = Read iDescendants (Sales Region 1) = Write
Write
Case 3
iDescendants (United States) = Write iDescendants (West) = None iDescendants (Sales Region 1) = Read
Write
About Attributes on page 156 Creating Attributes on page 157 Renaming Attributes on page 158 Deleting Attributes on page 158
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for which you want to define an attribute or
attribute value.
Note: Only sparse dimensions can contain attributes.
155
3 Select the top level in the dimension hierarchy. 4 Click Custom Attributes.
If the dimension you selected is not a sparse dimension, Custom Attributes is not available.
About Attributes on page 156 Working with Attribute Values on page 159 Using Attributes and Attribute Values on page 163
About Attributes
Attributes let you add another level of granularity to your data. You create attributes for a dimension when you want to group its members according to the same criterion. You then create attribute values for each attribute, which are assigned to dimension members. You can filter members by their attribute values when creating data forms and reports. For example, you may have a Product dimension with members for three product lines, some of which are sold in retail outlets and some sold only by catalog. When you are analyzing or reporting on your data, you might need separate totals for retail and catalog sales. To gather this type of information, you could define an attribute called Channel for the Product dimension, with the values Retail and Catalog. You could then assign one of these values to each of the members in the Product dimension that you need to categorize.
Note: You can assign attributes only to sparse dimensions. You cannot assign attributes to label-only members. If you need to add an attribute to a dense dimension, you must change that dimension to sparse for all plan types on the Preferences tab.
156
Because the Account dimension is usually defined as a dense dimension, you cannot assign attributes to it. If you must assign attributes to the Account dimension, change it to a sparse dimension for all plan types. Alternately, if you change a dimension from sparse to dense, all existing attributes and attribute values for that dimension are automatically deleted. For more information on changing the sparsity/density option for a dimension, see Optimizing Application Performance on page 76.
Creating Attributes
Planning allows you to create attributes at the dimension level for sparse dimensions, which are typically Entity and user-defined custom dimensions. Once you create an attribute for a dimension, you can create the values for that attribute and assign those values to dimension members.
To create an attribute:
1 Perform one action:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for which you want to create an attribute. 3 Click Custom Attributes.
Only sparse dimensions can contain attributes. If the dimension you selected is not a sparse dimension, Custom Attributes is not available. To see which dimensions are sparse, click the Performance Settings tab.
4 Above the Attributes column, click Create. 5 On the Create Attribute dialog box, in the Name text box, enter a unique name of up to 32 characters.
Note: The attribute value name cannot contain the tab, double quote , or backslash \ characters. The attribute value name cannot start with any of the following characters: \ < | , = @ _ + - { } ( ) .
The options are available only for Entity dimension attributes. If you later modify the attribute you are creating, Plan Type Options are not displayed. You cannot later change the Plan Type option you set when you create the attribute.
6 Press Enter if you have more attributes to enter; click Save when you are done entering new attributes. 7 At the Create Attribute dialog box, click Cancel.
See Working with Attributes on page 155.
157
Renaming Attributes
You can rename attributes that you have already created.
To rename an attribute:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for which you want to change an attribute.
Note: Only sparse dimensions can contain attributes.
4 From the Attributes column, select the attribute you want to rename. 5 Above the Attributes column, click Modify. 6 On the Modify Attribute dialog box, in the Name text box, enter a unique new name of up to 32 characters.
Note: The attribute value name cannot contain the Tab, double quote , or backslash \ characters. The attribute value name cannot start with any of the following characters: \ < | , = @ _ + - { } ( ) .
7 Click Save.
After changing an attribute, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes. See Working with Attributes on page 155.
Deleting Attributes
When you delete an attribute, all attribute values associated with the attribute are also deleted. The attribute values are removed from any members to which they had been assigned, and the attribute is removed from any dimensions to which it had been assigned.
To delete an attribute:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
158
2 From the Dimension drop-down list, select the dimension for which you want to delete an attribute.
Note: Only sparse dimensions can contain attributes.
4 Select the attribute you want to delete. 5 Above the Attributes column, click Delete. 6 When you are prompted to confirm the deletion, click OK.
After deleting an attribute, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes. See Working with Attributes on page 155.
Creating Attribute Values on page 159 Assigning Attribute Values to Members on page 160 Modifying Attribute Values on page 162 Deleting Attribute Values on page 162
159
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for which you want to create an attribute value.
Note: Only sparse dimensions can contain attributes.
3 Select the top level in the dimension hierarchy. 4 Click Custom Attributes.
Note: If the dimension you selected is not a sparse dimension, Custom Attributes is not available.
5 On the Manage Attributes and Values page, select the attribute for which you want to specify a value. 6 Above the Attribute Values column, click Create. 7 On the Create Attribute Value dialog box, in the Name text box, enter a unique name of up to 32
characters.
Note: The attribute value name cannot contain the tab, double quote , or backslash \ characters. The attribute value name cannot start with any of the following characters: \<|,=@_+-{}().
8 Press Enter if you have more attribute values to enter; click Save when you are done entering new attribute
values.
160
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for whose member you want to assign an
attribute value.
Note: Only sparse dimensions can contain attributes. To see which dimensions are sparse, click the Performance Settings tab.
3 In the Dimension hierarchy, select a member to which you want to assign an attribute value. 4 Click Edit.
Or, for members that are already assigned attribute values: on the Dimensions tab, the column titled Attributes displays View. Click View to change a members attribute value assignment.
Note: If the selected dimension is not a sparse dimension, Custom Attributes is not available.
5 Select the Attribute Values tab. 6 From the Attribute Values list, select the attributes values you want to assign to the member.
You can select one attribute value from each group of attributes. indicates that the attribute member is marked for deletion. See Unmarking Members That are Pending Deletion on page 135.
To assign the attribute value to the selected member: click the Add icon,
To remove an attribute value from the selected member: from the Assigned Attribute Values list, select the attribute value you want to remove and click the Remove icon, . .
To remove all attribute values from the selected member: click the Remove All icon,
8 Click Save.
Note: Click Refresh to revert to the previous values on the page and keep the page open. Click Cancel to revert to the previous values on the page and close the page.
161
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension for which you want to modify an attribute value.
Note: Only sparse dimensions can contain attributes.
3 Select the top level in the dimension hierarchy. 4 Click Custom Attributes.
Note: If the dimension you selected is not a sparse dimension, Custom Attributes is not available.
5 From the Attributes list, select the attribute that contains the attribute value you want to modify. 6 From the Attribute Values list, select the attribute value you want to change. 7 Above the Attribute Values column, click Modify. 8 On the Modify Attribute Value dialog box, in the Name text box, enter a unique name of up to 32
characters.
Note: The attribute value name cannot contain the tab, double quote , or backslash \ characters. The attribute value name cannot start with any of the following characters: \<|,=@_+-{}().
9 If the Marked for Delete property is selected, you can clear it to unmark the member for deletion. See
Unmarking Members That are Pending Deletion on page 135.
10 Click Save.
See Working with Attributes on page 155.
162
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select the dimension that contains an attribute for which you want to
delete an attribute value.
Note: Only sparse dimensions can contain attributes.
3 Select the top level in the dimension hierarchy. 4 Click Custom Attributes.
Note: If the dimension you selected is not a sparse dimension, Custom Attributes is not available.
5 From the Attributes list, select the attribute that contains the attribute values you want to delete. 6 From the Attribute Values list, select the attribute values you want to delete.
To select all the attribute values for deletion, select the check box by the Attribute Values title.
7 Above the Attribute Values column, click Delete. 8 To confirm deletion, click OK.
After deleting an attribute value, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes. See Working with Attributes on page 155.
163
When users select two or more custom attribute values from different attributes, they behave as they would in an AND statement. For example, if a user selected the option to include members with the attribute values Fortune 500 from the Customers attribute and Northeast from the Region attribute, all members with both the Fortune 500 and Northeast attribute values display. When users select a base member and an associated custom attribute member, they behave as they would in an AND statement. For example, if a user selected the North America base member and its descendants, and the user selected the Population equals 250,000 custom attribute value, all members that are both in North America and have the Population equals 250,000 attribute value display.
164
Chapter
This section describes how to create scenarios to group the application into separate plans with their own review cycles. This section also describes how to create versions, which allows for many iterations of a plan. You use the Scenario and Version dimensions to create individual plans to be reviewed and approved. Each scenario/version combination contains its own set of data for the accounts and other dimensions of each entity. After users complete data entry for an entity for a specific scenario and version, they can submit or promote the data for the entity to another user for review and approval. The intersection of entity, scenario, and version is referred to as a planning unit. Planning tracks the status of each planning unit as it moves through the review process.
In This Chapter
Setting Up Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Setting Up Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Sorting Version and Scenario Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Moving Scenario and Version Members Within the Dimension Hierarchy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
165
Setting Up Scenarios
Planning allows you to create scenarios to group data that an application uses. This section describes how to set up and maintain scenarios within a Planning application. The following table lists the tasks you can perform and links to the procedures for each task.
Task Learn more about scenarios. Create a scenario. Edit a scenario. Delete a scenario. Copy a scenario. Assign access to a scenario. Work with the Scenario dimension hierarchy. Delete supporting detail associated with a scenario. Topic See About Scenarios on page 166. See Creating a Scenario on page 167. See Editing a Scenario on page 168. See Deleting a Scenario on page 169. See Copying a Scenario on page 169. See Assigning Access to Members on page 149. See Working with a Dimension Hierarchy on page 126. See Deleting Supporting Detail Associated With a Scenario on page 319.
About Scenarios
Scenarios enable you to:
Apply different planning methods to scenarios. Create new forecasts. Enter data into scenarios. Associate different scenarios with different time periods. Associate different scenarios with different exchange rates. Assign user access rights by scenario. Report on certain scenarios. Compare and analyze different scenarios.
Creating scenarios lets you group your application into separate plans with their own review cycles. Scenarios can also cover different time spans. For example, your organization may create one-year and three-year revenue plans that are prepared by different users and follow different review paths. You could create two scenarios, Current Year Revenue and 3Year Revenue Forecast, for this purpose. When you create a scenario, you define the properties described in the following topics:
Time Periods on page 167 Exchange Rate Table on page 167 Access Rights on page 167
166
Time Periods
You assign each scenario a range of years and time periods for which it is valid. You can also specify whether or not to use the Beginning Balance time period for a scenario. When users access a data form, they can enter into that scenario only years and periods that are within the range. Years and periods outside of the range display as read-only. You can modify the time range of scenarios as needed to allow for continuous planning. For example, you may have a scenario named 3Year Forecast that has 2002 as the start year and 2004 as the end year. At the beginning of the 2003 fiscal year, you could advance the start year to 2003 and the end year to 2005. You could then enter forecast data for 2005.
Access Rights
You can specify access rights to the members of the Scenario dimension for groups or users. Access rights determine whether or not a user or group can view or modify data. A user or group can have only one of the following access rights: Read, Write, or None. However, the access rights for a user can be combined based on the groups to which that user belongs.
Creating a Scenario
To create a scenario:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Scenarios. 3 Click Add. 4 In the Scenario text box, enter a name of up to 80 characters for the new scenario. 5 Optional: In the Description text box, enter a description of up to 255 characters for the new scenario. 6 From the Start Yr., Start Period, End Yr., and End Period drop-down lists, select the time period you want
to associate with the new scenario.
7 Optional: From the Exchange Rate Table drop-down list, select an exchange rate table to associate with
the new scenario.
Note: If an application uses multiple currencies, you should associate a scenario with an exchange rate table so that currency conversions can be calculated.
Setting Up Scenarios
167
8 Optional: From the Alias Table drop-down list, select an alias table to associate with the scenario and
enter the alias description for the scenario.
9 Select the Include BegBal as Time Period option if you want to include the BegBalance time period in this
scenario for currency conversion.
10 Select the Enabled for Process Management option if you want to include this scenario in process
management.
If you select this check box, this scenario will display in the scenario drop-down list on the Check Status and Manage Process page.
11 Click Save.
Editing a Scenario
To modify a scenario:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Scenario. 3 Select the scenario you want to edit. 4 Click Edit. 5 Optional: In the Scenario text box, enter a name of up to 80 characters for the scenario. 6 Optional: In the Description text box, enter a description of up to 255 characters for the scenario. 7 From the Start Yr., Start Period, End Yr., and End Period drop-down lists, select the time period you want
to associate with the scenario.
8 Optional: From the Exchange Rate Table drop-down list, select an exchange rate table to associate with
the scenario.
Note: If an application uses multiple currencies, you should associate a scenario with an exchange rate table so that currency conversions can be calculated.
9 Optional: From the Alias Table drop-down list, select an alias table to associate with the scenario and
enter the alias description for the scenario.
10 Select the Include BegBal as Time Period option if you want to include the BegBalance time period in this
scenario for currency conversion.
11 Select the Enabled for Process Management option if you want to include this scenario in process
management.
If you select this check box, this scenario will display in the scenario drop-down list on the Check Status and Manage Process page.
12 Click Save.
168
Deleting a Scenario
When you delete a scenario, all planning units that use the scenario (including data) are deleted. You cannot delete a scenario that is used in a planning unit that has been started. Also, you cannot delete a scenario that is assigned to an axis on a data form. You first need to remove the reference to the scenario from the data form and then assign a different scenario to an axis on the data form.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Scenarios. 3 Select the scenario(s) you want to delete. At least one scenario must remain in the application. 4 Click Delete. 5 When you are prompted to confirm the deletion, click OK.
Note: After deleting a scenario, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes.
Copying a Scenario
When you select to copy a scenario, only the scenario properties are copied. The data values and access rights associated with the original scenario are not copied to the new scenario.
To copy a scenario:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Scenarios. 3 Select the scenario you want to copy. 4 Click Copy Scenario. 5 In the Copy to Scenario text box, enter a name of up to 80 characters for the new scenario. 6 Optional: In the Description text box, enter a description of up to 255 characters for the new scenario. 7 From the Start Yr., Start Period, End Yr., and End Period drop-down lists, select the time period you want
to associate with the new scenario.
8 Optional: From the Exchange Rate Table drop-down list, select an exchange rate table to associate with
the new scenario.
Setting Up Scenarios
169
Note: If an application uses multiple currencies, you should associate a scenario with an exchange rate table so that currency conversions can be calculated.
9 Optional: From the Alias Table drop-down list, select an alias table to associate with the scenario and
enter the alias description for the scenario.
10 Select the Include BegBal as Time Period option if you want to include the BegBalance time period in this
scenario for currency conversion.
11 Select the Enabled for Process Management option if you want to include this scenario in process
management.
If you select this check box, this scenario will display in the scenario drop-down list on the Check Status and Manage Process page.
12 Click Save.
Setting Up Versions
Planning allows you to create versions to group data that an application uses. This section describes how to set up and maintain versions within a Planning application. The following table lists the tasks you can perform and links to the procedures for each task.
Task Learn more about versions. Create a version. Edit a version. Delete a version. Display a version. Copy a version. Assign access to a version. Work with the Version dimension hierarchy. Topic See About Versions on page 170. See Creating a Version on page 172. See Editing a Version on page 172. See Deleting a Version on page 173. See Displaying Versions on page 174. See Copying Versions on page 174. See Assigning Access to Members on page 149. See Working with a Dimension Hierarchy on page 126.
About Versions
You use the Scenario and Version dimensions to create individual plans to be reviewed and approved. Each scenario/version combination contains its own set of data for the accounts and other dimensions of each entity. After users complete data entry for an entity for a specific scenario and version, they can submit or promote the data for the entity to another user for review and approval. The intersection of entity, scenario, and version is referred to as a planning unit. Planning tracks the status of each planning unit as it moves through the review process.
170
Versions allow flexibility in the planning process and are independent of individual scenarios. For example, if you create Best Case and Worst Case versions in the Version dimension, you can use these versions with any of the scenarios that you created. The following are some possible uses of versions:
To allow multiple iterations of a plan, for example, Preliminary and Final To model possible outcomes based on more optimistic or less optimistic assumptions, for example, Best Case and Worst Case To manage dissemination of plan data, for example, Internal and External To facilitate target settings
Workflow Tasks are not allowed for target versions. Children of target members must be blank (for example, #missing) for the data input to be allowed at the top level. Target members must be set to Store (Dynamic Calc overrides data input with sum of children).
Setting Up Versions
171
Creating a Version
To create a version:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Version. 3 Click Add. 4 In the Version text box, enter the name of the version you are adding to the application. 5 From the Type drop-down list, select the type of version for the application:
Standard Target - Displays versions whose values are entered from the parent level down. Standard Bottom Up - Displays versions whose values are entered at the lowest member level and aggregated upward. Standard bottom up versions are a dimension in a planning unit.
6 Optional: In the Description text box, enter a description of up to 255 characters for the new version. 7 Optional: From the Alias Table drop-down list, select an alias table to associate with the version and enter
the alias description for the version.
8 Select the Enabled for Process Management option if you want to include this version in process
management. If you select this check box, this version displays in the version drop-down list on the Check Status and Manage Process page.
Note: This option is not available for Target versions.
9 Click Save.
Editing a Version
You can edit an existing version to change the name of a version and the access rights assigned to the version. You can assign access rights to a version to specify which users have access to it. For example, you may want to give users read-only access to the version Final.
To modify a version:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Version. 3 Select the version you want to edit. 4 Click Edit.
172
5 Optional: In the Version text box, modify the name of the version. 6 Optional: From the Type drop-down list, modify the type of version for the application:
Standard Target - Displays versions whose values are entered from the parent level down. Standard Bottom Up - Displays versions whose values are entered at the lowest member level and aggregated upward. Standard bottom up versions are a dimension in a planning unit.
7 Optional: In the Description text box, enter a description of up to 255 characters for the edited version. 8 Optional: From the Alias Table drop-down list, select an alias table to associate with the version and enter
the alias description for the version.
9 Select the Enabled for Process Management option if you want to include this version in process
management.
If you select this check box, this version displays in the version drop-down list on the Check Status and Manage Process page.
Note: This option is not available for Target versions.
10 Click Save.
Note: After modifying a version, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes.
Deleting a Version
You cannot delete a version that is used in a planning unit that has been started. Also, you cannot delete a version that is currently assigned to an axis on a data form. You must first remove the reference to the version from the data form and then assign another version to an axis on the data form. At least one version must remain in the application.
Select Administration > Dimensions. Select File > New > Dimension Member.
2 From the Dimension drop-down list, select Versions. 3 Select the version(s) you want to delete. 4 Click Delete. 5 When you are prompted to confirm the deletion, click OK.
Note: If a planning unit has been started, you cannot delete a version that is associated with it.
Setting Up Versions
173
Note: After deleting a version, you need to update and validate business rules, reports, and Hyperion Application Link adapter processes.
Displaying Versions
To view different types of versions:
1 Perform one of the following actions:
Select Administration > Dimensions. Select File > New > Dimension Member.
3 In the Display drop-down list, select the version types you want to display.
Select Standard Target to display versions whose values are entered from the parent level down. Select Standard Bottom Up to display versions whose values are entered at the lowest member level and aggregated up.
Copying Versions
You can use the Copy Version page to copy data from one bottom-up or target version of a selected scenario to another bottom-up or target version within the same scenario. You can copy between bottom-up and target versions, but keep in mind the following:
When you copy to a bottom-up version, only selected level zero entities are copied. When you copy to a target version, all selected entities are copied.
For example, you can create a Best Case version and then copy some or all of the data in that version to a Worst Case version to quickly create a starting point for the new version.
To copy a version:
1 Select File > Workflow > Copy Version. 2 In the Scenario drop-down list, select the scenario you want to copy. 3 In the Copy From drop-down list, select the version from which you want to copy data. 4 In the Copy To drop-down list, select the version into which you want to copy data. 5 Click Go.
Note: The entities for the selected version display in the Available Entities list.
6 In the Available Entities list, select the entities to which you want to copy data.
174
Note: The Available Entities list displays only the entities to which you have write access.
7 Click > to add the selected entity to the Selected Entities list or click >> to add all of the entities in the
Available Entities list. Click < to remove a selected entity from the list, or click << to remove all entities from the list.
8 Repeat steps 6 and 7 until the Selected Entities list is complete. 9 Optional: To copy any comments or annotations that are associated with accounts, select the Copy
Account Annotations check box.
10 Optional: To copy any supporting detail that is associated with versions, select the Copy Supporting Detail
check box.
Note: Only annotations for selected entities are copied. If you are copying to a bottom-up version, only level zero entities and their annotations are copied.
. .
175
To move the member up one position, click To move the member down one position, click
. .
176
Chapter
9
This section describes how to populate Planning applications with members and data from external systems.
In This Chapter Importing Custom Dimension Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Using Hyperion Application Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Sorting Members Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
177
178
Using Flow Diagrams on page 179 Using the Hyperion Planning Adapter on page 180 Using the Hyperion Essbase Adapter on page 182 Using the Flat File Adapter on page 184 Connecting Ports on page 185 Running an Adapter Process on page 186
179
Flow Diagram Workspace Function These are the active elements of an adapter process. Each adapter represents a specialized task or tasks within the adapter process where it is used. Adapters are reusable objects that can be utilized multiple times in an adapter process, or in multiple adapter processes. These indicate the specific task that the adapter performs, such as read data from a file or write data to a file. These are the places on the adapters where you attach connections. Ports can receive data from other adapters, send data to other adapters, or both. The ports on the Planning adapter represent the member properties. They can receive data from other adapters, but cannot send data. These are the communication paths between adapters and are used to exchange data between adapters. This displays the adapters that are available for use. You can then drag any available adapter from the Adapter Palette to the Flow Diagram Workspace.
Element Adapters
Methods Ports
180
4 Enter the name of the Planning Web server and click OK. 5 When you connect to the server, the Logon to Planning dialog box displays. From the Applications dropdown list, select the Planning application.
Note: The Properties dialog box for the Hyperion Planning Adapter displays with the Data Source tab selected. The Data Source tab shows the server and application to which you are connected.
6 Select the General tab and enter the name for the adapter, or accept the default. 7 Select the Methods tab. 8 From the Dimension drop-down list, select the dimension for which you want to load members. 9 If the source from which you are importing is not sorted in parent/child order, select Sort in Parent/Child
Order.
181
11 Specify the locations for the errors and exceptions files or accept the defaults. 12 Click OK.
Note: The Hyperion Planning Adapter is now added to the flow diagram workspace.
Loading Data
Use the Data Load page to define the data to load directly into an Analytic Services database using the Planning Adapter. This data load is in addition to the regular metadata load in Hyperion Application Link.
3 From the Available Driver Dimensions drop-down list, select the dimension to which you are loading data
in an Analytic Services database.
4 Select the members of the driver dimension to which you want to load data values.
These members become ports in the Planning Adapter.
5 Click Save.
To review your driver member settings, select a data load dimension and driver dimension, then click Go. For more detailed information about using the Hyperion Planning Adapter, see the Hyperion Planning Adapter Online Help.
182
Also, you may find that you use Analytic Services for analysis of sales. The Hyperion Essbase Adapter supports loading values to Planning. You can then use these values in a Planning application for forecasting, budgeting, and projections. For more detailed information about using the Hyperion Essbase Adapter, see the Hyperion Essbase Adapter Online Help.
3 The Logon dialog box displays and you must perform the following tasks:
In the Server text box, enter the name of the Analytic Services server. In the Application text box, enter the name of the Analytic Services application. In the User text box, enter your user name. In the Password text box, enter the password that corresponds with your user name. Click Login.
4 The system verifies the logon information and, if valid, logs on to the Analytic Services application. The
Data Source tab in the Properties dialog box displays by default.
5 From the Database drop-down list, select a Analytic Services database to use in the adapter process.
Note: You cannot change the database once you select it.
6 Click OK.
183
The value in the HSP_Rates dimension should be HSP_InputValue for the actual data entry. The second line for HSP_InputCurrency represents the code that is assigned to the currency in the relational store to allow for currency overrides. The code is numeric as Analytic Services cannot accept alpha characters in the data cells. Then you can run a currency conversion calculation script to populate reporting currency values in the database.
A load file can contain members for only one dimension. Parent members must display before children members, unless the Sort in Parent/Child option is selected. For example, if the Fixed Assets account is the parent of the Land account, then Fixed Assets must display before the Land account in the load file. If a parent is not included, the members are imported as children of the root parent. For example, in the Account dimension they would be imported as children of the member Account. If the field or column names in the text file match the port names in the Hyperion Planning Adapter, they can be automatically connected to the ports. If the names do not match, you must manually connect them to the ports.
184
If a field exists in the load file, but you do not connect it to a port on the Hyperion Planning Adapter, the members for that field are not loaded. The Valid for Consolidations, Two Pass Calculations, Distribution, and Plan Type properties take a binary value. A value of 1 turns the options on and a value of 0 turns the options off.
3 Enter the name and path of the text file you want to load, or click the Browse button to select a file. 4 Select the Methods tab. 5 Select the Reader method if it is not already selected. 6 Select the Format tab. 7 Select Fixed Length or Delimited as the File Type. 8 If you selected Delimited as the File Type, select a delimiter from the Delimiters options. 9 Select the Fields tab. 10 If the first line of the file contains field headers, select the First Line for Field Names option. 11 Click File Preview and select Grid View to make sure that the data source file is correct. 12 Click OK.
Note: The Flat File Adapter is now added to the flow diagram workspace.
Connecting Ports
There are two ways to connect ports: quick connect and manual connect. When you use quick connect, VBIS finds all ports with names that match and establishes connections between them. You use the manual connect to connect ports that do not have matching names. You can mix the connections methods.
185
2 Drag the mouse to the quick connect circle of the adapter to which you want to connect.
Connection lines display between all ports with matching names.
2 Drag the mouse to the appropriate port of the adapter to which you want to connect.
A connection line displays between the two ports.
Importing Data
You can load data values into the Planning application from external systems. For example, you can load data for actuals from the ERP system so that you can calculate variances. Or, you may have an existing Analytic Services database (for example, operational analysis) from which you want to load historical or current data into a Planning application You use Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2 or Hyperion Essbase Adapter to load files that have been extracted from external systems. Data load files must meet the following requirements:
Each data point must be tagged with a member from each dimension. Data must be for bottom level members, unless you are loading into a target version. Data must be scanned from the top of the file and from left to right. Each field in a record must be separated by spaces, tabs, new lines, or carriage returns.
186
A member name or alias must be enclosed in double quotes if it contains blanks, numeric characters, dashes, or unary operators. It must also appear exactly as it does in the outline. Members from the same dimension must be in the same column or row. Members from different dimensions can be together only on the page header. They cannot be mixed in any other rows or columns.
Loading Data on page 182 Loading from Essbase Administration Services on page 187 Data Load File Example on page 188
2 Follow the instructions in the Analytic Services documentation for connecting to the server and then
entering a username and password.
3 Minimize the Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic
Services 9.2.
4 Select Start > Programs > Windows NT Explorer. 5 Browse to the directory that contains the data files you want to load. 6 Select the text files that you want to load and drag those files onto Essbase Administration Services for
Essbase 7/Analytic Administration Services for Analytic Services 9.2 on the Windows Task Bar at the bottom of the screen. Hold the mouse there until Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2 maximizes.
7 Continue holding the mouse and drag the files onto the Essbase Administration Services for Essbase
7/Analytic Administration Services for Analytic Services 9.2 window, then release the mouse.
8 Follow the instructions in the Analytic Services documentation for selecting the application to which you
want to load the data files.
9 Select the database to which you want to load the data files.
Note: Select the database that corresponds to the plan type in the Planning application into which you selected to load the data.
Importing Data
187
If a dimension uses the same value for all rows, you can place it in the header as a page dimension, as in the following example:
ACTUAL EUROPE ASIA EUROPE ASIA FINAL GROSS SALES NET INCOME NET INCOME GROSS SALES JAN FEB FEB JAN 2001 2001 2001 2001 150 150 110 200
To use the SortMember.cmd utility, launch the SortMember.cmd utility from the
Utils directory, using the following syntax:
SortMember <servername> <username> <password> <application> <member> <children|descendants> <ascend|descend>
Table 39
SortMember Utility Parameters Explanation The server name on which the Planning application resides. If the application resides on a remote server, the HspJsHome.properties file used by SortMember.cmd must contain the appropriate remote server references for this application. For information on locating the properties file, see Default Location of the Properties File on page 45.
Parameter
<servername>
The name of the Planning administrator The Planning administrator password The name of the Planning application that contains the dimension members to sort
188
Table 39
SortMember Utility Parameters Explanation The parent member whose children or descendants you want to sort Whether to sort by children or descendants Sorting by children affects only the members in the level immediately below the specified member. Sorting by descendants affects all the descendants of the specified member.
Parameter
<member> <children|descendants>
<ascend|descend>
For example:
SortMember localhost admin password BUDGET account200 descendants ascend
Note: If the application server, HBR Service, or Hyperion RMI service is running when the SortMember utility is launched, you might see some java.rmi or Port already in use:11333 errors. They do not affect the functionality of this utility.
189
190
Chapter
10
In This Chapter
This chapter explains Shared Services (formerly called Hyperion Hub) models as they are shared between multiple Hyperion products. This chapter contains the following topics:
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 About Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Registering Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 About Managing Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 About Sharing Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 About Sharing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Working with Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Working with Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Sharing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
191
Overview
Shared Services enables multiple applications to share information within a common framework. The following table lists the high-level tasks that you can perform with Shared Services.
Task Managing Models Sharing Metadata Sharing Data For Information About Managing Models on page 194 About Sharing Metadata on page 195 About Sharing Data on page 195
About Models
Shared Services provides a database, organized into applications, in which applications can store, manage, and share metadata models. A model is a container of application-specific data, such as a file or string. There are two types of models; dimensional hierarchies such as entities and accounts, and nondimensional objects such as security files, member lists, rules, scripts, and Web forms. Some Hyperion products require that models be displayed within a folder structure (similar to Windows Explorer). Folder views enable the administrator to migrate an entire folder structure or a portion of a folder structure easily using Shared Services. The process of copying a model or folder from a local application to Shared Services is known as exporting. The process of copying a model or folder from Shared Services to a local application is known as importing.
Prerequisites
Shared Services supports external directories for user authentication. To use Shared Services functionality, you must configure Planning to use external authentication.
Note: After installing Shared Services, you must configure external authentication. For more information about installation and configuration of Shared Services, see the Hyperion System 9 Shared Services Installation Guide.
Registering Applications
Before you can use Shared Services, you must register your product with Shared Services using the Configuration Utility. For more information about using the Configuration Utility to register your product with Shared Services, see the Hyperion System 9 Planning Installation Guide.
192
Before you can use Shared Services with a Hyperion Planning application, you must register the application so that Hyperion Planning knows where to find Shared Services. Links to Shared Services display on the Planning Administration menu only after you register a Planning application with the Shared Services.
The hostname can include a domain, but the domain is not required if the server can resolve the hostname to the Shared Services server using other means. For example:
http://product:8000
or
http://finserv.hyperion.com:8080 Note: Even if Shared Services and Planning are running on the same server, you should not register the Shared Services URL as localhost:<port#>. Instead, you should use the DNS-listed hostname for that server, such as shareserver:8080.
6 Click Save.
Registering Applications
193
Assign Application to Project Options Description Creates a text box into which you enter the name of the new Project you want to create in the User Management Console. When you click Submit, the current application name is displayed under the new Project name in the User Management Console.
Note: This option is available only if you are have the Project Manager role in Shared Services.
Existing Projects
Enables you to select from the drop-down list an existing project to which you want the current application assigned. When you click Submit, the current application name is displayed under the Project you selected. Leaves the current application as unassigned in the User Management Console. The current application name is displayed under the Unassigned Applications folder in the User Management Console.
Unassigned Project
Version tracking Access control Synchronization between models and folders in the application and corresponding models and folders in Shared Services Ability to edit model content and set member properties of dimensional models Ability to rename and delete models
Users must be assigned the Manage Models user role to perform the preceding actions on Shared Services models.
Note: The Manage Models user must have Manage permission for a model via the Shared Services Model Access window in order to assign permissions to it.
See Working with Models on page 200 for detailed information about models. For more information about assigning user roles, see the Hyperion System 9 Shared Services User Management Guide available on the Hyperion Download Center.
194
Assign access to integrations Create an integration Edit an integration Copy an integration Delete an integration Create a data integration group View (including filtering the view of) an integration
To view and run Shared Services data integrations, users must be assigned the Run Integrations user role. As a Run Integrations user, you can perform the following actions on data integrations:
View (including filtering the view of) an integration Run, or schedule to run, an integration Run, or schedule to run, a group integration
Before data can be moved between applications, the models for both the source and destination application must be synchronized between Shared Services and the product.
195
See Sharing Data on page 226 for details about moving data between applications. For more information about assigning user roles, see the Hyperion System 9 Shared Services User Management Guide available on the Hyperion Download Center.
Track model versions Control access to models Edit member properties in dimensional models Synchronize models between the application and Shared Services
See Working with Models on page 200 for detailed information about how to manage models.
196
3. App1 designates specific models for sharing. When a model is shared, it is available for use with other applications. 4. App2 selects the Common.Shared application (the same application that is shared by App1). 5. App2 selects models in the shared application. The shared models are displayed in the Model Listing view for App2. An application that is shared can contain both private models and shared models in the Model Listing View. Private models are for the exclusive use of the individual application. Shared models are available to any application that shares the same shared application. Filters enable you to designate which part of a shared model to use in an application. In this way, you can share models with other applications if the models share a core set of common members; the models are not required to be identical. When you import a shared model, the filter removes members that you have not designated as common. See Filtering the Content of Models on page 215 for information on creating filters.
Figure 2
197
Creating Applications
Shared Services enables you to create a shared application. Shared Services provides one shared default application called Common. Should additional shared applications be needed, they must be created by application users or administrators.
The maximum length is limited to 80 characters regardless of the application in which you are working. Names are not case sensitive. All alphanumeric and special characters can be used, with the exception of the forward slash (/) and double quotation () characters.
Deleting Applications
You need Manage permission on an application to delete an application.
Note: Users must have the appropriate product-specific user roles to delete an application. For a listing of product user roles, see the appropriate product-specific appendix in the Hyperion System 9 User Management Guide.
To delete an application:
1 Select Administration > Manage Projects. 2 If it is not already selected, select the Browse tab.
Ensure that each of the applications currently using the shared application are no longer sharing access to the application that you want to delete.
198
3 Select the application to delete and click Delete. 4 Click OK to confirm deletion of the application.
Sharing Applications
To be able to share models with other applications, you must share a private application with a shared application in Shared Services. Figure 3 shows a sample Select Shared Application window.
Figure 3
3 Select the application with which you want to share. 4 Click Share to begin sharing the application with the shared application that you specified.
After you have set up access to a shared application, you can designate models to be shared. See Sharing Models on page 213. You can stop sharing access to a shared application at any time. When you do so, models that are shared with the current application are copied into the application.
3 Select the application with which you want to stop sharing. 4 Click Stop Share to stop sharing with the designated application.
199
Figure 4
Note: If the current application is new, the view might not show models. Application models are displayed in the Browse tab after you explicitly export them to Shared Services. See Synchronizing Models and Folders on page 201 for information.
All models are displayed in ascending order. The Manage Models Browse tab provides information about each model in Shared Services:
Model name Model type Last time the model was updated Whether the model is locked and who locked it If a filter is attached to the model and whether the filter is enabled: indicates a filter that is enabled indicates a filter that is disabled
200
You can see only the models to which you have at least Read access. If you do not have access to a model, it is not displayed in the Manage Models Browse tab. Icons indicate where models are located: indicates a private model indicates a shared model Some Hyperion products require that models be displayed within a folder structure (similar to Windows Explorer). Folder views enable the administrator to migrate an entire folder structure or a portion of a folder structure easily using Shared Services. Folders are visible on the Manage Models Browse tab, Manage Models Sync tab, and Manage Models Share tab. Path information for folders is displayed directly above the column headers and path text is hyperlinked to refresh the page within the context of the selected folder. Icons indicate where folders are located: indicates a private folder indicates a shared folder From the Manage Models Browse tab, you can perform any of the following operations:
View and edit members and member properties in dimensional models. See Viewing and Editing Model Content on page 207. Filter content that is imported to an application from a shared model. See Filtering the Content of Models on page 215. Compare the latest application version of a model to the latest version stored in Hyperion Shared Services. See Comparing Models on page 205. Track model history. See Tracking Model History on page 217. View model properties. See Viewing and Setting Model Properties on page 224. Rename models. See Renaming Models on page 212. Delete models. See Deleting Models on page 212.
You can synchronize the Shared Services version of a model with the application version, by importing the model from Shared Services to the application, or by exporting the model from the application to Shared Services. To do so, select the Manage Models Sync tab. See Synchronizing Models and Folders on page 201. You can share a model with other applications. To do so, select the Manage Models Share tab. See Sharing Models on page 213.
201
When the latest version of a model resides in both the Planning application and in Shared Services, the Planning application and Shared Services are said to be synchronized, or in sync, with regard to that model. If a model is out of sync, you can synchronize it by importing the model to the application or exporting the model to Shared Services, depending on where the latest version resides. You need Write permission to synchronize a model.
Note: Models within folders can also be synchronized using the Shared Services sync operation. If a folder is selected, then all models within that folder and within any subfolders will be synchronized.
Figure 5
The Sync Preview window lists all models and folders in Shared Services and in the Planning application. The Sync Operation field provides a recommended operation to apply to each model or folder. For more information about sync operations, see Sync Operations on page 203.
3 Optional: For models with Select Sync Operation, you can compare the latest version of the model in
Shared Services to the model in the application by clicking the Compare button. Before clicking Compare, you must select a Sync Operation in the drop-down list box.
The latest version of the model in Shared Services is compared to the latest version in the application. The contents of the two models are shown line-by-line in a side-by-side format. Hub Version refers to the model in Shared Services. Application Version refers to the model in the application. For information on resolving differences between the models, see Comparing Models on page 205. After you resolve the differences in a model, you are returned to the Sync Preview page.
202
6 Click Report to see a report of the operations that have been completed. 7 Click Refresh to update the message. 8 Click Close to return to the Sync Preview window.
Sync Operations
The Sync Preview window lists all models in Shared Services and in the application. The Sync Operation field provides a recommended operation to apply to each model, as follows:
If a model exists in the application but not in Shared Services, the sync operation is Export to Hyperion Hub. You cannot change this operation. If you select the model, when you synchronize, the specified model is copied to Shared Services.
Note: Keep in mind when exporting that Shared Services supports dimensions that contain up to 100,000 members.
If a model exists in Shared Services but not in the application, the sync operation is Import From Hyperion Hub. You cannot change this operation. If you select the model, when you synchronize, the specified model is copied to the application. If a model exists in both the application and Shared Services, the sync operation is selectable. Select from one of the following options:
Note: Remember these factors when deciding which compare operation to perform. With export, the compare operation considers the application model to be the master model. With import, the compare operation considers the Shared Services model to be the master model. In the following descriptions, the master model is underlined.
203
Export with Merge Merges the application model content with the content in Shared Services. Notice the following factors:
This option considers any filters during the merge process and ensures that filtered members are not lost. If a property only exists in the application model, then the property is retained in the merged model. If a property only exists in the Shared Services model, then the property is retained in the merged model. If a property exists in both models, the value of the property in the application model will be retained in the merged model. A member in the application model but not in the Shared Services model will be retained in the merged model A member in the Shared Services model but not in the application model will not be retained in the merged model. A member which exists both in the Shared Services model and in the application model, but in different generation levels, will be merged and the position in the application model will be maintained. If an application system member exists only in a Shared Services model, export with merge will not delete this member. If an application system member exists both in a Shared Services model and in the application model, export with merge will merge the properties as usual and take the system member-specific attributes from the application model. See Application System Members on page 211.
For properties with attributes, the merge is based on the attribute value. For example, if the following Alias attribute exists in the Shared Services model:
<Alias table=French>Text in French<\Alias>
then the merged result will contain both attributes and will look like the following example:
<Alias table=French>Text in French<\Alias> <Alias table=English>Text in English<\Alias>
If the value for both Alias attributes is the same in both models, then the value for the application model is retained in the merged model.
Export with Overwrite Replaces the Shared Services model with the application model. Import and Merge Merges the content from the Shared Services model with the application model content. Import and Replace Replaces the application model with the Shared Services model.
204
Clear before Import Removes the existing content of the application model and replaces it with the content from the Shared Services model.
The maximum length is limited to 80 characters regardless of the application in which you are working. Names are not case sensitive. You can use all alphanumeric and special characters, with the exception of the forward slash (/) and double quotation () characters. Therefore, you cannot export a dimension to Shared Services that contains forward slash or double quotation characters.
Note: The restrictions on names listed in this section are enforced explicitly by Shared Services. Planning may enforce additional restrictions on names. If you are sharing models with one or more other products, you should be aware of additional naming restrictions that may be enforced by those products.
Comparing Models
At any time, you can compare a model in Shared Services to its corresponding version in the application. The latest version in Shared Services is compared to the model in the application. To compare different versions in Shared Services, see Tracking Model History on page 217.
To compare the application representation of a model with the Shared Services representation
of the model:
3 Select a Sync Operation in the drop-down list box for the model of interest. 4 Click the Compare button next to the Sync Operation box.
The latest version of the model in the application is compared with the latest version in Shared Services.
205
Compare Operations
The contents of the two models are shown line-by-line in a side-by-side format. Application Version refers to the model in the application. Application versions of a model are displayed on the left side of the Resolve Models (Compare) window. Hub Version refers to the model in Shared Services. Hub versions of a model are displayed on the right side of the Compare Models window. Figure 6 shows a sample Resolve Models (Compare) window.
Figure 6
By default, the Resolve Models window displays up to 50 rows per page, displays any folders in an expanded format, and displays only those models with differences. Color coding highlights any differences between the content of the two models, as follows:
Red indicates that the element has been deleted from the model. Green indicates that the element has been inserted into the model. Blue indicates that the element has been changed.
Note: The compare operation filters out any application system members that are not relevant to the product being viewed. For example, if viewing HFM models, Shared Services will filter out any application system members that are not valid for HFM. For more information about application system members, see Application System Members on page 211.
206
Table 41
Resolve Models (Compare) Window Elements Description Click to display the selected member and any children under the selected member in an expanded format (default) Click to display the selected member and any children under the selected member in a collapsed format Click to jump to the first model element with a difference Click to display the difference immediately previous to the current difference Click to display the next difference after the current difference Click to jump to the last model element with a difference Click to display all model elements, not just the elements with differences Click to display only the model elements with differences (default)
Note: For contextual purposes, Show Diff Only also displays the members immediately previous to and immediately after the member with a difference.
Element Expand All button Collapse All button <<FirstDiff button <PrevDiff button NextDiff> button LastDiff>> button View All button Show Diff Only button
Click to display the member property differences for a selected element A red arrow indicates a deleted element in the Application Version of a model A green arrow indicates an inserted element in the Application Version of a model Click to jump to the first page of the model Click to display the previous page of the model
Select a page to display in the Taskflow Listing area. Click to display in the Taskflow Listing area the page you selected in the Page dropdown list box. Click to display the next page of the model Click to jump to the last page of the model
Rows
207
Figure 7
The editor enables you to manage dimension members by performing these tasks:
View all members for a model, including application system members Add a sibling or a child to a member Change the description of a member Rename a member Move a member up or down in the hierarchy Move a member left or right (across generations) in the hierarchy Edit dimension member properties Enable or disable a filter
If you are renaming a member, keep the following rules in mind: a. You cannot rename a shared member. b. You cannot create a duplicate member name (the rename operation performs a uniqueness check). c. You cannot rename an application system member.
Note: Renaming a member and moving a member across generations within Shared Services enables products to retain the member properties for a shared model. Therefore, if you want to retain member properties across all products for a shared model, perform the rename or move member operation within Shared Services rather than within the individual product.
208
Add a child or sibling member Rename a member (notice the rules about renaming members in the previous section) Delete a member Move a member up, down, left, or right in the dimensional hierarchy Edit member properties For more information about editing member properties, see Editing Member Properties on page 209.
If a filter exists for a model, enable or disable a filter For more information about filters, see Filtering the Content of Models on page 215.
Note: If you click on a member and it is not editable, then the member is an application system member. For more information about application system members, see Application System Members on page 211.
That you have not created names that are too long (for example, 20 characters for Hyperion Financial Management, 80 characters for Hyperion Planning) That you have not created any duplicate names
Note: Shared Services does not perform validations for Alias/UDA uniqueness.
6 Click Save to save the changes that you have made and to create a new version of the model in Shared
Services.
209
Figure 8
To view which products share a particular shared property, hover the cursor over the shared property icon. A tool tip is displayed with the names of the products that share the property.
5 Select a tab and use the editing keys to change member property settings as you prefer.
Note: Alias properties may be displayed in a different order in Hyperion Shared Services than in Planning. See the discussion following the procedure for details.
6 In the Edit Member window, click Save to save the property settings that you have made.
210
Save to save the changes you have made and create a new version of the model Close to return to the Model Listing view
If a member has an alias property, all the aliases and alias table names for the member are displayed in the Edit Member window. For example: Planning:
<Alias table="English">MyAlias in English</Alias> <Alias table="German">MyAlias in German</Alias> <Alias table="French">MyAlias in French</Alias>
Shared Services:
Alias (English): MyAlias in English Alias (German): MyAlias in German Alias (French): MyAlias in French
The order in which Shared Services reads the alias tables is not necessarily the order in which the aliases are shown in Planning, which can be changed by user preferences.
Import operations will only import application system members if they are valid for your product. For instance, if a shared model has a system member called active which is only valid for HFM, when this model is imported by Planning, it ignores this member. Export with Overwrite replaces the Shared Services model with the application model, including any application system members. Export with Merge merges the application model content with the content in Shared Services. Notice the following factors:
211
If an application system member exists only in Shared Services, export with merge will not delete this member. If an application system member exists both in Shared Services and in the product, export with merge will merge the properties as usual and take the system memberspecific attributes from the product side of the model. All other export with merge scenarios will behave exactly the same way for system members as they do for normal members. See Sync Operations on page 203.
Renaming Models
Shared Services enables you to rename models in Shared Services. For example, you might want to rename a model if two applications want to share dimensional models that are named differently. For example, one application uses plural dimension names and the other application uses singular names. To share the models requires renaming one or both of them to a common name. Renaming a model changes the name only in Shared Services. The internal representation of the name does not change. If you import a new version of a renamed model to the application, the new version retains the original name. You need Write access to a model to rename it.
To rename a model:
1 Select Administration > Manage Models. 2 If it is not already selected, select the Browse tab. 3 Select a model and click Rename. 4 Type a new name in the New Name text box. 5 Click one of these options:
Rename to save the new name Cancel to cancel the name change
See Model Naming Restrictions on page 205 for a list of restrictions on model names.
Deleting Models
You can delete a model if you have Write access to it.
To delete a model:
1 Select Administration > Manage Models. 2 If it is not already selected, select the Browse tab. 3 Select a model and click Delete. 4 Click OK to confirm deletion.
212
Sharing Models
You set up the sharing of models between applications by designating a common shared application to be used by two or more applications. See Working with Shared Applications on page 196 and Sharing Applications on page 199 for details about shared applications. You can select two types of models to share:
You designate models in the private application in Shared Services to share with other applications. You select models from a shared application that have been made available for sharing by another application.
Note: Models within folders can also be shared using the Shared Services share operation. If a folder is selected, then all the models within that folder and within any subfolders will be shared.
To share models:
1 Select Administration > Manage Models. 2 Select the Share tab.
The sample Share Models window shown in Figure 9 lists both private and shared models.
Figure 9
Icons indicate whether a model is shared: indicates a private model that is not shared indicates a shared model indicates a model with a conflict (model exists in both the private application and in the shared application in Shared Services)
213
The Share Operation column provides a recommended operation to apply to each model, as follows:
Note: The Share Operation column displays only the first 10 characters of the shared application name. If the shared application name exceeds 10 characters, then Shared Services appends ellipses (...) to the end of the application name.
Share to <shared_application_name> Copies the content of the model in the private application to the shared application. The share operation also deletes the model in the private application and creates a link in the private application to the model in the shared application. Unshare from <shared_application_name> Copies the content of the model in the shared application to the private application and removes the link to the shared application.
Note: The model remains in the shared application. A copy of this previously shared model will be available in the users private/working application.
If there is a conflict and the model exists in both a private application and a shared application, the share operation is selectable. This conflict sometimes occurs because a model was previously shared and then unshared. Selecting a share operation enables you to reshare a model that was previously shared. Use the drop-down list box to select one of the following options:
Share from <shared_application_name> (Overwrite) Deletes the model in the private application and creates a link to the model in the shared application. Share to <shared_application_name> (Merge) Merges the content of the model in the private application with the content of the model in the shared application. The model in the private application is then deleted and a link is created to the model in the shared application. Share to <shared_application_name> (Overwrite) Replaces the content of the model in the shared application with the content of the model in the private application. The model in the private application is then deleted and a link is created to the model in the shared application.
3 Select one or more models to share and, if the share operation for a model is selectable, choose a share
operation.
4 Click Share to begin the sharing operation. 5 Click Refresh to update the status of the operation. 6 Click Report to view information about the status of the operation, including whether it was successful and
the reason for failure if the operation failed.
214
You can stop sharing a model at any time. When you stop sharing a model, a copy of the model is created in the private application in Shared Services.
215
Figure 10 shows a sample Members List area of the Create/Edit Filter window.
Figure 10
4 From the Members List area, select a member. 5 Click Add to move the selected member from the Members List area to the Filtered Out Members text box.
The Select Member drop-down list box indicates how much of the hierarchy is to be filtered, as follows:
Descendants (Inc). Filters the selected member and all of its descendants. Descendants. Filters descendants of the selected member (but not the member itself). Member. Filters the selected member only.
You can move selected members back to Members List from Filtered Out Members with the Remove and Remove All buttons.
6 Repeat the two previous steps until you have selected as many members to retain as needed. 7 Click one of these options:
Save to save the filter Close to cancel the changes you have made , in the Model Listing view indicates that a model has an attached filter.
After a filter is applied to a model, you see only those members within a model that are not filtered out. If you would like to see all the members in a filtered model, you can disable the filter and then, after viewing, enable the filter again.
216
2 If it is not already selected, select the Browse tab. 3 Select a filtered model and click Filter. 4 Click Disable. 5 Click Save to view the model in the Model Listing view.
The disabled filter icon, but the filter is disabled. , in the Model Listing view indicates a model has an attached filter,
217
Figure 11
4 From the version list, you can perform any of the following tasks:
ii. Click View. See Viewing and Editing Model Content on page 207 for more information.
Compare any two model versions to each other. i. Select any two versions.
ii. Click Compare. The contents of the two model versions are shown line-by-line in a side-by-side format. See Comparing Models on page 205 for more detailed information.
Replace the current model in the application with a version in the list. i. Select any version.
ii. Click Import. The specified version is imported to the application and replaces the current model. If a filter was applied to a previous version of a model, the model is imported with the filter applied.
218
See Viewing and Setting Model Properties on page 224 for more information.
To access specific models in Shared Services, users must be assigned access rights individually or inherit access rights by being part of a group that is assigned access rights. If an individual user is assigned to a group and the access rights of the individual user conflict with those of the group, the rights of the individual user take precedence. To give users access to models other than their own, an administrator must add the users and assign their permissions.
Permissions
Model management provides the following types of permissions:
Read. The ability to view the contents of a model. You cannot import a model if you have only Read access to it.
Write. The ability to change a model. Write access includes the ability to export, import, and edit a model. Write access does not automatically include Read permission. You must assign Read permission explicitly, in addition to Write permission, if you want a user to have these permissions.
219
Manage. The ability to create new users and change permissions for users. Manage access does not automatically include Read and Write permissions. You must assign Read and Write permissions explicitly, in addition to Manage permission, if you want a user to have all these permissions.
The following table summarizes the actions that a user can take in regard to a model with each of the permissions.
Table 42
Action Sync Import Export View Filter Compare History Set Properties Assign Access Share Assign Permissions Edit Rename Delete
Write Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No Yes Yes Yes
Manage Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
You can apply permissions to groups and to individual users. Users are automatically granted the permissions of the groups to which they belong. You can, however, explicitly add or deny permissions to a user to override group permissions.
220
For each type of access permission (Read, Write, and Manage), you must apply one of the following actions:
Grant. Explicitly grant the permission to the user or group. Granting permissions to a member of a group overrides permissions inherited from the group. For example, if a group is denied a permission, you can explicitly grant the permission to a member of the group.
Deny. Explicitly deny the permission to the user or group. Denying permissions to a member of a group overrides permissions inherited from the group. For example, if a group is granted a permission, you can explicitly deny the permission to a member of the group.
None. Do not apply the permission to the user or group. Not applying a permission is different from denying a permission. Not applying a permission does not override permissions inherited from a group. Specifying None for particular permissions for individual users enables you to apply permissions on a group basis.
Note: If a user belongs to groups with mutually exclusive permissions to the same model, permissions that are assigned override permissions that are denied. For example, if a user belongs to a group that denies Read access to a particular model and belongs to another group that assigns Read access to the model, the user in fact is granted Read access to the model.
221
Figure 12
Figure 13
5 In the Available Users/Groups text box, select users or groups to assign to this model (press Ctrl to select
multiple users). Click Add to move the selected users and groups to the Selected Users/Groups text box or click Add All to move all users and groups to the Selected Users/Groups text box.
Note: Group names are preceded by an asterisk (*).
6 Assign permissions to the selected users and groups by selecting one of the Grant, Deny, or None option
buttons for the Read, Write, and Manage permissions.
222
Figure 14
Note: Assigning (or denying) a permission does not implicitly assign (or deny) any other permissions; that is, assigning Write permission does not implicitly assign Read permission, and assigning Manage permission does not implicitly assign Read and Write permissions. Likewise, denying Read permission does not implicitly deny Write and Manage permissions, and denying Write permission does not implicitly deny Manage permission. You must explicitly assign all permissions that you want a user to have.
See Permissions on page 219 for details about the Read, Write, and Manage permissions and the Grant, Deny, and None actions that you can apply to each permission.
4 Select the check box next to one or more users or groups and click Edit.
The window shows the permissions currently assigned to the selected users or groups.
Note: The
5 Change permissions for the selected user or group by selecting one of the Grant, Deny, or None option
buttons for the Read, Write, and Manage permissions.
See Permissions on page 219 for details about the Read, Write, and Manage permissions and the Grant, Deny, and None actions that you can apply to each permission.
223
To view any changes made to model access, you must log out of the product application, close the browser, and then re-login to the product application.
4 Select the check box next to one or more users or groups and click Delete.
Note: When you click Delete, the permissions are immediately removed without a warning message being displayed.
Figure 15
224
Creator. Name of the user who created the model Updated By. Name of the person who updated the model If there have been no updates, the name of the creator is listed and the Updated Date is the same as the Created date.
Create Date. The date on which the model was created in (exported to) Shared Services Updated Date. The date on which the model was last updated in Shared Services Versioning. Whether versioning is enabled If versioning is not enabled, you can enable it by changing this setting. Once versioning is enabled, however, you cannot disable it.
Lock Status. Whether the model is locked or unlocked You can change this setting to lock the model for your exclusive use or to unlock the model to allow other users to work with it. Models are locked for only 24 hours. After 24 hours, the model is automatically unlocked.
Source Application. The name of the shared application Source Model. The path to the model in the shared application Transformation. The name of the transformation, if any, that Shared Services applies to the model to make it usable to the application
Dimension Type. The name of the dimension type. If the Dimension Type value is None, then you can select a new dimension type in the Dimension Type drop-down list box next to the Change To button.
Change To. Only shown if the Dimension Type value is None. Click the Change To button after you select a new dimension type value in the Dimension Type drop-down list box.
Dimension Type drop-down list box. Only shown if the Dimension Type value is None. Use the drop-down list box to select a new dimension type. Then click Change To to change the dimension type.
You need Read access to view model properties and Write access to change model properties.
225
If versioning is not enabled, enable it by clicking the Enable button next to Versioning. After versioning is enabled, model management maintains a version history for the model. You cannot disable versioning for a model after you enable it.
Lock or unlock the model by clicking the Lock or Unlock button next to Lock Status. If the Dimension Type value is None, select a new dimension type in the drop-down list box next to the Change To button. After you select a new dimension type, click Change To and accept the resulting confirmation dialog box to invoke the change.
5 Click Close to return to the previous page and save any changes that you have made.
Sharing Data
Shared Services enables you to move data between applications. The method used to move data is called data integration. A data integration specifies the following information:
Source product and application Destination product and application Source dimensions and members Destination dimensions and members
A data integration wizard is provided to facilitate the process of creating a data integration. Whoever has write access to the DataBroker.DataBroker application can create data integrations. Users with read access to the DataBroker.DataBroker application can run data integrations. Access rights to this application are granted through the Shared Services User Management Console. See the Hyperion Shared Services User Management Guide. By default, all Shared Services users have full access (Read, Write, and Manage) to all integrations. A data integration can be run manually or scheduled to run at a specific time. Data integrations can also be placed in groups and run sequentially.
226
To access all data integration functionality, click Administration > Manage Data.
Figure 16 shows a sample Manage Data window.
Figure 16
A list of integrations is displayed. The list includes names, source applications, and destination applications. An application name identifies a product, application, and a shared application in the form: <Product.Application.Shared Application>, for example, HFM.App1.beta.
Sharing Data
227
Note: When viewing a list of integrations, performance may become slower as you add more integrations and as more users view the list.
Group integrations do not have a source and destination; each integration in a group specifies its individual source and destination. A group icon in the source and destination columns identifies a group integration. The link, View group details, lists the integrations in the group. You can perform any of the following functions from the Integrations page:
Create, edit, or copy an integration (see Creating or Editing a Data Integration on page 229) Create a data integration group (see Grouping Integrations on page 241) Delete an integration (see Deleting Integrations on page 236) Run, or schedule to run, an integration (see Scheduling Integrations on page 237)
2 Select a product from the product Source or Destination drop-down list box or from both the product
Source and Destination drop-down list boxes.
The second Source or Destination drop-down list box is populated with the applications for the selected product.
4 Click Filter View to update the list based on the selections that you made.
228
The filter enables the display of integrations that act on a particular source product or application, or on a destination product or application, or on a combination of both. For example, if you specify HBM as the source application and Planning as the destination application, the list includes all integrations whose source is Business Modeling (HBM) or whose destination is Planning. The following examples illustrate the different combinations of product and application that you can specify in the Source and Destination combination boxes
If a source product is specified and the three other drop-down boxes specify all, the list displays all integrations with the specified source product. If a source product and a source application are specified and the two destination dropdown boxes specify all, the list displays all integrations with the specified source application. If a source product and destination product are specified and the two application dropdown list boxes specify all, the list displays all integrations from the given source product to the given destination product. If an integration is bidirectional (can be transposed) and either source-to-destination or destination-to-source matches the given products, the integration is listed.
If you want to create an integration, click New. If you want to edit an integration, select an integration and click Edit.
Note: Locking of integration models in edit mode is not supported. As a consequence, it is possible for multiple users to simultaneously open an integration and make changes. If more than one administrator edits the same integration simultaneously, the last one to save takes precedence. The entire integration is overwritten with the last version saved. No warning message is displayed.
If you want to use an existing integration to create a new integration, select an existing integration and click Copy.
Sharing Data
229
Note: Action buttons (New, Edit, Delete, Copy, and Run) that are enabled for a user are defined at the DataBroker application level and not at the model level. However, for existing integration models, the actions that a user can perform are controlled at the model level. For example, if a user has full access rights to the DataBroker application, but Read access to a specific integration model, all buttons are enabled but when the user tries to edit and save this integration, an error is displayed.
The first page of the wizard is displayed. Figure 17 shows a sample Create Integration window.
Figure 17
For a new integration, the fields are blank. For an integration to be edited or copied, the fields are populated with existing values. Figure 18 on page 231 shows a sample Edit Integration window.
230
Figure 18
Edit Integration Window Options Description A text box for a unique name for the integration. For an edited integration, text box is read-only and cannot be changed. To rename an integration, copy the integration to a new name, and delete the original integration. A combination text box to identify the source for the data. The first box contains a drop-down list of products registered with Shared Services. When you specify a product, the second box is populated with applications belonging to the product. When you specify an application, the third box is populated with data sources. Data sources include elements like Hyperion Planning Plan Type. If you select an application that does not require or support data sources, Default Data Source is displayed in a disabled field that you cannot change.
Source
Destination
A combination text box to identify the destination for the data. The first box contains a drop-down list of products registered with Shared Services. When you specify a product, the second box is populated with applications belonging to the product. A check box that determines the direction in which the integration can be run. If the box is not checked, data is moved from the source to the destination. If the box is checked, the user can choose a direction (source to destination or destination to source) when scheduling or running the integration. A check box that enables writing to read-only fields in the destination application.
Bidirectional
System Override
Sharing Data
231
Table 43
Edit Integration Window Options (Continued) Description A check box that enables the integration, for performance reasons, not to transfer missing cell (#missing) values. If the box is checked, to ensure that data is transferred successfully, you must prepare the destination database before running the integration. See Prerequisites for Moving Data Between Applications on page 226 for details. A text box for a value that acts as a multiplier for the data. Enter a value with which you want to scale the integration data. For example, to convert data from a positive to negative value during the data transfer, specify a scale value of -1. Each transferred data value is then multiplied by -1, in effect, converting them to negative values. A text box for optional comments and notes.
Scale
Notes
If you want to specify the shared dimensions, select one or more pairs of dimensions (in source and destination applications) and click Share. A dimension can be shared with only one dimension in the other application. A line is drawn between any two dimensions that are shared.
If you want to unshare any dimensions that are shared by default, select one or more dimensions in either application and click Unshare; or click Unshare All to remove sharing from all dimensions. If you want to return to the default shared dimensions, click Default.
Note: You are not required to identify every dimension that is in fact identical. The reason to identify shared dimensions is to specify the dimensions for which you want to move a range of members. For any particular integration, if you are interested in only one member for a dimension, you can leave the dimension unshared.
232
The third page of the wizard enables you to pick ranges of members from the shared dimensions to define the slice of data that will be transferred.
Shared Dimension Members. Dimensions identified as shared on the previous wizard page Common POV. Dimensions not identified as shared Each POV (point of view) uses the same background POV members and a unique set of dynamic POV members. You specify the dynamic POVs.
If you specify an AllMembers() function, the integration must check all 11 members; however, data is transferred only for 1999, 2000, and 2001, because these years are common to both applications. Warning messages are returned for the other years.
Note: You must select at least one member from each dimension in Common Members or specify a function that identifies a common member.
Sharing Data
233
When using double quotation marks ( ) and parentheses () in member names in the Create Integration Wizard, follow these guidelines: The following examples illustrate valid use of these characters in member names: abc abc func(abc) func(abc) func(a,b,c) func(a(b)c) func(a(b)c) These are examples of invalid member strings: func(abc) func(a,b,c) func(a(b)c) func(abc) If you select invalid member names from the Data Integration Wizard, it automatically adjusts the syntax to be valid before passing the name on. However, if you manually type an incorrect name, the wizard does not correct the invalid name, and an error is returned. The following members may be valid within an application, but may behave differently: a,b,c will be treated as three members, not one named a,b,c. Different styles can be mixed in a single shared pair of dimensions value input box, for example: a, b, c, abc, Children(a,b,c), iDescendants(a(b)c), Ancestors(a(bc)
234
d. Next to a dimension in the destination application, select the magnifying glass. e. From the list of members select a single member. f. Repeat steps d and e for all other dimensions in the destination application for which you want a member selected.
Note: You can leave background POV dimensions blank if the application does not require a value for them.
g. Click the Dynamic POV icon next to a dimension to move the dimension from the Background POV area to the Dynamic POV area. h. Click Add to create a POV that is based on the static and dynamic members that you have selected. i. Optional: If you want to create another POV, select a different member and click Add. You can repeat this step by selecting different members for the dynamic POV and clicking Add for each selection. The numbering in the lower right corner identifies the POV, for example, POV 3 of 5. You can navigate to each POV by using the left and right arrow keys. You can also move the dimension in the Dynamic POV area back to the Background POV area and move a different POV to the dynamic area and create another set of POVs. j. Optional: If you want to replace the content of any existing POV that you have access to, complete the following steps. i. Use the arrow keys in the lower right corner to navigate to a POV.
ii. Change the content in one of the Dynamic POV areas. iii. Click Replace. When the integration is run, it copies the data from the dimension member or members in the source application list to the dimension member or members in the destination application list.
9 Optional: If you want to see a list of POVs, click View All. 10 Optional: If you want to remove a POV, complete the following steps.
a. Click the left (<) or right (>) paging icon to navigate to a POV. b. Click Remove.
11 Save the integration, or cancel the changes that you made by taking one of the following actions:
Click Save to save the integration. The Create Integration window remains open. You can make additional changes to the integration and save it again when finished.
Click Save and Close. The integration is saved and the list of integrations is displayed. To schedule the new integration to run, see Scheduling Integrations on page 237.
Sharing Data
235
Click Save and Run. The integration is saved and the page to schedule an integration to run is displayed; see Scheduling Integrations on page 237.
Click Close. Any changes that you made since the last save are lost. Any new group that has not been saved is not created.
Note: Case-sensitivity in integration and integration groups is handled differently depending on the relational database. For Oracle configurations, if you save a new integration or group with a name comprised of the same characters but different case, such as "ABC" overwriting "Abc," you are prompted to overwrite the existing one. After you overwrite, two integrations are created: "Abc" with the old contents and a new integration or group named "ABC" with the new contents. In the case of non-Oracle configurations, if you try to overwrite "Abc" with "ABC", an initial message warning about overwriting is displayed. If you continue to overwrite, an exception is displayed stating that the name already exists and you are forced to select a new name.
Deleting Integrations
You can delete integrations that are no longer useful.
To delete an integration:
1 Click Administration > Manage Data.
A list of integrations is displayed.
Note: If the integration of interest is not displayed, check the Filter View Source and Destination drop-down boxes to see if the list of integrations is filtered. See Filtering Integration Lists on page 228 for information about how to filter an integration list.
OK to delete the selected integration or integrations Close to cancel the delete operation
236
Scheduling Integrations
You can run an integration immediately or schedule it to run at a particular date and time. You can also place an integration in a group and schedule the group to run. See Grouping Integrations on page 241 and Scheduling Group Integrations on page 243.
3 Optional: If the integration is bidirectional, the source and destination application can be reversed.
Selecting an application from the Source drop-down list box and the Destination drop-down list box automatically shows the other application that will be used as the destination.
Note: If the source and destination applications are the same, it can be confusing with a bidirectional integration to know which way the data is being moved. The first entry in the Source drop-down box is the original, default source application.
4 Click Run.
A popup window is displayed to schedule the integration to run. Figure 19 shows a sample Run Integration window.
Figure 19
Sharing Data
237
6 Click Schedule for and scroll to select the month, day, and time in the drop-down list boxes to schedule
the integration to run at a particular time.
The integration you scheduled is added to the list of scheduled integrations. For information on viewing scheduled integrations, see Viewing the Status of an Integration on page 238.
View the status of a running, completed, or failed integration; see Viewing the Status of an Integration on page 238. Cancel a running integration; see Canceling an Integration on page 239. Run a copy of an integration; see Copying an Integration to Run on page 239. Reschedule an integration; see Rescheduling an Integration on page 240. Remove an integration from the list of scheduled integrations; see Removing an Integration on page 240.
Figure 20
238
The Status column indicates whether an integration is pending, running, completed, or failed.
To view details about a completed or failed integration, click the Failed or Completed link in
the Status column.
Note: Data integrations that contain members with parentheses in the name, for example "Account1()", will fail. If this is the reason for the failure, you will see an Unknown function name Account1" error.
Canceling an Integration
You can cancel an integration that is scheduled to run or in progress (running).
To cancel an integration:
1 Click Administration > Scheduled Integrations. 2 Select an integration.
You can select a single integration only.
3 Click Cancel.
A confirmation message is displayed.
5 To schedule the integration to run at a particular time, click Schedule for and scroll to select the month,
day, and time in the drop-down list boxes.
Sharing Data
239
The integration you scheduled is added to the list of scheduled integrations. You can schedule an integration multiple times, which results in the integration being listed multiple times on this page.
Rescheduling an Integration
You can reschedule an integration that is waiting to run to a different date or time.
To reschedule an integration:
1 Click Administration > Scheduled Integrations. 2 Select an integration.
You can select a single integration only.
5 To schedule the integration to run at a particular time, click Schedule for and scroll to select the month,
day, and time in the drop-down list boxes.
Removing an Integration
You can remove an integration that is pending to run or one that has already run (completed or failed).
To remove an integration:
1 Click Administration > Scheduled Integrations. 2 Select an integration.
You can select multiple integrations to remove.
3 Click Remove.
A confirmation message is displayed.
240
OK to remove the integration or integrations you have selected Close to cancel the operation
Note: In some cases, removing an integration or group that has been run and then attempting to remove it from the Scheduled Integrations page results in a blank screen. In these cases, select the Back button in your browser and refresh your screen using either F5 or your browser's Refresh button.
Grouping Integrations
You can create groups of integrations to run at the same time. Before creating a group, you must first create individual integrations that can be added to a group; see Creating or Editing a Data Integration on page 229. In the group, you specify the order in which to run the integrations.
To create a blank new group, click New Group. A Create Integration Group page with blank fields is displayed.
To create a new group with a list of integrations, select one or more integrations from the list of saved integrations, and click New Group. A Create Integration Group page with populated fields is displayed.
To edit an existing group, select the group and click Edit. A Create Integration Group page with populated fields is displayed.
Sharing Data
241
Figure 21
3 Type a name for the group, or change the name for an existing group.
The name must be unique among existing group and integration names.
4 Optional: Type or change comments in the notes field. 5 Click Next to go to the next page.
Note: If you click Save or Save and Close, the group (name and notes) is saved. You can edit the group later and add integrations.
242
8 Optional: If you are editing an existing group, or if you add integrations that you want to remove, select one
or more integrations in Selected Integrations and click Remove to remove them from the group.
You can click Remove All to remove all integrations from the group. Integrations are run in the order that they are shown in Selected Integrations.
9 Optional: Select an integration and click the up or down arrow keys to move the integration up or down in
the list to change the order in which it is run.
10 Save the group, or cancel the changes you have made by taking one of the following actions:
Click Save to save the group. The Create Integration Group window remains open. You can make additional changes to the group and save it again when finished.
Click Save and Close. The group is saved and the list of integrations is displayed. To schedule the new group to run, see Scheduling Group Integrations on page 243.
Click Save and Run. The group is saved and the page to schedule a group to run is displayed; see Scheduling Group Integrations on page 243.
Click Close. Any changes you made since the last save are lost. If it is a new group and it has not been saved yet, no group is created.
Sharing Data
243
3 Click Run.
A page is displayed to schedule the group to run. Figure 22 shows a sample Run Group Integration window.
Figure 22
5 To schedule the group to run at a particular time, click Schedule for and scroll to select the month, day,
and time in the drop-down list boxes.
The group you scheduled is added to the list of scheduled integrations. For information on viewing scheduled integrations, see Viewing the Status of an Integration on page 238.
Note: If one of the integrations within a group encounters an error while running, the entire group stops running.
244
Chapter
11
This section describes how to create, modify, and manage data forms and the folders in which they are stored.
In This Chapter About Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Understanding the Composition of a Data Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 Managing Data Forms and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 Creating Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 Using Business Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 Previewing Data Forms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 Assigning Access to Data Forms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Printing Data Form Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Searching for Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Modifying Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Moving Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Deleting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Importing Data Form Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Importing and Exporting Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
245
Data Forms and Plan Types on page 246 Data Forms and Access Rights on page 246 Data Forms and Currencies on page 247 Designing a Data Form for Multiple Currencies on page 247 Data Forms and Versions on page 247 Data Forms and Attributes on page 248 Data Forms and Shared Members on page 248 Data Forms and Calculations on page 248
246
Users enter data through the Enter Data page. All users have access to the Enter Data page. Access to specific data forms created by administrators or interactive users is based on access rights. For example, a user having read access to a data form can see the data form listed and can select the data form for entering data. Whether users can actually change the data in the data form depends on whether they have access to its members. When users access a data form in the Web client for data entry, their access to the rows and columns on the data form is determined by the data access rights they have been assigned to the members on the rows and columns of the data form. In order for a data form to be editable by a user, the user must have access to at least one member of each secured dimension on the data form. For example, if a user has read-only access to the Europe entity, all of the rows and columns on the data form that include the Europe entity display in a read-only format.
To compare converted currencies in the same data form for rows and columns, select members from at least two different currencies. To convert currencies for all the members in the data form, assign the Currency dimension to the page axis and select reporting currencies as members. Users can then select the currency member of their choice from the page axis and then launch the Calculate Currencies business rule to view all the values in that currency.
247
Point of View on page 248 Page Axis on page 249 Rows and Columns on page 249
Point of View
By selecting members for the dimensions assigned to the point of view, you determine the context for the pages, rows, and columns. For example, if the Scenario dimension is set to Budget in the point of view, all data entered in the pages, row, and columns goes into the Budget scenario. The point of view is always set to a single member for each point of view dimension. A user cannot change the member that is selected for the point of view. When defining the point of view, you can specify which members are visible on the data form. This helps simplify data forms, displaying only the relevant members. See Defining the Page and POV on page 263. You can also simplify data forms by setting up user variables that are displayed on the POV. See Managing User Variables on page 273.
248
Page Axis
The page axis lets you set up combinations of members that may span dimensions so users can work with data in smaller, logical views. Each item on the page axis can have members selected from one dimension or from multiple dimensions. Users see only members to which they have access. You specify any number of page drop-down lists, and select members using relationship functions or attributes. You can then switch among member sets by selecting them from the page axis. You display member names or aliases on the page axis. You can also specify the number of members in a page dimension that enables a search facility on the page drop-down lists on the data entry page. You may want to take advantage of this feature if dimensions contain a large number of members, to make it easier for users to locate the members with which they want to work. See Defining the Page and POV on page 263.
249
To view all the data forms in a folder, click the folders name in the Data Form Folders area. To select all the data forms in the data forms list, select the check box at the top of the list.
Creating Folders
Folders help organize the data forms you create. You can create as many folders as needed, and you can arrange the folders in a hierarchy. For example, you can create a top-level folder called P&L. Within the P&L folder, you can create folders named Revenue and Operating Expenses to organize P&L data forms. You can move folders within the hierarchy, and give folders the same name if they are not on the same hierarchical level. You cannot:
Rename folders Assign access rights to folders Delete folders unless they are empty Select multiple folders Rename, move, or delete the top level folder called Data Forms, which contains all the folders and forms for the application
To create folders:
1 Select Administration > Manage Data Forms. 2 From the Folders list on the left side of the page, select the folder under which to create the folder. 3 Above the Folders list, click Create. 4 In the text box, enter a name for the new folder.
You cannot rename a folder.
5 Click OK.
Moving Folders
When you move folders, all the data forms and nested folders within the folder are also moved.
To move folders:
1 Select Administration > Manage Data Forms. 2 From the Folders list on the left side of the page, select the folder you want to move. 3 Above the Folders list, click Move. 4 From Destination Folder, select the folder to which you want to move the selected folder. 5 Click OK.
250
Deleting Folders
To delete folders:
1 Select Administration > Manage Data Forms. 2 From the Folders list on the left side of the page, select the folder you want to delete.
You cannot delete a folder that contains folders or data forms.
3 Above the Folders list, click Delete. 4 When you are prompted to confirm your intention to delete the folder, click OK.
Data form properties. See Setting Data Form Properties on page 252. Row and column layout. See Setting the Row and Column Layout on page 252. Page and POV definition. See Point of View on page 248 and Page Axis on page 249. Member selection. See Selecting Members on page 258. Display options. See Setting a Data Forms Display Options on page 264. Business rules selection and properties. See Selecting Business Rules on page 268 and Setting Properties of Business Rules on page 269. Access rights. See Adding Access to Data Forms on page 271.
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder under which you want to
store the new data form.
3 From the right side of the page, click Create. 4 The Data Form Design Wizard displays and guides you through the process of creating a data form.
251
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form. 3 From the list of data forms on the right side of the page, select the data form whose properties you want to
set, and click Edit.
4 In the Data Form text box, enter a name for the data form of up to 80 characters.
You can change the name of the data form later by updating the text in the Data Form text box.
5 Optional: In the Description text box, enter a description for the data form of up to 255 characters. 6 If the Plan Type drop-down list is displayed, select the plan type to associate with the data form. 7 Optional: To make the data form read-only, select Make data form read-only. 8 Optional: In the Enter Instructions text box, enter instructions that users can view. 9 Click Next to continue setting up the data form.
The Row/Column Layout tab is displayed. See Setting the Row and Column Layout on page 252.
You must select at least one member for each dimension. A data form must have at least one dimension assigned to the row and column axis.
252
You cannot select the same dimension for more than one axis. (You can have dimensions on more than one axis if you set user variables in the POV.) To move a dimension from one axis to another, delete it from the source axis and select it for the destination axis.
To set up dimensions and members for the column and row axis:
1 Set the forms properties as described in Setting Data Form Properties on page 252. 2 On the Row/Column Layout tab, in the Column Dimensions area, use the first Dimension drop-down list
to select the dimension to display first in the column axis.
To add more dimensions to a column, click Add Dimension. To add more columns, click Add Column. See Adding Column Definitions on page 256.
In the Members text box, type the names. Under Select, click the Select Members icon, .
See Selecting Members on page 258 and Creating Asymmetric Rows and Columns on page 262.
4 Repeat the previous steps to assign more dimensions to the column axis. 5 In the Segment Properties area, select any of these options:
Table 44
Segment Properties for Data Form Columns Description Hide the segment so it is not displayed on the data form For columns, do not display line breaks Create a read-only segment in the data form to allow comparing old, read-only data with new, editable data Create a bold border before the segment to visually distinguish parts of the data form Apply these settings to all columns in segments
Option Hide Suppress Hierarchy Read only Show Separator Apply to All Segments
253
Column Properties for Data Form Columns Description Select to suppress missing data, and hide columns unless at least one cell has a data value. Deselect to display the column with #missing in cells where data is missing.
Column width
SmallDisplay 7 decimal places on the data form MediumDisplay 10 decimal places on the data form LargeDisplay 13 decimal places on the data form. Size-to-FitForce all column headings to fit in the displayed space. CustomDisplay over 13 decimal places on the data form. You can enter a value up to 999.
7 In the Row Dimensions area, from the first Dimension drop-down list, select the dimension to display first
in the row axis.
To add more dimensions to a row, click Add Dimension. To add more rows, click Add Row. See Adding Row Definitions on page 256.
In the Member text box, type the names. Click the Select Members icon, , under Select.
See Selecting Members on page 258. For information about selecting different sets of members across the same dimension for a row, see Creating Asymmetric Rows and Columns on page 262.
9 Optional: Repeat the previous steps to assign more dimensions to the row axis. 10 In the Segment Properties area, select any of these options:
Table 46
Segment Properties for Data Form Rows Description Hide the segment so it is not displayed on the data form For rows, do not display indentation Create a read-only segment in the data form to allow comparing old, read-only data with new, editable data Create a bold border before the segment to visually distinguish parts of the data form Apply these settings for rows in all segments
Option Hide Suppress Hierarchy Read only Show Separator Apply to All Segments
254
Row Properties for Data Form Rows Description Select to aid performance of the Suppress missing data setting when suppressing a large number of rows, such as 90% or more. The Suppress missing blocks setting can degrade performance if few or no rows are suppressed. Hyperion recommends that you test data forms before and after using this setting to determine if performance is improved. You should also test data forms whenever you make significant changes to your application.
Note: With this setting, attributes may not be displayed in data forms. Also, certain suppressed blocks may have dynamic calc members ignored.
Select to suppress missing data, and hide rows without data unless at least one cell has a data value. Deselect to display rows with #missing in cells when data is missing. You cannot simultaneously select Suppress Missing Data and Allow Users to Dynamically Add Rows. Enable users who have write access to the data form to dynamically change and refresh the data forms definition by adding rows. Selected members to which they have access appear on the data form. You cannot simultaneously select Allow Users to Dynamically Add Rows and Suppress Missing Data.
Click Previous to return to the previous tab. Click Next to continue setting up the data form. The Page/Point of View tab is displayed. See Defining the Page and POV on page 263.
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form you
want to work with.
3 From the list of data forms on the right side of the page, select the data form whose layout you want to set. 4 Click Edit. 5 Fill out the Properties tab as described in Setting Data Form Properties on page 252. 6 Specify dimension members for the rows and columns as described in Setting the Row and Column
Layout on page 252.
255
7 On the Row/Column Layout tab, to the right of the row or column dimension whose property you want to
set, click the Dimension Properties icon,
Property Options for Individual Row and Columns Description Select one or both options to display member name and member alias. Select to start the member list expanded, or deselect to show the list collapsed.
9 Click Submit.
, under Select.
Click Submit to save your selections. Click Return to Data Form Layout to continue designing the data form.
Use the Edit Columns button on the Row/Column Layout tab to further define the columns dimensions and members.
256
2 On the Member Selection dialog box, select members for the dimension. 3 Click Submit. 4 Repeat this for the necessary dimensions. 5 Perform one action:
Click Submit to save your selections. Click Return to Data Form Layout to continue designing the data form.
6 Click Submit.
Use the Edit Rows button on the Row/Column Layout tab to further define the rows dimensions and members.
To set or change the dimension members assigned to a column or to remove the column
definition:
1 On the Row/Column Layout tab, click Edit Columns. 2 On the Edit Column Definitions dialog box, next to the column you want to change or delete, click one of
these items:
Edit to further define the member selections for the column. Delete to delete the additional column definition (including its member selection).
To set or change the dimension members assigned to a row or to remove the row definition:
1 On the Row/Column Layout tab, click Edit Rows. 2 On the Edit Row Definitions page, next to the row you want to change or delete, click:
Edit to further define the member selections for the row. Delete to delete the additional row definition (including its member selection).
257
Selecting Members
On the Member Selection page, you select members for the current dimension. You can select members directly, by attribute, or based on a relationship.
, to move the selected members to the right Selected Members list. , to remove the selected members from the Selected Members
When selecting members for the page, row, or column axis, you can use the Member relation drop-down list to select a range of members based on database outline relationships.
The following table describes member relationships, and the members that are included on data forms for each relationship:
Table 49
Member Relationships Members Included on the Data Form The selected member All descendants of the selected member, excluding the selected member The selected member and all its descendants All members above the selected member, excluding the selected member The selected member and all its ancestors All members from the same level in the hierarchy as the selected member, excluding the selected member
258
Table 49
Member Relationships (Continued) Members Included on the Data Form The selected member and all its siblings The member in the level above the selected member The selected member and its parent All members in the level immediately below the selected member The selected member and all its children All descendants of the selected member that have no children
Relationship Siblings (inc) Parents Parents (inc) Children Children (inc) Level 0 Descendants
Members chosen using the Relation drop-down list are displayed in their unexpanded state. You can also select attribute values to associate with the selected members from the Attributes section. Select the check box next to the Attributes title to select all attributes. See Selecting Attribute Values as Members on page 259.
3 Click Submit.
Notes for Administrators:
You can change users access to a dimension member to display different members in data forms after plans are refreshed. The order of members in the Selected Members list determines the order on the data form. To change the order of members, select a member and then click the up or down arrow in the Selected Members title bar. Use the scroll bar on the right to view long member lists or the horizontal scroll bar at the bottom to see members that have long names or are nested. To define different sets of members for a dimension, see Creating Asymmetric Rows and Columns on page 262. To select members that are attribute values, see Selecting Attribute Values as Members on page 259. To create data forms that can display account annotations, see Setting a Data Forms Display Options on page 264.
You can select shared members by the attribute values they inherit from their base member. You can select attribute values using one or more attribute members.
259
Selecting two or more attribute values as members from the same attribute dimension results in members that have either attribute value. For example, selecting Blue and Red from the Color attribute includes members that are either Blue or Red. Selecting two or more attributes from different attribute dimensions results in members that have both attribute values. For example, selecting Blue from the Color attribute and Large from the Size attribute includes members that are both Blue and Large. Selecting a base dimension member and an associated attribute value results in base dimension members that have the associated attribute value. For example, selecting North America (base member) and all its descendants and Populations equal to 200,000 (attribute value) includes all members that are both North American and have populations equal to 200,000. A data form in which attribute values are selected as members shows the attribute name as well as the base dimension member names and/or aliases.
When you open or calculate values in a data form, Analytic Services replaces the substitution variable with the value assigned to it. By default, each substitution variable is retrieved and cached from the Analytic Services server every five minutes. You can change the retrieval interval by setting a new value for the SUBST_VAR_CACHE_LIFETIME property in the HspJSHome.properties file; the default value is 300 seconds, or five minutes. (For more information on the HspJSHome.properties file, see Creating the Properties File on page 43 and Default Location of the Properties File on page 45.) You create and assign values to substitution variables using Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2 or ESSCMD. These substitution variables are then available in Planning when you select members for a Web data form. For rules on setting substitution variables names and values, see the Hyperion System 9 BI+ Analytic Services Database Administrators Guide. A substitution variable must be appropriate for the context in the data form. For example, you could select a substitution variable named CurrQtr with a value of Qtr2 as a member of the Time Period dimension. However, it is not valid to select a substitution variable named CurrYr for the Year dimension if its value is Feb. You can set substitution variables on the Analytic Services server, application, or database level. The same substitution variable can exist on multiple levels; Planning uses the first one it finds as it searches for them in this order: database, then application, then server.
260
Planning checks the validity of substitution variables not when you design the data form but when the substitution variables are actually used (for example, when the data form is opened). Therefore, test substitution variables by saving the data form and then opening it. For information on errors generated when substitution variables are calculated, you can check several logs. See the Analytic Services server log for information on attempts to use a substitution variable that is no longer contained in Analytic Services. See the Planning log for information on substitution variables that are not valid in the data form.
Listed substitution variables also show their current associated value. For example, the substitution variable CurrentScenario might display a value as follows:
CurrentScenario=Actual
3 Click Submit.
The user variables list displays all the user variables that you have set up for the current dimension. For example, the available user variable for the Entity dimension might display as follows:
Division = [User Variable]
261
3 Click Submit.
Before opening the data form, planners must select a value for the user variable in preferences.
3 Select a different set of members for the row or column than you selected for the dimension in the previous
row or column.
4 Click Submit. 5 Repeat this for the necessary dimensions. 6 Perform one action:
Click Submit to save your selections. Click Return to Data Form Layout to continue designing the data form.
You can set up data forms that allow users to dynamically change the data forms definition by creating additional rows with members, as needed.
262
In the Member text box, type the names. Click the Select Members icon, , under Select.
For more information about selecting members, see Selecting Members on page 258.
Tip: You can specify the number of members in a page dimension that enables a search facility on
the page drop-down lists on the data entry page. You may want to take advantage of this feature if dimensions contain a large number of members, to make it easier for users to locate the members they want to work with. You set this option by selecting File > Preferences > Display Options tab. Under the Page Selection Options, enter a value in the Allow Search When Number of Pages Exceeds option. See the Hyperion System 9 Planning Users Guide or Web help system.
3 Repeat the previous steps to assign any number of dimensions to the page axis.
Assigning multiple dimensions to the page axis enables planners to easily select dimensionality while entering data. By selecting File > Preferences > Display Options tab, users can also specify whether Planning sets the page selection to the most recently used selection.
4 Select or deselect the Member Name and Alias options to display the member name or member alias. 5 In the Point of View Dimensions area, select each dimensions member by doing one of the following:
In the Member text box, type the name. Click the Select Members icon, , under Select.
For more information about selecting members, see Selecting Members on page 258.
6 Select the Visible check box to make the dimension member name or alias visible on the data form.
If Visible is not selected, the member name or alias does not appear on the data form. Hiding point of view dimension members that are irrelevant to users can make a data form easier to use. For example, a user-defined dimension such as Employee may be meaningful on a headcount hiring data form, but irrelevant on a data form to plan capital spending.
263
7 Select or deselect the Member Name and Alias options to display the member name or member alias. 8 Save the data form by performing one action:
Click Save to save the data form and return to the Data Form Management page. Click Save As to save the current data form definition and settings under a new name. The previous data form remains intact. Click Previous to return to the previous tab. Click Next to continue setting up the data form.
The Account dimension must be assigned to a row axis. Account, Entity, Versions, and Scenario dimensions cannot be assigned to the column axis. The Entity dimension can be assigned to either the row, page, or POV axis. Version and Scenario dimensions must be assigned to either the page or POV axis.
Specify Minimum values to add zeros to numbers with a small number of decimals. Specify Maximum values to truncate and round the decimal portion of longer numbers. For example:
Table 50
Data Precision Examples Minimum Precision 0 3 Any number <=5 7 Any number <=5 0 Maximum Precision Any Any None None 3 0 Displayed Value 100 100.000 100.12345 100.1234500 100.123 100
264
Table 50
Data Precision Examples (Continued) Minimum Precision 2 2 Maximum Precision 4 4 Displayed Value 100.1234 100.00
2 In the Display Properties area, select the appropriate check boxes to enable the following features:
Display missing values as blankLeave data form cells empty where data does not exist. If this option is not selected, empty cells display the text #missing. (See Displaying #Missing with Smart Lists on page 331.) Enable account annotations Enable users to add annotations of up to 1500 characters to accounts during data entry (displays if the data form meets the criteria listed above for enabling account level annotations). Allow multiple currencies per entityIf the application supports multiple currencies, this option allows entities to support multiple currencies, regardless of their base currency. Users can select the currency for displayed cell values in a data form on the fly. Enable Smart ListsEnable Smart Lists to display on the data form (see Working with Smart Lists on page 327).
3 In the Printing Options area, set your preferences for how the information in the data form is displayed:
Table 51
Printing Options Explanation Select the printed page size for the data form: A3, A4, Ledger, Legal, Letter, or 11"X17". The default is A4. Select the PDF display orientation: PortraitVertical LandscapeHorizontal
Select from the fonts in the drop-down list to set the font for the information displayed in the PDF file. To add fonts to the drop-down list, see Adding Fonts on page 267. Type a number from 1 to 26 to set the font size for the information displayed in the PDF file. Type a number from 1 to 99 to set the percentage of the page to use for row headers. If the row header exceeds the space allotted for it, the text wraps. Set a smaller percentage value to allot more display space for data and column headers. The default value is 35. If rows or columns do not fit on a page, type the number of columns to display on each page.
265
Table 51
Printing Options (Continued) Explanation Select to include supporting detail as extra rows in PDF files. Select a value from the list to specify how the supporting detail is displayed: Normal OrderPrints supporting detail in the same order it appears on the Supporting Detail page, after the member it is associated with. Reverse OrderPrints supporting detail in reverse order, before the member associated with it. Supporting detail for children appears above their parents, and the order of siblings is preserved.
Format data Apply precision Repeat headers on all pages Show account annotations Show cell text Show attribute members Show currency codes Show shading
Select to apply number format settings from the data form to the displayed data. Select to apply the data forms precision settings (desired number of decimal points) to the data that is displayed in PDF files. If you consistently have more rows or columns than will fit on one page, select to repeat the headers on all displayed pages. If the data form designer enabled account annotations for the data form, select to display account annotations in PDF files. Select to display text notes associated with individual or groups of cells. If attribute members are selected in the data form, select to display them in PDF files. If the data form supports multiple currencies, select to display the currency codes of values in PDF files. Select to display rows with shading.
4 From Available Menus, select which menus to associate with the data form by moving them to Selected
Menus:
moves the selected menus moves all menus removes the selected menus removes all menus
or .
5 If you select multiple menus, set the order in which they are displayed by clicking
Multiple menus are displayed sequentially, with separators between them.
6 Click Save.
266
Adding Fonts
By default, Planning supports a number of built-in (type-1) fonts for printing data forms (for example, Helvetica, Times, Courier, and so on). Administrators can add true type fonts to the Font drop-down list to enable printing in various other languages such as Turkish and Russian. All Planning applications on the application server can access the added fonts.
3 Save and close the HspJSHome.properties file. 4 Restart the application server.
The fonts you added to the properties file are now available from the Font drop-down list.
Creating business rules, see the Hyperion System 9 Business Rules Administrators Guide and the Hyperion System 9 Business Rules Users Guide. Using runtime prompts, see Using Runtime Prompts on page 270.
Data that behaves as a rate (for example, prices and percentage data types) should be backcalculated for Summary Time Periods (for example, Quarters) using business rules.
267
To avoid prolonged calculation times, exclude Dynamic Calc members from business rules. In the Business Rules Copy Data Action Component, shared members are displayed the same as base members, and are not distinguished in the entities tree for member selection.
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form. 3 From the list of data forms on the right side of the page, select the data form for which you want to select
business rules.
4 Click Edit. 5 Fill out the Properties tab, as described in Setting Data Form Properties on page 252. 6 On the Row/Column Layout tab, specify the dimensions and members for rows and columns, as described
in Setting the Row and Column Layout on page 252.
7 On the Page/Point of View Layout tab, specify the dimensions and members for the page axis in the data
form, as described in Defining the Page and POV on page 263.
8 On the Other Options tab, set your preferences for how the data form is displayed, as described in Setting
a Data Forms Display Options on page 264.
9 On the Business Rules tab, from the Plan Type drop-down list, select the plan type. 10 From the Business Rules list, select the business rules you want to associate with the data form. 11 Move the business rules to Selected Business Rules on the right side by clicking the right arrow to move
the selected business rules or clicking the double right arrows to move all the business rules.
Note: By default, the Calculate Data Form and Calculate Currencies business rules are selected. The Calculate Data Form business rule is automatically created for each data form to calculate subtotals. The Calculate Currencies business rule is created for data forms that include multiple currencies in a row, column, or page, to enable converting values among the available currencies. You can deselect the Calculate Currencies business rule if you use a customized calc script to calculate currency conversions. You can also deselect the Calculate Data Form business rule; if you do, planners cannot calculate data in the data form.
268
12 To set the order of the selected business rules (which determines the order users see the rules displayed
and the order in which they are launched when the data is saved), select a business rule in the Selected Business Rules list and click the up or down arrow.
Note: The order in which business rules are launched is very important and may affect the data. If you are launching both the Calculate Data Form and the Calculate Currencies business rules, it is important that the currency conversions be run first, before subtotaling.
Click Save to save the data form and return to the Data Form Management page. Click Save As to save the current data form definition and settings under a new name. The previous data form remains intact. Click Previous to return to the previous tab. Click Next to continue setting up the data form.
Note: When you open a data form, all business rules associated with the data form are displayed regardless of access rights. You can reposition or remove these business rules. When adding business rules to data forms, you can select only business rules to which you have access.
If a business rule contains a runtime prompt, before the rule is saved, the user is prompted to enter the runtime prompt. The business rule Calculate Data Form is programmatically created for each data form to calculate subtotals. The Calculate Currencies business rule is created for data forms that include multiple currencies to enable the conversion of values among the available currencies.
2 Optional: If a business rule has runtime prompts and you want the default member selection on the
runtime prompt window to match the current member selection in the page and POV axes of the open data form, select Use Members on Data Form.
269
Note: The Use Members on Data Form option is available only for business rules that have runtime prompts. This option is most effective when used by runtime prompts that use a dimension only once. To pass the member selection on the data form into the runtime prompt, you must also select Remember the Last Page Selected, accessed by selecting File > Preferences > Display Options tab.
3 Optional: If you want to hide the runtime prompt value from the user, select the Hide Prompt check box.
This feature is only enabled if you have selected the Use Members on Data Form check box preceding it.
All runtime prompt member values are filled in (appropriate dimension members can be read from the data form) No dimensions are repeated in the runtime prompt
For additional information, see the Hyperion System 9 Business Rules Administrators Guide.
4 Click OK.
Please select an account. Select a month. Enter the expected number of customer visits per quarter. What percentage change in earnings do you expect next month?
Note: When launching a business rule with a runtime prompt, Planning validates the value entered, but it does not validate the business rule.
To set the default member selection in a runtime prompt, see Setting Properties of Business Rules on page 269.
270
Administrators and interactive users who can view and change various data form designs. By default, administrators have write access to all data forms for design modifications. Interactive users have write access to certain data forms based on access rights. Users who can access the data forms for view or data input. By default, administrators have write access to all data forms. Interactive users and planners have access to data forms based on access rights. Whether users have access to the data in the data form depends on whether they have access to its members.
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form for
which you want to assign access.
3 From the list of data forms on the right side of the page, select the data form for which you want to assign
access.
Note: Access rights are assigned to data forms, not to folders. You can assign access to one data form at a time.
4 Click Assign Access. 5 Click Add Access and select the users or groups you want to have access to the data form. 6 Optional: To get the latest set of users and groups from the User Management Console, click Refresh
Users and Groups.
7 In the Type of Access box, select the kind of access you want the selected users or groups to have to the
data form:
ReadUser can view the data form and enter data WriteUsers can change the data form design, view the data form, and enter data NoneUsers cannot view the data form
271
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form for
which you want to assign access.
3 From the list of data forms on the right side of the page, select the data form for which you want to change
access.
Note: Access rights are assigned to data forms, not to folders. You can change access to only one data form at a time.
4 Click Assign Access. 5 Select the users or groups for which you want to change the access assignment and click Edit Access. 6 Optional: To get the latest set of users and groups from the User Management Console, click Refresh
User/Group Lists.
7 In the Type of Access box, select the kind of access you want the selected users or groups to have to the
data form:
ReadUser can see the data form and enter data WriteUsers can change the data form design, see the data form, and enter data NoneUsers cannot see the data form
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder containing the data form for
which you want to remove access.
3 From the list of data forms on the right side of the page, select the data form for which you want to remove
access.
Note: Access rights are assigned to data forms, not to folders. You can remove access to only one data form at a time.
272
5 Select the users or groups for which you want to remove the access assignment and click Remove Access. 6 When you are prompted to confirm your intention to remove access, click OK.
Select Administration > Manage User Variables. Select File > New > User Variable.
2 Click Add. 3 On the Select User Variable page, for Dimension Name, select the dimension for which you want to create
a user variable.
4 For User Variable Name, type the name of the new user variable. 5 Click OK.
273
You can now associate the new user variable with a data form. See Selecting User Variables as Members on page 261. After that, planners can select members for the user variable to focus the data form on certain members. See the Hyperion System 9 Planning Users Guide or users help system.
Select Administration > Manage User Variables. Select File > New > User Variable.
2 Select the user variable you want to delete. 3 Click Delete. 4 When asked to confirm your intention to delete the user variable, click OK.
Select Administration > Reporting. Select File > New > Report.
Select the data forms whose definitions you want to print by taking one or more of the following actions:
To move data forms to the Selected Data Forms area, select them and click To move all data forms to the Selected Data Forms area, click .
To move data forms from the Selected Data Forms area, select them and click To move all data forms to the Available Data Forms area, click .
Tip: You can also click and drag to select multiple data forms.
274
4 Optional: Select Include Member Selection List to include column and row dimension members on the
report. This is selected by default.
5 Optional: Select Include Business Rules to include a list of business rules that are associated with the
data form. This is deselected by default.
Plan type Description Column dimension, column members, if selected, and any additional column definitions Row dimension, row members, if selected, and any additional row definitions Page and Point of View dimensions Access rights assigned to the data form Business rules associated with the data form, if selected
on the Adobe Acrobat toolbar.
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 On the Data Form Management page, in the Search text box, enter the name or part of the name of the
data form that you want to find and select.
3 Click
275
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the Data Form Management page, select the folder
where the data form you want to modify is stored.
3 From the Data Forms list on the right, select the data form you want to modify. 4 Click Edit. 5 Make the necessary changes to the data form. See:
Setting Data Form Properties on page 252 Setting the Row and Column Layout on page 252 Defining the Page and POV on page 263 Selecting Members on page 258 Setting a Data Forms Display Options on page 264 Selecting Business Rules on page 268 Changing Access to a Data Form on page 272
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder where the data form you want
to move is stored.
3 From the Data Forms list on the right side of the page, select the data form you want to move.
Note: You can move multiple data forms at once if they are in the same folder.
4 From the right side of the page, click Move. 5 From the drop-down list, select the destination folder. 6 Click OK.
276
Select Administration > Manage Data Forms. Select File > New > Data Form.
2 From the Data Form Folders list on the left side of the page, select the folder where the data form you want
to delete is stored.
3 From the Data Forms list on the right side of the page, select the data form you want to delete. 4 From the right side of the page, click Delete. 5 When you are prompted to confirm your intention to delete the data form, click OK.
Using the ImportFormDefinition utility provides an efficient method of importing row and column definitions from a data source that is sparsely populated. Planning imports only the rows or columns that contain data to the data form definition. The ImportFormDefinition utility is available only for use on Windows-based systems. If you installed Planning on a UNIX system, you can run the utility on the Windows-based system on which you installed Planning Desktop. To import a data form, you perform these general steps: 1. Prepare the data form for importing. See Preparing the Data Form on page 277. 2. Prepare the data file. See Preparing the Data File on page 278. 3. Run the utility to import the data form definition. See Importing the Data Form Definition on page 279 and ImportFormDefinition Examples on page 280.
277
Prepare your data form as usual and set up dimensions on the row, column, page and POV, depending on your requirements. For example, in most cases you would define the layout of the columns when you define the data form and use the ImportFormDefinition options to import only the rows.
Note: The resulting data form looks like the data form definition, not the way the data is structured in the data file.
The rows that are imported from the data file to the data form definition are filtered based on the members you specify on the data form and the import options you specify. It is important to define the members on each axis of the data form appropriately, and define the import options you want, as this affects which data is imported. Examples are discussed in ImportFormDefinition Examples on page 280.
The first line of the file represents the column of the data file. It must be a list of members from a single dimension. Each line after the first line must include a member from every dimension other than the one representing the column, followed by data. Member names must be enclosed in double quotation marks. The delimiter must be a space. Data must not be enclosed in double quotation marks. Data cells that are blank must include #Mi.
Note: The layout of the data form, not the format of the data file, determines how the resulting data form appears. You can use the same data file to load many different data forms because the data file represents what appears in the data form, not where it appears.
278
For information on locating the properties file, see Default Location of the Properties File on page 45.
2 Launch the ImportFormDefinition utility from the Utils directory, using this syntax:
ImportFormDefinition /A:appname /U:username /P:password /F:formname /D:filename [/AR] [/AC] [/SR] [/SC] [/KC] [/KR]
Table 52
ImportFormDefinition Utility Parameters Purpose Specify the name of the Planning application. Specify the Planning administrator user name. Specify the Planning administrator password. Specify the Planning data form name. Specify the name and location of the Analytic Services Column Export format data file. The location could be the full path and file name, or any format required for the operating system to find the file. For example, on a Windowsbased system, you can specify an FTP site. Add the rows found in data file. This option is on by default. You can disable adding rows by specifying /-AR. For example, in some cases you might want to define the rows in Planning and import only the column definition from the data file. Add columns found in data file. This option is on by default. You can disable adding columns by specifying /-AC. For example, in most cases you would want to define the columns in Planning and import only the row definition from the text file. Keep the existing member selections for the columns in the data form. This option is on by default. You can instead clear existing columns by specifying /-KC. Data forms must have at least one column definition. If you clear columns but do not add them, the data form is not saved and an error is displayed. Required? Yes Yes Yes Yes Yes
Switch
/A /U /P /F /D
/AR
No
/AC
No
/KC
No
279
Table 52
ImportFormDefinition Utility Parameters (Continued) Purpose Keep the existing member selections for the rows in the data form. This option is on by default. You can instead clear existing member selections in rows by specifying /-KR.Note: A data form must have at least one row definition, so if you clear rows, but do not add them, then the data form will fail to save, and you will get an error. Sort rows in the data form. This option is on by default. You can disable sorting rows by specifying /-SR. Sort columns in the data form. This option is on by default. You can disable sorting columns by specifying /-SC. Required? No
Switch
/KR
/SR /SC
No No
The ImportFormDefinition utility displays progress messages. Creating the data form could take some time, depending on the amount of data in the file. The ImportFormDefinition utility imports the definition to the Planning data form, ensuring that all the cells that have data in the data file are represented on the data form. Cells in the data file that contain #Missing do not cause rows or columns to be added to the data form. Note these points when importing data form definitions:
If you disable importing rows or columns, the ImportFormDefinition utility filters the imported data by any rows or columns defined on the data form. If you run the ImportFormDefinition utility more than once, it merges the new results with the existing data form definition. If you run the ImportFormDefinition utility more than once and you specify sorting, it sorts new and existing rows or columns by dimension order.
ImportFormDefinition Examples
It is important to define the members on each axis of the data form appropriately, and define the import options you want, as this affects which data is imported. If you want to only import rows that contain data for the specified columns, use the following procedure:
280
1. In Planning, specify the columns you want on the data form design. For example, you might specify Descendants Inclusive of YearTotal on the Column. 2. For the dimension for which you want to import members to the row, add the dimension root to the data form design. For example, to load accounts on the row, place the root of the Account dimension on the row of the data form design. 3. When you run the ImportFormDefinition utility, use the following options: /AR /-AC The ImportFormDefinition utility loads accounts from the data file if the members from each dimension that make up that cell match the members on the data form columns, pages, and POV. The added rows are filtered by members on the page. For example, if you place some members on the page, only accounts that contain data for those members are added to the data form. Rows are filtered by the members on the POV. For example, if the data file contains data for the salary account for 2004, but only 2005 is on the POV, that salary account is not added to the row even though it exists in the data file.
To run the FormDefUtil.cmd utility, launch the FormDefUtil.cmd utility from the \Utils
directory, using this syntax:
formdefutil <import|export> <filename|formname|-all> <server name> <user name> <password> <application>
Parameter/Switch Purpose Specifies whether to import or export the data form definition. When used with import, specifies the name of the XML file that contains the data form definition. When used with export, specifies the name of the Planning data form that you want to export to XML. Use -all with import or export to import or export all the XML files or data form definitions in the current application. Required? Yes Yes. -all is optional.
<import|export> <filename|formname|all>
281
Parameter/Switch
Purpose Specifies the server name on which the Planning application resides. Specifies the name of the Planning administrator. Specifies the Planning administrator password. When used with export, specifies the name of the Planning application that contains the data form definitions to export. When used with import, specifies the name of the Planning application to which you want to import the data form definition.
When you export a data form definition, the utility creates an XML file in the current directory. It also logs errors in a file named FormDefUtil.log, which is saved in the directory
from which you run the utility. This directory is by default \Utils.
Tip: You can copy the utility to any directory and launch it from there to save files to a directory other than \Utils.
For example:
282
Chapter
12
This section describes the concept of a planning unit and its life cycle through the budgeting and review processes. It also describes how to manage task lists and copy data to help guide users through the planning process.
In This Chapter About the Budgeting Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 Overview of Managing Task Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 Managing Task Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 Copying Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
283
Approve a planning unit from any process state Approval path is independent of organizational structure Highlight the exceptions and problem areas Built-in audit information through annotations and process status Add annotations and comments at each pass through the review process Accountability through ownership
Planning Units on page 284 Starting the Review Process on page 286 Entity Hierarchy on page 287 Setting Up E-mail for Workflow Notification on page 287 Printing Planning Unit Annotations on page 287
Planning Units
Scenarios and versions are the basis of the planning review cycle. Entities submit planning data for a particular scenario and version. The combination of scenario, version, and entity is called a planning unit and is the basic unit for preparing, reviewing, and approving plan data. For example, consider this data outline:
The Version dimension has two members: Best Case, Worst Case. The Entity dimension has three members: New York, California, Connecticut. The Scenario dimension has two members: Actual, Budget.
284
The planning unit might consist of a version (Worst Case), an entity (New York), and a scenario (Actual) as shaded in the following example:
You start, view, and promote planning units using Planning Webs Check Status task. Planning Web also maintains a history of the budget review process and supports users annotations. For more information about Check Status, see the Planning Web help. A planning unit is in one of six possible states:
Not Started - This is the initial state of all planning units. Any budget administrator can initiate the review process using the Start action. First Pass - This is the first state for planning units that have been selected to go through the budgeting process. There is no owner of a planning unit during First Pass. Any user with data access can enter data and promote the planning unit during the First Pass state. Under Review - This state occurs when a Promote action is taken on a planning unit and signifies that a planning unit is being reviewed by someone in the organization. Only the current owner or the budget administrators can modify data or perform an action on a planning unit that is in the Under Review state. Signed Off - This state occurs when a Sign Off action is taken on a planning unit. Only the current owner or the budget administrators can modify data or perform an action on a planning unit that is in a Signed Off state. Ownership does not change when a planning unit is signed off. Not Signed Off - This state occurs when a Reject action is taken on a planning unit. Only the current owner or the budget administrators can modify data or perform an action on a planning until it is in a Not Signed Off state. Approved - This state occurs when an Approve action is taken on a planning unit. After a planning unit is approved, the budget administrator becomes the owner of the planning unit. Only the budget administrators can modify data or perform an action on a planning unit that is in the Approved state. With multiple budget administrators, management of the
285
planning cycle is procedural, requiring coordination among the administrators. Once all the planning units are approved, the budget cycle is complete. Any administrator can approve a planning unit or reject a planning unit that has already been approved.
Note: In all states except the Not Started state, all users with read access can view data, view the process state, view the history, and read and enter new annotations.
4 Click Go. 5 Select the Start option next to the entity that you want to start.
Note: For budget administrators, the Entity list can be displayed as a tree or a flat list. If you are in a tree view, you can expand the hierarchy until you see the entity or entities you want to work with, or if you are in the flat list view, you can click a column header to sort the list.
6 Optional: To remove planning units from the planning process or from being tracked in the system, select
the Exclude option next to the desired planning unit.
Note: After an administrator excludes a planning unit, all annotations and history associated with the planning unit are discarded. The planning units status is returned to Not Started and the owner is set to No Owner. However, the data values are retained.
For more information on working with planning units, see the Hyperion System 9 Planning Users Guide or help system.
286
Entity Hierarchy
The parent/child relationships between entities affect their movement through the review process. The following rules apply:
When you promote or reject a parent, its children are automatically promoted or rejected, unless they are in the Approved state. The owner selected for the parent becomes the owner of the children also. When you approve a parent, its children are automatically approved. After all of the children of a parent are promoted to the same owner, the parent is promoted to that owner automatically. After all of the children of a parent are signed off, the parent status automatically changes to signed off.
Note: You cannot change the status of a parent if its children are owned by different users. If the children of a parent are promoted to different users or signed off by different users, the parent has no owner and its status can only be changed by the budget administrators.
For information on specifying the e-mail server, see Specifying System Settings on page 316. If the specified e-mail server name is valid, the application owner now becomes the source of all e-mail notifications. If the e-mail server name is not valid, no one else can enable e-mail notification.
The planning unit's title, author, date, and annotation text are displayed automatically. Annotation text, not data that may be associated with the planning unit, is displayed. Planning unit annotations are displayed chronologically, with the most recent entry first.
Note: If you are using a Thai language system, the time stamp in annotations and audit reports displays in the Gregorian calendar, rather than the Buddhist calendar. This is due to a limitation in the JDK (Java Development Kit) 1.3.1 for application servers.
287
Enter the names of the Scenarios, Versions, and Entities Click to select the Scenarios, Versions, and Entities
4 In the Process Status area, select the check boxes of the status states on which you want to report for the
specified planning units. The default for all status states is On.
Name of the application Selected set of Scenarios, Versions, and Entities Planning Unit title and status Date of origin Author Content of the annotation
on the Adobe Acrobat toolbar.
Managing Task Lists on page 289 Creating Task List Folders on page 289 Creating Task Lists on page 291 Adding Instructions to Task Lists on page 291 Adding and Defining Tasks on page 292 Assigning Access to Task Lists on page 300
288
2 To open the Manage Task Lists page, take one of the following actions:
Select Administration > Manage Task Lists. Select File > New > Task List.
3 Use the Manage Task Lists page to set up task list folders and create and manage task lists.
For detailed instructions, see the following topics:
Creating Task List Folders on page 289 Creating Task Lists on page 291
2 In the Task List Folders area, click in a folder, such as Task Lists, in which to create the task list folder.
The first time you create a task list folder, only the Task Lists folder is displayed in the Task List Folders area. After additional folders are created, they appear beneath the Task Lists folder. You can click the plus sign (+) or minus sign (-) to expand or collapse the folders.
3 In the left side of the Manage Task Lists page, click Create.
A dialog box is displayed, prompting you for the name of the new folder.
4 In the dialog box, enter the name of the task list, and then click OK.
The new task list folder appears in the folder that you selected before clicking the Create button.
289
2 In the Task List Folders area, select the folder that you want to move.
After you select a folder, a Move button appears above the Task List Folders area. You cannot move the pre-created Task Lists folder.
3 Above the Task List Folders area, click Move. 4 In the dialog box that is displayed, select the destination folder, and then click OK.
The selected task list folder is moved to the new location.
2 In the Task List Folders area, select the folder that you want to delete.
You can delete any folder except the Task Lists folder. After you select a folder, a Delete button appears above the Task List Folders area.
3 Above the Task List Folders area, click Delete. 4 When you are prompted to confirm the deletion, click OK.
If you select a folder that contains additional folders, an error message is displayed. You cannot delete folders that contain other folders.
290
First, you create and name the task list, using the instructions in this topic. Next, you define the content of the task list by adding instructions and tasks, and setting up access. See the following topics:
Adding Instructions to Task Lists on page 291 Adding and Defining Tasks on page 292 Assigning Access to Task Lists on page 300
2 In the Task List Folders area, click the folder in which you want to create the task list. 3 Above the Task List area on the right side of the Manage Task Lists page, click Create.
A dialog box prompts you to enter the name of the new task list.
4 In the dialog box, enter the name of the task list that you want to create, and then click OK.
The name of the task list is displayed in the Task List area on the right side of the page.
5 Now that you have created and named the task list, continue with the following procedures to define it:
To add instructions, see Adding Instructions to Task Lists on page 291. To add and define tasks, see Adding and Defining Tasks on page 292. To assign access permissions, see Assigning Access to Task Lists on page 300.
2 In the Task List Folders area, click the folder that contains the task list that you want to modify, and then
select the task list.
The task list is displayed in the Task List area on the right side of the page.
291
3 In the Task List area, select the task list that you want to modify, and then click Edit.
The Edit Task List dialog box appears.
4 In the Edit Task List dialog box, select the Instructions tab. 5 In the Enter Instructions text box, type instructions for the task list, and then click Save and Close.
You can also specify two types of e-mail messages to send to users. Due date messages are sent after a tasks due date, to alert users that the task was not completed by the due date. Alert messages are reminders that are sent after an alert date that you set, and are repeated until the due date is reached for a task. In order to send these messages, you must set up an e-mail server as described in Specifying System Settings on page 316.
2 In the Edit Task List dialog box, click Add Child to add a task.
The Add Task dialog box is displayed.
292
3 In the Task field, type a name for the task. 4 From the Type drop-down list, select the type of task that you are adding:
URL Taskopens a specified URL Web Data Formopens a Web data form Business Rulelaunches a business rule that you specify Workflowstarts the review process with a scenario and version that you specify Descriptivedescribes an action that users must take
5 In the Instructions text box, enter instructions to help users understand how to complete the task. 6 Optional: To enter a due date for the task, select the Due Date check box, and then enter the date and
time by which users must complete this task:
a. Select the month, day, and year from the drop-down lists. (You can change the date display format in Planning preferences. See Specifying System Settings on page 316.) b. Select the hours, minutes, and AM or PM from the drop-down lists. After you select the Due Date check box, the Alert check box is selectable, and you have the option of setting up e-mail reminder messages to be sent to users. An e-mail server must be set up, using the instructions in Specifying System Settings on page 316.
7 Optional: If you select the Due Date check box, you can set up e-mail messages to be sent if the task is not
completed by the due date:
a. In the Due Date area, select the Repeat Every check box. b. Type a number in the Repeat Every text box, and then select an option from the drop-down list to indicate the frequency of the e-mail reminder. For example, to send a message every 4 hours after the due date and time have passed, type 4 in the text box, and then select Hour(s) from the drop-down list.
8 Optional: If you select the Due Date check box, you can set up alert e-mail messages to be sent after the
alert date and before the due date:
a. Set the date when you want alert messages to begin by selecting the month, day, and year from the drop-down lists. b. Set the time when you want alert messages to start by selecting the hours, minutes, and AM or PM from the drop-down lists. c. In the Alert area, select the Repeat Every check box. d. Type a number in the Repeat Every text box, and then select an option from the drop-down list to indicate the frequency of the e-mail reminder. For example, to indicate that a message should be sent once a day after the alert date and until the due date, type 1 in the text box and then select Day(s) from the drop-down list.
9 Optional: Select the Dependency check box if you want to make completion of this task dependent on
completing a primary task.
10 Click Save and Close. 11 Set up properties for the task in the Property tab, as described in Setting Task Properties on page 294.
293
2 In the Edit Task List dialog box, select a task, and then click Edit. 3 In the Edit Task dialog box, click the Property tab.
The Property tab displays fields that are appropriate for the type of task you selected.
4 In the Properties tab, take one of the following actions, depending on the type of task for which you are
setting properties:
Table 53
Setting Task Properties Action Enter a fully qualified URL that you want to associate with this task, such as http://www.hyperion.com. Optionally, select Use Single Sign On to enable users to open a URL for another Hyperion product that accepts single sign-on. For information about setting up single sign-on, see the Hyperion System 9 Shared Services Installation Guide. For Data Form Folder, select the folder containing the Web data form that is associated with this task. For Data Form, select the Web data form that you want users to work on as part of this task. For Plan Type, select the plan type associated with the business rule that you want the user to execute. For Business Rule Name, select the business rule that you want the user to execute. For Scenario and Version, select the scenario and version you want the user to work in.
Note: For Descriptive tasks, you do not need to take any action.
5 In the Edit Task dialog box, click Save. 6 In the Edit Task List dialog box, click Close.
294
Editing Tasks on page 295 Copying Tasks on page 297 Moving Tasks on page 297 Moving Task Lists on page 298 Deleting Tasks on page 298 Deleting Task Lists on page 299
Editing Tasks
You can use the Edit Task dialog box to modify the type of task, its instructions, the due date and alert date, and whether e-mail reminder messages are sent to users. Due date messages are sent after a tasks due date, to alert users that the task was not completed by the due date. Alert messages are reminders that are sent after an alert date that you set, and are repeated until the due date is reached for a task. In order to send these messages, you must set up an e-mail server as described in Specifying System Settings on page 316.
To edit a task:
1 Open the Edit Task List dialog box:
a. Select Administration > Manage Task Lists to open the Manage Task Lists page. b. In the Task List Folders area, click the folder that contains the task list you want to modify. c. In the Task List area on the right side of the page, select a task list, and then click Edit.
2 In the Edit Task List dialog box, select a task, and then click Edit. 3 In the Edit Task dialog box, make any of the following changes:
URL Taskopens a specified URL Web Data Formopens a Web data form Business Rulelaunches a business rule that you specify Workflowstarts the review process with a scenario and version that you specify Descriptivedescribes an action that users must take
4 In the Instructions text box, modify the instructions for completing the task.
295
5 Optional: To enter a due date for the task, select the Due Date check box, and then enter the date and
time by which users must complete this task:
a. Select the month, day, and year from the drop-down lists. (You can change the date display format in Planning preferences. See Specifying System Settings on page 316.) b. Select the hours, minutes, and AM or PM from the drop-down lists. After you select the Due Date check box, the Alert check box is selectable, and you can set up e-mail reminder messages to be sent to users.
6 Optional: If you select the Due Date check box, you can set up e-mail messages to be sent if the task is not
completed by the due date:
a. In the Due Date area, select the Repeat Every check box. b. Type a number in the Repeat Every text box, and then select an option from the drop-down list to indicate the frequency of the e-mail reminder. For example, to send a message every 4 hours after the due date and time have passed, type 4 in the text box, and then select Hour(s) from the drop-down list.
7 Optional: If you select the Due Date check box, you can set up alert e-mail messages to be sent after the
alert date until the due date:
a. Set the date when you want alert messages to begin by selecting the month, day, and year from the drop-down lists. b. Set the time when you want alert messages to start by selecting the hours, minutes, and AM or PM from the drop-down lists. c. In the Alert area, select the Repeat Every check box. d. Type a number in the Repeat Every text box, and then select an option from the drop-down list to indicate the frequency of the e-mail reminder. For example, to indicate that a message should be sent once a day after the alert date and until the due date, type 1 in the text box and then select Day(s) from the drop-down list.
8 Optional: Select the Dependency check box if you want to make completion of this task dependent on
completing a primary task.
9 To edit properties for the task, click the Property tab and follow the procedures described in Setting Task
Properties on page 294.
10 When you finish making changes, click Save in the Edit Task dialog box. 11 In the Edit Task List dialog box, click Close.
296
Copying Tasks
In the Edit Task List dialog box, you can make a copy of a task list and save it with a different name to use it for another purpose. You can copy one task list at a time.
2 In the Edit Task List dialog box, select the task list that you want to copy. 3 Click Save As.
A dialog box prompts you for the name of the new task list.
4 In the dialog box, enter the name of the new task list, and then click OK.
The task list is saved with the name that you specified in the same folder as the original task list. To close the Edit Task List dialog box, click Close.
Moving Tasks
In the Edit Task List dialog box, you can move tasks up and down to change their position on the task list. When you move a task that has subordinate tasks, the subordinate tasks move, too. You can also cut and paste tasks to move them to a different level of the hierarchy. You cannot use cut and paste within the same level.
2 In the Edit Task List dialog box, select the task you want to move.
You can select only one task to move at a time.
3 Perform an action:
Click Up Arrow to move the task up one position. Click Down Arrow to move the task down one position.
The task and any subordinate tasks move up or down in the task list.
297
a. Select Administration > Manage Task Lists to open the Manage Task Lists page. b. In the Task List Folders area, click the folder that contains the task list you want to modify. c. In the Task List area on the right side of the page, select a task list, and then click Edit.
2 In the Edit Task List dialog box, select the task you want to move.
Be sure that only one check box is selected. You can only select one task to move at a time.
To move the task to a new position on the task list, select the task you want to appear above the task. To move the task to the root tasklist, do not select any specific task position.
2 In the Task List Folders area on the left side of the page, click the folder that contains the task list that you
want to move.
4 In the Task List Folders area on the left side of the page, click Move. 5 In the dialog box that appears, select the destination folder to move the task to the desired location. 6 Click OK.
Deleting Tasks
You can use the Edit Task List dialog box to delete tasks when you no longer need them.
To delete tasks:
1 Open the Manage Task Lists page.
For instructions, see steps 1 and 2 in Managing Task Lists on page 289.
298
2 In the Task List Folders area on the left side of the page, click the name of the folder that contains the task
that you want to delete.
3 In the Task List Folders area, select the task list that contains the task that you want to delete.
The task list is displayed in the Task List area on the right side of the page.
4 In the Task List area on the right side of the page, select the check box next to the task list that contains
the task that you want to delete.
5 In the Task List area, click Edit. 6 In the Edit Task List dialog box, select any tasks that you want to delete, and then click Delete. 7 When you are prompted to confirm the deletion, click OK.
2 In the Task List Folders area, click the folder that contains the task list with the task that you want to
delete, and then select the task list.
The task list is displayed in the Task List area on the right side of the page.
3 In the Task List area, select any task lists that you want to delete, and then click Delete. 4 When you are prompted to confirm the deletion, click OK.
299
Click Ctrl+V. From the Microsoft Internet Explorer menu, select Edit > Paste.
3 In the Task List area, click Assign Access. 4 In the Assign Access dialog box, click Add Access. 5 Optional: To get the latest set of users and groups from the User Management Console, click Refresh
Users and Groups.
6 In the Users and Groups area, select the users or groups who will have access to the task list. 7 In the Type of Access area, select how you want the selected users or groups to use the task list:
Assignenables users or user groups to view and use the task list Manageenables users to modify the task list Manage and Assignenables users to modify the task list, and to see and use the task list Noneprevents users from seeing this task list
8 Click Add.
300
9 Click Close.
3 In the Task List area, click Assign Access. 4 In the Assign Access dialog box, select the users or groups for whom you want to change access, and then
click Edit Access.
5 Optional: To get the latest set of users and groups from the User Management Console, click Refresh
User/Group Lists.
6 In the Type of Access area, select how you want the selected users or groups to use the task list:
Assignenables users or user groups to view and use the task list Manageenables users to modify the task list Manage and Assignenables users to modify the task list, and to see and use the task list Noneprevents users from seeing this task list
301
3 In the Task List area, click Assign Access. 4 Select the user or group whose access you want to remove, and then click Remove Access. 5 When you are prompted to verify the action, click OK. 6 Click Close.
Copying Data
When planners create a budget, it is often useful to copy the entire plan from one year to another or from one business unit to another. Administrators can support the planning effort by using the Copy Data feature to copy all relational data, including supporting detail, from one dimensional intersection to another dimensional intersection. For example, you can copy Budget, FY05, Final to Forecast, FY06, First Draft. You can also copy data from FY04 to FY05 to help planners prepare a budget, or you can copy data from one business unit to another. When you use the Copy Data feature, note the following points:
The settings that you select in the Copy Data page are preserved for the current session only. After you log out, the fields are restored to the default settings. The members and dimensions that you copy must be present in the selected plan types. Data must be copied into cells that can accept data. For example, you cannot copy data into read-only or dynamic cells. You can use copy account annotations, supporting detail, and cell text. However, you cannot copy planning unit annotations. Analytical Service data is copied regardless of the options that you select in the Copy Data Options area. Because this is an administrative function, Planning assumes that you have full access to the data you are copying. In addition, you are not prevented from copying to planning units that are approved. This feature does not calculate data. If you want to perform calculations, such as increasing the forecast by 5%, you can apply the appropriate business rule after copying the data.
To copy data:
1 Select Administration > Copy Data. 2 For Plan Type, select a plan type, and then click Go.
You can copy from one plan type at a time. When you click Go, the appropriate dimensions are displayed for this plan type.
3 In the Static Dimensions area, enter the set of dimension members for the intersections of data:
a. In the Dimension area, select a dimension from which to copy. b. In the Members area, click the Member Selection icon to select the members from which to copy.
302
You can select multiple members. For example, for Time Periods, you can select Jan, Feb, and Mar.
4 Optional: To add another static dimension to the list, click Add Dimension, and then repeat the previous
step to define the dimension. (To remove a dimension from the list, select None - Select a Dimension. The dimension moves to the Dimensions with Source and Destination area, below.)
5 In the Dimensions with Source and Destination area, enter the dimensions into which you want to copy
data:
a. In the Source area, click the Member Selection icon to select a member to use for the destination. b. In the Destination area, click the Member Selection icon to select a member to use for the destination.
6 In the Copy Data Options area, select any of the following types of information that you want to copy:
8 If you want to copy data for another plan type, select a different plan type in step 2, and then repeat the
procedure.
Copying Data
303
304
Chapter
13
This chapter explains how to:
Move a Planning application from one server to another (for example, moving from a test environment to a production environment). Copy and rename an application on the same server. Set individual preferences and global settings for various aspects of the application. Delete certain application information.
In This Chapter
Moving an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 Copying a Planning Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 About Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 Deleting Application Information Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Deleting Shared Descendants Using a Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
305
Moving an Application
To move an application means to move it to a different environment while keeping its name intact. This topic assumes the following:
The two environments are referred to as Test and Production. The application is moved from Test to Production and is named HYPPLAN. The relational database created for this planning application in the Production environment is named HYPPLANDB. Each environment has all the necessary components installed. The test and production environments contain the same users. You are using Planning Release 9.2.x. The test and production environments are using the same external authentication providers as specified in the CSS.XML file. You backed up your Shared Services and OpenLDAP repositories as specified in the Hyperion System 9 Shared Services Installation Guide.
Note: Before moving or copying an application, make sure that you have upgraded your applications to the latest release and perform a Refresh on the source application.
Moving a Planning Application on page 306 Moving Business Rules Data on page 308 Moving Reporting Data on page 311
2 Make sure the application owner is a user in the test and production environments. 3 Make a backup of the relational database for the development application (for example,
hypplan.bak), and then restore the backup of the development database to a new relational database in the production environment.
4 Create and configure a UDL or encrypted connection string pointing to the new relational database.
306
See Creating Applications Using a Microsoft Data Link UDL or Creating Applications Using an Encrypted Connection String in the Hyperion System 9 Planning Installation Guide.
5 Create and configure a data source pointing to the new relational database.
See Creating Applications Using a Microsoft Data Link UDL or Creating Applications Using an Encrypted Connection String in the Hyperion System 9 Planning Installation Guide.
6 Create a new entry for the application in the HSX_DATASOURCES table by doing the following:
a. To add a new record, open the HSX_DATASOURCES table and insert a new line.
Note: This table is found in the database used by the UDL associated with the System Data Link file in the Planning Desktop.
b. For the new record, enter the following values in the column fields:
Product=Planning AppName=name of new application Description=optional DSN=name of the DSN created for the new application
7 On the Analytic Services server, create an application (for example, named HYPPLAN). Make sure the
application name is the same as you entered in the HSX_DATASOURCES table in step 6.
8 Open Planning and open the application in the Production environment. 9 Use the Manage Database task to create the Analytic Services outline.
Note: You can also use the AppScheduler utility to schedule the application creation or refresh. For example, you can create the application HYPPLAN by entering the following: Appscheduler localhost, HYPPLAN,user1, password, /C or /R. For more information, see Scheduling Application Databases to be Refreshed in the Hyperion Planning Administrators Guide.
Note: If you have custom Analytic Services outlines (.otl files), you should open them using Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services 9.2 from the Development machine and perform a Save As over the existing *.otl on the Production machine. If you have custom calc scripts (.csc), load rules (.rul), or report scripts (.rep), you can copy the files to the Analytic Services application directory. You can then load any data from the development application. Selecting Create from the Manage Database task overwrites all .otl, .csc, .rul, and data values that exist in the database. If any of these files has been copied from the development server, you should select the option to Refresh the database only on the production server. Otherwise, the files must be copied from the development server again.
Note: Users on the Analytic Services server that hosts the original application do not already have to be defined on the Analytic Services server for the new application. The users will be automatically added to Analytic Services when a Database Create or Database Refresh is performed with the Security Filters option checked. However, the Analytic Services server must run on a network that recognizes these users.
Moving an Application
307
10 Run the Configuration Utility in Planning to create the Planning properties file (HspJSHome.properties). For
more information, see the Hyperion System 9 Planning Installation Guide.
You can also create the Planning properties file by specifying parameters from the cmd prompt. Example 1Planning without Hyperion Business Rules
HspSetupSupport.exe c:\temp 11333 no
where
HspSetupSupport.exe = Properties file utility that is run from <drive letter>:\hyperion\HyperionPlanning\Utils folder c:\temp = properties file location 11333 = RMI port no = no connection to HBR
where
HspSetupSupport.exe = Properties file utility that is run from <drive letter>:\hyperion\HyperionPlanning\Utils folder c:\temp = properties file location 11333 = RMI port yes = connection to HBR server3 = AAS server name 10080 = AAS server port admin = AAS admin user name password = AAS admin user password
If the utility runs successfully, the HspJSHome.properties file is created in the location you specified.
11 After you have generated the properties file, log on to HYPLAN on the Planning Web and register the
application with Shared Services.
308
2 In the Analytic Administration Services Login dialog box, enter a server name and your user name and password
to log on to Analytic Administration Services.
3 In the left navigation frame of Analytic Administration Services, expand the Business Rules node. Then expand
the Administration node.
5 Click Connect to connect to the repository from which you want to migrate repository objects. 6 On the Enter Source Repository Information dialog box, do the following:
a. From the Repository Version drop-down list, select one of the following repository versions from which to migrate:
Note: If you are migrating a 4.0 repository to a 4.1 repository, run the Externalize Users utility in Analytic Administration Services first. When you run this utility, all native Analytic Administration Services and Business Rules users from the previous release are migrated from the Analytic Administration Services/Business Rules repository into the Shared Services repository. For more information on using the Externalize Users utility to migrate users to Shared Services, see the Hyperion System 9 Analytic Administration Services Installation Guide.
Business Rules 4.1 Repository: Select this option to migrate graphical and non-graphical business rules and other repository objects such as variables, macros, sequences, and projects from a Business Rules 4.1 repository into another Business Rules 4.1 repository. You may want to use this option if you need to migrate your repository to a new server (for example, from a development to a production server). Note: You cannot migrate rules from an
active repository to another repository. For example, if you have repositories A and B, and A is the active repository, you cannot migrate rules from the A repository into the B repository, though you can migrate rules from the B repository into the A repository.
Business Rules 4.0 Repository: Select this option to migrate non-graphical business rules and other repository objects such as variables, macros, sequences, and projects, as well as any database locations and access privileges assigned to them, from a Business Rules 4.0 repository into a Business Rules 4.1 repository. When you migrate your Business Rules 4.0 repository to a 4.1 repository, all Business Rules repository objects including rules, sequences, variables, macros, and projects, as well as any database locations and access privileges assigned to them, are migrated to Shared Services automatically. During migration, any Business Rules roles assigned to users are migrated and assigned equivalent roles in Shared Services. In addition, any Business Rules groups are migrated to Shared
Moving an Application
309
Services. If the groups have roles assigned to them, these roles are also migrated and assigned equivalent roles in Shared Services. If a Business Rules group does not exist in Shared Services, it is created. After they are migrated to the Shared Services repository, existing Business Rules users and groups are automatically provisioned for use in Business Rules. You can work with Business Rules users and groups, and assign roles to them, in Hyperion System 9 Shared Services User Management Console. For an overview of Shared Services User Management Console, Hyperions new centralized interface for managing users, groups, and roles for all Hyperion products, see the Hyperion System 9 Shared Services User Management Guide. Graphical Repository: Select this option to migrate graphical business rules from a graphical repository (from 2.x through 4.0.1) into a Business Rules 4.1 repository. All of your graphical business rules remain graphical business rules in the Business Rules 4.1 repository. Note: You cannot convert non-graphical business rules into graphical business rules by
migrating to a new repository.
b. From the Repository Type drop-down list, select one of the following repository types from which to migrate:
Note: You can only select Microsoft Access if you are migrating from a graphical repository.
c. Enter the name and port number of the server on which the repository resides. If you are using an Oracle repository, enter the instance. d. For SQL and DB2, enter the database name (this is the empty Business Rules database that was created in Microsoft SQL Server or DB2 during configuration) followed by the username and password for that database. e. Click Test Connection to test the connection to the database. If the connection fails, make any necessary changes until you can connect successfully. f. Click Connect to connect to the server. Note: Select Current if you want to connect to the server
that you are connected to currently.
The business rules and sequences that you can migrate to this release of Business Rules are listed on the Business Rules tab and the Sequences tabs, respectively. If you are migrating a 4.0 or 4.1 repository, any variables, macros, and projects that you can migrate are listed on their respective tabs.
If you are migrating a 4.0 or 4.1 database, on the Business Rules, Variables, Macros, Sequences, and Projects tabs, select the check boxes next to the names of the business rules, variables, macros, sequences, and projects you want to migrate. Or click the Select All button to migrate all of them.
310
If you are migrating a graphical repository, select the check boxes next to the names of the business rules and sequences you want to migrate. Or click the Select All button to migrate all of them. Go to step 9.
Note: If you want to migrate all of the items listed on each tab, click the Select All button for each tab.
8 If you are migrating a 4.0 or 4.1 database, click the Dependents button to migrate the variables and macros
that are associated with the business rules you selected.
The variables and macros associated with the business rules you selected are listed on the Variables and Macros tabs.
9 Click Migrate to migrate the objects you selected. 10 Run the Configuration Utility in Planning to create the Planning properties file. See the Hyperion System 9
Planning Installation Guide. If you want to create the Planning properties file from the cmd prompt, see step 10 on page 308.
Follow the instructions in the Hyperion System 9 BI+ Financial Reporting, Interactive Reporting, Production Reporting, Web Analysis Migration Guide and Migration Planning Guide.
Note: The location of this program may vary, depending on where you installed Hyperion Reports.
5 Restart your Hyperion Reports Services. 6 To reconfigure the server, log on to Hyperion Reports. 7 In the Hyperion Reports Administrator area of the Hyperion Report Server Configuration dialog box, enter
the user ID and password of the Hyperion Reports administrator for the development reports relational database.
This is the first user who configured the server in the development environment.
Moving an Application
311
8 Click OK.
If you have calculation scripts or member formulas in the application you are copying, see the Analytic Services documentation for information on copying these components. The following sample procedure is based on copying a Microsoft SQL application.
For information on backing up SQL, Oracle, and DB2 databases, see Backing Up Applications and Application Databases in the Planning Administrators Guide.
2 Create a new relational database repository and restore the backup of the original application to the new
database repository.
Note: When you restore the backup to the new database, you may get an error stating that physical files cannot be overwritten because they are in use by the original application. In this case, you need to rename the physical file names for both Data and Log files to reflect the name of the new database.
3 Create and configure a UDL or encrypted connection string pointing to the new relational database.
See Creating Applications Using a Microsoft Data Link UDL or Creating Applications Using an Encrypted Connection String in the Hyperion System 9 Planning Installation Guide.
4 Create and configure a data source pointing to the new relational database.
See Creating Applications Using a Microsoft Data Link UDL or Creating Applications Using an Encrypted Connection String in the Hyperion System 9 Planning Installation Guide.
5 Create a new entry for the application in the HSX_DATASOURCES table by doing the following:
312
a. To add a new record, open the HSX_DATASOURCES table and insert a new line.
Note: This table is found in the database used by the UDL associated with the System Data Link file in the Planning Desktop.
b. For the new record, enter the following values in the column fields:
Product=Planning AppName=name of new application Description=optional DSN=name of the DSN created for the new application
Note: The application name must be different than the original application name and must be the same as the name you enter for the Analytic Services application that you create in step 6.
6 On the Analytic Services server, create an application (for example, named HYPPLAN). Make sure the
application name is the same as you entered in the HSX_DATASOURCES table in step 5.
Note: Users on the Analytic Services server that hosts the original application do not need to already be defined on the Analytic Services server for the new application. The users are automatically added to Analytic Services when a Database Create or Database Refresh is performed with the Security Filters option checked. However, the Analytic Services server must run on a network that recognizes these users.
You need to run the Configuration Utility for Planning and regenerate the Planning properties file to display the new application on the Web. After you have generated the properties file, log on to HYPLAN on the Planning Web and register the application with Shared Services.
313
For more information on these tabs, see the Hyperion System 9 Planning Users Guide or Web help system. For more information on setting preferences, see the following topics:
Setting Personal Preferences on page 314 Setting Application Defaults on page 315 Specifying System Settings on page 316 Limiting Use of an Application During Maintenance on page 317 Specifying Custom Tools on page 317 Setting Display Options on page 318 Setting Printing Options on page 318
Administrators have access to a Show drop-down list that controls which tabs are available. Using the following tabs, administrators can set their personal preferences, set defaults for the application, and specify system settings.
Option on the Show Drop-down List Current Application Defaults Description By selecting Current Application Defaults and clicking Go, administrators have access to the Application Settings tab and the Display Options tab. When saved, the values set on these tabs become the application defaults. Other users can override these defaults, and can revert to the defaults by selecting the Use Application Defaults check box on the preferences tabs. For more information on setting these options, see the Hyperion System 9 Planning Users Guide or Web help system. Advanced Settings By selecting Advanced Settings and clicking Go, administrators have access to the System Settings tab and the Custom Tools tab. See Specifying System Settings on page 316 and Customizing the Planning Tools Page on page 340.
314
Select the Application Settings tab to set e-mail options, select an alias table, and set options for member selection and workflow. For more information on these options, see the Hyperion System 9 Planning Users Guide or Web help system. Select the Display Options tab to set options for number formatting, page selection, warnings for large data forms, and the number of dimensions to show on a page. For more information on these options, see the Hyperion System 9 Planning Users Guide or Web help system. Select the Printing Options tab to specify how pages are printed. For more information on these options, see the Hyperion System 9 Planning Users Guide or Web help system. Select the User Variables Options tab to limit the number of dimension members that display on a data form by setting a user variable. For information on setting up user variables, see Managing User Variables on page 273.
Note: Selecting the Use Application Default check box for an option resets the value to the current application default. See Setting Application Defaults on page 315.
Select the Application Settings tab to set e-mail options, select an alias table, and set options for member selection and workflow. For more information on these options, see the Hyperion System 9 Planning Users Guide or Web help system. Select the Display Options tab to set options for number formatting, page selection, warnings for large data forms, and the number of dimensions to show on a page. For more information on these options, see the Hyperion System 9 Planning Users Guide or Web help system.
5 Click Save.
When saved, these settings become the application defaults, which other users can select with the Use Application Defaults check box.
315
Options for System Settings Description In the text box, type the machine name of the server hosting e-mail services for the application users. For example: mail.hyperion.com From the drop-down list, select one of the following to set the character set used for e-mail messages: UTF-8 - to use the Unicode encoding format (this is the default) Regional Setting - to use the system's regional setting
From the drop-down list, select an option to set the date format for tasks in a task list: MM-DD-YYYY or DD-MM-YYYY.
Note: This setting changes the date display format only in the Edit Task dialog box.On all task list pages, the date display depends on the locale settings of your system.
In the text box, type the URL for the Shared Services server and click Register Shared Services. See Registering Applications on page 192. Select Yes to show users full names (for example, John Smith) in addition to their user name (for example, JSmith) when working with users. Select No to suppress the display of users full names.
Note: If the Display Users' Full Names check box is selected, you cannot have two users with identical full names. If you try to add a user with the same full name as an existing user, an error message is displayed.
Determine whether users can access the application when it is in maintenance mode, such as during backups. Select Owner, Administrators, or All users to give access to the application owner, to administrators, or to all users. See Limiting Use of an Application During Maintenance on page 317. Assign an administrator to be the application owner. (By default, the person who creates the application is the application owner. However, the owner may grant ownership to another administrator.)
Select User
316
6 Repeat the above steps for each application for which you want to specify system settings.
All users Enables all users to log on to the application or to continue working with the application if they are currently logged on. Administrators Enables only other administrators to log on to the application. Interactive users and planner user types are forced off and prevented from logging on to the application until the option is set back to All Users. Owner Enables only the owner of the application to log on to the application. All other users are prevented from logging on to the application or, if they are currently logged on, they are forced off the system until the option is set back to All Users or Administrators. This option is available only to the application owner; only the application owner can restrict other administrators from using the application.
6 If your selection is more restrictive than the current setting, you are asked to confirm your selection. Click
OK if you intend to limit access to the application.
7 Click Save.
317
For Name, enter the name that you want to display for the link. For URL, enter a fully qualified URL, such as http://www.hyperion.com For User Type, select the type of user that you want to access the link, such as Basic or Administrator.
6 Click Save.
3 Click Save.
Account annotations. See Deleting Account Annotations on page 319. Supporting detail associated with a scenario. See Deleting Supporting Detail Associated With a Scenario on page 319.
318
3 Run the queries in the aadelete.sql file that are appropriate for your relational database.
Example of Deleting Account Annotations In the following example, all account annotation for an account named Account1 is deleted:
DELETE FROM HSP_ACCOUNT_DESC WHERE ACCOUNT_ID=(SELECT OBJECT_ID FROM HSP_OBJECT WHERE OBJECT_NAME='ACCOUNT1') INSERT INTO HSP_ACTION (FROM_ID, TO_ID, ACTION_ID, OBJECT_TYPE, MESSAGE, ACTION_TIME, PRIMARY_KEY) VALUES (0,0,2,18,NULL,GETDATE(),NULL)
3 Run the queries in the sddelete.sql file that are appropriate for your relational database. 4 Start the Web application server.
319
Example of Deleting Supporting Detail Associated With a Scenario In the following example, all supporting detail of a scenario named Actual is deleted:
DELETE FROM HSP_COLUMN_DETAIL_ITEM WHERE DETAIL_ID IN (SELECT DETAIL_ID FROM HSP_COLUMN_DETAIL WHERE DIM1 = (SELECT OBJECT_ID FROM HSP_OBJECT WHERE OBJECT_NAME ='ACTUAL')); DELETE FROM HSP_COLUMN_DETAIL WHERE DIM1 = (SELECT OBJECT_ID FROM HSP_OBJECT WHERE object_name ='Actual');
Before you launch this utility, close the Manage Database task on the Planning Desktop. If the application server, HBR Service, or Hyperion RMI service is running when the Delete Shared Descendants utility is launched, you may see some java.rmi or Port already in use:11333 errors. They do not affect the functionality of this utility.
If you installed Planning in the default location, the Utils directory is in the following path: <drive letter>:\Hyperion\HyperionPlanning\Utils.
DeleteSharedDescendants <servername> <username> <password> <application> <member>
320
Table 55
DeleteSharedDescendants Utility Parameters Description The server name on which the Planning application resides. If the application resides on a remote server, the HspJsHome.properties file used by DeleteSharedDescendants.cmd must contain the appropriate remote server references for this application. For information on locating the properties file, see Default Location of the Properties File on page 45. The name of the Planning administrator The Planning administrator password The name of the Planning application that contains the shared dimension members to delete. The member whose shared descendants you want to delete.
Note: If a member name contains a space, you must surround it by quotation marks (for example, Member One). If the shared member itself is specified in the command line, a message No shared descendants of <member_name> were found is displayed.
Variable
<servername>
<member>
For example:
DeleteSharedDescendants localhost admin password BUDGET account200
For information on the results of running the utility, check the two log files, which are generated in the same directory as the utility:
DeleteSharedDescendants.log, which contains status messages. DeleteSharedDescendantsExceptions.log, which contains error messages.
Note: If you run this utility while the manage Database task is open on the Planning Desktop, there is no error message displayed, but the member is not deleted from the application. The LOG and CMD files in the Utils directory show that one shared member was found, but 0 shared members were deleted.
321
322
Chapter
14
In This Chapter
This section describes how to set up and customize menus, Smart Lists, UDAs, and member formulas in a Planning application.
Working with Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 Working with Smart Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Working with UDAs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Working with Member Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
323
Launch another application Launch a URL Launch a business rule, with or without runtime prompts Move to another data form Move directly to the Manage Process page with a predefined scenario and version
To support context-sensitive actions, the context of the right-click is relayed to the next action. Planning passes the following context: the POV and the Page, the member the user clicked on, andif you clicked on a rowthe members to the left on the row, orif you clicked on a columnthe members above the column. Use the Manage Menus page to create, edit, and delete menus. The page lists menus defined in the application. Notes:
When designing data forms, on the Other Options tab, you select which menus are available for Data Form menu item types. See Setting a Data Forms Display Options on page 264. As you update your application, update the appropriate menus. For example, if you delete a business that a menu references, remove it from the menu.
To create a menu, click Create, enter the name for the menu, and click OK. To change a menu, select it and click Edit. To delete menus, select them, click Delete, and click OK.
To add, change, or delete menu items, see Working with Menu Items on page 324.
324
3 First time only: To add the first item to the menu, click Add Child and Save. 4 Select a menu item and perform an action:
To add a menu item below the selected item, click Add Child (available only for Menu Header menu types). To add a menu item at the same level as the selected item, click Add Sibling. To edit a menu item, click Edit. To delete a menu item, click Delete. To change the order of menu items within the same level, click the Up or Down Arrow. You can move multiple items simultaneously.
Use the Edit Menu Item dialog box to define the menu item properties. See Adding or Changing Menu Items on page 325.
5 Click Save.
Click Save As to save the current selections under a new menu name.
Only alphanumeric and underscore characters (for example: Status) No special characters or spaces
Label
Enter the text to display when the menu is selected. Spaces and special characters are allowed. Menu labels are displayed in the user interface. Labels can either be text or they can reference a resource variable by name. For example, to set a menus label to File, either set it to File directly or set it to the name of a resourcesuch as LABEL_FILEwhich may be localized. For information on localizing labels, see Chapter 15, Customizing Planning Web Client.
Icon
Optional: In context of the Planning server, enter the path and filename to a graphic to display next to the menu. For example: /HyperionPlanning/Images/globe.gif
325
Item Type
Data Formlaunch a selected data form. Note: The member selection context for the member, page, and POV is retained when the user right-clicks in the source data form so that if the target data form contains any of these dimension members on the page, its page is set to match the context. URLnavigate the user to the specified URL Business Rulelaunch the selected business rule Workflowmove the user to the Manage Process page to work with a planning unit Menu Headercreate a menu under which you can create children menu items. To display a separator bar on the menu at this item, enter a single hyphen as the Label. In this case, the Required Dimension list is not available.
Your selection determines the available Properties. For example, no properties are available for the Menu Header type. Required Dimension Select the dimension for which the menu item is displayed. For example, if you select Account, when users click into Account members on a data form, this menu item is available with a right-click. Selecting No Required Dimension makes the menu available whenever the user right-clicks in the data form, regardless of the current dimension member.
5 Define menu item properties, which differ depending on the menu item type:
Type Data Form Options 1. From Data Form Folder, select the folder containing the destination data form. 2. From Data Form, select the data form. URL 1. In URL, enter the complete URL to which to direct the user. For example: http://<server name>/HFM/Logon/HsvLogon.asp. 2. Select Use Single Sign-on to append the SSO token to the URL. 3. Select Launch in a Separate Window to launch the URL in a separate window than Plannings main window.
326
Options 1. From Plan Type, select the plan type for which the business rule is available. 2. From Business Rules, select the business rule to launch. 3. From View Type, select how to display runtime prompt pages:
Classic Viewuse the default Planning view Streamline Viewdisplay each runtime prompt on a separate line instead of a section; eliminate icon and reduce screen text
4. Optional: In Window Title, enter a title to display instead of Runtime Prompts. 5. Optional: In OK Button Label, enter the text to display for the OK button. 6. Optional: In Cancel Button Label, enter the text to display for the Cancel button. 7. Optional: Select Launch in a Separate Window to launch the business rule in a separate window than Plannings main window. Workflow Specify the planning unit to which the user is directed by selecting a scenario and a version.
6 Click Save.
Users select one of the Smart List options as the value for the cell. Use the Smart Lists page to create, edit, and delete Smart Lists. The page lists Smart Lists defined in the application. An overview to using Smart Lists:
Define Smart Lists, described in this section. Associate Smart Lists with members (see Table 35, Member Properties, on page 146). Select dimensions for which Smart Lists are displayed (see Setting the Evaluation Order of Smart Lists on page 330).
327
Optional: Turn Smart Lists on or off for various data forms. See Setting a Data Forms Display Options on page 264. Optional: Use Smart List values in member formulas. See Including Smart List Values as Variables on page 336. Optional: Set how #missing cells associated with Smart Lists display in data forms. See Displaying #Missing with Smart Lists on page 331.
To create a Smart List, click Create, enter the name, and click OK. To change a Smart List, select it and click Edit. To delete Smart Lists, select them, click Delete and OK.
See Adding or Changing Smart List Properties on page 328 and Adding or Changing Smart List Entries on page 329.
Note: Data cells can display only one Smart List. If multiple Smart Lists intersect at cells, set which one takes precedence. See Setting the Evaluation Order of Smart Lists on page 330.
Only alphanumeric and underscore characters (for example: Position) No special characters or spaces
Smart List names can be referenced in formula expressions (see Working with Formula Expressions on page 334). Label Enter the text to display when the Smart List is selected. Spaces and special characters are allowed.
Note: Smart List labels can reference a resource, which can be translated into different languages. See About Customizing Text, Color, and Images on page 346.
Display Order
How Smart Lists are sorted in the drop-down list: by ID, Name, or Label
328
Description Enter a label (for example, No Justification) to be displayed as an entry in the Smart List whose value is #missing. Notes:
It displays as the first selection in the Smart List drop-down, allowing #missing as a valid selection in the data form. When the cell is not in focus, this label displays only if Drop-Down Setting is selected in the next option. Otherwise, #missing or a blank cell is displayed, depending on the Display Missing Values As Blank selection for the data form (see step 2 on page 265). #missing labels determine only the display of cells with #missing data; #missing remains the stored value.
See Displaying #Missing with Smart Lists on page 331. #Missing Data Form Label Determines how #missing vales are represented in cells associated with Smart Lists. Options:
Drop-Down Settingdisplays the label set in #Missing Drop-Down Label. Data Form Settingdisplays #missing or leaves cells blank, depending on the Display Missing Values As Blank selection for the data form (see step 2 on page 265). This selection determines what is displayed in the cell when it is not the focus. When the cell is in focus, the Smart List item that is selected from the drop-down is displayed.
See Displaying #Missing with Smart Lists on page 331. Automatically Generate ID Select to automatically generate the numeric ID for each Smart List entry. If you do not select this option, you can customize Smart List ID values. See Adding or Changing Smart List Entries on page 329.
For first items only: enter information into the first row. To add an item, click Add and fill in its row.
329
To delete an item, select it and click Delete. To edit an item, change the information in its row:
Entry Property ID
Description Unique number that sets the order for the displayed entry.
Note: Customizable only if Automatically Generate ID is not selected on the Properties tab.
Name
Only alphanumeric and underscore characters (for example: Customer_Feedback) No special characters or spaces
Label
Displayed text for the Smart List entry on the drop-down list (for example: Customer Feedback).
4 Perform an action:
Click Save. Select the Preview tab. See Previewing Smart Lists on page 330.
For each plan type, which dimensions display Smart Lists in data forms. If no dimensions are selected for a plan type, no Smart Lists are displayed. Which Smart List takes precedence when multiple Smart Lists intersect.
To turn Smart Lists on or off for dimensions and set their evaluation order:
1 Select Administration > Manage Smart Lists.
330
2 Select the Smart List Evaluation Order tab. 3 Select the plan type and click Go. 4 From Available Dimensions, select which dimensions display Smart Lists by moving them to Selected
Dimensions:
moves the selected dimensions moves all dimensions removes the selected dimensions removes all dimensions
Note: If there are no dimensions selected, no Smart Lists are available for the selected plan type. While you can select multiple dimensions per plan type, for ease of use, Hyperion recommends selecting one dimension per plan type.
5 For multiple dimensions, set the order of precedence for Smart Lists among the selected dimensions by
clicking or .
Smart Lists associated with the first dimension in the list take precedence over Smart Lists associated with the subsequent dimensions.
6 Click Save. 7 Set which data forms use Smart Lists (see Setting a Data Forms Display Options on page 264).
When designing the data form, select the option: Display Missing Values as Blank. When setting Smart List properties, select the option: Data Form Setting. When designing the data form, do not select the option: Display Missing Values as Blank. When setting Smart List properties, select the option: Data Form Setting.
#missing
Enter the custom label in the #Missing Drop-Down Label field (for example, No Change). Select the option: Drop-Down Setting.
331
See Adding or Changing Smart List Properties on page 328 and Setting a Data Forms Display Options on page 264.
3 From the dimension hierarchy, select any member and click Edit. 4 Select the UDA tab. 5 Optional: To create a new UDA, click Add.
See Creating UDAs on page 332.
6 Select UDAs for the member by moving them to Selected UDA and clicking Save:
moves the selected UDAs removes the selected UDAs removes all UDAs
7 Optional: To undo your changes and restore the previous information, click Refresh.
Creating UDAs
On the Create a UDA dialog box, you name the new UDA. See Working with UDAs on page 332.
332
To create a UDA:
1 Navigate to the UDA tab, following the first four steps in Working with UDAs on page 332. 2 On the UDA tab, click Add. 3 Enter a name and click Save.
See Changing UDAs on page 333.
Changing UDAs
On the Modify UDA dialog box, you change UDA names.
To change a UDA:
1 To navigate to the UDA tab, follow the first four steps in Working with UDAs on page 332. 2 On the UDA tab, select a UDA and click Edit. 3 Change the name and click Save.
Deleting UDAs
Deleting a UDA removes it for the whole dimension.
To delete a UDA:
1 Navigate to the UDA tab, following the first four steps in Working with UDAs on page 332. 2 Select the UDA and click Delete.
Note: If you delete a UDA, you must update all member formulas, calc scripts, and reports that reference it.
Any operator type, function, value, member name, UDA, and so on that is allowed in Analytic Services formulas (see the Hyperion System 9 BI+ Analytic Services Database Administrators Guide and Online Help) Predefined Planning formula expressionsincluding Smart List valuesthat expand into a formula or value upon database refresh (see Working with Formula Expressions on page 334)
333
3 Select the member. 4 Select the Member Formula tab. 5 In the text box, define formulas for the member.
See the Hyperion System 9 BI+ Analytic Services Database Administrators Guide for syntax, rules, and usage on Analytic Services formulas. Also see Working with Formula Expressions on page 334.
6 Optional: To check the validity of the member formula, click Validate Member Formula and OK. 7 Click Save.
Before you click Save, clicking Refresh restores the previous member formula information. See Viewing Details of Formula Validation on page 334.
3 Click OK.
You can update the dimension outline without updating all the business rules and calc scripts that depend on the outline. Calculations become much more independent of specifics in the outline.
334
You can use Smart Lists as objects in calculations. Performance is not decreased when you use formula expressions because they are run only when you refresh the database.
3 Select the member and click Edit. 4 Select the Member Formula tab. 5 In the text box, define formulas for the member.
You can include Planning formula expressions and Analytic Services native formulas in the member formula. See the Hyperion System 9 BI+ Analytic Services Database Administrators Guide for syntax, rules, and usage on Analytic Services native formulas. See Formula Expressions on page 336 for descriptions of the Planning formula expressions you can use in the member formula.
Note: Planning provides predefined formula expressions that you can use in member formulas. You cannot edit or create your own formula expressions.
6 Optional: To check the validity of the member formula, click Validate Member Formula and OK. 7 Optional: If there are errors in the member formula, click Show Details to view a description of the errors. 8 Optional: Click Refresh to restore the previous member formula if you do not want to save the changes you
made to the member formula.
9 Click Save.
Prerequisites
Before using formula expressions in member formulas, you should understand:
For more information, see the Hyperion System 9 BI+ Analytic Services Database Administrators Guide.
Syntax
Member formula expressions support functions and variables. Follow these syntax rules for functions and variables when you create formula expressions:
Enclose variables or properties with square brackets, [ ]. If you omit square brackets, the variable is treated as a native variable.
335
Enclose member names with quotation marks (for example, Account 200). Characters in variables are case-insensitive, but cannot have extra spaces or characters such as the underscore ( _ ). You can include subcalls to other functions within an expression. Do not enter text where a number is required. The order of the outline is important in a member formula. For example, do not reference a value that has not been calculated yet.
Formula Expressions
Planning formula expressions can include the following predefined variables and functions.
Table 56
Variables in Formula Expressions Description Generates an IF statement if the Planning application is a multi-currency application. Generates an empty string if the Planning application is a single currency application.
Note: This variable is used with ClosedInputValueBlock.
Variable OpenInputValueBlock
CloseInputValueBlock
Generates an End IF statement if the Planning application is a multi-currency application. Generates an empty string if the Planning application is a single currency application.
Note: This variable is used with OpenInputValueBlock.
NumberOfPeriodsInYear NumberOfYears
Returns the number of time periods in the year Returns the number of years in the application
336
Table 57
Functions in Formula Expressions Description Returns the name of a predefined dimension. The dimtags are:
Function Dimension(dimTag)
Period(periodName)
Generates a cross reference for the account Generates a cross-reference for the account. The account name contains a prefix that you define. The default prefix is No, followed by a blank space and the account name. For example, No Salary. Generates a member formula that returns an index for the time period; the index is based on the calendar year. Generates a member formula that returns an index for the time period; the index is based on the fiscal year. Generates a calendar year-to-date formula for the member Generates a calendar year-to-date formula for:
The member The time period index based on the calendar year The time period index based on the fiscal year
Use this function when the members are renamed. The default member names are: Cal TP-Index and Fiscal TPIndex.
337
You enter the wrong number of parameters in the formula expression. You misspell the member name in the formula. You do not surround the member name with quotation marks. You misspell the function or variable name in the formula expression. You include a number where a string is required.
338
Chapter
15
You can customize various different aspects of the Planning Web user interface: Links on the Tools page Style such as font size and alignment Style of rows and column members in data forms Text, images, and color Workflow
In This Chapter
Customizing the Planning Tools Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Customizing Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Customizing the Style of Row and Column Members in Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 About Customizing Text, Color, and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Customizing the Colors, States, and Actions for Process Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
339
7 From the User Type drop-down list, select which user type you want to have access to this link. Your choices
are Administrator, Interactive, and Basic:
Administrator users see all links Interactive users see interactive user and basic user links Basic users see basic user links
340
Changing font colors to add emphasis or create a color-coding scheme Adjusting the background color of certain UI elements Inserting your organizations logo Creating a different color scheme for the desktop
Before you customize a Planning cascading style sheet, ensure that you have basic knowledge of cascading style sheets and that you are familiar with style sheet editor tools. Some of the settings are necessary for the proper display of portions of the product. Changes to cascading style sheets are made on the Web application server, so any changes affect all users connected to the Web application server. Style sheets are located in the <DeploymentDirectory> for your Web application server. For information on where to find this directory for various Web application servers, see Default Location of Cascading Style Sheet Files on page 342. Planning primarily uses two cascading style sheets: a global sheet that defines Web UI elements common to multiple Hyperion products, and one that is specific to Planning. The global cascading style sheet is called global.css. The following table lists the major sections in the global.css file, and shows the sections that Hyperion strongly recommends against customizing.
Table 58
Major Sections in the global.css File Sections Not Recommended for Customizing Tadpole Menubar Tadpole Menuitem Menu Styles (order is important)
Tadpole Masthead Tadpole Content Area Tadpole Logon Styles Tabs Tab Anchor Tags Tab Body TaskTabs Task Tab Body
341
Table 58
Major Sections in the global.css File (Continued) Sections Not Recommended for Customizing
Customizable Sections Groupbox Groupbox Anchor Tabs Buttons When Drawing Buttons in HTML When Using Button Tag When Using Input Tag
3 Paste the CSS files into <DeploymentDirectory>\custom\HspCustom.css. 4 Make all changes to the HspCustom.css file in the following directory:
<DeploymentDirectory>\custom.
For information on customizing the styles in data forms to reflect members hierarchical positions within the row or column axis, see Customizing the Style of Row and Column Members in Data Forms on page 345. All Planning Web pages include a reference to the HspCustom.css file, and any settings made here override those in global.css and planning.css.
342
For information about the default directory of other Web application servers, see the following examples.
Example: Tomcat 5.0.28 C:\Hyperion\HyperionPlanning\AppServer\InstalledApps\Tomcat\5.0.28\ HyperionPlanning\webapps\HyperionPlanning Example: WebSphere C:\WebSphere\AppServer\installedApps\<server name>\ HyperionPlanning.ear\HyperionPlanning.war Example: WebLogic 8.1 C:\Hyperion\HyperionPlanning\AppServer\InstalledApps\WebLogic\8.1\ HPDomain
Applications deployed with WebLogic are deployed in .EAR format. This does not leave an expanded version of the files where you can easily modify the contents. If you are using WebLogic, you must extract the .EAR file, and then customize the settings. See Customizing Planning When Using WebLogic on page 349.
Before making any changes to a cascading style sheet, copy the original version and make it easily accessible. Styles that are common across multiple products can be found in the global.css file. Styles for products requiring unique styles can be found in the <productname>.css file. Some of the user interface controls are components that are part of third-party technologies used in Hyperion products. Changing the styles of these third-party controls requires changes in all associated files. Avoid making changes to styles that affect layout, including the following:
Changes to color affects the color of fonts. Changes to background affects the color of elements such as buttons. To change the color of hyperlink text, use the hyperlink style (a:link, a:hover, and a:visited). Carefully consider any changes to toolbar buttons, because the changes may require editing all of the buttons in the product. yperion toolbar buttons rely on a dark-blue background to be displayed properly.
343
Customization Examples
This section provides topics on common customizations:
Including Your Logo on page 344 Changing the Color of the Content Area Background on page 344 Changing the Color of Hyperlinks and Visited Hyperlinks on page 345
2 Open the global.css file using a style sheet editor tool. 3 In the Tadpole Masthead section of the global.css file, change the reference to the image:
.masthead TD.co_brand { background-image: URL("images_global/<image_name>.gif");
4 Open the BannerTop.jin file, and then make the same change to the <td> tag that has the following
comment: Insert Co-Brand Logo onto this TD.
<!--Insert Co-Brand Logo onto this TD --> <td class=co_brand logo_padding> <img class=co_brand src=<%=iconPath %>spacer.gif/> </td>
5 To change the image on the Logon screen to your organizations logo or image, replace the
logon_panel.jpg file with the new image in the following directory: <WebAppServer>\<ApplicationDirectory>\ui_themes\tadpole\images_global
344
Table 59
Changing the Color of the Content Area Background White Content Area Background
.content table.content { background: #ffffff; }
Changing the Color of Hyperlinks and Visited Hyperlinks Red Hyperlinks and Visited Hyperlinks
.content table.content { background: #ff0000; }
These customized styles are applied regardless of which dimension is displayed in the data form. Text alignment in rows is not supported. The styles are based on members displayed hierarchical level, not necessarily the Analytic Services relationships. Setting large font sizes on a row impacts the rows alignment. The customized styles are not reflected when the data form is printed to a PDF file.
345
Table 61
Header Tags in Planning.css File Columns columnHeader_0 columnHeader_1 columnHeader_2 columnHeader_3 columnHeader_4
The tags rowHeader_0 and columnHeader_0 affect the lowest-level class. The tags rowHeader_4 and columnHeader_4 affect the highest-level class. Members above level 4 display with the level 4 style.
Customizing Text, Color, and Images on page 346 Customizing Text in Non-Latin Languages on page 348 Restricted Characters in Customized Messages on page 349 Customizing Planning When Using WebLogic on page 349 Customizing Planning When Using WebLogic and UNIX on page 351
Labels and messages, using HspCustomMsgs_en.template Customizable colors and images, using HspCustomImgs_en.template
Whenever you add labels, you must add them to the HspCustomMsgs resource file. For example, when you add Smart Lists entries or menu items, include the new labels in the resource file. When your application is localized, update the corresponding resource file. For
346
example, to localize an application into three languages, add new labels to all three localized HspCustomMsg files (each with their language code in the filename) and include the translated words. When you make changes in these files, keep the following points in mind:
You must avoid certain characters when customizing text or messages. See Restricted Characters in Customized Messages on page 349. Some colors are named, and others are given as hex values or RGB values. Image file names and the Images directory are case-sensitive on some Web application servers and operating systems. You must store any new images that you add to the Web interface using HspCustomImgs_en.properties in the Images directory. If Planning was installed using the default Hyperion Home directory, the Images directory is located in the following path: <WebAppServer>\<applicationDirectory>\Images The silent deployment implemented by WebLogic 8.1 does not extract files from the EAR and WAR archives. You must manually extract, modify, and then archive the customization files. See Customizing Planning When Using WebLogic on page 349. To customize other types of images, see Customizing Cascading Style Sheets on page 341. The procedure describes how to customize the English messages in the HspCustomMsgs_en file. To localize the application, update the file for the appropriate language.
If Planning was installed using the default Hyperion Home directory, the HspCustomMsgs_en.template and HspCustomImgs_en.template files are located in the following path: <DeploymentDirectory>\Images For details about this path, see Default Location of Cascading Style Sheet Files on page 342. If you are using WebLogic, see Default Location of the Properties File on page 45.
3 Rename the files as HspCustomMsgs_en.properties and HspCustomImgs_en.properties. 4 Make your changes in the HspCustomMsgs_en.properties file and the
HspCustomImgs_en.properties file.
Each line in the HspCustomMsgs_en.properties file represents a text resource that you can customize. Each line in the HspCustomImgs_en.properties file represents a color or image resource that you can customize. The lines start with the name of the resource, followed by an equal sign and the resource that you can customize. You do not need to include punctuation at the end of the line. Carriage returns signal the end of the resource.
347
For example, you can change the Tools menu label used on the Tools > Links page from Tools: Analyze and Report to Tools: Additional Resources by going to the following line in the HspCustomMsgs_en.properties file:
LABEL_HOME_TOOLS=Tools: Analyze and Report
5 When you are finished making changes to the .properties files, save your changes. 6 For the changes to take effect, stop and restart the Web application server.
For the location of the properties file, see Default Location of the Properties File on page 45.
2 Rename the HspCustomMsgs_en.template file to HspCustomMsgs_ru.source. 3 Customize the .source file as needed with the appropriate label names, messages, and so on. 4 Copy a .BAT file similar to this sample file for Russian into the directory that contains your
HspJsHome.properties file:
@echo off echo Creating HspCustomMsgs_ru.properties set path=.;c:\bea\jdk131\bin set CLASSPATH=. native2ascii -encoding Cp1251 (To determine the correct encoding, see the note that follows these steps.) HspCustomMsgs_ru.source HspCustomMsgs_ru.properties pause
5 Edit the .BAT file to make sure the language settings and directory path to the native2ascii
executable are correct.
6 Run the .BAT file to generate the HspCustomMsgs_ru.properties file. 7 Restart the Web application server.
All characters should now display correctly. For a complete list of canonical encoding, refer to the following Web site: http://java.sun.com/j2se/1.3/docs/guide/intl/encoding.doc.html.
348
To generate a new .properties file, make any additional customization changes to the .source file, and then run the .BAT file again.
If the string includes quotation marks (), JavaScript reads it like this:
someJavaScript(some string with quotes);
Because JavaScript cannot parse double quotation marks, this results in errors. The best practice is to avoid using the following characters in custom messages:
Single quotation marks () Double quotation marks () Back slash (\) Forward slash (/)
349
5 Rename the files with the .properties extension (for example, HspCustomMsgs_en.properties
and HspCustomImgs_en.properties).
7 Cut and paste the .properties files to the same folder as the HspJSHome.properties file.
For the location of the properties file, see Default Location of the Properties File on page 45.
9 Create a folder called Images under C:\mytemp\ear, and then copy any customized image GIF files
into the C:\mytemp\ear\Images folder.
10 Create a folder called custom under C:\mytemp\ear, and then copy the HspCustom.css file to
C:\mytemp\ear\custom.
For example:
c:\mytemp\ear>c:\bea\jdk131\bin\jar uvf HyperionPlanning.war Images\*.gif
For example:
c:\mytemp\ear>c:\bea\jdk131\bin\jar uvf HyperionPlanning.war custom\*.css
12 Add the updated WAR file back into the EAR file.
a. If the command line is not already at this location: invoke the command line interface and navigate to the C:\mytemp\ear folder. b. Type the following command:
350
For example:
c:\mytemp\ear>c:\bea\jdk131\bin\jar uvf c:\bea\Hyperion\applications\HyperionPlanning.ear HyperionPlanning.war
13 Restart the WebLogic Web application server to redeploy HyperionPlanning.ear into WebLogic.
After you perform this procedure, you can make any modifications to messages directly in the HspCustomMsgs_en.properties file without going through the steps again. If the images exist in the Images folder, you can make any changes to the product areas where they are used directly in the HspCustomImgs_en.properties file without repeating these steps. However, if you add new images or modify the style sheet, you must perform these steps again.
2 Copy and paste the HspCustomMsgs_en.template file to the directory where the
HspJSHome.properties file is located.
The location of this file depends on where you decompressed the HyperionPlanning.ear file. See Default Location of the Properties File on page 45.
3 Rename the file to HspCustomMsgs_en.properties. 4 Update the HspCustomMsgs_en.properties file, and then save your changes.
For information on customizing this file, see Customizing Text, Color, and Images on page 346.
351
Customizing the Colors on page 352 Customizing the States on page 353 Customizing the Actions on page 354
This returns various information, including the state_id, the name of the process status state, and the color. By default, the value of the color is <NULL>, which converts to black. Note the state_id of the process status state for which you want to change the color, and then run the following query:
UPDATE HSP_PM_STATES SET COLOR = '<new color>' WHERE STATE_ID = <state_id>
To change the First Pass process status state color to green, run the following SQL statement:
UPDATE HSP_PM_STATES SET COLOR='GREEN' WHERE STATE_ID=1
Note: For an Oracle relational database, you must issue a COMMIT; command to commit the transaction.
352
Not Started First Pass Approved Not Signed Off Under Review Signed Off
The process status state information is stored in the HSP_PM_STATES table in the NAME column. You must run statements for your relational database to change the state value in the database. Example: SQL Relational Database Get a list of all the available process status states and their current names by running the following query:
select * from hsp_pm_states
This returns various information, including the state_id, the name of the process status state, and the color. Note the state_id of the process status state for which you want to change the name, and then run the following query:
UPDATE HSP_PM_STATES SET NAME = '<NewName>' WHERE STATE_ID = <state_id>
To change the Approved process status state name to Promoted, run the following SQL statement:
UPDATE HSP_PM_STATES SET NAME='PROMOTED' WHERE STATE_ID=1
Note: For an Oracle relational database, you must issue a COMMIT; command to commit the transaction.
353
The process status action information is stored in the HSP_PM_ACTIONS table in the NAME column. You will need to run statements for your particular relational database to change the action value in the database. Example: SQL Relational Database To get a list of all the available process status actions and their current names, run the following query:
select * from hsp_pm_actions
This returns various information, including the action_id and the name of the process status action. Note the state_id of the process status action for which you want to change the name, and then run the following query:
UPDATE HSP_PM_ACTIONS SET NAME = '<NewName>' WHERE ACTION_ID = <action_id>
To change the Approve process status action name to Accept, run the following SQL statement:
UPDATE HSP_PM_ACTIONS SET NAME='ACCEPT' WHERE ACTION_ID=1
Note: For an Oracle relational database, you must issue a COMMIT; command to commit the transaction.
354
Chapter
Troubleshooting
16
This section describes how to resolve some common issues.
In This Chapter Calculation Script is Too Long or Complex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Cannot Find Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Cannot Process Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Conflicting Change by Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Copy Version Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Currency Conversion Calc Script Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Database Locked by Another Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Exiting Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 500 Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 Manage Database Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 Maximum Number of Applications Already Connected or Database is Locked . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Missing Planning Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 Session Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Slow Performance When Opening Large Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Slow Performance When Opening Data Forms Using a Dial-Up Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 Unable to Create Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Unable to Refresh Application Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Unsuccessful Log On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Unable to Find Properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Troubleshooting
355
Solution:
2 If you still get the error message, then limit the calc script to only one reporting currency.
If you are successful in generating the calc script, try selecting two reporting currencies. If that works, then continue adding reporting currencies until you again get the error message. Then skip to step 3. If you are unsuccessful in generating the calc script with only one reporting currency, then you should remove some currencies from the application.
3 Use the Currency Conversion Calcscript option in the Manage Database task to generate as many other,
smaller currency conversion calc scripts as you need to include the desired scenarios, reporting currencies, and versions.
Solution:
356
Troubleshooting
All dimensions and members Users Groups Security Aliases Alias tables Exchange rates Year Period
Solution:
Solution:
357
Solution:
Solution:
Solution:
358
Troubleshooting
Exiting Planning
Scenario: In some cases, multiple instances of Planning processes may occur on the Planning server, especially if the processes are not completed between logon sessions, or if both the Web and NT client are opened simultaneously. This could result in the inability to refresh data and unnecessarily reduce available memory. After all Planning Web users are logged off, the administrator needs to manually remove these processes from the Planning server.
Solution:
Exiting Planning
359
Solution:
Solution:
360
Troubleshooting
To confirm that the DCOM users temp environment variables conform to an 8.3 naming
convention, complete one of the following procedures:
8 Open Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services
9.2, and then open the outline.
9 Close Essbase Administration Services for Essbase 7/Analytic Administration Services for Analytic Services
9.2, and then restart Planning.
10 Try to create or refresh the database with the Manage Database task on the Planning Desktop. If the error
recurs, repeat steps a) through i), but this time also create a folder called C:\tmp and set the System Environment variables Temp and Tmp to C:\tmp.
If after going through the above steps, the error persists, create a Temp folder under C:\temp. Repeat the previous steps, redirecting first the user variables and then the system variables to C:\temp\temp. If you continue to receive the error, redirect the environment variables back to C:\temp.
Note: The settings for Temp and Tmp in the user and system variables must be unique. Do not set the user and system variables to the same folder.
361
By default, the MAXAPPLS parameter is set to 40. Solution: You should increase the number of applications allowed by increasing the MAXAPPLS parameter.
where:
<database name> is the name of the relational database <n> is the number of applications that can be connected at one time
For example, to increase the number of maximum number of applications that can be connected at one time to 100 for a database named Business, you would specify:
db2 -v update db cfg for Business using MAXAPPLS 100 db2 -v terminate
Solution:
362
Troubleshooting
Session Timeout
Scenario: If a user quits a session by closing the browser instead of logging off, the session times out after a period of time, and the user name is removed from the Statistics page. You can change the number of minutes before the session times out by modifying the timeout settings for your Web application server. For example, for Apache Tomcat 5.0.28, modify the web.xml file in the Web-inf directory. For more information about modifying timeout settings, see the documentation for your Web application server.
Solution:
2 Modify the timeout setting for the Web application server, and then save your changes.
For example, for Apache Tomcat 5.0.28, change the number 60 in the session-timeout setting to the number of minutes you want to use. For more information about modifying timeout settings, see the documentation for your Web application server.
To set the number of data form cells that trigger a warning message upon opening:
1 In Planning, select File > Preferences. 2 Select the Display Options tab. 3 In the text box Warn If Data Form Larger Than __ Cells, type a value.
For more information on improving performance when you have a large number of users, see Clearing Options when Creating or Refreshing an Application Database on page 79.
363
Solution:
To modify the web.xml file to improve performance, for any Web application server except
WebLogic:
2 After the tag </description> and before the tag <listener>, insert the following lines:
<filter> <filter-name>HspCompressionFilter</filter-name> <filterclass>com.hyperion.planning.HspCompressionFilter</filter-class> <init-param> <param-name>compressionThreshold</param-name> <param-value>2048</param-value> </init-param> <init-param> <param-name>debug</param-name> <param-value>1</param-value> </init-param> </filter> <filter-mapping> <filter-name>HspCompressionFilter</filter-name> <url-pattern>/EnterData.jsp</url-pattern> </filter-mapping>
364
Troubleshooting
4 Compress the content in C:\war to C:\ear\HyperionPlanning.war. 5 Compress the content in C:\ear into C:ear\HyperionPlanning.ear 6 Deploy the new HyperionPlanning.ear for the WebLogic Web application server.
Solution:
Analytic Services must be running. Advanced User Rights must be set up on the local machine. Administrator user must be set up in DCOM for HsxServer and HspDataSource. If the Analytic Services supervisor username is the same as the Planning administrator username, the passwords must be identical. If you are using local authentication, the machine name must be different from the username. The name of the Planning application cannot be the same as an existing Analytic Services application name. If you are using DB2, you might get an error message if the database is not set up correctly. This error can be due to various causes, such as auditing tables that are not set up properly.
Solution:
365
4 Increase the size of each log file (for example, 2000). 5 Click Next to accept all the defaults. 6 On the Summary screen, enter the user name and password. 7 Click Finish. 8 Restart DB2. 9 Refresh the database.
Avoid the error by performing a database refresh more frequently, after making a few changes,
instead of waiting until you have made all changes into the application.
Unsuccessful Log On
Scenario: When logging on to Planning Web client, a user receives the error: Unsuccessful login. Please try again. Ensure that you are using a valid username and password. Ensure that Analytic Services server and Shared Services are running. Review the error log. If the Log On button does not appear when you are attempting to log on, you can resolve the problem by adjusting the security settings in your Web browser, and adding the Planning server name as a Trusted Site. For example, in Internet Explorer, select Tools > Internet Options > Security > Trusted Sites > Sites and add http://<servername> to the trusted sites zone.
Solutions:
Solution:
366
Troubleshooting
APPENDIX
This section describes how to use JavaScript to customize data forms. If you are a programmer familiar with JavaScript, you can customize the look and behavior of Planning data forms by writing custom JavaScript and including it in an application. To deploy the changes described in this section, use the instructions provided in Chapter 15, Customizing Planning Web Client.
In This Appendix
About Customizing Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 Modifying JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 Deploying Custom JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
387
You can add a button to a data form that links to any Web page or runs custom JavaScript code that you add. You can specify on which data forms the buttons appear. You can modify the applications behavior when a user saves a data form. You can replace or augment the default Planning behavior. You can modify the applications behavior when the focus enters or leaves a cell. You can replace or augment the default Planning behavior.
There are no additional system requirements for end users if you include custom JavaScript in your Planning application. Administrators do not have to take any special steps to enable the custom JavaScript for the application. You simply modify an existing JavaScript file with your changes, and the data forms you specify include your changes.
Modifying JavaScript
To add custom JavaScript to a Planning application, you modify the code in ValidateData.js, which is installed in \<default web application directory>\<Planning>\web\custom. For examples of how you can customize data forms, see the sample code and comments in SampleValidateData.js, which is installed in the \<default web application directory>\<Planning>\web\custom. See the following examples of default directories for Web application servers:
Example: Tomcat 5.0.28 C:\Hyperion\HyperionPlanning\AppServer\InstalledApps\Tomcat\5.0.28\ HyperionPlanning\webapps\HyperionPlanning Example: WebSphere C:\WebSphere\AppServer\installedApps\<server name>\ HyperionPlanning.ear\HyperionPlanning.war Example: WebLogic 8.1 C:\Hyperion\HyperionPlanning\AppServer\InstalledApps\WebLogic\8.1\ HPDomain
Applications deployed with WebLogic are deployed in .EAR format. This does not leave an expanded version of the files where you can easily modify the contents. If you are using WebLogic, you must extract the .EAR file, and then customize the settings. Planning provides the following functions to help you customize data forms:
customCellEnterPre on page 390 customCellEnterPost on page 391 customCellValidatePre on page 392 customCellValidatePost on page 393 customOnLoad on page 394
388
Modifying JavaScript
389
customCellEnterPre
Description Use customCellEnterPre when you want custom behavior to occur when focus comes into a cell, before the default Planning logic runs. For example, when the focus enters a cell, you can display a message that indicates the acceptable range for the value the user is about to enter. Or when the focus enters particular cells, such as certain accounts, you can display a message that prompts the user to enter supporting detail. After customCellEnterPre runs, if customCellEnterPre returns True, the Planning default logic runs. If customCellEnterPre returns False, no additional logic follows the custom code.
SampleValidateData.js includes an example that displays a message prompting the user to
enter supporting detail when the focus comes into particular cells. Arguments
Argument Row Col Cell Description An integer that defines the row for the cell. An integer that defines the column for the cell. A handle for the HTML input object.
Returns
Return Value True False Description Indicates that the Planning default logic will run after this code completes. Indicates that no further logic (Planning default logic or customCellEnterPost) will run after this code completes.
See Also
customCellEnterPost
390
customCellEnterPost
Description Use customCellEnterPost when you want custom behavior to occur when focus comes into a cell, after the default Planning logic runs. You can use customCellEnterPost in the same ways you can use customCellEnterPre.Choose which to use based on when you want the code to run.
customCellEnterPost runs when focus comes into the cell, after Planning's default logic if
both customCellEnterPre and Plannings default logic return True. If customCellEnterPre or Planning default logic returns False, this function is disabled. Return values have no effect.
SampleValidateData.js includes an example for customCellEnterPre that you can also use for customCellEnterPost. The example displays a message prompting the user to enter
supporting detail when the focus comes into particular cells. Arguments
Argument Row Col Cell Description An integer that defines the row for the cell. An integer that defines the column for the cell. A handle for the HTML input object.
Returns Returns
Return Value True False Description Indicates that the Planning default logic will run after this code completes. Indicates that no further logic will run after this code completes.
See Also
customCellEnterPre
Modifying JavaScript
391
customCellValidatePre
Description Use customCellValidatePre when you want custom behavior to occur when focus leaves a cell, before the default Planning logic runs. For example, you can compare the value a user entered for the cell to another value and display an alert if the variance is too great. Or you could limit a value to a range and display an alert if the value a user entered is out of the range. You could also define a new spreading algorithm that occurs when the focus leaves a cell, replacing the Planning default spreading algorithm. For example, usually Planning spreads by time period, but you can write custom JavaScript that pre-aggregates the data on the client side prior to writing the values back to Analytic Services. After customCellValidatePre runs, if customCellValidatePre returns True, the Planning default logic runs. If customCellValidatePre returns False, no additional logic follows the custom code. In this case, the data form uses your custom code and skips the Planning default logic, which could cause a user to submit an invalid grid.
SampleValidateData.js includes an example that executes additional validation when the
focus leaves a cell. When the focus leaves a cell, the JavaScript code compares the value the user entered for the current year to last years value. If the current years value is more than 10% larger than the previous year's value, a message is displayed. Arguments
Argument Row Col Cell Description An integer that defines the row for the cell. An integer that defines the column for the cell. A handle for the HTML input object.
Returns
Argument True False Description Indicates that the Planning default logic will run after this code completes. Indicates that the no further logic will run after this code completes.
See Also
customCellValidatePost
392
customCellValidatePost
Description Use customCellValidatePost when you want custom behavior to occur when focus leaves a cell, after the default Planning logic runs. You can use customCellValidatePost in the same ways you can use customCellValidatePre.Choose which to use based on when you want the code to run.
customCellValidatePost runs when the focus leaves a cell, after Planning's default logic if both customCellValidatePre and Plannings default logic return True.
If customCellValidatePre or Planning default logic returns False, this function is disabled. Return values have no effect.
SampleValidateData.js includes an example for customCellValidatePre that you can use for customCellValidatePost. The example executes additional validation when the
focus leaves a cell. When the focus leaves a cell, the JavaScript code compares the value the user entered for the current year to last years value. If the current years value is more than 10% larger than the previous year's value, a message is displayed. Arguments
Argument Row Col Cell Description An integer that defines the row for the cell. An integer that defines the column for the cell. A handle for the HTML input object.
Returns
Return Value True False Description Indicates that the Planning default logic will run after this code completes. Indicates that the no further logic will run after this code completes.
See Also
customCellValidatePre
Modifying JavaScript
393
customOnLoad
Description Use customOnLoad if you want custom behavior to occur when a data form is loaded (or reloaded). A new JavaScript variable called savedData indicates whether or not a Save has just been completed. You can customize the logic that occurs when the customOnLoad function is called, augmenting the default Planning logic. For example, when users open a data form, you could display an instruction, or you could add some checking to determine if the data loaded matches some tolerances and inform the users of any corrective actions that must be taken if it does not. Arguments No arguments. Returns No return values.
drawCustomButtons
Description Use drawCustomButton to add a custom button to a data form. The button can link to any data entry page or launch custom JavaScript code you include in ValidateData.js. You can specify on which data forms the buttons appear. For example, you can add a button that validates the data form, or add a button that runs a Hyperion Report.
SampleValidateData.js includes an example that adds a button labeled Validate to a data
form. When a user clicks the button, the JavaScript code compares the values entered for the current year to last years values. If the current years values are more than 10% larger than the previous year's values, a message is displayed. Arguments No arguments. Returns No return values.
394
validateForm
Description Use validateForm when you want to provide data form-level behavior that is launched when a user clicks Save. With the Planning default behavior, when a user clicks Save on a data form, the validateForm function submits the grid. You can customize the logic that occurs when the validateForm function is called, augmenting the default Planning logic. For example, you can calculate a variance between budget and actuals by comparing the values in two columns, and when a user clicks Save, display an alert if the variance is too high.
SampleValidateData.js includes an example that executes additional validation when a
user clicks Save. When a user clicks Save, the JavaScript code compares the values the user entered for the current year to last years values. If the current years values are more than 10% larger than the previous year's values, a message is displayed. Arguments No arguments. Returns
Return Value True False Description Saves the grid. Cancels the save.
Modifying JavaScript
395
Make sure you specify which data forms the code is applicable to. See the sample code in SampleValidateData.js for an example. You need to maintain the custom JavaScript when you upgrade to a new version of Planning. Because youre modifying a standard Planning JavaScript file, the next time you upgrade you need to merge your code with the updated version of ValidateData.js. (If there are no changes to ValidateData.js, you could back up the file before installing the upgrade of Planning and then copy your version of the file.) Because the default Planning calc scripts can run after the data on a data form is saved, the default calc scripts could overwrite the actions of your custom JavaScript. In addition, if you have set up any custom calc scripts that are set up to run automatically after the data on a data form is saved, these calc scripts could overwrite the actions of your custom JavaScript. If you are programming custom JavaScript that determines how values are propagated throughout the hierarchy, you need to be aware of the possible conflict with calc scripts. Custom JavaScript can modify cells that aren't visible on the data form if they are part of the data form design. For example, if a a quarter is collapsed, custom JavaScript can still affect the values for the individual months. Custom JavaScript cannot affect suppressed rows or columns. Depending on the complexity of the code, using the cell-level JavaScript functions could have an adverse effect on the performance of your application. For complex JavaScript, consider using the data form-level function (validateForm) or a custom button to launch the JavaScript code.
validateDataHelper.js, which is installed in \<default Web application directory>\<Planning>\web\custom, contains utility functions you might want to use.
If you choose to use custom JavaScript in your Planning application that overrides the Planning default behavior, you are responsible for making sure that the data is valid. You can use the default JavaScript functions that Planning uses for validation to verify that the data is valid after your custom JavaScript runs. These validation functions are in enterData.js, which is installed in \<default Web application directory>\ <Planning>\web. See the LeaveCell function for an example of how these functions are used.
396
APPENDIX
B
In This Appendix
This appendix describes the rules for naming applications, databases, dimensions, members, and aliases in Analytic Services. For detailed information on creating Analytic Services applications and databases, see the Analytic Services product documentation.
Naming Restrictions for Applications and Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 Naming Restrictions for Dimensions, Members, Aliases, and Data Forms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 Using Dimension and Member Names in Calculation Scripts, Report Scripts, Formulas, Filters, and Substitution Variable Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Naming Restrictions for User Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
397
Use no more than 8 bytes when naming non-Unicode-mode applications and databases; use no more than 30 characters when naming Unicode-mode applications and databases. Do not use spaces anywhere in the name. Do not use the following special characters anywhere in the name: asterisks backslashes brackets colons commas equal signs greater than signs less than signs periods In relational database environments, extended characters except for the underscore (_) character cannot be used in Planning application names. For aggregate storage databases only, do not use any of the following words as application or database names: DEFAULT LOG METADATA TEMP | + ? " ; / plus signs question marks double quotation marks semicolons single quotation marks slashes tabs vertical bars
* \ [] : , = > < .
Enter the name in the case in which you want the word displayed. The application or database name is created exactly as you enter it. If you enter the name as all capital letters (for instance, NEWAPP), Analytic Services does not automatically convert it to upper- and lowercase (for instance, Newapp).
398
Use no more than 80 bytes when naming non-Unicode-mode dimensions, members, or aliases; use no more than 80 characters when naming Unicode-mode dimensions, members, or aliases. Names are not case-sensitive unless case-sensitivity is enabled. See Setting Outline Properties in Hyperion System 9 BI+ Analytic Administration Services Online Help. Do not use HTML tags in member names, dimension names, aliases, and descriptions. Do not use quotation marks(" "), brackets ([]), backslash (\),or tabs anywhere in a name.
Note: Brackets ([]) are supported in block storage outlines, but are not recommended because their use causes errors when converting to an aggregate storage outline.
At the beginning of a dimension or member name, do not use the following characters: at signs backslashes braces commas dashes, hyphens, or minus equal signs less than signs Do not place spaces at the beginning or end of a name. Analytic Services ignores spaces at the beginning or end of a name. Do not use a forward slash (/) in member names. Do not use the following characters in data form names on Planning Web: quotation marks ("), forward slash ( /), or backward slash ( \) () . + ' _ | parentheses periods plus signs single quotation marks underscores vertical bars
@ \ {} , = <
Do not use a space in prefixes to time periods in custom calendars. Do not use the following words as dimension or member names:
Calculation script commands, operators, and keywords. For a list of commands, see the Analytic Services Technical Reference. Report writer commands. For a list of commands, see the Analytic Services Technical Reference. Function names and function arguments. For a list of functions, see the Analytic Services Technical Reference. Names of other dimensions and members (unless the member is shared), and generation names, level names, and aliases in the database.
399
Any of the following words: GENRANGE GROUP GT ID IDERROR INTEGER LE LEVELRANGE LOOPBLOCK LOOPPARMS LT MBR MBRNAME MBRONLY MINUS MISSING MUL MULOP NE NON NONINPUT NOT OR PAREN PARENPARM PERCENT PLUS RELOP SET SKIPBOTH SKIPMISSING SKIPNONE SKIPZERO TO TOLOCALRATE TRAILMISSING TRAILSUM UMINUS UPPER VARORXMBR XMBRONLY $$UNIVERSE$$ #MISSING #MI
ALL AND ASSIGN AVERAGE CALC CALCMBR COPYFORWARD CROSSDIM CURMBRNAME DIM DIMNAME DIV DYNAMIC EMPTYPARM EQ EQOP EXCEPT EXP EXPERROR FLOAT FUNCTION GE GEN
Note: If you enable Dynamic Time Series members, do not use the associated generation namesHistory, Year, Season, Period, Quarter, Month, Week, or Day.
400
Using Dimension and Member Names in Calculation Scripts, Report Scripts, Formulas, Filters, and Substitution Variable Values
In substitution variable values, calculation scripts, report scripts, filter definitions, partition definitions, or formulas, you must enclose member names in brackets ([]) when used within MDX statements and otherwise in quotation marks (" ") for block storage databases, in the following situations:
The name starts with one or more numerals (for example, 100). The name contains spaces or any of the following characters: ampersand asterisk at sign backslash braces colon comma dash, hyphen, or minus exclamation point equal sign ~ tilde
>
&
*
greater than sign less than sign parentheses percent sign period plus sign semicolon slash
< ()
%
@ \ {}
: ,
.
+ ;
! =
In calculation scripts and formulas, you must enclose member names that are also Analytic Services keywords in quotation marks (" ") for block storage databases, and in brackets ([]) for aggregate storage databases including the following member names: BEGIN DOUBLE ELSE END FUNCTION GLOBAL IF MACRO MEMBER RANGE RETURN STRING THEN You must enclose in quotes names that contain any of the following characters in calculation scripts, report scripts or formulas, and names that start with any of these characters: Spaces + - * / ( ) : , @ ; ) { } [ ] <
Using Dimension and Member Names in Calculation Scripts, Report Scripts, Formulas, Filters, and Substitution Variable Values
401
402
APPENDIX
C
The tables in this section list the common member attributes used in Shared Services. The tables list the common name for the attribute as used in Shared Services and the equivalent member attribute in the Hyperion product. The tables list only the attributes that are different between Shared Services and the other Hyperion products.
Note: NA indicates that the attribute is not used by the Hyperion product.
In This Appendix
Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Configuration Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Account Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Account Type Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Entity Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Scenario Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Version Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Year Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Consolidation Method Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Container Model Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Element Model Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
403
Member Attributes
Table 62
Common Member Attributes Hyperion Financial Management Attribute Description NA NA NA UserDefined1-3 NA NA NA NA NA IsCalculated=No NA NA NA NA Hyperion Business Modeling Attribute Name NA NA NA NA NA NA NA NA NA NA NA NA NA NA
Shared Services Attribute Alias SharedMember DataStorage2 DataStorage4 UDA1-n Consolidation Consolidation2 Consolidation4 MemberFormula2 MemberFormula4 DataStorage - StoreData DataStorage - SharedMember DataStorage - Dynamic Calc DataStorage - Dynamic Calc And Store DataStorage - None
Planning Attribute Alias DataStorage Reserved for future use Reserved for future use UDAs (Reserved for future use) AggSymbol (plantype1) AggSymbol (plantype2) AggSymbol (plantype3) Reserved for future use Reserved for future use Stored SharedMember Dynamic & Calc Dynamic-Calc & Store PlanType
Configuration Attributes
Table 63
Common Configuration Attributes Hyperion Financial Management Attribute DefaultCurrency NA NA NA FirstYear LastYear Hyperion Business Modeling Attribute CurrencyName NA NA OutgoingEmail Server NA NA
404
Table 63
Common Configuration Attributes (Continued) Hyperion Financial Management Attribute NA NA BaseFrequency NumberOfPeriods Hyperion Business Modeling Attribute NA NA TimelineType NA
Common Account Member Attributes Hyperion Financial Management Attribute AccountType NA AccountType Hyperion Business Modeling Attribute Type NA NA
Common Account Type Attributes Hyperion Financial Management Attribute Expense Income GroupLabel Hyperion Business Modeling Attribute Cost Revenue NA
Common Entity Member Attributes Hyperion Financial Management Attribute DefCurrency Hyperion Business Modeling Attribute NA
405
Common Scenario Member Attributes Hyperion Financial Management Attribute DefaultFreq ConsolidateYTD SupportsProcess Management Hyperion Business Modeling Attribute NA NA NA
Common Version Member Attributes Hyperion Financial Management Attribute NA NA Hyperion Business Modeling Attribute NA NA
Common Year Member Attributes Hyperion Financial Management Attribute Label Hyperion Business Modeling Attribute ID or Name
Common Consolidation Method Attributes Hyperion Financial Management Attribute ConsolMethod Description Hyperion Business Modeling Attribute NA NA
406
Common Container Model Attributes Hyperion Financial Management Attribute NA NA Hyperion Business Modeling Attribute LoginUserName Login Password
Planning Attribute NA NA
Common Element Model Attributes Hyperion Financial Management Attribute NA Hyperion Business Modeling Attribute Application
Planning Attribute NA
407
408
APPENDIX
D
In This Appendix
This appendix describes the structure of the Reference Applications for Planning. It also describes how to create and initialize the Reference Application.
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 About the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 About the Dimension Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 About the Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 About the Data Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 About the Business Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 About Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 About Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Creating the Reference Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Initializing the Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Creating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Loading Data into the Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 Upgrading to a Large Reference Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
409
Introduction
The Reference Application is a Planning application, included in the base installation of the product that provides sample application designs and application objects. The Reference Application contains a full set of dimensions, sample data forms, business rules, and reports. A data set is included to present a realistic application size and user experience. A wizard is provided to load the data for the application and increase the size of the application (including additional dimension members and data) from a small application to a larger application. For specifics about the application and the wizard for loading data and enhancing the size of the application, see About the Application on page 410 and Creating the Reference Application on page 414.
410
Dimension Members in Planning DatabaseSmall Application on page 411 Dimension Members in Planning DatabaseLarge Application on page 411
Planning DatabaseSmall Application Type Dense Dense Sparse Sparse Sparse Sparse Sparse Sparse Sparse Sparse Members 19 155 2,122 4 4 6 20 5 29 14 Members stored 19 148 1,208 4 4 6 20 5 29 14
Dimension Period Account Entity Scenario Version Currency HSP_Rates Year Segment Channel
411
Planning DatabaseLarge Application Type Dense Dense Sparse Sparse Sparse Sparse Sparse Sparse Sparse Sparse Members 19 1,233 20,094 4 4 6 20 5 29 14 Members stored 19 1,151 19,180 4 4 6 20 5 29 14
Dimension Period Account Entity Scenario Version Currency HSP_Rates Year Segment Channel
Database Created
Database Name X
Database Description Stores expenses related to departments and sales activity. Also stores data needed for the companys financial statement and capital-related expenses
412
Data Forms in Planning Size Small Medium Large Run Business Rules on Save Number of Cells 391 986 2,482 391
Form Name 03 Services Revenue - Installation 02 Other Operating Expenses 01 Dept Expenses 03 Services Revenue - Installation with HBR
Description This calculation takes unit values that are entered into the Units member and lags them one month in the member called Lagged Units 1 Mth. This calculation evaluates the value entered into Account member 506110 for the Individual Contractor Expense and determines the additional Individual Contractor expenses by different plan types.
IndivContr
413
About Users
The Reference Application for Planning includes only one user: the administrator who creates and initializes the Reference Application.
About Reports
The Reference Application for Planning includes the following set of predefined Financial Reporting reports:
Table 78
Predefined Reports for Planning Report Name 1.0 Department Expenses by Entity 2.0 Income Statement by Entity Description Details the specific, general, and administrative costs for FY05 and FY06 by Entity Provides an income statement that gives visibility into high-level revenue and expense components by Entity Details the revenue components by Segment, Channel, and Entity
Consol
414
3 Click OK and proceed through the Setup Application pages, as described in Chapter 3, Creating an
Application.
After you have created the Reference Application using the Setup Application, you must initialize it and create the database. See:
Initializing the Reference Application on page 415 Creating the Database on page 416
415
To initialize the Reference Application, from Planning Web, select Edit > Reference Application
> Initialize Reference Application.
Creating the Reference Application on page 414 Initializing the Reference Application on page 415
416
Creating the Reference Application on page 414 Initializing the Reference Application on page 415 Creating the Database on page 416
The Reference Application includes a Planning Reference Application Load and Upgrade Wizard that enables you to:
Load the initial data into the small application Upgrade the small application to a large application to enable you to work with larger applications.
This section describes how to use the wizard to load data. For information on upgrading from a small to a large Reference Application, see Upgrading to a Large Reference Application on page 418.
Note: To use the wizard, you must have installed the following on the Planning Desktop computer: Hyperion Application Link Basic 9.2 or 7.0, the Planning Adapter 9.2, and the Analytic Services Adapter 9.2.
3 Click Next. 4 On the Specify Planning Information page, enter the following information into the text boxes:
417
Table 79
Specify Planning Information Page Description The name you gave the Reference Application when you created it with the Setup Application task, as described in Creating the Reference Application on page 414. The name of the server on which the Reference Application is installed. Your user ID in Analytic Services. Your password in Analytic Services. Enter it again in the Confirm Password text box.
5 Click Next. 6 At the Summary page, review the information and if you are satisfied with it, click Load.
The Load process can take up to 20 minutes.
7 When a message displays that the load process has completed, take one of the following actions:
To exit the wizard, click OK. (You can skip the next steps.) To view any of the logs to learn more about the information that was loaded or problems encountered, click View Logs. Proceed to the next steps.
Data Load Message Logdata that was loaded Data Load Exception Logdata that could not be loaded
9 Click Close.
418
3 Click Next. 4 On the Specify Planning Information page, enter the following information into the text boxes:
Table 80
Specify Planning Information Page Description The name you gave the Reference Application when you created it with the Setup Application task, as described in Creating the Reference Application on page 414. Your user ID in Planning. The name of the server on which the Reference Application is installed. Your password in Planning. Enter it again in the Confirm Password text box. Your user ID in Analytic Services. Your password in Analytic Services. Enter it again in the Confirm Password text box.
Planning User ID Planning Server Planning Password Analytic Services User ID Analytic Services Password
5 Click Next. 6 At the Summary page, review the information and if you are satisfied with it, click Upgrade.
The upgrade process can take up to 30 minutes.
7 When a message displays that the upgrade process has completed, take one of the following actions:
To exit the wizard, click OK. (You can skip the next steps.) To view any of the logs to learn more about the information that was upgraded or problems encountered, click View Logs. Proceed to the next steps.
419
Member Load Message Log dimension members that were loaded Member Load Exception Logdimension members that could not be loaded Data Load Message Logdata that was loaded Data Load Exception Logdata that could not be loaded
9 Click Close.
420
Glossary
#Missing See missing data (#MISSING) account A dimension that represents an accounting container that identifies the location and primary nature of the data. account type The definition of how an accounts value flows over time, as well as its sign behavior. Account type options are expense, revenue, asset, liability, or equity. An additional account type option factor is used for calculation purposes. Expense examples: payroll expenses, salaries, office supplies, legal expenses, and rent. Revenue examples: sales, interest income, and other income. Asset examples: cash, accounts receivable, fixed assets, and accumulated depreciation. Liability examples: accounts payable, accrued expenses, and long-term debt. Equity examples: common stock, preferred stock, additional paidin-capital, and retained earnings. activity-level authorization Defines user access to application components and the types of activities they can perform on the application component. Activity-level authorization controls whether a given user may perform a certain action in an application and is independent of the data that will be operated on by the action. Data access is controlled by data-level authorization. adapter The fundamental elements in a Hyperion Application Link adapter process. Each adapter represents a set of specialized instructions. aggregate function An operation that summarizes or performs analysis on data. Sum, calculation of an average, and identification of a maximum value are examples of aggregate functions. alias An alternative name for a dimension, member, or description.
alias table A database table that contains a list of secondary names for a given member within a dimension. ancestor A branch member that has members below it. For example, in a dimension that includes years, quarters, and months, the members Qtr2 and 2001 are ancestors of the member April. application A related set of dimensions, dimension members, and plan types associated with a database that are used to meet a specific set of analytical and/or reporting requirements. application currency The default reporting currency for the application. application log A record of user actions performed on an application. application server A middle-tier server that is used to deploy and run Web-based application processes. asset account An account type that stores values that represent the assets of a company. asymmetric rows or columns A data form design characterized by groups of members that differ by at least one member across the groups. There can be a difference in the number of members or the names of members under each heading in the data form. For example, a data form could have three members (Product A, B, and C) grouped under East and two members (Product D and E) grouped under West. attribute A classification of a member in a dimension. For example, a Product dimension can have several attributes, such as Size and Flavor. A specific member of the Product dimension can have the Size attribute, 8, and the Flavor attribute, Cola.
Glossary
421
authentication Verification of identity as a security measure. Authentication is typically based on a user ID and password. Passwords and digital signatures are forms of authentication. balance account An account type that stores unsigned values that relate to a particular point in time. base currency The currency in which daily business transactions are performed. base entity An entity at the bottom of the organization structure that does not own other entities. broadcast message A simple text message sent by an administrator to a user who is logged on to a Planning application. The message displays information to the user such as system availability, notification of application refresh, or application backups. budget administrator A person responsible for setting up, configuring, maintaining, and controlling an application. Has all application privileges and data access rights. business rules Logical expressions or formulas that are created within an application to produce a desired set of resulting values. calculated data field A calculated data field is a field that holds a data value resulting from a formula or arithmetic calculation as opposed to being retrieved as a stored data value from a database. calculation script A file containing commands that define how a block storage database is consolidated or aggregated. A calculation script may also contain commands that specify allocation and other calculation rules separate from the consolidation process. calendar User-defined time periods and their relationship to each other. Q1, Q2, Q3, and Q4 comprise a calendar or fiscal year. cell A unit of data representing the intersection of dimensions in a multidimensional database; the intersection of a row and a column in a worksheet. child A member that has a parent above it in the database outline. column A vertical display of information in a grid or table. A column can contain data from a single field, derived data from a calculation, or textual information.
cube A block of data that contains three or more dimensions. Multidimensional cubes are better suited for complex data analyses than for relational databases because relational databases are limited to two dimensions. An Analytic Services database is a cube. currency The monetary unit of measure associated with a balance or transaction. currency code A three-character ISO (International Standards Organization) code used to identify a countrys currency. US dollars = USD, British pound sterling = GPB, Japanese Yen = YEN currency conversion A process that converts currency values in a database from one currency into another currency. For example, to convert one U. S. dollar into the euro, the exchange rate (for example, 0.923702) is multiplied with the dollar (1* 0.923702). After conversion, the euro amount is.92. custom dimension A dimension created and defined by users. For example, channel, product, department, project, or region could be custom dimensions. custom property A property of a dimension or a dimension member that is created by a user. data The values (monetary or nonmonetary) associated with the query intersection. data form A grid display that allows users to enter data into the database from a Web browser, and to view and analyze data or related text. Certain dimension member values are fixed, giving users a specific view into the data. data source 1. A data storage application. Varieties include multidimensional databases, relational databases, and files. 2. A named client-side object connecting report components to databases. Data source properties include database connections and queries. data type Defines the kind of data associated with an account member: currency, non-currency, or percentage. default A pre-loaded response to a request for data and the accepted value if no data is entered. dense dimension A dimension likely to contain data for every combination of dimension members. For example, a time dimension is typically a dense dimension because it contains all combinations of all members. Contrast with sparse dimension.
422
Glossary
dependent entity An entity that is owned by another entity in the organization. descendant Any member below a parent in the database outline. For example, in a dimension that includes years, quarters, and months, the members Qtr2 and April are descendants of the member Year. destination currency The currency to which the balances will be converted. You enter exchange rates and convert from the source currency to the destination currency. For example, when you convert from euros to USD, the destination currency is USD. dimension A data category that is used to organize business data for retrieval and preservation of values. Each dimension usually contains a hierarchy of related members grouped within it. For example, a Year dimension often includes members for each time period, such as quarters and months. Other common business dimensions may be measures, natural accounts, products, and markets. dimensional hierarchy A type of Shared Services model that typically includes a hierarchy of related group members, such as entities or accounts. See also model. direct rate A currency rate that you enter directly in the exchange rate table. The direct rate is used for currency conversion. For example, assume you want to convert balances from GBP to USD. In the exchange rate table, you enter a rate for the period/scenario where the source currency is GBP and the destination currency is USD. drill-down Navigation through the query result set using the organization of the dimensional hierarchy. Drilling down moves the user perspective from general aggregated data to more detailed data. While default drill down typically refers to parent-child navigation, drilling can be customized to use other dimension member relationships. For example, drilling down can reveal the hierarchical relationships between year and quarters or between quarter and months. entity A dimension representing organizational units, which can be divisions, subsidiaries, plants, regions, products, or any other financial reporting unit. exchange rate A numeric value used to convert one currency to another. For example, to convert $1 into Euros, the exchange rate of 0.8936 is multiplied with the dollar. The Euro equivalent of $1 is 0.8936.
exchange rate type An identifier associated with an exchange rate. Different rate types are used because there may be more than one rate for a period and year. Users traditionally define a rate at period end for the average rate of the period and also a rate for the end of the period. Additional rate types are historical rates, budget rates, forecast rates, and so on. All of these exchange rate types apply to the same point in time. expense account An account type that stores periodic and year-to-date values that decrease net worth if the value is positive. export The process of moving a model, including its contents, from the application to Shared Services. See also model. external authentication The practice of storing user logon credentials in a corporate authentication repository (such as a Lightweight Directory Access Protocol [LDAP] directory) as an alternative to maintaining users and groups that are native to each Hyperion product. file delimiter One or more characters, such as a comma (,), separating fields in a data source. filter In Shared Services, a method that enables users to filter selected members from the model when the model is imported. See also model. frame An area of the desktop where information is displayed to the user. There are two main areas on the desktop: the navigation frame and the workspace frame. generation A layer in a hierarchical tree structure that defines member relationships in a database. For example, generations are ordered incrementally from the top member of the dimension (generation 1) down to the child members. hierarchy A set of multidimensional relationships in an outline, often created in a tree formation. For example, parents, children, and generations represent a hierarchy. Hyperion Application Link A suite of application integration services that connect resource planning systems, transaction processing applications, and other data sources with Hyperions analytic applications.
Glossary
423
Hyperion System 9 Business Rules An application module for application designers who need to create, document, and maintain complex allocation processes and business rules for analytic applications throughout an organization. Hyperion System 9 Financial Reporting A graphical report writer that enables users to create a wide variety of financial reports for printing and online access. Hyperion System 9 Shared Services An application enabling users to share data between supported Hyperion products by publishing data to Shared Services and running data integrations. import The process of moving a model, including its contents, from Shared Services to the application. See also model. input currency type An attribute that designates the currency type of the values that are entered and stored in the applications. interactive user Interactive users can review and approve budgets, set up e-mail notification to other users, create Web-based data forms, create worksheets using Smart View for Office, create reports using Financial Reporting, create and launch integrations using Hyperion Application Link, create and launch business rules using Business Rules and/or Analytic Services, enter and view data in Web data forms and Smart View. iteration A pass of the budget or planning cycle in which the same version of data is revised and promoted. liability account An account type that stores point in time balances that represent the liabilities of a company. Examples of liability accounts include accrued expenses, accounts payable, and long term debt. local currency Any input currency type. When an input currency type is not specified, the local currency is the same as the entitys base currency. log A system-maintained record of transactional data resulting from actions and commands. log file A system-maintained file that records transactional data resulting from actions and commands. For example, an application log file records user actions that are performed on that application; a client log file records client messages, actions, and errors.
member A discrete component within a dimension. For example, a time dimension might include such members as Jan, Feb, and Qtr1. metadata The structure elements of an application that describe and hold data. Examples of metadata are dimension names, member names, properties, exchange rates, and security. missing data (#MISSING) A marker indicating that data in the labeled location does not exist, contains no value, or was never entered or loaded. For example, missing data exists when an account contains data for a previous or a future period but not for the current period. model A file or string of content containing an application-specific representation of data. Models are the basic data managed by Shared Services. Models are of two major types: dimensional and non-dimensional application objects. multidimensional database (MDDB) A method of organizing, storing, and referencing data through three or more dimensions. An individual value is the intersection of a point for a set of dimensions. navigation frame The left side of the desktop where you access applications and their related components. The tasks presented in the navigation frame are based upon the users security rights. page axis Enables you to set up views (pages) of selected members, to organize the data in a data form into smaller, logical groups. Each page on the page axis can have members selected from one dimension or from multiple dimensions. For example, you could set up one page to enter data for Radio promotions and another page to enter data for Web promotions. parent A member that has an aggregated branch of children below it. planner Planners comprise the majority of users and can enable e-mail notification for themselves, input, submit, and view data, user reports that have been created by others, run data integration routines, execute business rules, and use Smart View for Office. planning unit A slice of data at the intersection of a scenario, a version, and an entity. It is the basic unit for preparing, reviewing, annotating, and approving plan data.
424
Glossary
POV (point of view) A feature that lets you work with members of dimensions that are not assigned to a row, column, or page axis. For example, you could assign the Currency dimension to the POV and select the Euro member. By selecting this POV in a data form, all the data in the form is displayed in Euro values. precision Number of decimal places displayed in a number. private application An application for the exclusive use of a product to store and manage Shared Services models. process pad A button bar in the top part of the workspace frame that guides users through a series of screens related to a process. promote The action to move a data unit to the next review level. This would allow a user who has the appropriate access to review the date. For example, an analyst may promote the data unit to the next level for his supervisors review. RDBMS See relational database management system (RDBMS). relational database A type of database that stores data in the form of related tables. A single database can be spread across several tables, and can be viewed in many different ways. Contrast with multidimensional database (MDDB). relational database management system (RDBMS) A database management system for accessing data in a relational database and storing data in the form of related tables. A RDBMS takes SQL statements entered by a user or contained in an application program and creates, updates, or provides access to the relational database. report A layout that dynamically identifies the content and formatting of a report. Reports become populated with data when they are run. reporting currency The currency in which an enterprise prepares its financial statements. Planning supports currency conversions from local currencies to one or more reporting currencies. The converted reporting currency values are stored. row A horizontal display of information in a grid or table. A row can contain data from a single field, derived data from a calculation, or textual information. The words row and record are sometimes used interchangeably.
runtime prompt A system variable that allows values to be entered during the execution of an allocation process. Values can be members, strings, or numbers. saved assumptions Planning assumptions that are created either globally or locally. The saved assumptions can be named, saved and referenced in planning methods and allocations to help drive plan and budget values. scaling Determines how currency values are displayed in a data form or report: in whole numbers, tens, hundreds, thousands, millions, and so on. scenario A dimension that specifies a data classification. Examples include Actuals, Budget, Forecast1, and Forecast2. security agent A Web access management solutions provider employed by companies to protect Web resources; also known as Web security agent. The Netegrity SiteMinder product is an example of a security agent. security platform A framework providing the ability for Hyperion applications to use external authentication and single sign-on. security rights Rights defined by a users data access permissions and activity-level privileges as explicitly defined for a user and as inherited from other user groups. shared application An application in Shared Services that enables two or more products to share their models. See also model. shared member A member that shares storage space with another member of the same name. A storage property designates members as shared. The use of shared members prevents duplicate calculation of members that occur more than once in an Analytic Services outline. shortcut menu A menu that is displayed when you rightclicks a selection, an object, or a toolbar. A shortcut menu lists commands pertaining only to that screen region or selection. sibling A child member at the same generation as another child member and having the same immediate parent. For example, the members Florida and New York are both children of East and siblings of each other.
Glossary
425
single sign-on The ability of an externally-authenticated user to access multiple, linked Hyperion applications after logging on to the first application. The user can launch other applications from the first application (and from other linked Hyperion applications) without logging on again. The users ID and password are already authenticated. sparse dimension A dimension unlikely to contain data for all combinations of dimension members. For example, product and market dimensions are sparse if not all products are sold in all markets. Contrast with dense dimension. substitution variable A variable that acts as a global placeholder for information that changes regularly. The variable and a corresponding string value is set; the value can then be changed at any time. Substitution variables can be used in calculation scripts, report scripts, rules files, outline formulas, security filters, partition definitions, MDX statements, Smart View for Office, Analytic Services API, and Planning data forms. supporting detail Calculations and assumptions from which the values of cells are derived. Supporting detail can include text, values, and operators that define how data aggregates. synchronized The condition that exists when the latest version of a model resides in both the application and in Shared Services. See model. system administrator A person responsible for installing and initially configuring Planning, including setting up security. time dimension A dimension that defines how often data is collected and updated, such as fiscal or calendar periods. triangulation currency A currency through which exchange rates can be derived. For example, if you set up the Euro/Dollar exchange rate and the Euro/Yen rate, the Dollar/Yen rate can be derived by using Euro as the triangulation currency. user variable A variable that dynamically renders data forms based on a users member selection, displaying only the specified entity. For example, the user variable named Department enables you to display only specific departments and employees. variance The difference between two values (for example, between a planned and actual value).
version A possible outcome used within the context of a scenario of data. For example, Budget - Best Case and Budget - Worst Case where Budget is the scenario and Best Case and Worst Case are the versions. workspace frame The area on the right of the desktop that displays the window related to the task currently selected in the left navigation frame.
426
Glossary
Index
Symbols
#missing data displaying as empty cells, 265 in accounts calculations, 141 representing with Smart Lists, 331 suppressing in columns, 254 suppressing in rows, 255 #Missing Data Form Label option, 329 #Missing Drop-Down Label option, 329
access statistics, 65 access to application, withdrawing, 317 Account dimension, 138 Account members account types, 139 annotating, 264 data type and exchange rate type, 143 plan types, 138 refreshing, 69 saved assumptions, 142 account types and variance reporting, 141 default time balance property, 140 described, 139 examples of use, 139 summary of, 140 Actual_365 weighted average time balance, 141 Actual_Actual weighted average time balance, 140 Ad Hoc analysis grid, 24 adapter palette, 180 adapter process creating, 180 running, 186 Add Smart List Entries tab, 329 administrators and application ownership, 31, 316 application owner, 31 creating business rules, 34 creating metadata, 31 creating the application, 32 designing data forms, 33 populating the application, 34 setting up security Advanced Settings option described, 314
Numerics
4-4-5 weekly pattern, 57 500 error message, 360 5-4-4 weekly pattern, 57 56K dialup connections, using, 49
A
access rights assigning to data forms, 271 assigning to members, 149 assigning to task lists, 300 assigning to users and groups, 84 available options, 84 clearing all, 86 data forms, 246 defining for scenarios, 167 deleting for members, 151 importing, 86 inheritance options, 85 modifying for members, 151 overview, 32, 82 reporting on, 88 See also security
Index Symbols
427
using, 316 aggregation options, 132 alias names about, 96 displaying on data form rows, 256 alias tables clearing, 98 copying, 98 creating, 97 deleting, 98 editing, 97 setting the application default, 99 Allow Multiple Currencies Per Entity option, 265 Allow Search When Number of Pages Exceeds option, 263 Allow Users to Dynamically Add Rows option, 255 Analytic Services closing, 50 connecting to multiple servers, 42 multidimensional databases, 66 naming restrictions, 397 overview of, 27 starting, 42 working with partitions, 72 Analyze and Report page, setting links for, 317 ancestors, determining for a member, 131 annotating accounts, 264 cells, 266 planning units, 285 application databases, implications of creating, 66 overview to creating and refreshing, 32 overview to populating with data, 34 overview to setting up, 30 ownership, 31, 316 application currency conversion calcscript and batch refresh, 74 and create database, 66 application databases about, 66 refreshing, 69 refreshing incrementally, 69 scheduling a refresh, 72 application defaults overriding, 315
setting, 315 Application drop-down list, 49 Application Maintenance Mode, 317 application management. See Shared Services applications. application servers registering, 50 unregistering, 50 applications backing up, 61, 79 choosing, 55 closing, 63 copying and renaming, 312 creating, 55 creating additional, 60 creating the calendar, 56 currency conversion calcscripts, 67 data source for, 55 defining currencies, 58 defining the calendar range, 57 deleting, 61 forcing users off, 317 moving, 306 naming, 56 naming rule, 397 opening, 61 optimizing performance, 76 overview, 54 problem creating, 365 problem refreshing, 365 Reference Application, 410 registering for Shared Services, 316 saving, 59 setting up plan types, 58 Setup Application task, 55 unlocking, 63 using, 60 Apply Precision option, 266 Apply Security check box, 145 APPSCHEDULER utility, 72 ARBORPATH variable, xix asset account type, 140 example, 139 Assigned Access check box, 91 asymmetric rows and columns, 262 attribute values
428
Index A
as members on data forms, 259 assigning to members, 160 defining, 159 deleting, 162 effect of changing dimension from sparse to dense, 157 loading, 181 modifying, 162 overview, 159 using in data forms, 163 using in Hyperion Application Link, 164 attributes creating, 157 deleting, 158 effect of changing dimension from sparse to dense, 157 modifying, 158 on data forms, 248 overview, 155 refreshing, 69 renaming, 158 using in data forms, 163 using in Hyperion Application Link, 164 audience for this guide, xv audit trails, 91 clearing, 93 Automatically Generate ID option, 329 Average option in Exchange Rate Table window, 120 average time balance property, 140
editing, 107 bottom-up versions, 171 and currency calculations, 70 broadcast messaging, 63 BroadcastMessage.exe file, 64 browser controls, hiding, 49 budget process impact of the entities hierarchy, 287 initializing, 36 overview, 22, 284 overview to cycle, 36 post-planning activities, 40 starting the review cycle, 38 Business Rule menu item, 326 properties, 327 Business Rules and broadcast messages, 64 and usage statistics, 65 creating business rules, 34 enabling for Planning, 44 migrating data, 308 overview of, 28 user roles, 35 business rules about runtime prompts, 270 and dynamic calc members, 268 and Smart View, 34 Classic View, 327 in Reference Application, 413 launch upon Save, 269 launching overview, 38 migrating, 308 overview to setting up, 34 overview to using with data forms, 267 selecting members for runtime prompts, 269 Streamline View, 327 using, 267 using for rates, 267
B
background mode, importing users, 87 backing up an application, 79 databases, 69 system tables, 61 balance property, 140 bandwidth, increasing, 364 base currency for Entity members, 138 base time period defining, 56 spreading data, 56 BegBalance member. See Beginning Balance time period BegBalance option in Exchange Rate Table window, 120 Beginning Balance time period and exchange rates, 111 and scenarios, 167
C
Calculate Currencies business rule about, 110 creation, 269 deselecting, 268
Index B
429
importance of launching order, 269 with multiple currencies, 247 Calculate Data Form business rule and Smart View, 110 creation, 269 creation of, 268 description, 110 importance of launching order, 269 Run on Save option, 37 calculation method of currency conversion, 119 calendar range, defining, 57 Calendar workspace frame, 56 calendars adding years to, 105 changing the current year or time period, 106 creating in applications, 56 creating summary time periods, 103 defining roll ups, 102 deleting summary time periods, 104 practical limits, 103 setting up, 102 cascading style sheets, customizing, 341 category nodes on the Desktop, 47 cell text, show, 266 cells, read-only, 253 to 254 change-tracking, 91 characters, reserved, 398 Classic View option, 327 ClosedInputValueBlock variable, 336 closing applications, 63 Planning, 50 collapsed member list, setting, 256 colors, customizing in the UI, 346 column definitions adding, 256 changing, 257 column properties, setting, 255 Column Width option, 254 columns read-only, 253 separators for, 253 suppress hierarchy, 253 commands, Help menu, xviii common member attributes in Shared Services, 403 compression filter, 364
conflicting changes to data, 357 consulting services, xx Copy Data, 302 Copy Data Link feature, 299 Copy Version error when using, 358 using, 174 copying an application, 312 data, 302 supporting detail, 302 CrossRef(accountName) function, 337 CrossRef(accountName, prefix) function, 337 CSS files, customizing, 341 cubes. See databases currencies calculating conversions, 119 conversions with, 58 creating, 113 data forms, 247 defining in an application, 58 deleting, 116 editing, 115 enabling multiple, 109 multiple, 58 reporting, 112 viewing information about, 112 currency conversion calc script failed, 358 optimizing performance, 68 setting parameters, 67 too long, 356 Currency option in Exchange Rate Table window, 119 Current Application Defaults option about, 314 using, 315 custom attribute display, enabling, 145 custom tools, setting, 317 customCellEnterPost, 391 customCellEnterPre, 390 customCellValidatePost, 393 customCellValidatePre, 392 customizing text about, 346 in non-Latin languages, 348 customizing the UI
430
Index C
of data forms, 387 of row and column members, 345 of the Tools page, 340 of the Web client, 339 text, color, and images, 346 when using WebLogic, 349 when using WebLogic and UNIX, 351 with a cascading style sheet, 341 customOnLoad, 394 CYTD(memberName) function, 337 CYTD(memberName, calTpIndexName, fiscalTpIndexName) function, 337
layout, 252 members, 258 menus, associating with, 266 modifying, 276 moving, 276 to 277 multiple currencies, 269 naming restrictions, 399 optimizing calculations, 248 options, 264 overview to setting up, 33 page axis, 249 plan types, 246 point of view, 248 previewing design, 270 printing form definitions, 274
D
data copying, 302 distribution over time, 56 importing, 186 read-only, 254 suppress missing in columns, 254 suppressing missing in rows, 255 data entry forms. See data forms data files load file example, 188 loading, 182, 187 Data Form menu item, 326 properties, 326 data forms about, 246 access rights, described, 246 assigning access rights, 271 asymmetric rows and columns, 262 attribute values as members, 259 attributes, 248 business rules for, 268 creating, 251 currencies, 247 customizing with JavaScript, 388 designing with multiple currencies, 247 displaying Smart Lists in, 330 exporting, 281 importing data form definitions, 277, 281 in Reference Application, 413 large, improving performance, 363
printing options, 265 properties, 252 read-only, 252 to 254 rows and columns, 249 searching for, 275 segments, 252 separators, 253 to 254 shared members, 248 versions, 247 data integrations. See Shared Services data integrations. data load dimension, 182 Data Load page, 182 data source name (DSN), 55 Data Storage property about, 132 setting, 145 data type for Account members, 143 Database check box. See refreshing databases databases Analytic Services, 66 implications of creating, 66 naming rules, 397 See also applications, application databases setting restructuring interval, 71 unlocking, 358 DB2 See IBM DB2 DCOM, configuring, 82 decimal places on the data form, 254 defaults about setting, 314
Index D
431
alias table, 99 custom tools, setting, 317 overriding with personal preferences, 314 setting for the application, 315 setting system, 316 Define Basis tab, 56 Define Range tab, 57 DeleteSharedDescendants utility, 320 dense dimensions, 124 and performance, 77 changing to sparse, 157 Dependency check box, 293, 296 deployment scenario, 29 Desktop. See Planning Desktop dialup connections, 49 dimension hierarchy expanding and collapsing, 127 finding members in, 128 moving members, 129 navigating, 127 setting the number of members displayed, 128 sorting members, 128 Dimension(dimtag) function, 337 dimensions Account, 138 aggregation options, 132 collapsing, 127 dense, 124 Entity, 137 expanding, 127 finding, 128 hierarchies, 125 naming, 397 overview, 124 relationship to members, 124 See also members sparse, 124 storage options, 132 user-defined, 143 Display Missing Values as Blank option, 265 Display Order option for Smart Lists, 328 Display Users Full Names option and importing security, 88 setting, 316 distribution of data over time periods, 56
documents conventions used, xviii feedback, xx structure of, xvi documents, accessing Hyperion Download Center, xvii Hyperion Solutions Web site, xvii Information Map, xvii online help, xvii down arrows in data cells, 327 drawCustomButtons, 394 driver dimensions, 182 DSN (data source name), 55 Due Date check box, 293, 296 Dynamic Calc and Store option, setting, 132 dynamic calc members about, 133 and currency conversion calc script, 68 database refresh and member formulas, 71 in currency conversion calc script, 358 setting, 133 dynamic calc versus dynamic calc and store, 133 dynamically adding rows about, 262 enabling, 255
E
Edit Smart List Entries tab, 329 Edit Smart List Properties tab, 328 education services, xx Effective Access check box, 91 e-mail announcements, 63 e-mail notification, about setting up, 287 Enable Account Annotations option, 265 Enable custom attribute display option, 145 Enable HBR check box, 44 Enable Smart Lists check box, 265 Ending option in Exchange Rate Table window, 120 enterprise resource planning (ERP), 179 Entity dimension, 137 Entity members alias table, 147 and plan types, 137 base currency, 138 equity account type, example, 139
432
Index E
error messages, 355 for formula expressions, 338 Essbase. See Analytic Services Essbase.sec file, 67 examples of deleting account annotations, 319 of deleting supporting detail associated with a scenario, 320 exchange rate tables defining for scenarios, 167 deleting, 122 modifying, 121 overview of, 118 setting up, 119 exchange rates refreshing, 69 setting up, 117 types, 111 types for Account members, 143 expanded member list, setting for rows, 256 expense account type, 140 and variance reporting, 141 examples, 139 exporting data forms, 281 expressions. See formula expressions
deleting, 251 moving, 250 fonts adding, 267 in PDF file, 265 forcing users off the system, 317 Format Data option, 266 FormDefUtil utility, 281 forms. See data forms formula expressions, 334 benefits of using, 334 described, 336 error messages for, 338 prerequisites for using, 335 syntax for, 335 using in member formulas, 335 using Smart Lists in, 336 functions in Smart View, 25 functions. See formula expressions
G
getCalendarTPIndex() function, 337 getFiscalTPIndex() function, 337 global settings about, 314 specifying, 316 to 317 global.css style sheet, 341 Group the Results By option, 90
F
Failed to execute error message, 338 Financial Reporting and broadcast messages, 64 and usage statistics, 65 overview of, 27 security, 85 user roles, 36 First time balance property, 140 fiscal year, setting up, 57 FIX statement, troubleshooting, 358 Flat File Adapter adding, 185 using, 184 flat file load file, 184 Flow Diagram workspace, 180 Flow time balance property, 140 folders creating, 250
H
HAL. See Hyperion Application Link Help menu commands, xviii Historical option in Exchange Rate Table window, 119 Hsp_Audit_Records table, 93 Hsp_Rates dimension, 118 HspCustom.css, 342 HspCustomImgs_en.template file, 347 HspCustomMsgs_en.template file, 347 HspJSHome.properties file adding fonts to, 267 changing JDBC driver, 45 configuring JDBC connection pooling, 46 creating, 43 default location, 45 overview, 44
Index F
433
supporting detail cache, 65 unable to find, 366 Hyperion Application Link and usage statistics, 65 creating an adapter process, 180 effect of deleting a member, 153 flow diagram workspace, 180 missing icon, 362 overview of, 27 user roles, 34 using attributes and attribute values, 164 using to import members, 179 Hyperion Consulting Services, xx Hyperion Download Center, xvii Hyperion Education Services, xx Hyperion Essbase Adapter adding, 183 using, 182 Hyperion Hub applications. See Shared Services applications. Hyperion Hub data integrations. See Shared Services data integrations. Hyperion Hub models. See Shared Services models. Hyperion Planning Adapter adding, 181 loading attribute values, 181 loading shared members, 181 using, 180 Hyperion Planning Spreadsheet Add-in. See Smart View Hyperion product information, xix Hyperion products single sign-on, 294 using with Planning, 27 Hyperion Smart View for Office. See Smart View Hyperion Solutions Web site, xvii Hyperion support, xix Hyperion Technical Support, xx
customizing with the HspCustomImgs_en file, 346 ImportFormDefinition utility, 277 importing access rights, 86 data, 186 data form definitions, 277, 281 data forms, 281 metadata, 178 importing content into Smart View, 26 importing models. See Shared Services models. ImportSecurity utility, 86 Include Supporting Detail option, 266 incremental refresh, 69 Information Map, xvii inheritance options Children (inclusive) option, 150 Children option, 85, 150 Descendant (inclusive) option, 150 Descendant option, 85, 150 iChildren option, 85 iDescendant option, 85 Member option, 85, 150 initializing the Reference Application, 415 integrating data. See Shared Services data integrations.
J
JavaScript, customizing data forms with, 387 JDBC connection pooling, 46 JDBC driver, changing, 45
L
label only data storage about, 134 and data entry forms, 134 setting, 133 labels in menus, 325 in Smart Lists, 328 landscape printing orientation, 265 language in the UI, localizing, 346 Launch page, 49 leap year, accounting for, 140 liability account type, example, 139 Linking tasks to Planning Web pages, 299 links to URLs
I
IBM DB2 database database is locked message, 361 enabling more connections, 361 unable to refresh, 365 images customizing with the cascading style sheet, 341
434
Index I
from the Tools page, 317 on a menu, 326 load file, flat file, 184 loading data into the Reference Application, 417 specifying parameters, 182 localizing, 347 labels, 325 the UI text, 346 Lock Current Application From Other Users option, 69 locked application, 63 locking users out of an application, 69, 317 logged-on users, 65 logging on to Planning Web, 48 unsuccessful try, 366
determining where used, 131 editing, 146 effect of moving on plan types, 129 expanding, 127 finding, 128 importing custom dimension members, 178 importing overview, 178 importing using Hyperion Application Link, 179 modifying access rights, 151 moving within the dimension hierarchy, 129 names, displaying on data form, 256 naming, 397 of the Entity dimension, 137 sorting, 128 unmarking for deletion, 135 working with shared members, 153 Menu Header menu item, 326 menu items Business Rule type, 326 creating or changing, 325 data forms, 326 icons for, 325 introduction, 324 label for, 325 Menu Header, 326 types, 325 URLs, 326 Workflow type, 326 menus adding, 346 adding items to, 324 associating with data forms, 266 creating, 324 introduction, 324 updating, 346 message announcements, 63 for scheduled application refresh, 74 metadata importing, 178 overview to setting up, 31 shared through Shared Services, 403 Method option in Exchange Rate Table window, 119 minimizing dimension columns, 130 missing data in accounts calculations, 141 model management. See Shared Services models.
M
maintenance mode, 317 Manage Database errors, 360 Marked for Delete property, 135 MAXAPPLS parameter, 361 Member Alias option, 256 member attributes used in Shared Services, 403 Member Formula tab, 333 member formulas refreshing, 69 using formula expressions in, 335 validating, 334 viewing results of validation, 334 working with, 333 Member Name option, 256 member selection on data forms, 258 setting for runtime prompts, 269 members adding, 146 alias names, 96 assigning access to, 149 assigning attribute values to, 160 collapsing, 127 deleting, 152 deleting a parent, 153 deleting access rights, 151 determining ancestors, 131
Index M
435
monthly distribution patterns, 56 moving an application, 306 multiple alias tables, 96 multiple currencies, 58 designing data forms with, 247 enabling, 109 loading exchange rate data, 183
Oracle, creating the HspJSHome.properties file, 44 overview of Planning, 22 of Reference Application, 410 owner of the application, assigning, 316
P
page axis about, 249 defining, 263 enabling search facility, 263 partitions, 72 PDF printing, fonts in, 267 Percentage of Page to Use for Row Headers option, 265 performance optimizing currency conversion, 68 optimizing in applications, 76 optimizing over dial-up connections, 364 when importing access assignments, 88 when opening large data forms, 363 Period(periodName) function, 337 period, changing, 106 personal preferences, setting, 314 plan building overview, 36 plan types Account members, 138 data forms, 246 effect of moving members, 129 Entity members, 137 setting up in applications, 58 planning cycle overview, 36 Planning Desktop controlling the display, 47 overview of, 47 starting, 47 planning units, 284 annotating, 285 enabling e-mail notification, 287 printing annotations, 287 starting the review process, 286 point of view about, 248 defining, 263 hiding or showing members on, 263 populating the application, overview, 34 portrait printing orientation, 265
N
naming dimensions, 397 members, 397 naming conventions applications, 397 databases, 397 dimensions, 397 members, 397 naming restrictions Analytic Services user names, 402 for applications and databases, 398 for dimensions, members, and aliases, 399 in Analytic Services, 397 in calculation scripts and report scripts, 401 in formulas and filters, 401 native2ascii program, 348 navigation frame on the Desktop, 47 network bandwidth, increasing, 364 Never Share option about, 134 setting, 133 non-expense account types, 141 number formatting, 111 Number of Data Columns Per Page option, 265 NumberOfPeriodsInYear variable, 336 NumberOfYears variable, 336
O
opening large data forms, 363 OpenInputValueBlock variable, 336 optimizing performance by application design, 76 of calculations on data forms, 248 of currency conversion, 68 over dial-up connections, 364 when importing access assignments, 88
436
Index N
ports, connecting, 185 post-planning activities overview, 40 preferences, setting personal, 314 prerequisites for using this guide, xv Preview tab for Smart Lists, 330 previewing data form design, 270 printing data form definitions, 274 fonts, 267 options for data forms, 265 planning unit annotations, 287 private applications. See Shared Services applications. process status states customizing the actions, 354 customizing the color, 352 customizing the states, 353 overview to customizing, 352 properties file. See HspJSHome.properties file
problem-solving, 357 scheduling, 72 registering the application server, 50 relational database, optimizing, 43 Repeat Every check box, 293, 296 Repeat Headers on All Pages option, 266 Report Options tab, 90 reporting currencies, 112 reports audit trails, 91 in Reference Application, 414 on access assignments, 88 Required Dimension drop-down list, 326 reserved characters in Analytic Services, 397 in customized text, 349 See also naming restrictions restoring dimension columns, 130 revenue account type example, 139 summary, 140 RMI port number, 44 roll ups, defining in calendars, 102 row definitions about dynamically adding, 262 adding, 256 changing, 257 dynamically adding, 255 row properties, setting, 255 Row/Column Layout tab, 253 rows separators for, 254 suppress hierarchy, 254 runtime prompts, using, 270 Russian font, adding, 267
Q
quick connect port connection, 185
R
range of time periods, setting, 103 read-only cells, 254 Read-only option for data forms, 253 RefAppUpgradeUtility file, 417 Reference Application business rules, 413 creating, 414 creating the database, 416 data forms, 413 initializing, 415 loading data, 417 overview, 410 predefined reports, 414 upgrading to a large application, 418 Refresh Users and Groups button when assigning access to a data form, 271 when assigning access to a dimension member, 150 when assigning access to a task list, 300 refreshing databases, 69 and application changes, 66 implications of, 69 incrementally, 69
S
SampleValidateData.js, 388 saved assumptions, 142 scaling, 111 scenarios and currency conversion calc scripts, 68 changing the order, 176 copying, 169 creating, 167 defining access rights, 167
Index Q
437
defining exchange rate tables, 167 defining time periods, 167 deleting, 169 deleting supporting detail, 319 editing, 168 sorting, 175 scheduling an application refresh, 72 messages, 63 sddelete.sql file, 319 searching among pages, 263 for members, 128 Secfile.txt file, 86 security about, 83 DCOM, 82 See also access rights setting up, 82 setting up in Financial Reporting, 85 security filters generating for all users, 67 generating for one or more users, 83 validating, 66, 70 segments described, 252 read-only, 253 suppress hierarchy, for columns, 253 suppress hierarchy, for rows, 254 Select Another Rate Table option, 120 Select Objects tab, 89 separator lines, described, 252 separators setting for columns, 253 setting for rows, 254 servers registering, 50 unregistering, 50 session timeout, 363 Setup Application task, 55 shading display option, 266 shared members, 153 applying security to, 67 creating, 154 data forms, 248
deleting, 320 loading, 181 setting, 133 shared models. See Shared Services models. Shared option overview, 134 setting, 133 Shared Services assigning a Planning application to a project, 193 registering an application, 316 Shared Services applications common shared application, 198 creating, 198 deleting, 198 naming restrictions, 198 overview, 196 overview of private applications, 196 overview of shared applications, 196 process for sharing, 196 sharing, 199 stopping sharing, 199 Shared Services data integrations accessing, 226 accessing functions, 227 assigning access, 195, 227 Create Integrations user role, 195 creating, 229 deleting, 236 described, 195 editing, 229 filtering integration lists, 228 overview, 226 prerequisites, 226 Run Integrations user role, 195 scheduling group integrations, 243 user roles, 195 viewing integrations, 227 Shared Services models access permissions, 220 application system members, 211 assigning permissions, 221 common member attributes, 403 compare operations, 206 comparing, 205 configuring for external authentication, 192
438
Index S
deleting, 212 deleting permissions, 224 described, 192 dimensional hierarchies, 192 editing content, 207 editing member properties, 209 editing permissions, 223 filtering content, 215 Manage Models user role, 194 managing permissions, 219 naming restrictions, 205 non-dimensional hierarchies, 192 overview, 192 permissions, 219 private, 197 properties, viewing and setting, 225 registering applications, 192 renaming, 212 setting properties, 225 shared, 197 shared applications, 195 sharing, 199, 213 sharing data, 195 sharing metadata, 195 sync operations, 203 synchronizing, 201 system members, 211 tracking version history, 217 types of permission, 219 user authentication, 219 user roles, 194 versioning, 217 viewing, 200 viewing properties, 225 Shared Services Server URL option, 316 Show __ Members on Each Dimensions Page option, 128 Show Account Annotations option, 266 Show Ancestors button, 131 Show Attribute Members option, 266 Show Cell Text option, 266 Show Columns option in Exchange Rate Table window, 120 Show Currency Codes option, 266 Show drop-down list about, 314
options on, 314 Show Inherited From Group check box, 91 Show Matching Access of Relation check box, 91 Show Matching Access of Type option, 90 Show Separator option, 253 to 254 Show Shading option, 266 Show Usage button, 113, 131 Size-to-Fit column width, 254 Skip options, 141 Smart Lists adding or changing entries, 329 and data entry, 327 customizing, 346 displaying in data forms, 330 previewing, 330 representing #missing, 331 setting precedence, 330 setting properties, 328 updating, 346 using in formula expressions, 336 working with, 327 Smart View Ad Hoc analysis grid, 24 and business rules, 34 benefits, 23 functions, 25 importing content, 26 key features, 24 overview, 22 overview to setting up worksheets, 33 terminating for application refresh, 74 worksheet overview, 33 sorting members, 128 with a utility, 188 SortMember utility, 188 source plan type and Accounts, 138 effect of moving members, 129 sparse dimensions, 124 and performance, 77 effect of changing to dense, 157 spreading data, 56 Spreadsheet Add-in. See Smart View spreadsheets. See Smart View SQL database, optimizing, 43
Index S
439
Start Expanded option, 256 starting Planning on the Desktop, 47 on the Web, 48 with the Launch page, 49 statistics on usage, 65 storage options, 132 Store option about, 134 setting, 132 Streamline View option, 327 strings, customizing, 346 style sheets, customizing, 341 substitution variables, 260 summary time periods changing the range, 103 creating, 103 deleting, 104 supporting detail associated with a scenario, deleting, 319 benefit, 37 copying, 302 detection cache allocating memory for, 78 percentage used, 65 Suppress Hierarchy option for columns, 253 for rows, 254 Suppress Missing Data option for columns, 254 for rows, 255 suppressed hierarchy, described, 252 system settings, 316
copy data link, 299 creating, 289 deleting, 299 overview, 288 removing access, 301 reordering, 298 setting date format, 316 tasks alert messages, 292 copying, 297 defining, 292 deleting, 298 dependencies, 293, 296 due date messages, 292 moving, 297 overview, 288 technical support, xx terminating applications for refresh, 74 text about customizing, 346 customizing in the UI, 346 time balance calculations, 141 Time Balance property, 140 time periods changing, 106 defining for scenarios, 167 practical limit, 103 Time Periods dimension, about, 102 timeout for sessions, 363 Tools Analyze and Report page, setting links for, 317 Tools page, customizing, 340 tools, setting custom, 317 tracking changes, 91 triangulation overview, 119 troubleshooting, 355 Turkish font, adding, 267
T
target versions description, 171 setting up, 35 Task List Date Format option, 316 task list folders creating, 289 deleting, 290 moving, 290 task lists assigning access, 300 changing access, 301
U
UDAs changing, 333 creating, 332 deleting, 333 working with, 332 unlocking applications, 63, 358 unmarking members that are pending deletion, 135 unregistering the application server, 50
440
Index T
URL menu item, 326 properties, 326 URL tasks, single sign-on, 294 URLs, setting up, 317 usage scenario, 29 usage statistics, 65 user names, displaying full names, 316 user variables associating with a form, 261 creating, 273 deleting, 274 overview, 273 users controlling access, 82 displaying full names, 316 overview to setting up, 32 utilities for deleting shared descendants, 320 for importing and exporting data forms, 281 for importing data form definitions, 277, 281 for importing security, 86 for loading data into the Reference Application, 417 for scheduling a refresh, 72 for sorting members, 188 for unlocking an application, 63
deleting, 173 displaying, 174 editing, 172 error when copying, 358 setting up, 174 setting up bottom-up versions, 70, 171 setting up target versions, 171 sorting, 175 target, and currency conversion, 70
W
Warn If Data Form Larger Than __ Cells option, 363 Web Analysis, overview, 28 Web client about, 27 customizing the UI, 339 starting, 48 web.xml file, 364 WebLogic, customizing the UI with, 349 weekly distribution patterns, 56 Weighted Average time balance properties, 140 Workflow menu item, 326 properties, 327
Y V
Valid For plan type setting and Account members, 138 and custom dimensions, 143 and Entity members, 137 effect of moving members, 129 specifying, 144 Validate Member Formula option, 334 validate security filter size, 70 ValidateData.js, 388 validateForm, 395 variance reporting and account type, 140 versioning. See Shared Services models. versions and currency conversion calc scripts, 68 changing the order, 176 copying, 174 creating, 172 data forms, 247 years adding to calendar, 105 changing current, 106 maximum, 103 practical limit, 103 Years option in Exchange Rate Table window, 120
Z
zeros in accounts calculations, 141
Index V
441
442
Index Z