|
Copyright © 2009, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS:Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.
This software and documentation may provide access to or information on content, products and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third party content, products and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third party content, products or services.
Oracle Hyperion Planning, Fusion Edition contains significant enhancements to administrator features. Oracle Hyperion EPM Architect, Fusion Edition is a feature in Planning that enables administrators to manage, create, and deploy applications within one interface. This document describes key administration tasks in Classic Planning and in Planning with Performance Management Architect.
You can create applications using Performance Management Architect or Classic application administration. Different menus and options are available for each type of application. For example, for applications created with Performance Management Architect application administration, you manage Smart Lists within Performance Management Architect. For applications created with Classic administration, you can select Administration, then Smart Lists to use the feature within Planning.
Table 1. Key Planning Administration Tasks
| Category / Action | Classic Planning | Planning with Performance Management Architect |
|---|---|---|
| Application Creation, Database Refresh | ||
| Managing data sources | Select Navigate, then Administer, then Classic Application Administration, and then Planning Administration. Click Manage Data Source. Update instances in Oracle's Hyperion Enterprise Performance Management System Configurator. In Planning, you can also select Administration, then Manage Data Source, then select appropriate options, such as Create Data Source, Edit Data Source, and Delete Data Source. | In the Application Library (Navigate, then Administer, then Application Library), select Tools, then Manage Planning Data Source to start the data source wizard. Update instances in Oracle's Hyperion Enterprise Performance Management System Configurator. |
| Configuring system properties | Select Administration, then Manage Properties to review and modify application and system properties stored in the system database. | From Oracle Enterprise Performance Management Workspace, Fusion Edition, open the Planning application by selecting Navigate, then Applications, then Planning, and then the application name. Select Administration, then Manage Properties to review and modify application and system properties. |
Creating applications | Select Administration, then Create Application. Define the application by completing the tasks in the application wizard. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Application to launch the application wizard. Complete the tasks in the application wizard to create the application. This does not create the application within Planning until the application is validated and deployed. You can also use the application wizard to create blank applications, and drag dimensions from the Shared Library to the application. You can modify application properties in the Properties Grid, such the starting year, calendar, plan types and names, and multiple currencies. |
Opening applications | Select Navigate, then Applications, then Planning, and then select the application name. You can also log on to Planning and select an application. | Select Navigate, then Applications, then Planning, and then select the application name. After you deploy an application, you can open it in Planning. |
Registering applications | Select Navigate, then Administer, then Classic Application Administration, and then Planning Administration. Click Register Application. In Planning, you can also select Administration, then Register Application. | Select Navigate, then Administer, then Classic Application Administration, and then Planning Administration. Click Register Application. You can register applications again if necessary by right-clicking an application in the Application Library (Navigate, then Administer, then Application Library) and selecting Reregister. |
Deleting applications | Select Navigate, then Administer, then Classic Application Administration, then Planning Administration. Click Delete Application. In Planning, you can also select Administration, then Delete Application. | In the Application Library (Navigate, then Administer, then Application Library), right-click a deployed application and select Delete. You can delete applications with a status of Deployed or Not Deployed. |
| Creating and refreshing the database, generating security filters | Select Administration, then Manage Database, then select appropriate options, such as Database, Security Filters, Shared Members, and Validate Limit. After selecting options, click Create or Refresh. | Cube Create and Cube Refresh are combined in the Deploy operation. In the Application Library (Navigate, then Administer, then Application Library), right-click an application and select Deploy. Select appropriate options, such as Create Outline, Refresh Outline, Security Filter Validation, and Shared Members. |
| Viewing jobs in the Job Console | Select Tools, then Job Console. View the status of these operations: Clear Cell Details, Copy Data, and calculations for business rules, rulesets, and sequences. You can filter jobs by user, job type, run status, start time, end time, or job name, and enable notification by e-mail when a launched job completes or generates an error. You can also set properties for the threshold time at which the job moves to background execution. | Select Navigate, then Administer, then Library Job Console. View the status of operations for dimensions, applications, transactions, comparisons, export, and logs. |
| Sending bulk messages | Select Tools, then Broadcast Message. | Use task automation to create an e-mail message. In the Application Library (Navigate, then Administer, then Application Library), select an application and then select Administration, then Manage Taskflows. In the taskflow editor, click Add Stage. Then set parameters such as E-mail. |
| Metadata and Data Loads | ||
Performing initial and incremental metadata loads | Load metadata with:
| Create an import profile by creating:
You can then execute the import profile to load metadata to the Shared Library or to an application from flat files or interface tables. |
Scheduling metadata updates | Schedule updates with the built-in scheduling options in:
You can also write scripts that run the Planning Outline Load utility. | Use taskflows to schedule imports and updates for the Shared Library and application. (You must have already deployed the application and defined an Import Profile.) Use the Batch Client for interactive scripting updates for the Shared Library and application. See the Oracle Hyperion Enterprise Performance Management Architect Batch Client User's Guide. |
Loading data | Load data with:
| Load data using the interface tables included with the Data Synchronization module. Open the Data Synchronization module (select Navigate, then Administer, then Data Synchronization). Select File, then New, then Synchronization. Use the wizard to define the source and target information. For the source, select the Data Interface Area option (for data loaded using a relational database) or External Source (for data loaded using flat files). For the target information, select the appropriate Planning application. You can predefine external files and data interface information. In the Data Synchronization module (Navigate, then Administer, then Data Synchronization), select File, then New, then Data Interface Table Definition, or File, then New, then External File Definition before building the synchronization. You can manually execute the synchronization or schedule it using Task Automation or the Batch Client. |
Scheduling data loads | Schedule updates with the built-in scheduling options in:
You can also write scripts that run the Planning Outline Load utility. | Data loads can be scheduled using taskflows or a third-party scheduler that can integrate with a script created for the Batch Client. In the Dimension Library (Navigate, then Administer, then Dimension Library), select Administration, then Manage Taskflows to add a stage for data synchronization. Use the Batch Client to integrate with a third-party scheduler. |
Creating dimensions | Select Administration, then Dimensions. Click Add Dimension. | In the Dimension Library (Navigate, then Administer, then Dimension Library), perform one task:
|
| Creating dimension members | Select Administration, then Dimensions. Select a current member and select Add Child or Add Sibling to add a member. You can also load members with the Planning Outline Load utility, Oracle Data Integrator Adapter for Planning, Oracle's Hyperion® Data Integration Management Adapter for Planning, or Oracle Hyperion Financial Data Quality Management Adapter for Planning, Fusion Edition. | In the Dimension Library (Navigate, then Administer, then Dimension Library), right-click a member. Select Create Member, then As Child or As Sibling. Import dimension members into the Dimension Library by creating and importing a flat file or importing information from interface tables. You can also use the Batch Client in interactive mode or script mode to create new members. |
| Creating attribute dimensions | Select Administration, then Dimensions. Select the root member of a sparse dimension, such as Entity. Click Custom Attributes, and click Create. Enter an attribute name, and select the data type. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Dimension. Enter a name and description, and select the attribute dimension type. Associate the new dimension with the base dimension by right-clicking the base dimension, (such as Entity, and selecting Create Associations. Select the appropriate type of dimension, such as Currency, and the dimension with which to associate, such as Base Currency. Click Save. These associations must be activated to make them valid for an application. (Right-click the application name, then select Activate all associations.) You can also create attribute dimensions using the Batch Client. |
| Creating attribute dimension members | Select Administration, then Dimensions. Select the root member of a sparse dimension, such as Entity. Click Custom Attributes, and select the attribute. Above the Attribute Values column, click Create. Enter a name and click Save. | In the Dimension Library (Navigate, then Administer, then Dimension Library), right-click a member, then select Create Member, then As Child or As Sibling. Import dimension members into the Dimension Library by creating and importing a flat file or importing information from interface tables. You can also create attribute dimension members using the Batch Client. |
| Creating Smart Lists | Select Administration, then Manage Smart Lists. Click Create, then define the Smart List properties. On Entries, click Add and define the drop-down list items. Preview the Smart List and click Save. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Dimension. Enter a name and description, and select the Smart List type. After the Smart List is created, you can add members. (Right-click a member and select Create Member, then As Child or As Sibling.) You can also import Smart List dimensions using flat files or interface tables, or create them using the Batch Client. |
| Creating alias tables | Select Administration, then Alias Tables. Click Add to add an alias table. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Dimension. Enter a name and description, then select the Alias type. After the Alias dimension is created, you can add members. (Right-click a member and select Create Member, then As Child or As Sibling.) Associate the new dimension with the base dimension, such as Entity or Account, by right-clicking the application name, then selecting Activate all associations. You can also import alias tables using flat files or interface tables, or create them using the Batch Client. |
| Creating UDAs | Select Administration, then Dimensions, then select a dimension and a dimension member and click Edit. On the UDA tab, select UDA members or create them by clicking Add and entering a name. Select UDAs for the member by moving them to the Selected UDA list. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Dimension. Enter a name and description, then select the UDA type. After the UDA dimension is created, you can add members. (Right-click a member, then select Create Member, then As Child or As Sibling.) Associate the new dimension with the base dimension, such as Entity or Account, by right-clicking the application name, then selecting Activate all associations. You can also import UDA members using flat files or interface tables, or create them using the Batch Client. |
| Creating exchange rate tables | Select Administration, then Manage Exchange Rates. Click Create, specify a name and description, and click Save. Enter values in the exchange rate table for the proper currency conversions. | In the Dimension Library (Navigate, then Administer, then Dimension Library), assign the Exchange Rate Table property to Planning Scenario members in the Property Grid. In Planning, select Administration, then Manage Exchange Rates. Click Create, specify a name and description, and click Save. Enter values in the exchange rate table. |
| Editing member properties | Select Administration, then Dimensions. Select a member and click Edit. Modify member properties and click Save. | Perform one task:
|
| Organizing dimensions | Select Administration, then Dimensions. To sort dimensions, select a sort option, then click the Sort Ascending or Sort Descending button. You can also expand or collapse the dimension hierarchy. | In the Dimension Library (Navigate, then Administer, then Dimension Library), select File, then New, then Folder. Enter the folder name and click OK. To add dimensions to the folder, in the Shared Library, right-click the folder and select Add Dimensions. |
Moving a member within the hierarchy | Select Administration, then Dimensions. To move members or branches up or down one position, select the member or branch and click the Move Up or Move Down button. To move members including parents and children, click Cut, select the destination member, and click Paste. You can also use the Sort Member utility. | Perform one task:
|
| Reordering child members | Select Administration, then Dimensions. To move members or branches up or down one position, select the member or branch and click the Move Up or Move Down button. To move members including parents and children, click Cut, select the destination member, and click Paste. You can also use the Sort Member utility. | You can reorder children in the Dimension Library (Navigate, then Administer, then Dimension Library). Drag a member up or down to change the order. You can also right-click the dimension and select Reorder Children. Reorder members, then click OK. |
| Searching for members | Select Administration, then Dimensions. Select a search option, enter search text, and click the Search Up or Search Down button. | In the Dimension Library (Navigate, then Administer, then Dimension Library), right-click a dimension and click Find Members. Select to search by the member name, alias, or property, then click OK. |
| Security | ||
Application Creator role | The global Oracle's Hyperion® Shared Services role of Application Creator or <product> Application Creator (for example, Planning Application Creator) allows users to create and deploy applications. See the Oracle Hyperion Enterprise Performance Management System Security Administration Guide. | The global Shared Services role of Application Creator or <product> Application Creator (for example, Planning Application Creator) allows users to create and deploy applications. Required, in addition to the Dimension Editor role, to navigate to the Planning Classic application administration options. See the Oracle Hyperion Enterprise Performance Management System Security Administration Guide. |
Dimension Editor role | The global Shared Services role of Dimension Editor creates and manages dimensions. | The global Shared Services role of Dimension Editor creates and manages dimensions within Performance Management Architect. Also required to access Planning Classic application administration options. |
Dimension security | Dimension modifications can be made by users provisioned as Administrators through Shared Services for the application. Dimension access permissions are defined in Shared Services or in the Planning Dimension page. | Dimension security is assigned by the Dimension Editor or the Dimension Owner. |
Calculation Manager Administrator | Rules are maintained in Oracle's Hyperion® Business Rules. | Planning Calculation Manager Administrator enables you to create business rules using Hyperion Calculation Manager. |
| Financial Data Management | ||
| Importing data from Oracle E-Business Suite | To import data from Oracle E-Business Suite into Oracle Hyperion Financial Data Quality Management, Fusion Edition:
| Use Oracle Hyperion Financial Data Quality Management ERP Integration Adapter for Oracle Applications to import data from Oracle E-Business Suite. To use ERP Integrator:
|
With the previous release, Oracle Hyperion Financial Management, Fusion Edition and Planning users working with Performance Management Architect applications could use a new calculation module, Calculation Manager, to create and administer their business rules in a graphical environment. However, classic Financial Management application users could only use Financial Management to create their business rules; Classic Planning application users and Oracle Essbase BSO users could only use Business Rules to create and administer their business rules.
In this release, Financial Management and Planning users working with Classic or Performance Management Architect applications, and Essbase BSO application users, can create and manage their business rules in Calculation Manager.
This table compares business rules features in Calculation Manager, in Business Rules (for Classic Planning and Essbase users), and in Financial Management (for Financial Management users).
Table 2. Comparison of business rules features in Calculation Manager, Financial Management, and Business Rules
| Feature / Action | In Calculation Manager | In Business Rules (for Classic Planning and Essbase users) | In Financial Management (for Financial Management Users) | ||
|---|---|---|---|---|---|
| Creating business rules | You can create a business rule graphically in a flow chart within the Rule Designer. There are five components for Planning and Essbase, and six components for Financial Management that you use to design business rules:
You can use members, variables, and functions in the components. | You can create a business rule in the Business Rules Graphical Designer and in the Business Rules node of the Administration Console of Oracle Essbase Administration Services. There are four actions and eight formulas you can use to design graphical business rules:
| You can create a business rule in the Rules Editor or in a text editor. You can use Visual Basic and Financial Management functions and members in Financial Management business rules. | ||
| Using system templates (in Calculation Manager) and actions and formulas (in Business Rules) to design business rules | There are eight Planning and Essbase system templates in Calculation Manager:
There are four Financial Management system templates in Calculation Manager:
| There are four actions in Business Rules that function like several of the system templates in Calculation Manager:
Business Rules also provides formulas that function like Calculation Manager system templates:
| Not applicable | ||
Creating custom-defined templates (in Calculation Manager) and macros (in Business Rules) to design business rules | You can use a wizard to design reusable custom-defined templates to perform calculations unique to your business. You can copy a system template and save it with a new name to use as a starting point for a custom-defined template. | You can design reusable macros to perform calculations unique to your business. | Not applicable | ||
Creating design time prompts | You can use a wizard to create design time prompts for custom-defined templates in Calculation Manager. | You can use variables in macros to prompt for information. | Not applicable | ||
| Sharing components | You can share script and formula components across plan (for Planning) and calculation (for Financial Management) types and applications. | Not applicable | Not applicable | ||
| Dragging and dropping components | You can drag and drop components into a business rule's flow chart within the Rule Designer. | You can drag and drop actions and formulas into the business rule's process bar in the Graphical Designer. | Not applicable | ||
| Showing and hiding detail | You can zoom in or out within a flow chart to display more (or less) detail. | Not applicable | Not applicable | ||
| Editing a business rule calc script | You can edit a business rule in calc script format, and return to editing it graphically in the Rule Designer. | You can edit a business rule in calc script format, but you cannot return to editing it graphically. | You can edit a business rule in text mode only. | ||
| Validating business rules | If you are working with a Performance Management Architect application, you can validate a Planning business rule against Performance Management Architect and/or Planning. You can validate a Financial Management business rule against Performance Management Architect only. You may want to validate against Performance Management Architect, for example, when the application you are validating against is not deployed, or when the application in Oracle Hyperion EPM Architect, Fusion Edition is not synchronized with the applications that are deployed to Financial Management and Planning. If you are working with a classic Financial Management or a classic Planning application: you can validate business rules against only Financial Management or Planning, respectively. | You can validate a business rule against Essbase or Classic Planning. | You can use the Scan function to scan the Visual Basic script file to ensure the functions are valid with the correct number of parameters and the dimension members are valid for the application. | ||
| Deploying business rules | You can deploy one business ruleset per calculation type to Financial Management; you can deploy one or more business rules to Planning and Essbase; you can deploy one or more business rulesets to Planning. You must deploy business rules and business rulesets to launch them from within Financial Management or Planning. The applications and calculation types, plan types, or databases you deploy them to determine their launch locations. | Not applicable | Not applicable | ||
| Launching business rules | After you deploy them from Calculation Manager, you launch Financial Management business rulesets and Planning business rules from within Financial Management and Planning. After you deploy Essbase business rules you can launch them from within Administration Services. Launch locations are determined by the locations to which you deploy business rules and business rulesets. You can define multiple launch locations for a business rule by creating shortcuts for it in Calculation Manager. | You can launch business rules from one or all locations by selecting the locations from which they can be launched. You can launch business rules from the Rules node of the Oracle Essbase Administration Services Administration Console, the Business Rules Graphical Designer, the Business Rules Web Launcher, a command line prompt, or from Planning Web. | You execute business rules when you perform calculations, translations, consolidations, and allocations. | ||
| Working with views | Calculation Manager contains four views of the objects to which you have access:
| Business Rules does not contain views. You view business rules and other objects in a flat list, by object type, from within the Administration Console. | Not applicable | ||
| Using the System View | The System View displays a hierarchical list of the Financial Management, Planning, and/or Essbase applications, their calculation types, plan types, and/or databases, and the objects to which you have access. This view enables you to see which application and calculation type, plan type, or database a business rule is designed against. (This is the default view in Calculation Manager.) | Not applicable | Not applicable | ||
| Using the Custom View | The Custom View displays a list of folders you create and objects you drag and drop into them. This view enables you to organize objects in a way that is meaningful to you. | Not applicable[a] | Not applicable | ||
| Using the Deployment View | The Deployment View displays a list, by application type and application, of the rules and rulesets that are deployed and not deployed, and their deployment and validation status. | Not applicable | Not applicable | ||
| Using the List View | The List View displays a list of the objects you select from the Filter dialog. The filter dialog enables you to create a filtered list, by application type, of applications, calculation and plan types, and objects to which you have access. | Not applicable | Not applicable | ||
| Migrating business rules | You can migrate business rules and other objects from the previous release of Business Rules to this release of Calculation Manager.
| You can migrate business rules from the previous release of Business Rules to this release of Calculation Manager and from previous releases of Business Rules to this release of Business Rules. | You can migrate business rules from the previous release of Financial Management to this release of Calculation Manager and from previous releases of Financial Management to this release of Financial Management. | ||
| Importing business rules | You can import business rules (and other objects such as templates and components) into Calculation Manager from Business Rules or from another Financial Management or Planning application within Calculation Manager. You can also import Essbase calc scripts into Calculation Manager. When you import calc script files, they become graphical business rules in Calculation Manager. | You can import business rules from an .xml file into Business Rules. | You can use the Load Rule option to import a valid Visual Basic script file into the application. | ||
| Exporting business rules | You can export one or more business rules and other objects from Calculation Manager to an .xml file. | You can export business rules and other objects from Business Rules to an .xml file. | You can use the Extract Rule option to export business rules from Financial Management to an external Visual Basic script file. | ||
| Using business rule shortcuts | You can create shortcuts to a business rule in multiple applications and calculation or plan types. When you deploy business rules with shortcuts, a copy of the rule is deployed to the applications and calculation or plan types for which you created a shortcut. | Not applicable | Not applicable | ||
| Working with variables | There are four variable types for Planning, two variable types for Financial Management, and three variable types for Essbase in Calculation Manager:
| There are two variable types in Business Rules:
| There are two variable types in Financial Management:
| ||
| Assigning access permissions to create and edit business rules | In Calculation Manager, your ability to create, view, and edit business rules and other objects is determined by the role you are assigned in Oracle's Hyperion® Shared Services and your ownership of the object in Calculation Manager. By default, a user owns the business rules and other objects the user creates. As an administrator or owner of the object, you can assign ownership of it to another user. | In Business Rules, you assign permission to edit business rules and other objects by selecting which users and groups can modify them. | In Financial Management, you do not need access permissions to create or edit business rules. | ||
| Assigning access permissions to launch business rules | You assign permission to launch business rules and business rulesets in Financial Management or Oracle Hyperion Planning, Fusion Edition; you assign permission to launch business rules in Oracle Essbase. Assigning permissions occurs after the business rules and business rulesets are deployed from Hyperion Calculation Manager. | You assign permission to launch business rules and sequences in Oracle's Hyperion® Business Rules by selecting the database location (or all locations) from which they can be launched and by selecting which users and groups can launch them. | You assign permission to execute a calculation process in Oracle Hyperion Financial Management, Fusion Edition by assigning the correct role security access for the application to which it belongs. For example, to run a Consolidate process, the user must have role security for Consolidate. |
[a] *In Business Rules, you can create projects to organize your business rules, sequences, macros, and variables in ways that are meaningful to you.