Browser version script

Oracle® Business Intelligence Publisher
Release Notes

Release 10.1.3.2.1
Part No. E05000-01
April 2007

This document contains the following topics:

Introduction

These release notes describe known issues and workarounds for Oracle Business Intelligence Publisher release 10.1.3.2.1. For installation information, consult the Oracle Business Intelligence Publisher Install Guide, which is available on the Oracle Business Intelligence Publisher install media and on the Oracle Business Intelligence Publisher Web site:

http://www.oracle.com/technology/products/xml-publisher/index.html

These release notes are organized into the following sections:

How to Use These Release Notes

These release notes are updated periodically as new information becomes available. To ensure that you are reading the latest version of the release notes, check the Oracle Business Intelligence Publisher Web site:

http://www.oracle.com/technology/products/applications/publishing/index.html

Operating Systems Supported by the BI Publisher Installer

The BI Publisher installer provides two installation types: Basic and Advanced. In a Basic install, the installer will install Oracle Containers for Java (OC4J) and install and deploy BI Publisher into that OC4J. The Advanced install type allows you to install and deploy BI Publisher into an existing, supported Oracle Application Server installation.

With this initial release of 10.1.3.2.1, the Oracle BI Publisher installer supports the following operating systems:

More platforms are planned. This document will be updated on the http://www.oracle.com/technology/products/xml-publisher/xmlpdocs.html as they become available.

To install BI Publisher on an operating system not supported by the installer; or to install BI Publisher into a J2EE application server other than OC4J or the Oracle Application Server, use the manual install option described in the Oracle Business Intelligence Publisher Install Guide.

Issues and Workarounds

General Issues

Interface May Enter Stale State After Extended Use

After extended use, the BI Publisher Web UI may enter a state in which the top header frame colors appear reversed (blue screen objects appear white); however, the navigation links remain white. Therefore you may not be able to see

Welcome, <username> Preferences Sign Out Help

To correct this problem, restart the browser.

BI Publisher Performance Impacted by Bug in Java SE Development Kit (JDK) 5.0 version

The Java SE Development Kit (JDK) 5.0 version 1_5_0_7 contains a bug that impacts the performance of BI Publisher.

To correct this problem, upgrade to JDK 5.0 update 11 (1_5_0_11). You can download this update from:

http://java.sun.com/javase/downloads/index_jdk5.jsp

Scheduler Tab and Buttons Disabled Until the Scheduler is Properly Configured

Starting with version 10.1.3.2.1 if the administrator has not correctly configured the BI Publisher scheduler, the Schedules tab and the Schedule buttons will be disabled even when the user has the XMLP_SCHEDULER role. To enable the Schedules tab and the Schedule button, you must configure and install the Scheduler tables.

Security Issues

PDF Encryption Limited to RC4 Algorithm

The RC4 algorithm is less secure than newer algorithms such as AES and is not recommended for use in new applications. However, the RC4 algorithm is the only supported encryption algorithm for Adobe Acrobat 6.0. Support for AES encryption for Adobe Acrobat 7.0 and higher versions is planned for future releases of Oracle BI Publisher.

This issue has no workaround.

Delivery Manager Issues

CUPS Server Does Note Appear as a Delivery Destination in Clustered Environment

If you are using a clustered environment, and you have a CUPS server implemented as a delivery option with no other printers defined, you may not see your CUPS Server as a delivery option.

To workaround this problem, add a real or dummy printer destination by creating an entry in the Admin > Delivery > Printer interface.

RTF Template Issues

Sorting Within a Nested For-Each-Group Fails with EmptyStackException Error

You can sort a group of data values using the <?sort:element_name?> syntax. This syntax follows immediately after the for-each-group syntax. This sort syntax does not work when it is included under a nested for-each-group. If you include this sort syntax under a nested for-each-group, then you will notice an EmptyStackException error and the report output is not displayed.

This issue has no workaround.

Alternate Table Row Formatting Not Working in HTML, RTF, and Excel Outputs

The user guide contains the "Row Formatting" topic that describes how to set the background color on alternate rows in a tabular report. This description works for PDF output only. In HTML, RTF, and Excel output formats, the alternate rows do not show the background color. In these output formats, all the rows appear with a white background.

This issue has no workaround.

Header and Footer Margin from Edge Not Preserved in RTF Output

Microsoft Word provides a Page Setup option for specifying the margin for the headers and footers from the edge of the page. This option is available by choosing the File menu, then Page Setup, then the Margins tab, and the From edge box. This margin setting is not retained when the output format is RTF. The output is created with the default margin settings instead. The margin settings do work correctly for other output formats such as HTML, PDF, and Excel.

This issue has no workaround.

Charts May Not Appear in Excel Output

When viewing a report layout that has a chart in Excel output, you may not see the chart and only see a small icon in the place where you expect to see the chart.

To workaround this problem, you must unblock security on image URLs as follows:

  1. Open WEB-INF/web.xml.

  2. Find the following block:

    <filter-mapping>
    <filter-name>SecurityFilter</filter-name>
    <url-pattern>/xdo/tmp/*</url-pattern> 
    </filter-mapping>
  3. Change the <url-pattern> element as shown:

    <filter-mapping>
    <filter-name>SecurityFilter</filter-name>
    <url-pattern>/xdo/tmp/*.tmp</url-pattern> 
    </filter-mapping>

Rounding Issue When Adding Decimal Numbers

As Oracle XDK conforms to XSL standards for IEEE 754, you might encounter rounding issues when adding numbers that are decimals. For example, suppose you add 13683.80 and 516.39, using this syntax in Oracle BI Publisher:

<?13683.80 + 516.39?>

The value returned is 14200.189999999999 which is caused by a limitation based on the IEEE 754 Binary Floating-Point-Arithmetic.

To work around this issue, use the format-number function or the round syntax as shown here to obtain a return value of 14200.19:

<?format-number:(13683.80 + 516.39);'D99'?>

or

<?(round((13683.80 + 516.39)*100) div 100)?>

PDF Template Issues

PDF Form Processor Lacks Support for Repeatable Fields in Landscape Templates

When you design a PDF template with repeatable fields, the output in portrait mode is correctly formatted. However, when the same report is created in landscape mode, the table headers are correct but the following occurs:

This issue has no workaround.

Template Builder Issues

Concatenated Data Sources Do Not Load Properly to the Template Builder

If your data source is concatenated XML from multiple SQL queries, the XML data will not load properly to the Template Builder from the direct connection to the BI Publisher server.

To workaround this issue, after building your data model, generate sample data and save it to an accessible directory. Use the Template Builder's load data function (Oracle BI Publisher > Data > Load Sample XML Data) to load the report data to the Template Builder. For more information on using the Template Builder in disconnected mode, see the Oracle Business Intelligence Publisher User's Guide.

When Using SSO, Update to mod_osso.conf File Required for Communication with Template Builder for Word

If your system is SSO-enabled, you must modify your mod_osso.conf file to disable SSO to allow Web service communication between BI Publisher and the Template Builder for Word. To open up the xmlpserver to allow the Web service, enter the following directive in the mod_osso.conf file:

<Location /xmlpserver/services/>
  require valid-user
     AuthType Basic
     Allow from All
     Satisfy any
</Location>

For the complete procedure for setting up BI Publisher with Oracle Single Sign-On, see the topic: "Setting Up Oracle Single Sign-On" in the Oracle Business Intelligence Publisher User's Guide. Note that this step is identical to Step 9, required for enabling the Web service between Oracle BI Presentation Services and Oracle BI Publisher.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/ .

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Legal Notices

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States 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, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.