Hyperion Financial Management Hyperion Financial Management Developed in Partnership with and based on work by Eric Erikson, 123OLAP HYPERION FINANCIAL MANAGEMENT 11.1.1 IMPLEMENTATION BOOT CAMP Copyright Notice Copyright 2009 Oracle Corporation All rights reserved Based upon the copyrighted works of: 123OLAP P.O Box 459 Plymouth CA 95669 No portion of this document 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 purchaser’s personal use, without the express written permission of Oracle Corporation Trademarks Windows/Windows 2000/Windows XP, and Microsoft Office are trademarks of Microsoft Corporation Excel, Windows/Windows 2000/Windows XP, and Microsoft Office are products of Microsoft Corporation Essbase is a registered trademark of Oracle Other product names mentioned in this document may be trademarks or registered trademarks of their respective companies and are hereby acknowledged Disclaimer The information in this document is subject to change without notice Neither Oracle Corporation nor 123 OLAP shall be liable for errors contained herein or consequential damages in connection with the furnishing, performance, or use of this material TABLE OF CONTENTS Introduction About the Author Chapter - Overview of Oracle Hyperion Financial Management Financial Reporting 1-2 HFM Structure and Design 1-2 What is a Dimension? 1-2 Members 1-4 Hierarchies - The Family Tree 1-5 Point of View 1-5 Drilling Up and Down a Dimension 1-6 Oracle EPM 1-6 HFM Server Architecture 1-6 Summary 1-7 Chapter 2a – Creating Applications – Profile and Metadata - Classic Application Profile 2a-1 Creating the Application 2a-4 Managing Metadata 2a-5 Loading and Extracting Metadata 2a-9 Accounts 2a-10 Application Settings 2a-12 Consolidation Methods 2a-14 Currencies 2a-15 Custom 1-4 2a-15 Entity 2a-17 Scenario 2a-18 Organization by Period 2a-19 Putting Everything Together 2a-20 Summary 2a-21 Chapter 2b – EPM Architect EPMA vs Classic 2b-2 EPMA Components 2b-2 Dimension Maintenance 2b-3 Accessing EPMA 2b-3 Application Maintenance 2b-10 Application Deployment 2b-13 Data Synchronization 2b-13 Application Upgrade 2b-17 Task Automation 2b-18 Summary 2b-19 Chapter – Data Loading The Native Format 3-1 Data Loading Alternatives 3-6 Data Extracting Alternatives 3-11 Copying and Clearing Data 3-13 Summary 3-15 Chapter – HFM Rules The Basics 4-1 Grouping Rules - Subroutines 4-2 Function and Dimension Syntax 4-3 Variables 4-3 Restricting When Rules Run 4-4 Common Calculations 4-7 Functions – Repeating Code 4-11 Easy Performance Improvement – With HS 4-11 Calculating Manager 4-12 Summary 4-12 Chapter – Creating and Building Lists Member Lists 5-1 Creating Lists 5-1 Loading and Extracting Lists 5-3 Summary 5-4 Chapter – Shared Services Security Basics 6-1 Provisioning Users and Groups 6-2 Creating and Assigning Classes 6-5 The Other Way (for Classic Applications) 6-8 Organizing the Design 6-9 Summary 6-10 Lifecycle Management 6-10 Shared Services – Other Features 6-12 Chapter – HFM Administrative Stuff HFM Copy Application – Classic Only 7-1 HFM Utilities 7-7 HFM Administration 7-10 System Messages 7-10 Task and Data Audit 7-11 Task Automation 7-13 Other Administration Menu Items 7-16 Process Control and Validations 7-16 Creating Data Entry Forms 7-19 HFM User Group 7-24 Typical Administrator Life 7-25 Chapter – HFM End User Basics Logging In and Logging Out 8-1 Tasklists 8-3 Creating Tasklists 8-4 Adding and Saving Tasklists 8-5 Data Grids 8-6 Creating a Grid 8-6 Modifying the Layout 8-7 Member Selections 8-8 Mulitple Member Selections for Rows and Columns 8-10 Working With Data Grids 8-12 Grid Background Colors 8-13 Common Data Grids 8-14 Data Entry - Multiple Ways 8-14 Data Entry Forms 8-15 Journals 8-16 Journals Overview 8-16 Creating Journals 8-17 Journal Templates 8-20 Chapter – HFM End User Next Steps Intercompany Reporting – Some Background 9-1 Running an Intercompany Report 9-2 Creating/Modifying an Intercompany Report 9-6 Process Control 9-7 Chapter 10 – HFM End User Reporting Running Reports 10-1 Hyperion Smart View for Microsoft Office 10-4 Smart View Functions for Microsoft Excel 10-6 HFM Forms within Microsoft Excel 10-8 Ad Hoc Analysis 10-8 Opening Reports in Microsoft Office 10-10 Using Smart Tags 10-12 Chapter 11 – Financial Reporting Studio Laying Out a Report 11-3 Selecting Members 11-6 Adding, Removing,and Moving Member Selections 11-7 Prompts and Current Point of View 11-7 Placing Selections into Separate Rows 11-8 Relationship Function Selections 11-8 Relationship Function Alternatives 11-10 Advanced Selections 11-11 Lists Tab 11-12 Editing Selections Manually 11-12 Limiting the Point of View Selections 11-13 Additional Rows/Columns 11-14 Previewing the Report 11-15 Saving a Report 11-15 Page Dimension 11-16 Text Rows/Columns within Grids 11-22 Inserting Functions 11-23 Formulas 11-29 Charting 11-31 Chart Layout 11-32 Types of Charts 11-32 Chart Properties 11-33 Chapter 12 – Workspace Reporting Workspace 12-2 Logging into Workspace 12-2 Books 12-7 Creating Books 12-8 Deleting Reports from a Book 12-10 Selecting Members for Books 12-10 Previewing Books 12-12 Saving Books 12-14 Book Setup 12-15 Batches 12-16 Scheduling Batches 12-18 Batch Scheduler 12-22 Canceling Batches 12-24 Batch Outputs 12-24 Snapshots 12-26 Assigning Access to Snapshots 12-27 Batch Comman Line Processing 12-28 EPM Financial Management© Chapter 12: Workspace Reporting Batches Batches are used to automate report and book execution Batches allow you to schedule reports and specify the output format When executing reports through batches, designers have, among others, the following output options • • • • Hardcopy - Printing to a specified printer PDF – The batch will generate a PDF document that can be distributed via email HTML – The batch will generate HTML documents that can be distributed via the web A location can be specified on the web Snapshot – This will generate all reports in a pre-retrieved format and is most often used when a report will be distributed through the Reports Client It is important to note that snapshots represent a pull of the data as of the batch execution time – they are not dynamically pulled when the users interface with them To create a batch, select File>New Document Next, select the Batch radio button: Click the Next button Both reports and books can be added Click Finish when all the reports and books have been added Copyright 2009 www.123olap.com 12-16 EPM Financial Management© Chapter 12: Workspace Reporting The Batch Editor appears and shows the book that we added in the previous step: Select the Edit>Add Item(s) menu option, if you want to add another report or book Can also choose to delete an item from the Batch, or change the member selections for a book Once all books, reports, and snapshots have been added, save the batch by selecting File>Save As from the menu option: Here we give the batch a name and save it in the 123olapReports folder Copyright 2009 www.123olap.com 12-17 EPM Financial Management© Chapter 12: Workspace Reporting Scheduling Batches Once a batch has been created, it is possible to schedule the Batch to run at a specific time in the future or immediately To so, select Edit>Schedule Batch: The Schedule Batch dialog box appears Navigate to a batch that has been saved, highlight, and click Next Copyright 2009 www.123olap.com 12-18 EPM Financial Management© Chapter 12: Workspace Reporting Select the NEXT button to proceed: The Start Time dialog box appears It is possible and often the case to just run it “Now” or immediately However, it is also possible to schedule the Batch to run at the following times: • • • • • • Once – run the batch at a specified time Select this if you not want to run the Batch immediately but on a specific time later Weekdays – run the batch every weekday at a specified time Daily – Same as weekdays but on weekends too Weekly – run the batch only a weekly basis at a specified day and time Monthly – run the batch every month at a specified day and time Quarterly, Semiannually, Annually – these options are not often used but will run quarterly, two times a year, or once a year at the specified days and times Note that the section at the bottom specifies the members from each dimension for the reports: Copyright 2009 www.123olap.com 12-19 EPM Financial Management© Chapter 12: Workspace Reporting It is possible to change the Batch Point of View for each batch, but generally this is not practical Select the NEXT button to continue scheduling the Batch job: The Destinations allow you to specify the Batch output When executing reports through Batches, designers have the following available options for output: • • • • • Hardcopy – Select the Print to option and specify a printer This will create a hardcopy report to a specified printer PDF – Select the Export as PDF option The batch will generate a PDF document that can then be distributed via email It is possible to specify an “External directory” This is any directory not in the Financial Reporting repository HTML – Select the Export as HTML option The batch will generate HTML documents that can then be distributed via the web If an external directory is specified, then the report will be saved to that directory This is most commonly an intranet site (external refers to any location outside the repository) Snapshot – Choose the Save As Snapshot option It is important to note that snapshots represent a pull of the data as of the batch execution time – they are not dynamically pulled when the users interface with them Email – If successful, the batch output can be distributed to a specified list of users If unsuccessful, the details are usually sent to the administrator(s) Copyright 2009 www.123olap.com 12-20 EPM Financial Management© Chapter 12: Workspace Reporting If selecting this option, select the users to receive the report as below Click the FINISH button to finish scheduling the Batch job: Copyright 2009 www.123olap.com 12-21 EPM Financial Management© Chapter 12: Workspace Reporting Batch Scheduler To view all of the batches that have been scheduled, open up the Batch Scheduler From the Reports Web Client, select the Tools>Schedule>Batch Scheduler menu option: The batch just scheduled will be displayed: Notice the status shows that the Batch above is currently Successful The various status options are: • • • • Running – a Batch that is currently being executed will display this status Successful – a Batch has been executed without errors will display this status Error – a Batch that resulted in an error during execution will display this status Pending – a Batch that is currently scheduled to execute at a future time will display this status While working with the Scheduler, refresh to see the latest status settings Select View>Refresh: Copyright 2009 www.123olap.com 12-22 EPM Financial Management© Chapter 12: Workspace Reporting To view the details of a batch especially when errors have occurred, select the batch in the scheduler and right-click select Show Details: The details of the batch execution are displayed: Copyright 2009 www.123olap.com 12-23 EPM Financial Management© Chapter 12: Workspace Reporting Canceling Batches If a batch has been scheduled but is pending execution, it is possible to cancel it Select the batch in the scheduler and right-click on it Select the Delete menu option: Confirm to delete the batch Batch Outputs Where does the output of PDF go when the External option is not chosen in the Batch scheduler? When you not specify “External location”, the default location is the repository home directory A folder with a number is stored in the Scheduler Output directory Each batch that will run will have a batch number associated with it – this number is incremented each time The folders can later be renamed Here is a screenshot of the PDF output that was generated for the first batch run on the system Copyright 2009 www.123olap.com 12-24 EPM Financial Management© Chapter 12: Workspace Reporting A Zip file will be created with all the PDF reports zipped into it This may be optimal for sending files over email as the files will be compressed By navigating to the Class Reports folder, we can see the actual PDF that was created: Alternately, and more likely, it is possible to retrieve the output via the Workspace This may be necessary as administrators typically not have access to folders on the Reports server directories From the Scheduler, select the batch that was run and right-click on it Choose the Retrieve Output menu option: Copyright 2009 www.123olap.com 12-25 EPM Financial Management© Chapter 12: Workspace Reporting Next is a prompt to save the Zip file to a specific location It is also possible to rename the file If this seems like a lot to go through, consider this: During batch creation, it is possible to specify an external directory If the Financial Reporting server is set up to map to a networked directory, then the process of retrieving batch output can be bypassed altogether Snapshots Snapshots allow distribution of reports without requiring dynamic retrievals from Hyperion This will improve report performance as all the reports have already been executed and saved In addition, consider the following advantage: Because Snapshots are static, they represent reports that have been audited and verified Dynamic reports may be executed at a point in time when the database is being reloaded or calculated – the problem here is that the database may be available but the data may not have been audited! Snapshots can be previewed by selecting the Snapshot as we have in the following: Copyright 2009 www.123olap.com 12-26 EPM Financial Management© Chapter 12: Workspace Reporting To preview a snapshot right-click on it and select to preview in PDF or HTML: Assigning Access to Snapshots From the destinations section of the Schedule Batch, select the Privileges button: Select a user or group and add it to the Selected Users and Group area: Copyright 2009 www.123olap.com 12-27 EPM Financial Management© Chapter 12: Workspace Reporting Batch Command Line Processing It is possible to generate an XML extract of a Batch and schedule it through the operating system scheduler This simplifies the timing of scheduled jobs by using a common scheduler Rather than rely on the Financial Reporting scheduler, this gives administrators the same interface for managing all scheduled jobs To generate a batch file for command line processing, from the Scheduler, right-click on the batch and select the Export for Command Line Scheduling option: Choose a location and a name to save the batch file Click the Save button and then choose a name for the XML extract and file location: The batch XML file can be opened in any text editor There should be no need to change the XML file format In fact, changing the format may cause command line execution to fail Copyright 2009 www.123olap.com 12-28 EPM Financial Management© Chapter 12: Workspace Reporting Here is an excerpt of the XML file that is generated: When generating command line references for batches, follow this guideline: Batches that will be used for command line processing should use the Schedule Now option For automation purposes with database maintenance – reports should be executed as soon as the batch command line is referenced To not reference a batch that has already been scheduled for processing, you can create a command line from scratch To select the Create File for Command Line Scheduling: Walk through all of the steps for scheduling a batch as we have shown in creating a batch The result of this will be to prompt to save the report in XML format To launch XML batches from a command line, you must reference the ScheduleBatch.cmd command The basic format is: ScheduleBatch exportBatchName.xml ReportServer Copyright 2009 www.123olap.com 12-29 EPM Financial Management© Chapter 12: Workspace Reporting In the following command window, launch the ScheduleBatch and feed it the XML export first generated and reference the report server: Copyright 2009 www.123olap.com 12-30