Oracle® Hyperion Financial Management, Fusion Edition

Enhanced Cell Text Addendum

Release 11.1.2.1


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

Authors: EPM Information Development Team

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.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

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.


Table of Contents:

Overview

Defining Cell Text Labels

Load File Format

Loading Cell Text Labels

Extracting Cell Text Labels

Loading and Extracting Cell Text Data

Database Management

Entering Cell Text in Web Data Grids or Forms

Attaching Documents to Web Grids or Forms

Creating Web Data Forms

Cell Text Rules

Working with Performance Management Architect

Working with Financial Reporting

Working with Smart View

Overview

In Oracle Hyperion Financial Management, Fusion Edition, you can add cell text for any valid cell in a data grid. At times, you may need multiple cell text entries to store different types of information for a Point of View intersection. The Enhanced Cell Text feature enables you to create multiple cell text entries and define cell text labels to easily identify types of information when you view cell text. You can use cell text labels in Financial Management Web data grids and data forms. Cell text labels are also supported in Oracle Hyperion EPM Architect, Fusion Edition, Oracle Hyperion Smart View for Office, Fusion Edition and Oracle Hyperion Financial Reporting, Fusion Edition.

Defining Cell Text Labels

Before users can enter multiple cell text entries, the administrator must define cell text labels. The labels are loaded into Financial Management as metadata. They apply to all account cells in the application, and are available for selection when users enter cell text information.

These are the guidelines for defining cell text labels:

  • The label name can be a maximum 80 characters. It must be unique within a data cell.

  • It can contain spaces but cannot start with a space. If you are using an Oracle database, labels cannot contain spaces.

  • The label name cannot contain these characters:

    • ampersand (&)

    • asterisk ( * )

    • at symbol ( @ )

    • comma ( , )

    • curly brackets ( { } )

    • double quotation mark ( " )

    • forward slash (/)

    • less than symbol (<)

    • minus sign (-)

    • number sign ( # )

    • period (.)

    • pipe character (|)

    • plus sign (+)

    • semicolon ( ; )

    • tilde character (~)

Example

For example, suppose an administrator has defined these cell text labels for an application. Users can select from the label list and enter the corresponding cell text data. When you view the cell text for a specific POV data cell, you would see this information:

Example of administrator-defined cell text labels

Note:

In the current release, only cell text labels are displayed in the Financial Management user interface; descriptions are not displayed.

Load File Format

You can load cell text labels as part of a metadata load in a Cell Text Labels section in the load file. The following example shows a sample load file section for cell text labels:

<MISC Name="CellTextLabel">
<MISCENTRY>
<LABEL>MaturityDate</LABEL>
</MISCENTRY>
<MISCENTRY>
<LABEL>CouponRate</LABEL>
</MISCENTRY>
<MISCENTRY>
<LABEL>ExchangeRate</LABEL>
</MISCENTRY>
<MISCENTRY>
<LABEL>Rating</LABEL>
</MISCENTRY>
<MISCENTRY>
<LABEL>InterestRate</LABEL>
</MISCENTRY>
</MISC>

Loading Cell Text Labels

You load cell text labels as metadata. The Load dialog box now includes an option for cell text labels. When loading, you can use the Merge or Replace mode. If you use Replace mode, the system may delete cell text labels that are currently in use, resulting in orphaned cell text data in the application. You can also delete cell text labels at any time from the system even if they have cell text data assigned, resulting in orphaned cell text data. In these instances, you can use the “Clear Invalid Records” option in Database Management to clear invalid cell text data.

For details on loading metadata, see the Oracle Hyperion Financial Management Administrator’s Guide.

Extracting Cell Text Labels

You can extract cell text labels as metadata. For details on extracting metadata, see the Oracle Hyperion Financial Management Administrator’s Guide.

Loading and Extracting Cell Text Data

You can load and extract cell text labels during the data load or extract process. To separate cell text content in the DAT file, you must use one of these delimiters: the pipe symbol (|) or the tilde (~).

Example:

!Descriptions
Actual;2011;February;Periodic;California;USD;Sales;[ICP None];GolfBalls;Customer2;[None];Increases;"MaturityDate~02/28/11|CouponRate~8%|Rating~AAA"

For details on loading and extracting data, see the Oracle Hyperion Financial Management Administrator’s Guide.

Database Management

You can delete cell text labels from the system, even if they have cell text data assigned, which may result in orphaned data. To clear invalid cell text data, in the Database Management module, use the Clear Invalid Records option.

Entering Cell Text in Web Data Grids or Forms

You can enter cell text information in Web data grids or Web data forms.

The cell text field can store as many characters as defined for the application. Maximum length for a cell text value is defined by the “MaxCellTextSize” application attribute.

You can enter any characters for cell text values and you can use spaces. However, you cannot include the pipe (|) or tilde (~) character if you used it as a delimiter for the cell text value in the load format.

For every application, there is a system-generated member for Cell Text Label named [Default]. If you want to enter only one cell text entry for a data cell, you can select the [Default] member to enter the cell text information. A cell can have either just one entry using the [Default] cell text label, multiple cell text label entries, or a combination of cell text labels and [Default] entries.

  To enter cell text:

  1. From a data grid or data form, select the cell for which you want to add cell text.

  2. Right-click and select Cell Text.

    Example of Cell Text Labels

    The Cell Text dialog box includes the POV information and a grid for cell text. If no text already exists for the cell, the system displays a blank grid.

  3. Click Add.

    The system adds a row with the [Default] system member as the cell text label.

  4. Do one of these steps:

    • Either accept the [Default] label or select one of the other previously loaded labels from the drop-down list.

    • On the row next to the [Default] system member label in the Cell Text column, enter the cell text.

    The cell text labels in the drop-down list are displayed in alphabetical order. You cannot use the same label twice in the same grid.

    Tip:

    To quickly find a cell text label from a long list, enter one or more letters of the label. For example, if you enter R, the system quickly advances to the first cell text label starting with R (Rating in this example). You can then use the up and down arrows to find the correct label.

  5. Optional: To add cell text rows, click Add, select a Cell Text Label, and enter text.

  6. When you finish entering cell text, click OK.

  7. Click Submit Data to save the data, or Reset Data to refresh the database

Attaching Documents to Web Grids or Forms

In addition to entering cell text in data grids or data forms, you can attach one or more documents to cells for additional detail. For example, you can attach a Microsoft Word document, Microsoft Excel spreadsheet, XSL, or RPT file. You can have a doc attachment for each cell text label per POV cell.

  To attach documents to cells:

  1. From a data grid or form, select the cell to which to attach a document.

  2. Right-click and select Cell Text.

  3. Click Attach.

  4. Do one of these steps:

    • To include one document attachment for the cell, click the cell with the [Default] cell text label.

    • To include multiple document attachments for the cell text label entry, click the icon to the right of each cell text row to open the Document Attachment dialog, then attach the document to that cell text row.

  5. From your list of custom documents, select one or more documents to associate with the cell, and click Attach.

  6. Click OK.

Creating Web Data Forms

When you are creating Web data forms, you can allow users to define each column or row as cell text information instead of data.

If you enter a value of 0, 1, 2, or [Default] for cell text, the system returns the default cell text entry.

celltext:Label

Sample script:

C1=Y#CUR.P#CUR,CellText:MaturityDate
Example of Web Data Form script with cell text

Cell Text Rules

The Enhanced Cell Text feature includes three new rules for storing and retrieving multiple cell text entries and using cell text labels.

GetCellTextWithLabel

Gets the cell text from the Point of View for the specified cell text label. This function can be used in these types of rules:

  • Calculation

  • Translation

  • Consolidation

  • Allocation

Syntax

HS.GetCellTextWithLabel("POVExpression", "CellTextLabel")

where POVExpression is a combination of members. If you do not specify a dimension, these default values are used.

  • Account - [none]

  • ICP - [ICP None]

  • Custom1...4 - [None]

  • Scenario - Current Scenario member

  • Entity - Current Entity member

  • Value - Current Value member

  • Year and Period - Current member

And CellTextLabel is either the default cell text label (“[Default]”) or one of the valid loaded cell text labels.

Note:

The default dimension member values apply when you use this function in Calculation rules. When used in Allocation, Translation, or Consolidation rules, you must specify the Account, ICP, and Custom1…4 members. The Scenario, Year, Period, View, Entity, and Value default to the current members.

Return Value

The cell text for the POV and cell text label specified.

Example

HS.GetCellTextWithLabel("A.Sales.I#[ICP None].C1#[None].C2#[None].C3#[None].C4#[None]","Rating")

ContainsCellTextWithLabel

Determines if the cell contains cell text for the specified label. This function can be used in these types of rules:

  • Calculation

  • Translation

  • Consolidation

  • Allocation

Syntax

HS.ContainsCellTextWithLabel("POVExpression", “CellTextLabel”)

where POVExpression is a combination of members. If you do not specify a dimension, these default values are used:

  • Account - [none

  • ICP - [ICP None]

  • Custom1...4 - [None]

  • Scenario - Current Scenario member

  • Entity - Current Entity member

  • Value - Current Value member

  • Year and Period - Current member

And CellTextLabel is either the default cell text label (“[Default]”) or one of the valid loaded cell text labels.

Note:

The default entries apply when you use this function in Calculation rules. When used in Allocation, Translation, or Consolidation rules, you must specify the full sub-cube account/ICP/Customs POV. The Scenario, Year, Period, View, Entity, and Value dimensions default to the current members.

Return Value

A Boolean expression that is True if the specified data cell contains cell text for the cell text label specified; False otherwise.

Example

In this example, if the specified cell does not contain cell text for the cell text label specified, then statements between the If...Then and End If lines are executed.

If HS.ContainsCellTextWithLabel ("A#Sales.C1#Prod1.C2#Region1", “Rating”) = "False" then ... End If

SetCellTextWithLabel

Writes a text string to cell text for a specified POV and cell text label. This function can be used in these types of rules:

  • Calculation

Syntax

HS.SetCellTextWithLabel("POVExpression", "CellTextLabel", "CellTextString")

where POVExpression is a combination of members and CellTextLabel is either the default cell text label (“[Default]”) or one of the valid loaded cell text labels. CellTextString is the text string to be written. You must specify the Account, ICP, and Custom POV members. The Scenario, Year, Period, View, Entity, and Value default to the current members.

Return Value

None

Example

HS.SetCellTextWithLabel "A#Asset.I#[ICP None].C1#None.C2#None.C3#None.C4#None”, “Rating”, “AAA”

Working with Performance Management Architect

Cell text labels are now supported in Oracle Hyperion EPM Architect, Fusion Edition. See the Oracle Hyperion Enterprise Performance Management Readme 11.1.2.1.102 (11780153).

Working with Financial Reporting

When you are working in Oracle Hyperion Financial Reporting, Fusion Edition, you can retrieve multiple cell text entries per Point of View. See the Oracle Hyperion Financial Reporting Readme 11.1.2.1.101 (11732644).

Working with Smart View

When you are working with Oracle Hyperion Financial Management, Fusion Edition data forms in Oracle Hyperion Smart View for Office, Fusion Edition, you can now retrieve multiple cell text entries per POV. See the Oracle Hyperion Smart View User’s Guide 11.1.2.1.101 (12398953).