Sei sulla pagina 1di 21

Hyperion® Business Rules Release 9.2.

1 Readme

Hyperion® Business Rules


Release 9.2.1
Readme

Readme File
This file contains the following sections:

Readme File ................................................................................................................ 1


Purpose....................................................................................................................... 3
New Features .............................................................................................................. 3
What’s New in 9.2.1 .................................................................................................. 3
Migrate Identities....................................................................................................... 3
What’s New in 9.2 ..................................................................................................... 4
Support for Japanese and Simplified Chinese ................................................................ 4
Importing and Exporting Business Rules........................................................................ 4
Copying and Pasting Members ..................................................................................... 4
Assigning Access Privileges ......................................................................................... 4
Working with the Business Rules Cluster Editor .............................................................. 5
Changes to Rules, Sequences, and Variables.................................................................. 5
New Business Rule Configuration ................................................................................. 5
Updated System Requirements ................................................................................... 6
Installation Updates.................................................................................................... 6
64-bit Processor Support .......................................................................................... 6
Support for 3rd Party Products................................................................................... 6
Shared Services Server Name in Hyperion Configuration Utility ................................ 7
Cannot Deploy Products to WebLogic on Turkish OS ................................................. 7
Apache Tomcat Deployment on 64-Bit Platforms Requires 32-Bit JDK ...................... 7
Language Selection in Installer ................................................................................. 7
Hyperion Configuration Utility................................................................................... 7
Uninstallation of Products on Windows set to Japanese and Korean Locales ............ 7
WebSphere Product Permissions Issue ..................................................................... 8
Installing on UNIX .................................................................................................... 8
Upgrading Essbase .................................................................................................... 8
Upgrading Shared Services ....................................................................................... 8

1
Hyperion® Business Rules Release 9.2.1 Readme

Upgrading Administration Services ........................................................................... 8


Known Issues.............................................................................................................. 9
Deploying WebSphere 6 and WebLogic 9 .................................................................. 9
Using Hyperion Configuration Utility after Upgrading to Release 9.2.1 ..................... 9
Using Hyperion Configuration Utility if Temporary XML Files Exist on UNIX .............. 9
Hostnames Specified in English Only....................................................................... 10
Incorrect Translation of Cancel Button in Product Installers................................... 10
Running Installers in Graphical Mode on UNIX........................................................ 10
Hyperion Home Environment Variable in Migration Utility....................................... 10
Launching User Management Console from Start Menu on Windows XP (Korean OS)
................................................................................................................................ 10
Language List in Portuguese Installer..................................................................... 10
Language List in Turkish Installer ........................................................................... 10
Turkish Keyboard Entry in Shared Services Registration Panel ............................... 11
Language List in Italian Installer ............................................................................ 11
Russian Installers Display English Button ............................................................... 11
Russian Keyboard Shortcuts.................................................................................... 11
Russian Characters in Console Mode ....................................................................... 11
JVM Install Error When Installing on Same Computer on Which PC Anywhere is
Installed.................................................................................................................. 11
External Authentication........................................................................................... 11
Business Rules ........................................................................................................ 12
Graphical Business Rules ........................................................................................ 14
Aggregating Data..................................................................................................... 14
Creating Blocks ....................................................................................................... 14
Formulas ................................................................................................................ 14
Considerations for Using Business Rules with Planning ............................................ 14
Defects Fixed ............................................................................................................ 15
Defects Fixed in this Release................................................................................... 15
Defects Fixed in Business Rules 9.2.0.3 .................................................................. 15
Defects Fixed in Business Rules 9.2.0.2 .................................................................. 16
Defects Fixed in Business Rules 9.2.0.1 .................................................................. 17
Defects Fixed in Business Rules 4.1.1.1 .................................................................. 17
Defects Fixed in Business Rules 4.1.1 ..................................................................... 18

2
Hyperion® Business Rules Release 9.2.1 Readme

Tips and Troubleshooting .......................................................................................... 19


Working with Graphical Business Rules .................................................................. 19
Creating Blocks ....................................................................................................... 19
Creating Runtime Prompts ........................................................................................ 19
Miscellaneous .......................................................................................................... 19
Using Formulas........................................................................................................ 19
Using the NOT operator ............................................................................................ 19
Working with Business Rules .................................................................................. 20
Documentation Updates ............................................................................................ 20
Updated Guides for this Release.............................................................................. 20
Character Support in Database Names .................................................................... 21
Oracle’s Hyperion System 9 Shared Services Documentation Addendum ................ 21
Documentation Display Issues Using Internet Explorer 7 in Microsoft Windows Vista
................................................................................................................................ 21
Accessing Oracle’s Hyperion Product Documentation.............................................. 21

Note: Any references in the documentation to the Oracle E -Delivery site pertain if your site
has access.

Purpose
This document includes important, late-breaking information about this release of Oracle’s
Hyperion® Business Rules (Business Rules). Review this information thoroughly before installing
Business Rules.

New Features
The following topics describe the new features for this release of Business Rules and for the 9.2
release.

What’s New in 9.2.1

Migrate Identities
The Migrate Identities feature updates old identity attributes in the Business Rules repository
with new attributes from Shared Services. This feature enables movement of user ids across
organizational units (OUs) and duplicate common names in different OUs. See the Hyperion
System 9 Shared Services User Management Guide for configuration information and a list of
identity attributes for external providers.

3
Hyperion® Business Rules Release 9.2.1 Readme

Note: Before you run Migrate Identities, run the UpdateNativeDir utility in Shared Services.
See the Hyperion System 9 Shared Services 9.2.0.3 Documentation Addendum and the
Hyperion Shared Services Installation Guide.

You can access the migrate identities function using the Migrate Identities button in the
Business Rules node within Administration Services.

To migrate unique Shared Services identities to Business Rules:

1. Select Start > Programs > Hyperion System 9 BI+ > Analytic Administration
Services > Administration Console.
2. On Analytic Administration Services Login, enter a server name, or select one from the
drop-down list. Then enter your user name and password, and click OK.
The Administration Services Administration Console window displays with Business Rules
collapsed in the left frame of the window.

3. In the left navigation frame of Administration Services, expand the Business Rules node.

4. Right-click the Administration node, and select Migrate Identities.

5. In Migrate Identities results window, review the results of the migration, and click OK.

Note: If Planning is installed, clicking the Migrate Identities button in Planning automatically
migrates identities to Business Rules in addition to Planning.

What’s New in 9.2

Support for Japanese and Simplified Chinese


This release of Business Rules supports the Japanese and Simplified Chinese languages.

Importing and Exporting Business Rules


Interactive users can now import and export business rules. The Import Business Rules and
Export Business Rules functionality is available from the Business Rules node of the
Administration Console. To access the Import Business Rules and Export Business Rules
functionality, right-click the Business Rules node and select the appropriate menu option.

Copying and Pasting Members


In the Multiple and Single Member Selection dialog boxes, you can copy members from, and
paste members to, the Selected Values list.

Assigning Access Privileges


When you assign a user access privileges to a business rule on the Access Privileges tab, the
users and groups that already have access privileges to the business rule are listed in the
Selected list on the Add Privileges dialog box.

4
Hyperion® Business Rules Release 9.2.1 Readme

Working with the Business Rules Cluster Editor


This release of Business Rules includes a cluster editor. A cluster is a group of database
locations. You can use the Business Rules cluster editor to add locations to a cluster or create a
new cluster, to add access privileges to all of the locations in the cluster simultaneously, to add
the access privileges of selected business rules to the cluster, and to copy access privileges
from one cluster to another.

Changes to Rules, Sequences, and Variables


To support Oracle’s Hyperion® Planning – System 9 (Planning), changes were made to the
Business Rules Rule Editor and Sequence Editor, and to the Business Rules variable
functionality.

• In the Rule Editor, run-time prompts are separated from other variables on a Run-time
Prompts tab. You can reorder the run-time prompts, hide them from display during
validation and launch, and associate global run-time prompts with a business rule.

• In the Sequence Editor, the Launch Variable Values functionality is now on a separate
tab, Launch Variables. If a sequence has more than one occurrence of a launch variable
(for example, multiple prompts for “Execution Database name?”), you can merge all
occurrences so only the first occurrence of the launch variable is displayed during
validation and launch.

• For variables, if you have a Planning outline selected, you can select a Planning Smart
List option as the variable type. A Smart List is a custom list of textual options that users
can select from a data cell on a Planning data form, instead of entering a data value into
the data cell. (There is a data value associated with each option; the data value is stored
in the database.) For example, you can set up an integer Smart List for a reporting cycle
that has values 1-5, for Yearly (1), Quarterly (2), Monthly (3), Daily (4), and Hourly (5).
A user can select “Monthly” from the list and the number three is stored in the database.
This prevents users from having to remember the stored values.

New Business Rule Configuration


In this release of Planning, we have improved the run time processing for Business Rules to
enhance performance. The installation of all of the components is the same as it was in
previous releases. The configuration of Oracle’s Essbase® Administration Services
(Administration Services) and Planning has been enhanced. You should register Administration
Services with Oracle’s Hyperion® Shared Services (Shared Services) prior to registering
Planning with Shared Services.

Note: If there are multiple registrations of Administration Services with Shared Services, the
last configuration will be saved and used when Planning is registered with Shared Services.

Planning leverages the HBRServer.properties file that is registered with Shared Services as
part of the Administration Services configuration. Additionally, in the Create Planning
properties file task within Oracle’s Hyperion® Configuration Utility™ (Hyperion Configuration
Utility), for Planning configuration you no longer need to enable Business Rules and fill in the
appropriate Administration Services/Business Rules connections. This information is now
managed within the HBRServer.properties file that Planning reads from Shared Services.

5
Hyperion® Business Rules Release 9.2.1 Readme

Updated System Requirements


Note: Please see the Essbase Administration Services Installation Guide for a complete list of
the system requirements for this release of Business Rules.

This release of Business Rules includes the following changed system requirements for Hyperion
products:

• Support for Oracle’s Hyperion® Essbase® - System 9 (Essbase), Release 9.2.1; continuing
support for Oracle’s Hyperion® Essbase™ (Essbase) 7.x and higher

• Support for Shared Services, Release 9.2.1

• Support for Administration Services, Release 9.2.1

Installation Updates
This section includes important installation information for Oracle’s Enterprise Performance
Management System (EPM System), third party products and Unix, and information about
installing Shared Services, Essbase, and Administration Services (which installs Business Rules
automatically). Before you begin to install Administration Services, read all of the installation
instructions in the Essbase Administration Services Installation Guide.

64-bit Processor Support

Unless specifically stated in the installation documentation, Intel Itanium processors are not
supported for any platform. See the “Planning the Administration Services Installation” chapter
in the product installation guides for information about processor support.

Support for 3rd Party Products

Business Rules 9.2.1 supports these products:


• Microsoft Internet Explorer 7.0
• AIX 5.2 ML7
• AIX 5.3 ML3
• Mozilla Firefox 2.0.0.3
This release of Administration Services and Business Rules is the last release to support these
products:

• Mozilla Firefox 1.0.7

• Oracle Application Server 10G – 9.0.4

• JDK Server 1.4.2_08

• JRE Server 1.4.2_08

6
Hyperion® Business Rules Release 9.2.1 Readme

• Browser Plug-in JVM 1.3.1_17

Shared Services Server Name in Hyperion Configuration Utility

On the Shared Services registration panel of Hyperion Configuration Utility, you can enter only
English alphanumeric characters and the following special characters in the Server field:

• Dash ( - )

• Underscore ( _ )

• Dot (.)

Cannot Deploy Products to WebLogic on Turkish OS

Because of a known issue with WebLogic 8.1 using a Turkish operating system, Hyperion
products cannot be deployed to WebLogic 8.1 in a Turkish operating system environment. You
must switch the locale to English and then deploy the product. (1-237420421)

Apache Tomcat Deployment on 64-Bit Platforms Requires 32-Bit JDK

If you are deploying to Apache Tomcat as a Windows service on a supported 64-bit platform,
the computer hosting Tomcat must have a 32-bit JDK installation.

Language Selection in Installer

On the Country Selection Panel in the installer, do not choose "Japan" as the language if you
are installing on an operating system that does not recognize Japanese characters. Instead,
choose the "Other" country option to ensure that the license panel in the installer displays
correctly.

Hyperion Configuration Utility

On UNIX platforms, set the number of operating system file descriptors to at least 1024 to
avoid possible issues with application server deployment. Refer to your operating system
documentation for information on using the Limit command to increase this setting. You should
modify the file descriptors setting before launching Hyperion Configuration Utility.

Uninstallation of Products on Windows set to Japanese and Korean


Locales

Caution: Uninstalling EPM System products on Japanese or Korean versions of Microsoft


Windows using the Add/Remove program may cause an operating system crash. To avoid this
potential problem when uninstalling, locate the uninstall.exe for the product (located in
C:\Hyperion\<product name>\uninstall\) and double-click the executable to perform the
uninstallation manually.

7
Hyperion® Business Rules Release 9.2.1 Readme

WebSphere Product Permissions Issue

On UNIX platforms, if you are using the IBM WebSphere application server, ensure that you use
the same account to install, deploy, and execute EPM System products that you use to install
WebSphere. Using the same account ensures that Hyperion Configuration Utility can
successfully deploy Oracle’s Hyperion products to WebSphere.

Installing on UNIX

Hyperion recommends that all of Oracle’s Hyperion applications be installed as the same user
on UNIX platforms.

All of Oracle’s Hyperion products install common third-party and internal components under
HYPERION_HOME. To ensure that installers have the permissions required to modify the
HYPERION_HOME location on UNIX platforms, Hyperion recommends that all of Oracle’s
Hyperion applications be installed under the same HYPERION user account on UNIX platforms.

Upgrading Essbase

This release of Business Rules supports Essbase Analytic Services 7.x or higher. (The current
release is Essbase, Release 9.2.1) If you are using an earlier release of Essbase, you need to
upgrade to a supported release. Release 9.2.1 is available on the Oracle E - Delivery site.

Upgrading Shared Services

To configure Administration Services and Business Rules, and to provision users and groups,
you need to install, or upgrade to, Shared Services, Release 9.2.1. See the Hyperion Shared
Services Installation Guide.

Upgrading Administration Services

Administration Services is the administration tool for managing and maintaining Essbase.
Administration Services consists of a client console (Administration Console) and a middle tier
application server that communicates directly with Essbase.

Note: Business Rules is installed automatically with Administration Services and is accessible
from within the Administration Console.

You need to upgrade to this release of Administration Services after you upgrade Essbase. For
more information on installing Administration Services, see the Essbase Administration Services
Installation Guide, which has detailed instructions for installing and upgrading Administration
Services on either Windows or UNIX operating systems. This release of Administration Services
is available on the Oracle E - Delivery site.

Note: Before you install this release of Administration Services, uninstall the previous release;
also uninstall any previous releases of Business Rules. For more information on uninstalling
these products, see the Essbase Administration Services Installation Guide.

8
Hyperion® Business Rules Release 9.2.1 Readme

Known Issues
The following sections describe known issues (and work-arounds, where necessary) for
Administration Services, Business Rules, and Oracle’s other Hyperion products and processes
you use with them.

Deploying WebSphere 6 and WebLogic 9

On the application server panel in Hyperion Configuration Utility, WebSphere 6 and WebLogic 9
are displayed as choices for auto-deployment. WebSphere 6 and WebLogic 9 can only be
deployed manually for this release. Do not select the auto-deployment option for WebSphere 6
or for WebLogic 9. Follow the instructions in the product installation guide to manually deploy to
these application server versions. (6589838, 6589839)

Using Hyperion Configuration Utility after Upgrading to Release 9.2.1

When running Hyperion Configuration Utility after upgrading products from release 9.0 to
release 9.2.1, the product selection page may display multiple listings for a product or may not
list the product you are trying to configure. If this problem occurs, perform these steps:

1. Navigate to the following directory:

(Windows): <HYPERION_HOME>\common\config\product\<product>\<release number>


(UNIX): <HYPERION_HOME>/common/config/product/<product>/<release number>

Where <HYPERION_HOME> is the Hyperion Home location on the computer and


<product> is the product name or abbreviation, for example:

c:\hyperion\common\config\product\planning\9.2.1

2. Delete the oldest *.xml file from this directory.

For example, if the directory contains two files named planning_1.xml and planning_2.xml,
delete the older file.

3. Re-run Hyperion Configuration Utility.

Using Hyperion Configuration Utility if Temporary XML Files Exist on UNIX

On UNIX platforms, application server deployment or Web server configuration tasks may fail if
the temporary folder (as defined by the TEMP environment variable) contains *-build.xml files
created by another user. Ensure that *-build.xml files do not exist in the temporary folder
before running Hyperion Configuration Utility. (1-246275191)

9
Hyperion® Business Rules Release 9.2.1 Readme

Hostnames Specified in English Only

In product installers and Hyperion Configuration Utility, hostnames (computer names) should
not be localized and should be entered in English only. For example, when registering with
Shared Services in Hyperion Configuration Utility, the Shared Services server name should be
entered in English. (1- 215194141)

Incorrect Translation of Cancel Button in Product Installers

Some product installers display an incorrect translation of the Cancel button. (1-232246171)

Running Installers in Graphical Mode on UNIX

On UNIX platforms, if you run an installer in graphical mode and see square blocks on the
interface, run the installer in console mode. This problem occurs on Linux, AIX, and HP-UX for
these locales: Japanese, Korean, Simplified Chinese, and Traditional Chinese. (1-225327495)

Hyperion Home Environment Variable in Migration Utility

Oracle’s Hyperion® Home Migration Utility (Hyperion Home Migration Utility) does not read the
Hyperion Home environment variable even though it is already set. To migrate again, first open
and close a command window before starting migration a second time. This ensures that the
most recent Hyperion Home environment variable is displayed. This problem occurs only in the
following languages: Dutch, Simplified Chinese, Traditional Chinese, Korean, and Russian. (1-
203998684)

Launching User Management Console from Start Menu on Windows XP


(Korean OS)

User Management Console does not open when launched from the Windows Start menu
shortcut (Windows XP, Korean operating system, WebSphere 5.1.1.7 only). Use the URL
http://localhost:58080/interop/index.jsp to launch the console instead of using the Start
menu. (1-241779801)

Language List in Portuguese Installer

Using a Portuguese operating system, the drop-down list on the Language Selection panel in
the installer incorrectly displays Simplified Chinese, Traditional Chinese, and Portuguese
selections in Portuguese characters. All other language selections are displayed in English. (1-
220188376)

Language List in Turkish Installer

Using a Turkish Linux operating system, several languages on the Language Selection panel in
the installer are incorrectly displayed in English instead of Turkish. (1-230485951)

10
Hyperion® Business Rules Release 9.2.1 Readme

Turkish Keyboard Entry in Shared Services Registration Panel

On the Shared Services registration/deregistration panel in Hyperion Configuration Utility, using


a Turkish keyboard to enter an IP address in the Server text box does not work properly. You
must specify the host name rather than the IP address in the Server text box. (1-220531027)

Language List in Italian Installer

On AIX 5.2 with an Italian locale, the drop-down list on the Language Selection panel in the
installer is displayed behind the display window. (1-242110895)

Russian Installers Display English Button

Using a Russian operating system, the OK button on the Language Selection panel in the
installer is displayed in English rather than Russian. (1-228824221)

Russian Keyboard Shortcuts

Using a Russian keyboard to press keyboard shortcuts in the installers and Hyperion
Configuration Utility does not work. (1-205984971)

Russian Characters in Console Mode

Using a Russian operating system or a Simplified Chinese operating system on HP-UX Itanium,
incorrect Russian characters are displayed when running Hyperion Configuration Utility, the
Hyperion Home Migration Utility, or Oracle’s Hyperion® License Server™ (Hyperion License
Server) installer in console mode. (1-206616898)

JVM Install Error When Installing on Same Computer on Which PC


Anywhere is Installed

Due to an InstallShield bug, if you try to install Administration Services and Business Rules on a
computer on which PC Anywhere is installed, Java Virtual Machine (JVM), which is installed
automatically with Administration Services and Business Rules, does not install. To resolve this,
uninstall PC Anywhere before you install Administration Services and Business Rules. After you
complete the installation, reinstall PC Anywhere.

External Authentication

The following are known issues for external authentication.

• Users with empty passwords are not supported.

• Microsoft Active Directory sp2 and earlier releases of Hyperion applications are known to
have connectivity issues over SSL. To resolve such issues, refer to:

http://support.microsoft.com/default.aspx?scid=kb;en-us;Q320711

11
Hyperion® Business Rules Release 9.2.1 Readme

• Oracle’s Hyperion® Remote Authentication Module™ (Remote Authentication Module)


9.0.x does not support SSL connections on AIX.

Business Rules

The following are known issues for this release of Business Rules.

• When you create a graphical rule with an XREF component, after you save the rule, the
Source tab displays only the dimensions that are valid for both applications and does not
display dimensions that are valid for one application only.

• You cannot use the Command Line Launcher to launch a sequence with several business
rules containing runtime prompt variables. To work around this, put the business rules
comprising the sequences into a .bat or .sh file to launch them.

• If you have Administration Services running on an Oracle 10g application server, when
you launch a business rule with runtime prompts on the Web Launcher, you may receive
the following error message when you try to make a selection using the Member
Selection lookup button, “Page not found.” To work around this, don't use localhost as
the server name when you launch the Web Launcher, and make sure port 7777 is open.

• You can use arrays only in enhanced calc scripts.

• During product deregistration, Business Rules is not removed from the


projects/unassigned products, and the HBRServer.properties file is not removed from
Shared Services.

• If you configure Administration Services and Planning at the same time, the
HBRServer.properties file in the Planning deployment folder is not updated. To avoid
this, configure Administration Services before you configure Planning. If you configured
Administration Services and Planning at the same time, run the Create Planning
properties file task in Hyperion Configuration Utility again to update the
HBRServer.properties file. For more information, see the “Configuring Planning”
chapter of the Hyperion Planning – System 9 Installation Guide for this release.

• On a Turkish operating system, if the Business Rules repository resides on a server


whose host name contains the Turkish letter “ı” (without the dot), Planning cannot
access the Business Rules repository. To work around this, install the Business Rules
repository on a server whose host name does not contain the Turkish letter “ı” (without
the dot).

• Before you add a Pro Rata Ratio formula component to a graphical business rule, you
need to associate the business rule with an outline. If you do not associate the business
rule with an outline first, you may receive a “NullPointerException” error message and
need to recreate the rule.

• If you have a sequence with one or more business rules that contain hidden run-time
prompts, you may not be able to launch the sequence. To resolve this, do not hide the
run-time prompts within the rules themselves; instead, hide the rule’s run-time prompts
on the Launch Variables tab for the sequence.

12
Hyperion® Business Rules Release 9.2.1 Readme

• If you use Save As to save a business rule with the same name, but at least one letter in
a different case (upper/lower), the rule may be corrupted, and you may receive the
following error: “<name> already exists. Do you want to replace it?” If you answer
“Yes,” you may receive the following error: "Error retrieving rule with id 24 for browse."
This error is displayed whenever you try to open the original rule. If you log off, then log
on again, the rule is not listed in the Rules node of the Administration Console.

• If you create a business rule with a run-time prompt that has a limit, and, while
automating the run-time prompt, give it a value outside of the limit, the rule launches
successfully using the Command Line Launcher, even though the value of is outside of
the limit.

• If the Administration Services server is running on an AIX operating system, and you are
using Tomcat as your application server, you may receive errors when you try to access
the Business Rules Web Launcher Logon page. To resolve this:

1. Locate tools.jar. ON AIX platforms, it is in: /usr/java14/lib/tools.jar.

2. Copy tools.jar to the $HYPERION_HOME\common\JRE\IBM\1.4.2\lib folder.

3. Restart the Administration Services server using startEASTomcat5028eas.sh.

• If you add a business rule with no access privileges to a project, and specify access
privileges of “Cannot launch all locations” for the project, then add the same business
rule to another project that has access privileges to launch against one location, the
business rule does not launch against any locations. In this case, the access privileges of
the first project to which the business rule is assigned take precedence over the access
privileges of the second project to which it is assigned.

• When you create a sequence using one or more sequences that contain rules with run-
time prompts, and select hide check boxes for some of the run time prompts, some of
the member selections may show incorrect dimensions and members. To resolve this,
type in the correct values.

• The Aggregate Data component does not function correctly when more than one account
member is selected. For example, you can create a business rule using the component
Aggregate Data, and then select the Account Members variable in the Account Member
Selection window. If you then click Validate and select Exempt Total Payroll and Total
Payroll, the rule is not validated and an error is displayed.

• When you register Administration Services in Shared Services, Business Rules is


registered using the name of the server on which the Business Rules repository resides.
If one relational database repository server is shared between two or more
Administration Services/Business Rules servers, only one entry is created in Shared
Services for these servers. The entry contains the name of the shared relational
repository server.

• When you validate business rules with variables of the Saved Selection type against
Planning database locations, the members are not validated against the members to
which the user has access privileges in the Planning database location.

13
Hyperion® Business Rules Release 9.2.1 Readme

• If a new Essbase application is created while Administration Services Administration


Console is open, this application does not display in the Business Rules Select Metadata
dialog box. To see the application displayed in the Business Rules Select Metadata dialog
box, restart Administration Services Administration Console or click the Refresh button.

Graphical Business Rules

Aggregating Data
• The Derived option in the Aggregate Data component does not use the correct member
values. If you specify values in a source anywhere in the task flow, those values are
displayed. Destination values are displayed only if you have no sources defined.
• Business rules containing the Two-Pass calculation option of the Aggregate Data component
produce an Essbase error message.

Creating Blocks
The database size preview estimates in the Create Blocks dialog box does not reflect that blocks
are not created for Dynamic Calc and Label Only members.

Formulas
• Validation errors may occur with Business Rules that contain remote (XREF) sources where
the dimension names are similar to the current database but the member values contained
in the databases differ.
• When using the Variable component, ensure that the default members selected in the
formula range are not Dynamic Calc or Shared members. If a Shared member is selected,
you receive a validation error message. If a Dynamic Calc member is selected, you receive
an error message when launching the business rule.

Considerations for Using Business Rules with Planning


• For graphical business rules, you can select and store members by alias if you build a
business rule against an Essbase location. If you build a business rule against a Planning
location, you can select by alias, but store only by member name. Because of this, you need
to re-select the members that are stored by alias when you migrate a rule from an Essbase
location to a Planning location.
• If a Planning user has different roles in different Planning applications, the user’s highest
role is used in Business Rules. For example, if a user is an administrator in one application
and a planner in another application, this user becomes an administrator in Business Rules
– he can create, modify, and launch any rule in any application.

• Hyperion recommends that if you are going to associate calc scripts or business rules with a
form, you should either do so where all users of that form have access to those calc scripts
or business rules, or create a generic business rule using run-time prompts, and instruct the
user to launch it manually.

14
Hyperion® Business Rules Release 9.2.1 Readme

Defects Fixed
The following change requests were resolved and included in this and prior releases of Business
Rules.

Defects Fixed in this Release

These defects were fixed for this release:

• You cannot run sequences in a load balanced or clustered environment.

• If you add a user to a native group and an external group, provision the groups to
Planning with the role of Planner, and refresh the access privileges in Planning, the user
is listed twice on the Users tab in the Business Rules node of Administration Services. If
you give access privileges for a business rule to the external group only, and log on to
Planning, the rule is not visible; if you give access privileges to the native group only,
the rule is visible in Planning.

• When the Business Rules connection to the relational database is lost, Business Rules
does not reconnect to it. To solve this problem, an optional property,
HBR_CONNECTION_VALIDATE_TIME, was added to HBRServer.properties. This
property specifies a time interval for checking the connection between Business Rules
and the relational database. If the connection is not valid, a new connection is
established. The time interval is specified in milliseconds and defaults to 300,000 (five
minutes).

• Grant access changes made in Planning should also be made in Business Rules.

• Identity migration should be supported in Business Rules.

• During migration of sequences to a new server, the Execution Database Name field (and
any information in it) on the Launch Variables tab in the Sequence Editor is not migrated
to the destination server.

Defects Fixed in Business Rules 9.2.0.3

• When you try to save a macro that contains two macros, an error message is displayed,
and you cannot save the macro.

• If you try to log on to the Administration Services Administration Console at


http://localhost:10080/easconsole/easconsole.jnlp using admin/password or
Planning admin/password, the Business Rules log on may fail.

• When user and group identities are in mixed case (upper and lower) and both users and
groups are provisioned to Business Rules, users are unable to see business rules in
Planning Web. If the configuration property, HBR_IDENTITY_IS_CASESENSITIVE, is not in
the HBRServer.properties file or is set to false, user and group identities are compared
regardless of their case. If the property is set to true, identities are treated in a case-
sensitive manner.

15
Hyperion® Business Rules Release 9.2.1 Readme

• If you create a business rule and try to assign access privileges to users in the Access
Privileges dialog box, the users in the Selected list may not be the users you chose from
the Available list.

• If you provision a user, then log on to Administration Services with the user name in a
different case than the one that you provisioned, you may not be able to select a
database outline.

• Prior to this release, runtime prompts of the Percent and Real types with a numeric
default value of more than three decimal places displayed only three decimal places in
the Administration Console. Now runtime prompts of the Percent and Real types with a
numeric default value of more than three decimal places display up to 16 decimal places
in the Administration Console.

• Users without database manager access rights in Essbase can open and view business
rules, but cannot launch or validate them using Business Rules Web Launcher.

• You may not receive an error message if you try to migrate business rules from an
Oracle repository to the same Oracle repository (that is, when the source and target
Oracle repositories are the same).

• The Business Rules logon fails when you try to log on to the Administration Services
Web console at http://server:port/easconsole/console.html.

• Entering a very high value (for example, 2,600,000,000) into a runtime prompt can
produce a slightly different value in Essbase. Entered numbers have only 8 digits of
precision.

Defects Fixed in Business Rules 9.2.0.2

• The Essbase user IDs and passwords are stored as unencrypted text in the
Administration Services HBRPLUGINDATA repository table.

• Users cannot enter members of the Planning dimension, Hsp_Rates, (Hsp_InputValue,


Hsp_InputCurrency) when launching a business rule.

• If you create a macro within a macro, or insert a macro in a business rule, when you
save it and try to reopen the macro, you may receive an error message before the
macro opens. When the macro opens, only two the Source and Parameters tabs are
displayed.

• If you have more than one repository on the same server, you may not be able to
connect to a repository when you try to migrate it; only the first connection is
maintained.

• If you add multiple off-site domains to the search order in Shared Services, the
Administration Services server may restart more slowly than usual.

16
Hyperion® Business Rules Release 9.2.1 Readme

Defects Fixed in Business Rules 9.2.0.1

Business Rules does not support the standalone version of Oracle’s Hyperion® System™ 9
BI+™ Analytic High Availability Services™ (Analytic High Availability Services). Only the
embedded version of Analytic High Availability Services, which is installed automatically during
the Administration Services installation, is supported for Business Rules.

Defects Fixed in Business Rules 4.1.1.1

• If you do not select a database outline for one of the business rules in a sequence and
you specify to hide the execution database prompt in the Sequence Editor, and then
launch the sequence from Planning Web, you are prompted to enter the execution
database even though you hid it in the Sequence Editor. To resolve this, select an
outline for the rule and save it again.

• In the Multiple and Single Member Selection dialog boxes, you cannot copy members
from, or paste members to, the Selected Values list.

• The @Level_0_Descendants(membername) function includes two Essbase functions:


@LevMbrs (dimensionname,O) and IDescendants (membername). If you use the
@Level_0_Descendants(membername) function in a graphical business rule, you may
receive an error message when you try to validate the rule. To resolve this, use a
combination of the @LevMbrs (dimensionname,O) and IDescendants (membername)
functions instead.

• When you create a rule with a global run-time prompt variable of the integer or Smart
List type, and select to allow missing values for the run-time prompt, when you run the
rule and do not enter a value for the run-time prompt (i.e., you leave it blank), you may
receive the error message: “Launch value must be specified.”

• The Submit button in the Select Smart List dialog box does not work if you are using the
Web Launcher on the Mozilla FireFox 1.0.7 Web browser.

• When you create a business rule using a cluster in a 4.1.1 repository, migrate the
business rule to another 4.1.1 repository, and open the migrated business rule, you can
see the cluster under the Clusters tab, but may not see the locations in the cluster.

• When you create a sequence and merge the run-time prompt variables, then create
another sequence and add the first sequence to it, the run-time prompts for the first
sequence are not displayed as merged run-time prompts. If you reopen the sequence,
the run-time prompts are displayed as merged run-time prompts.

• When you create a business rule sequence with run-time prompts, and open the rule in
Web Launcher, the run-time prompts in the rule may display a Smart List associated
with them, even though there is no Smart List associated with them. To resolve
this, type the integer/real value or member names.

• To migrate a 4.0 repository, Planning/Business Rules admin users should be provisioned


to Global Roles as an administrator.

17
Hyperion® Business Rules Release 9.2.1 Readme

Defects Fixed in Business Rules 4.1.1

• If you are using WebSphere 5.1.1 or Oracle 10g, you may receive the following error
message when you launch a business rule from the Business Rules Web Launcher:
OracleJSP: oracle.jsp.parse.JspParseException: Line # 49, <jsp:param name=""
value=""></jsp:param>.

• If you use advanced selection to set limits for a variable (for example, a combination of
OR, AND, AND NOT), you cannot edit these limits.

• A provisioned user may not be able to log on to Business Rules if this user belongs to a
group that has no assigned role. To resolve this, assign a role to the group to which the
user belongs.

• When you try to migrate repository objects that have dependencies (for example, a
business rule with a local variable) a second time, and click the Dependencies button in
the Migrate Repository window for any of these repository objects, the dependencies are
not selected. To resolve this, close the Migrate Repository window and reopen it.

• Local and global Use by Value variables with a type of member or members are not
available for selection when you are creating a graphical business rule.

• If you define access privileges for a user in Planning, log on to the Administration
Console as a Planning administrator and create a custom business rule, and try to
launch the rule in Planning, the run-time prompt member selection may incorrectly filter
out members to which the user has access privileges and the rule may not launch
successfully.

• If you have a business rule that runs against a Planning database location and you add a
Create Blocks action to it, the database size is not updated when you click the Update
button.

• In the database outline, a plus sign is displayed next to all members, even if the
members do not have any children. When you click a member that does not have any
children, the plus sign disappears.

• In the Multiple Member Selection dialog box, you cannot select multiple members in the
Available list using the CTRL and Shift keys. You can only select one member at a time.

• If you make a member selection that contains a generic function that is not recognized
as one of Oracle’s Hyperion® Essbase® - System 9 functions (for example,
@descendants_including), the rule using the selection may not validate or launch
successfully. When this rule is parsed to find run-time prompts, the parse fails, and no
run-time prompts are found. The user is not prompted to enter a run-time prompt value,
so a “variable not found” error message is generated at launch or validate time.

• In some circumstances, dimensions from outlines for Oracle’s Hyperion® Planning –


System 9 applications may be displayed when you are selecting members and database
outlines in Business Rules and Administration Services. This may prevent your business

18
Hyperion® Business Rules Release 9.2.1 Readme

rules from validating. To resolve this, log off of Administration Services, then log on
again.

Tips and Troubleshooting


Working with Graphical Business Rules

Creating Blocks
Do not use the Create Blocks component on a partitioned database. Performing this action on a
partitioned database may cause Business Rules to freeze.

Creating Runtime Prompts


• If you click Cancel on the Automate Values dialog box, a runtime prompt file is still created.
• An integer type runtime prompt value must be between the values -2,147,483,648 and
2,147,483,647.
• A runtime prompt for real numbers must have a value between -9999999 and 99999999.

Miscellaneous
• Statistical or ratio type member values (for example, prices and percentage data types)
should be back-calculated for Summary Time Periods (for example, Quarters) using a
business rule.
• If you are adding an @TODATE function, use double quotation marks to enclose the second
parameter.
• If you are adding an @WITHATTR function, enter an attribute dimension for the first
parameter and use double quotation marks to enclose the second parameter.

Using Formulas
• The following financial functions cannot be used together with any other source type in a
formula:
@NPV, @ACCUM, @COMPOUND, @COMPOUNDGROWTH, @DISCOUNT, @INTEREST, @IRR,
and @SLN

These functions should be the only block to the right of the equal sign in a formula, because
they never return values. They calculate a series of values internally based on the range
specified. For more detail on these functions, see the Hyperion System 9 BI+ Analytic
Services Technical Reference Guide.

Using the NOT operator


• When building an expression using Member Selection, NOT cannot be used when performing
any of the following tasks:
• Defining Business Rule settings
• Defining a component using Multiple Member Selection
• Defining runtime limitations

19
Hyperion® Business Rules Release 9.2.1 Readme

• Using the Aggregate, Clear Data, or Create Blocks components


• Specifying the global range
• The following functions are valid with NOT in the Advanced Selection of Multiple Member
Selection:
@CHILDREN
@ICHILDREN
@ANCESTORS
@IANCESTORS
@DESCENDANTS
@IDESCENDANTS
@UDA
@GENMBRS
@LEVMBRS
@SIBLINGS
@ISIBLINGS

• The following functions are not valid with NOT in the Advanced Selection of Multiple Member
Selection:
@ALLANCESTORS
@IALLANCESTORS
@LSIBLINGS
@ILSIBLINGS
@RSIBLINGS
@IRSIBLINGS
@MATCH
@RELATIVE
@ATTRIBUTE

Working with Business Rules

• If you install Oracle’s Essbase® Administration Services on an AIX operating system, and
want to use the Business Rules Web Launcher, the root AIX user must install JDK separately
using the AIX built-in utility, installp or smit. After it is installed, you must point JAVA_HOME
to it.

• If you have difficulty with your color settings in Business Rules, Hyperion recommends that
you increase your Display Properties color depth setting.

Documentation Updates
The following changes and additions were made to the documentation for this release.

Updated Guides for this Release

This document, the Hyperion Business Rules Readme, was updated for this release. All other
Business Rules guides and help systems are 9.2 versions. For a description of the new features
for this release, see the section “New Features” in this readme.

20
Hyperion® Business Rules Release 9.2.1 Readme

Character Support in Database Names

When using Oracle’s Hyperion® Configuration Utility to configure a database, you can enter
only English alphanumeric characters and the dash character (-) for the database name.

Oracle’s Hyperion System 9 Shared Services Documentation Addendum

All documentation for new features, enhancements, and fixed defects for EPM System security
and user provisioning is contained in the Hyperion System 9 Shared Services Documentation
Addendum. This document is provided with the Shared Services Installation Documentation zip
file on the Oracle E - Delivery site and on the Shared Services DVD.

Documentation Display Issues Using Internet Explorer 7 in Microsoft


Windows Vista

This release of Oracle’s Hyperion® Business Rules includes two HTML-based help systems for
administrator and Web Launcher functionality. When you open HTML help using Internet
Explorer 7 in Microsoft Windows Vista, the initial help page displays without the Content, Index,
and Search tabs. Right-click the Internet Explorer Information Bar and choose “Allow Blocked
Content” to display the Content, Index, and Search tabs. When you do this, the message,
“Internet Explorer cannot display the webpage” displays in the right pane. Using any of the tabs
or links in the left pane displays the correct page, and the help system functions normally until
you close it.

Accessing Oracle’s Hyperion Product Documentation

You can download the most recent version of Oracle’s Hyperion product guides from the
Documentation area of the Oracle Technical Network (OTN) Web site at
http://www.oracle.com/technology/index.html

You can also download Oracle’s Hyperion product guides as part of the complete product
offerings from the Oracle E-Delivery Web site at
http://edelivery.oracle.com/EPD/WelcomePage/get_form. Please note that individual
product guides are available for download only on the Oracle Technical Network (OTN) Web
site.

Copyright © 2007 Oracle and / or its affiliates. All rights reserved.


http://www.oracle.com

21