Oracle® Hyperion Disclosure Management

Readme

Release 11.1.2.2.00


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

Authors: EPM Information Development Team

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

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 is software or related documentation that 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 America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware 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 that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

This software or hardware 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:

Purpose

New Features and Enhancements

Installation Information

Supported Platforms

Supported Languages

Supported Paths to this Release

Defects Fixed in this Release

Known Issues

Tips and Troubleshooting

Documentation Updates

Accessibility Considerations

This document includes important, late-breaking information about this release of Oracle® Hyperion Disclosure Management. Review this Readme thoroughly before installing Oracle® Hyperion Disclosure Management .

Help Systems for the 11.1.2.2.000 Release

For Oracle Hyperion Disclosure Management User’s Guide in the 11.1.2.2.000 release, the help system accessed from within the product has been updated for the 11.1.2.2.300 release. Oracle®Hyperion Disclosure Management Release 11.1.2.2.000 Patch Set Update (PSU): 11.1.2.2.300 (14153925) is available for download on My Oracle Support. We recommend that you download and use this PSU which contains bug fixes and new features.

If you require a help system for the 11.1.2.2.000 release, you can download it from the documentation library: http://docs.oracle.com/cd/E17236_01/index.htm

Disclosure Management 11.1.2.2

Hosted Online Help - Online Help content for EPM System products is served from a central Oracle download location, which reduces the download and installation time for EPM System. You can also install and configure online Help to run locally. For more information, see the Oracle Enterprise Performance Management System Installation and Configuration Guide.

For new features relating to installation, architecture, and deployment changes in this release, see "New Features" in the Oracle Enterprise Performance Management System Installation and Configuration Readme. .

  • Various validation UI enhancements, which include the following:
    • Regulatory rules built into Disclosure Management. On the Disclosure Management Mapping Tool, provides support for XBRL formula validation. By selecting “ Show Formula Trace ”, you can run formulas that are part of the taxonomy.
    • Ability to display or hide selected columns:
      • Validate Tab: A new Validate tab is available in the mapping tool. This tab provides new features that assist the validation and error fixing process.
      • Display or Hide Columns: The Validate and Review tabs provide the ability to show or hide columns. To access this feature select View, and then More Columns. The following columns can be shown or hidden: Override value, Dimensions, Tuple and Doclet.
    • View Status Detail. On the Validate tab, you can view status detail by selecting View, and the Expand All.
    • Export Validation to Excel. You can export the validation messages to Microsoft Excel. From the Validate tab, click the Export icon (depicted as an Up arrow).
    • Mouse-over tooltips on columns are available.

Late-breaking information about installation of Oracle Enterprise Performance Management System products is provided in the Oracle Enterprise Performance Management System Installation and Configuration Readme . Review this information thoroughly before installing EPM System products.

Information about system requirements and supported platforms for EPM System products is available in a spreadsheet format in the Oracle Enterprise Performance Management System Certification Matrix . This matrix is posted on the Oracle Fusion Middleware Supported System Configurations page on the Oracle Technology Network (OTN):

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

Information about supported languages for EPM System products is available in a spreadsheet format on the Translation Support tab in the Oracle Enterprise Performance Management System Certification Matrix . This matrix is posted on the Oracle Fusion Middleware Supported System Configurations page on OTNa:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

You can upgrade to EPM System Release 11.1.2.2 from the following releases:

Note: For instructions to upgrade, see the Oracle Enterprise Performance Management System Installation and Configuration Guide , "Upgrading EPM System Products."

Note: If you are starting from Release 9.2.0.3+, 9.3.0.x, 9.3.1.x (except for Oracle Essbase 9.3.1.4.1, 9.3.1.5, 9.3.1.6, and 9.3.1.7), or 11.1.1.x, Oracle recommends that you upgrade to Release 11.1.1.3 as your interim release. If you are starting from an earlier release, Oracle recommends that you upgrade to the highest level release that directly supports upgrade from your starting release. Security Synchronization between Essbase and Shared Services was removed in Essbase Release 9.3, starting with Release 9.3.1.4.1. Essbase and Oracle Hyperion Shared Services Release 11.1.1.3, however, still synchronize security information. For this reason, if you are using Oracle Essbase Release 9.3.1.4.1, 9.3.1.5, 9.3.1.6, or 9.3.1.7, you must first upgrade all products to Release 9.3.3, instead of Release 11.1.1.3.

If you are coming from Release 11.1.2.0 or 11.1.2.1, use the Defects Fixed Finder tool to review the list of defects fixed between those releases and Release 11.1.2.2. This tool is available here:

https://support.oracle.com/oip/faces/secure/km/DocumentDisplay.jspx?id=1292603.1

  • 13905776 -- During the mapping process a dialog box occasionally pops up: "Error was encountered when registering document mappings".
  • 13908687 -- Unformatted property affects taxonomy loading.
  • 13916186 -- In The validate tab, removing a dimension mapping in the details tab causes an ADF error.
  • 13938325 -- iXBRL generates invalidCastException.
  • 14007080 -- SEC Viewer does not render the report completely.
  • 12573784 -- Multiple cells in a Microsoft Word table, Apply Scaling, do not show in the Review tab.
  • 12660897 -- Improvements to instance generation performance.
  • 12885091 -- Some taxonomy properties trigger null pointer exception.
  • 12885247 -- Boolean data types require manual edits in an instance document.
  • 13434045 -- Page breaks should be inserted in the generated Inline XBRL document.
  • 13448686 -- White spaces appear in generated IXBRL during HMRC validation.
  • 13482431 -- The Formula Trace button does not work.
  • 13501057 -- The Save As utility hangs the report if IXBRL is extracted to an empty path.
  • 13541330 -- Doclet settings are not applied in a master document.
  • 13586476 -- When iXBRL is generated, xsi="true" is incorrectly added for fixedItemType .
  • 13591178 -- Tuple data source mappings work incorrectly.
  • 13603189 -- Tuple mapping results in the error "“ Concept is not found in the taxonomy.
  • 13604274 -- When generating an instance, dimensional contexts are not created.
  • 13606337 -- An iXBRL generation error occurs when a paragraph mark exists in a tag.
  • 13606352 -- The Detach Mapping icon in the Review pane does not remove the entire mapping.
  • 13623115 -- The Disclosure Management mapping tool should show the "Balance Type" and "Weight" attributes of the numeric-based concepts in the Concept Detail tab.
  • 13632369 -- A Duplicate Report should not maintain the association to the master document.
  • 13638066 -- The Instance Generator creates duplicate context.
  • 13640916 -- Disclosure Management should provide an error message when the SEC viewer fails to generate a report.
  • 13693172 -- The Instance Generator creates duplicate context.
  • 13714750 -- Rollover references a prior taxonomy in the doclets.
  • 13715619 -- Contexts are not changed in the doclets after performing a rollover.
  • 13719369 -- Map level formats are not saved.
  • 13735246 -- You cannot remove extinct dimension maps from the mapping tool.
  • 13744707 -- XBRL generations contains invalid table vspace and hspace attributes.
  • 13769713 -- When Microsoft Word contains section breaks, XBRL generation produces instance, that contains HTML code not valid for the content of the HTML Body tag.
  • 13789194 -- A Net Exception occurs when you unmap a single cell in a Function Grid.
  • 13814934 -- A generated XBRL Instance does not sort correctly.
  • 13904981 -- Disclosure Management does not remove mapped default domain members from the Current Mapping tab.
  • 13920905 -- Facts with dimensions but different context seems to result in one context causing duplicate facts in the instance generated.

The following issues are the noteworthy known issues of this release.

Table 2. Known Issues

Bug Description
14180502

Microsoft Excel doclets saved in a version prior to 11.1.2.1.110, will fail upon migration to release 11.1.2.2. This happens when DiscMan 11.1.2.2.x (PS2) is applied on top of a Disclosure Management version prior to 11.1.2.1.110. when the Master Document is opened in the new version, the migration of Microsoft Excel doclets fail.

Workaround:

  1. Prior to deploying Disclosure Management PS2 (11.1.2.2), apply Disclosure Management PSU 11.1.2.110 or later.
  2. Migrate all the DM reports to the new 11.1.2.110 or later.
  3. Deploy PS2 (11.1.2.2)
  4. Migrate the reports to 11.1.2.
13954272

Chinese characters in the generated HTML is garbled: Adding the following line into the HTML will solve the problem:<meta http-equiv-“ Content-Type ” content=“ text/html; charset=utf-8/ ”/>

13899200

When a Schema Namespace has been defined in a taxonomy, it cannot be removed using the Taxonomy Designer.

13829667

Disclosure Management fails to remove dimension mapping for a grid cell on the Remove Mapping dialog box.

13770755

Unable to change an existing ID for an extended link. Workaround: Open the taxonomy files and manually replace all the references for the extended link ID with the desired name. Note that this needs to be done not only in the 'XSD' file but all other related taxonomy files (such as the presentation, calculation and definition linkbase files) where the extended link is referenced.

13484964

If you export a Microsoft Excel report with a file name containing non-ASCII characters, the Microsoft Excel file name is garbled in the .ZIP file.

13450832

A report name containing non-ASCII characters is garbled in the .DMR file after the XBRL has been generated.

13331834

The Drag/Drop operation of elements within the same tree may lead to duplicate elements being created in the Definition View. For Example:

  1. Open US GAAP extension taxonomy in TD, edit enabled, Definition view displayed.
  2. Search for "ScheduleOfDefinedBenefitPlansDisclosuresTable". Table tag is located under Extended Link (0610 - Disclosure - Pensions and Other Postretirement Benefits (Details))
  3. Attempt to drag/drop the tag to a different location in Extended Link 0610.

A duplicate tag is created where the desired behavior is to move the tag to a different location.

To avoid this behavior, save and re-open the taxonomy and then delete the duplicate elements.

13932507

Unable to remove a schema namespace from taxonomy. When authoring an extension taxonomy that references taxonomies by namespace, the Disclosure Management Taxonomy Designer (TD) may not remove all the generated namespace declarations automatically from the extension taxonomy after the user removes a reference taxonomy using the Referenced Taxonomies dialog.

In release 11.1.2.1.112 of Disclosure Management, the taxonomy author may need to manually edit the generated XBRL outside of Taxonomy Designer to completely remove all the namespace mappings associated with the removed reference taxonomy.

To remove a namespace mapping from the extension taxonomy schema file (typically this is the file that ends with *.xsd):

  1. Open the extension taxonomy schema file in any text editor.
  2. Search for the extra namespace mapping that identifies the schema that has already been removed in the Referenced Taxonomies dialog. For example, the nonnum taxonomy has the namespace mapping xmlns:nonnum="http://www.xbrl.org/dtr/type/non-numeric"
  3. Delete this line.
  4. Save the . xsd file.

The next time the extension taxonomy is loaded into the Taxonomy Designer, the taxonomy reference (the nonnum taxonomy) should be omitted from the Referenced Taxonomies dialog.

13840681

In a clustered environment the Essbase server name used by SmartSlice is different than FRDataSource.When you create an APS connection to Essbase, the server name used by default is the cluster name. The workaround is that users should click Advance Setup when creating an APS connection to ensure they match the server name used by Financial Reporting. To create this cluster/server mapping, do the following:

  1. Run <MW_HOME>/user_projects/epmsystem1/bin/upgrades/UpdateEssbaseServer.bat <hostName><clusterName>
  2. Run <MW_HOME>/user_projects/epmsystem1/bin/upgrades/FRUpdateEssbaseServer.bat
13922381

In the Disclosure Management Taxonomy Designer, XBRLI data types are not shown in the Properties drop-down list.

When authoring a taxonomy that uses data types in the XBRLI namespace, Disclosure Management Taxonomy Designer (TD) may not show them in the Data Type property dropdown list. In release 11.1.2.1.112 of Disclosure Management, Taxonomy Designer does not recognize all data types defined in the XBRLI namespace by default.

The complete set of data types defined in the XBRLI namespace that are designed for public taxonomies can be found online at: http://www.xbrl.org/2003/xbrl-instance-2003-12-31.xsd

To change the data type use for taxonomy extensions, set the <Enabled> element to have a value of "true" in the following <DataType> element declarations in the "XBRLMetadata.xml" file located under XBRL the Taxonomy Designer installation folder. (This file is typically located under: c:\Program Files\Oracle\Disclosure Management\XBRL Taxonomy Designer metadata\):

<DataTypes>

</SampleData>

.........<BaseType>normalizedString</BaseType>

..........<Documentation>Derived from string. All whitespace characters (tabs, carriage returns, line feeds) will be converted to space characters; all multiple spaces will be converted to a single space. See XML Schema Part 2, Section 3.2</Documentation>

..........<Enabled>true</Enabled>

..........<NumericContext>false</NumericContext>

..........<XBRL21>true</XBRL21>

..........<XBRL20>true</XBRL20>

..........<XBRL10>false</XBRL10>

..........<Image>String</Image>

...</DataType>

</DataTypes>

Note that the sort order might be different by customer depending on the number of <DataType> elements already defined.

The enabled data types are available after restarting the Taxonomy Designer.

Taxonomy Designer Reports Errors on Loading of the Taxonomy (13816946)

When authoring a taxonomy that uses the 2009 Linkbase Role Registry (LRR), Disclosure Management Taxonomy Designer (TD) may report inadequate errors related to the "negated labels". In release 11.1.2.1.111 of Disclosure Management, Taxonomy Designer does not recognize all roles defined in the LRR.

The complete set of LRR roles are designed for public taxonomies and defined online: http://www.xbrl.org/lrr/lrr.xml.

If a taxonomy extension uses one or more of these LRR roles, Taxonomy Designer might report inadequate errors on load related to negated labels. For example, the following errors may be reported:

  1. missing role definition for http://www.xbrl.org/2009/role/negatedLabel used on elementus-gaap:StockholdersEquityAbstract->us-gaap:TreasuryStockValue preferredLabel role of presentation arc
  2. missing role definition for http://www.xbrl.org/2009/role/negatedTotalLabel used on element us-gaap:IncomeTaxExpenseBenefitAbstract->us-gaap:DeferredTaxLiabilities preferredLabel role of presentation arc
  3. http://www.xbrl.org/2009/role/negatedNetLabel used on element us-gaap:DiscontinuedOperationsAndDisposalGroupsAbstract->us-gaap:DiscontinuedOperationTaxEffectOfIncomeLossFromDisposalOfDiscontinuedOperation preferredLabel role of presentation arc

Because the US-GAAP taxonomy provides equivalent negated label roles, these errors can be avoided by replacing each LRR role with an equivalent US GAAP role in the taxonomy extension. The SEC will accept authoring of either label roles, according to the EDGAR Filing Manual v18 set of guidelines.

The following mapping of LRR negated label roles to US GAAP negated label roles can be used to correct the taxonomy extension:

To change the taxonomy extension role use, complete the following steps in Taxonomy Designer:

  1. Add the following LabelRoles to the "XBRLMetadata.xml" file located under XBRL Taxonomy Designer installation folder. (This file is typically located under: c:\Program Files\Oracle\Disclosure Management\XBRL Taxonomy Designer metadata\) <LabelRoles> ....<LabelRole> . . . </LabelRole> <LabelRole> . . . </LabelRole> <LabelRole> . . . </LabelRole> <LabelRole> ..........<SortOrder>25</SortOrder> ..........<Type>Label</Type> ..........<URI21>http://www.xbrl.org/2009/role/negatedLabel</UII21> ..........<Name>Negated Label</Name> <Documentation>Negated</Documentation> ....</LabelRole> ....<LabelRole> ..........<SortOrder>26</SortOrder> ..........<Type>Label</Type> ..........<URI21>http://www.xbrl.org/2009/role/negatedLabel</UII21> ..........<Name>Negated Label</Name> <Documentation>Negated</Documentation> ....</LabelRole> ....<LabelRole> ..........<SortOrder>27</SortOrder> ..........<Type>Label</Type> ..........<URI21>http://www.xbrl.org/2009/role/negatedLabel</UII21> ..........<Name>Negated Label</Name> <Documentation>Negated</Documentation> ....</LabelRole> ....</LabelRoles>

    Note:

    The sort order might be different for a customer depending on the number of labelRoles already defined.
  2. Add the corresponding role URI references to the label linkbase file (typically this is the file that ends with *_lab.xml). For example, add role URIs for negatedLabel, negatedTotalLabel, and negatedNetLabel: <linkbase xmlns=http://www.xbrl.org/2003/linkbase" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://www.xbrl.org/2003/linkbase http://www.xbrl.org/2003/xbrl-linkbase-2003-12-31.xsd"> . . . . . . <roleRef xlink:type="simple" xlink:href="http://www.xbrl.org/lrr/role/negated-2009-12-16.xsd#negatedTotalLabel" roleURI="http://www.xbrl.org/2009/role/negatedTotalLabel" /> <roleRef xlink:type="simple" xlink:href="http://www.xbrl.org/lrr/role/negated-2009-12-16.xsd#negatedTotalLabel" roleURI="http://www.xbrl.org/2009/role/negatedTotalLabel" /> <roleRef xlink:type="simple" xlink:href="http://www.xbrl.org/lrr/role/negated-2009-12-16.xsd#negatedNetLabel" roleURI="http://www.xbrl.org/2009/role/negatedNetLabel" />

This area describes documentation updates

It is our goal to make Oracle products, services, and supporting documentation accessible to the disabled community. Oracle's <Product Name> supports accessibility features, which are described in Appendix <appendix letter> in the <Guide Name>. The most up-to-date version of this guide can be found in the Oracle Enterprise Performance Management System Documentation Library on the Oracle Technology Network ( http://www.oracle.com/technology/documentation/epm.html ).

In addition, this Readme file is accessible in HTML format.