New features and optimizations introduced with Release 9.3 in the Oracle's Hyperion® Interactive Reporting document file format, impact existing pre-9.3 Release Interactive Reporting documents saved in Interactive Reporting Studio Release 9.3 or later. These documents can lose structures when opened by an earlier release of Interactive Reporting Studio. This topic describes new structures that can be added and how documents saved in Release 9.3 or later can be made compatible with earlier releases.
Opening, using, and saving an Interactive Reporting document in Interactive Reporting Studio Release 9.3 or later without adding new structures does not cause loss of structure if opened again in an earlier release of Interactive Reporting Studio, as no new structures were added.
Examples of new structures:
Scatter and bubble charts are new sections that are not recognized in earlier releases of Interactive Reporting Studio. Earlier releases ignore these sections in a Release 9.3 or later Interactive Reporting document. If that document is then saved by the earlier release, the ignored sections are not written back to the saved file and are permanently lost.
The new chart types cannot be preserved in files of earlier formats.
Image Maintenance Using the Resource Manager
The Resource Manager, an Interactive Reporting Studio Release 9.3 and later feature, restructures how images are stored; therefore, reducing the file size and memory footprint of an Interactive Reporting document and accelerating the loading speed. Image restructuring occurs when the Resource Manager is used to remove duplicate images, or if new images are added. Image restructuring also occurs if Dashboard Studio is used to merge, import, optimize, or update Interactive Reporting documents.
Note:
See “Resource Manager” in the Hyperion Interactive Reporting Studio User's Guide.
The general rule of backward compatibility applies to those features supported by the earlier releases of Interactive Reporting Studio. Wherever possible, new features are implemented that are available to Release 8.0 and later. However, there are exceptions:
GIF and JPEG images are not supported by Interactive Reporting Studio Release 8.1 and earlier, use templates that include BMP images
PNG images are not supported in releases earlier than Release 9.3 (Use the RevertImageResources.js script to convert PNG images to BMP)
Interactive Reporting Studio Release 9.3 and later introduces the image Resource Manager to Interactive Reporting files (These Interactive Reporting documents lose their images when opened in earlier releases of Interactive Reporting Studio. Use the RevertImageResources.js script to convert the Interactive Reporting document to the earlier format)
Interactive Reporting Studio Release 9.3 and later introduces a new feature that enables JavaScript to create and modify dashboard controls, such as buttons and embedded charts (This feature is a prerequisite for the Webdash template, which means that Webdash can only be used to create dashboards with Interactive Reporting Studio Release 9.3 and later. However, dashboards built in Webdash can be run in earlier releases of Interactive Reporting Studio provided the RevertImageResources.js script has been run to convert the Resource Manager structures in the Interactive Reporting document to their earlier format)
Dashboard Studio Release 9.3.1 and later introduces Filter Aliases and Filter Exclusions which change the way filters are handled internally from this release onwards (Release 9.3.1 ESM and runtime documents are now incompatible with the Move Filters feature of Dashboard Studio Optimize Utility from Release 9.3 and earlier)
Release 9.3.1 and later introduces report embedding in dashboards (An Interactive Reporting document that contains embedded reports can be opened in an earlier release of Interactive Reporting Studio and the report section will be visible on the dashboard. However, because this feature is not supported in earlier releases, the behavior of the document may be unpredictable; for example, how the report is updated after filters are set and reset. It is recommended that documents with embedded reports are not used in earlier releases of Interactive Reporting Studio)
Files that contain new image structures can be converted to a pre-9.3 Release format by using RevertImageResources script, located in the bin folder. If the installation was not customized, the bin folder is under C:\Hyperion\products\biplus\bin. However, if the installation was customized, fix the path to be relative. See RevertImageResources.js and Running the RevertImageResources Script.
The script accepts a path as a command line parameter which can be the absolute path to an Interactive Reporting document, to revert it to its pre-9.3 release format, or to a folder that contains Interactive Reporting documents, to revert them to their pre-9.3 release format.
Note:
Any backslashes (\) in the path should be duplicated. For example, C:\\docs\\mydocument.bqy.
The script has been used to create multiple Dashboard Development Services Update Utility kits.
931_update_for_85—For customers who have Release 8.5 of the Dashboard Development Services Update Utility and Interactive Reporting Studio installed
931_update_for_92—For customers who have Release 9.2 of the Dashboard Development Services Update Utility and Interactive Reporting Studio installed
931_update_for_93—For customers who have Release 9.3 or later of the Dashboard Development Services Update Utility and Interactive Reporting Studio installed (to apply Release 9.3 service packs)
931_update_for_other—For customers who have Release 8.x (but not Release 8.5) of Interactive Reporting Studio installed and Release 9.0.x or earlier of the Dashboard Development Services Update Utility
Also see Using the Dashboard Development Services Update Utility, for information on the Dashboard Development Services Update Utility.