BIERN
BIERN
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
Topics
These issues pertain to all areas of Oracle BI Enterprise Edition and Oracle BI
Publisher, such as installation, migration, analyses and dashboards, metadata
repository development, and system administration.
• Compatibility of Oracle Business Intelligence with Oracle Fusion Middleware
• Obtain Patches from My Oracle Support
• Oracle Business Intelligence General Issues and Workarounds
• Oracle Data Visualization Issues and Workarounds
• Oracle Business Intelligence Analyses and Dashboards Issues and Workarounds
• Oracle BI Publisher Issues and Workarounds
• Oracle Business Intelligence Documentation Errata
1
Compatibility of Oracle Business Intelligence with Oracle
Fusion Middleware
It's important that you understand the compatibility of Oracle Business Intelligence with
Oracle Fusion Middleware.
Note:
To download the Oracle Business Intelligence 12.2.1.4 Installer for
Oracle Fusion Middleware 12.2.1.4, see the instructions in My Oracle
Support Doc ID 3004029.1.
2
4. Apply the mandatory patches. See the list of patches you must apply in Roadmap
for Installing and Configuring a Standard Installation Topology.
5. Configure Oracle Business Intelligence 12.2.1.4.0.
If you are using Oracle Business Intelligence 12.2.1.4 Installer for Oracle Fusion
Middleware 12.2.1.3, perform these steps:
1. Install Oracle Fusion Middleware 12c (12.2.1.3.0).
2. Install Oracle Business Intelligence 12.2.1.4.0 using Oracle Business Intelligence
12.2.1.4 Installer for Oracle Fusion Middleware 12.2.1.3.
3. Apply the mandatory patches. See the list of patches you must apply in Roadmap
for Installing and Configuring a Standard Installation Topology.
4. Configure Oracle Business Intelligence 12.2.1.4.0.
Upgrade Considerations
If you've already installed Oracle Business Intelligence 12.2.1.4.0 and you want to
upgrade to the latest update of Oracle Business Intelligence 12.2.1.4.0, see Upgrading
Oracle Business Intelligence 12.2.1.4.0.
If you are using Oracle Business Intelligence 12.2.1.4 Installer for Oracle Fusion
Middleware 12.2.1.4, perform these steps:
1. Install Oracle Fusion Middleware 12c (12.2.1.4.0) in a new Oracle Home.
2. Install Oracle Database Client 19c.
3. Install Oracle Business Intelligence 12.2.1.4.0 using Oracle Business Intelligence
12.2.1.4 Installer for Oracle Fusion Middleware 12.2.1.4.
4. Apply the mandatory patches. See the list of patches you must apply in Obtain
Patches from My Oracle Support.
5. Perform the upgrade steps in new Oracle Home to upgrade your existing domain.
If you are using Oracle Business Intelligence 12.2.1.4 Installer for Oracle Fusion
Middleware 12.2.1.3, perform these steps:
1. Install Oracle Fusion Middleware 12c (12.2.1.3.0) in a new Oracle Home.
2. Install Oracle Business Intelligence 12.2.1.4.0 using Oracle Business Intelligence
12.2.1.4 Installer for Oracle Fusion Middleware 12.2.1.3.
3. Apply the mandatory patches. See the list of patches you must apply in Obtain
Patches from My Oracle Support.
4. Perform the upgrade steps in new Oracle Home to upgrade your existing domain.
3
Middleware 12c 12.2.1.4.0 and Oracle Database Client 19c, apply the following
patches:
• 34065178: Apply this patch if you are using a JDK version greater than 1.8.0_331.
This avoids the 500 Internal Server Error by the Analytics URL.
• BI12.2.1.4 BP: Apply this patch after upgrading Opatch to the latest version to
avoid critical security vulnerabilities and to use the new features.
Note:
You must download and apply the latest Oracle Fusion Middleware
12.2.1.4.0 patches.
If you install Oracle Business Intelligence 12c (by using Oracle Business Intelligence
12.2.1.4 Installer for Oracle Fusion Middleware 12.2.1.3) with Oracle Fusion
Middleware 12c 12.2.1.3.0, apply these patches:
• 34065214: If you are using a JDK version greater than 1.8.0_331, apply this patch
to avoid the 500 Internal Server Error by the Analytics URL.
• BI12.2.1.4 BP: Apply this patch after upgrading Opatch to the latest version to
avoid critical security vulnerabilities and to use the new features.
• Patch numbers 27823500, 27401639, and 27479453 - The Node Manager won't
work with a non-Oracle database if you don't apply these patches.
Topics
• Error Accessing Reports in a High Availability Environment
• Initialization Block for E-Business Suite Displays NQS Error Message
• Integration with and Migration from Oracle BI Discoverer Is Not Supported
• Reconfiguring Custom Messages in the BI Sample Application After Upgrade
• Exported BAR Files Don't Include Data Files
• BI Composer Unavailable in SSL Configuration
• IBM Informix Dynamic Server Not Supported as a Data Source for Oracle BI on
Solaris x86-64
4
In a high availability environment, users accessing reports from the Oracle BI EE
search results might receive Page not found errors.
To work around this issue, go to the report URL and replace the alias host name (for
example, bihost1) with the physical host name.
The error is expected. The Test button command only works when the user links from
the E-Business Suite, and the browser supplies the ICX cookie.
Note:
For migration scenarios, the same two files must be replaced from Oracle BI
Enterprise Edition 11g to 12.2.1.x.
You can back up your customized messages and add them to the new customization
files after you upgrade.
5
1. Back up the following Oracle BI Enterprise Edition 12.2.1.x files that you have
customized:
• On UNIX: $ORACLE_HOME/bi/bifoundation/web/msgdb/l_en/messages/
logonmessages.xml and $ORACLE_HOME/bi/bifoundation/web/msgdb/pages/
common/signin.html
• On Windows: %ORACLE_HOME%
\bi\bifoundation\web\msgdb\l_en\messages\logonmessages.xml
and%ORACLE_HOME%\bi\bifoundation\web\msgdb\pages\common\signin.html
2. After you have upgraded to the most recent version, reapply the custom messages
in the logonmessages.xml and signin.html files:
• On UNIX: $NEWORACLE_HOME/bi/bifoundation/web/msgdb/l_en/messages/
logonmessages.xml and $NEWORACLE_HOME/bi/bifoundation/web/msgdb/
pages/common/signin.html
• On Windows: %NEWORACLE_HOME%
\bi\bifoundation\web\msgdb\l_en\messages\logonmessages.xml and
%NEWORACLE_HOME%\bi\bifoundation\web\msgdb\pages\common\signin.html
3. Stop then start the services.
6
Oracle Data Visualization Issues and Workarounds
This section describes issues and workarounds for Oracle Data Visualization.
Topics
• Known Issues with Oracle Essbase Database Connections and Data Sources
• Null Values in XLSX File Set to String
• Error Importing XLSX Files Generated from Microsoft Access
• Error Creating a Data Set from a Microsoft Access Database Containing Spaces
• Connection Not Found Error Message After Importing Project and Opening Oracle
Database Data Flow
• Time Series Forecast Step in a Data Flow Fails for Insufficient Number of
Historical Values
7
• When you import an Oracle Essbase data source, you can’t prepare the data, and
you can’t edit the data after import. For example, you can't change a column’s data
type or aggregation.
8
If you import a project that is sourced from an Oracle Database then try to open the
data flow, you might see an error message that connection can't be found.
To work around this issue, click the connection name, select it again, and save and
reopen the data flow.
Topics
• Treemap View Fails to Download in PDF, Excel, or Powerpoint Format
• Archiving and Unarchiving Dashboards Loses Links for Analyses
• Prompt Value Reset to All Column Values
9
To work around this issue, ensure that the catalog folders and objects on the
destination server match the structure on the original server.
Topics
• Bar Charts Showing Time on the X-Axis Don’t Display Axis Labels Correctly
• BI Publisher Displays PDF File Error Message when Printing with
ScheduleService Web Service
Bar Charts Showing Time on the X-Axis Don’t Display Axis Labels
Correctly
When an Oracle BI Publisher report using BI Publisher Template (.xpt) includes a bar
chart and if Time is represented along the x-axis, then the x-axis labels aren’t
displayed properly.
The first label entry is skipped and the first bar data appears glued to the y-axis. This
issue is caused by a limitation in the data visualization libraries that Oracle BI
Publisher uses to generate the chart.
1. In the data model SQL query for the report, use the TO_CHAR method on the
date/time fields to change the data type of the field from Dateto String.
2. Open the report in the Layout Editor.
3. Select the chart and expand the Properties pane.
4. Turn off the Time Series setting and clear the settings for Day, Month, Year, and
Time formats.
10
5. Save the layout changes.
This issue occurs only if you've configured the PDFtoPostScript filter to print the file to
a Postscript printer. After converting a PDF file into a Postscript file, BI Publisher
doesn't change the content type from application-pdf to application/octet-
stream in the web service.
Topics
• Some Documentation for Oracle BI Publisher and Oracle BI Enterprise Edition Is
No Longer Being Updated
• System Requirements and Specifications Guide Needs Update for Required
Packages for IBM AIX Operating System
• Oracle BI Administration Tool Documentation
• Developer's Guide for Oracle Business Intelligence Enterprise Edition
• Integrator's Guide for Oracle Business Intelligence Enterprise Edition
• Scheduling Jobs Guide for Oracle Business Intelligence Enterprise Edition
• XML Schema Reference for Oracle Business Intelligence Enterprise Edition
• Developer's Guide for Oracle Business Intelligence Publisher
11
• XML Schema Reference for Oracle Business Intelligence Enterprise Edition
• Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Mobile
Application Designer
• Developer's Guide for Oracle Business Intelligence Publisher
12
The following issues address the Developer's Guide for Oracle Business Intelligence
Enterprise Edition.
• Documentation About Creating and Using Impersonate User is Incorrect
Note:
You can choose to grant the newly created permission to either an
application role or a user. In this example we choose user.
14. Select Includes from the Principal Name list, and enter an asterisk (*) into the
field.
15. Click the search arrow icon (>) to display a list of users.
16. Select the user you want to give the permission to and click OK.
13
This example uses weblogic.
17. Click OK on the Create Application Grant page.
This paragraph should not mention v6 or v7, but should state that for Oracle BI EE
12c, if you want to develop new code or recompile existing code, you should use
version 12 (or later) of the Oracle BI EE web services URL. For example:
http://host:port/analytics-ws/saw.dll/wsdl/v12
14
Method Section Purpose Deprecated Result
getGroups() 3.13.6 of Integrator's Gets a list of catalog Returns a response
Guide for Oracle groups that are such as "getGroups
Business Intelligence members of the operation is not
Enterprise Edition account (for example, supported/
user or group). deprecated".
getMembers() 3.13.7 of Integrator's Gets direct members Returns a response
Guide for Oracle of the catalog group. such as "getMembers
Business Intelligence operation is not
Enterprise Edition supported/
deprecated".
This is an error. The configuration file is located by default in the following location:
<Oracle Middleware
Home>\user_projects\domains\bi\config\fmwconfig\biconfig\actions
In Oracle BI EE, you use scripts to configure the Action Framework. See Configure for
Actions with the Action Framework.
In , use the System Settings page (in Console) to set some of the most common
system settings. See Configure Advanced System Settings in the Console.
15
Step 5 of this procedure currently states:
5. On the resulting screen, under Responsibility, enter the Oracle BI EE URL. For
example:
http://my_server.domain.com:port/analytics
This is an error. The /analytics portion of this path should be left out.
http://my_server.domain.com:port
16
If the entry doesn't already exist, then add a new entry under:
<AuthenticationSchema name="EBS-ICX">
17
Scheduling Jobs Guide for Oracle Business Intelligence Enterprise Edition and
Integrator's Guide for Oracle Business Intelligence Enterprise Edition mention catalog
groups. The mentions of catalog groups in these guides are no longer applicable.
In particular, the following methods are deprecated for Oracle BI releases 12.2.1.2.0,
12.2.1.3.0, and 12.2.1.4.0:
18
• Publisher Uses Apache CXF
• String JDBCDriverType Field Description Is Incorrect
• Values for the Status Field for JobOutput and JobOutputDelivery Objects
• The Definition of getScheduledJobInfo Method is Inconsistent
• SFTP_HOSTKEY_FINGERPRINT Property for Secure FTP Document Delivery
• Layout Editor in BI Publisher Doesn't Support Custom JavaScript Plug-Ins
• Excel Output Format Value is Incorrect for the attributeFormat Field of
ReportRequest
• ScheduleRequest Data Types Missing from Developer's Guide for Oracle
Business Intelligence Publisher
• downloadReportDataChunk Chunk Size Is In Bytes Not In Kilobytes
• PDF Merger Documentation
• Locale Parameter Description Missing in downloadXLIFF() Method
• Incorrect Parameter Description For resendScheduledReport() and
resendScheduledReportInSession() Methods
• #unique_69
Field Description
String WCCAccount Optional. Select an account from the WebContent Server.
String WCCAuthor Optional. Enter the name of the author. If you don’t specify an
author, then the value defaults to the login name of the user.
String WCCComments Optional. Enter comments to include with the document on the
WebContent Server.
19
Field Description
String WCCFileName Required. Enter the name to assign to the file on the server. For
example: report.pdf.
Boolean Required. Specify True to allow custom metadata to be sent with
WCCIncludeMetadata the document. Custom metadata is defined in the data model.
String WCCSecurityGroup Required. Select the security group on the WebContent Server to
assign to the report.
String WCCServerName Required. Enter the name of the WebContent Server as defined in
the BI Publisher Administration page.
String WCCTitle Optional. Enter a title for the report. If you don’t enter a title, then
the Layout name is used as the title.
Field Description
WCCDeliveryOption [] item See Section 2.3.27 WCCDeliveryOption
Field Description
ArrayOfWCCDeliveryOption wccOptions See Section 2.3.5 ArrayOfWCCDeliveryOption
Values for the Status Field for JobOutput and JobOutputDelivery Objects
20
The values that are indicated for the status field of JobOutput and JobOutputDelivery
objects in Chapter 2 are incorrect in Developer's Guide for Oracle Business
Intelligence Publisher.
The correct list of status values that are available through the
getAllScheduledReportHistoryReturn web service are as follows.
JobOutput status values:
• STATUS_RUNNING = 'R';
• STATUS_SUCCESS = 'S';
• STATUS_FAILED = 'F';
• STATUS_CANCELLING = 'G';
• STATUS_CANCELED = 'C';
• STATUS_WITH_DELIVERY_ERROR = 'D';
• STATUS_SKIPPED = 'K';
• STATUS_WARNING = 'I';
• STATUS_UNKNOWN = 'X';
JobOutputDelivery status values:
• STATUS_FAILED = 'F';
• STATUS_WARNING = 'I';
• STATUS_UNKNOWN = 'X';
• STATUS_RUNNING = 'R';
• STATUS_SUCCESS ='S';
21
In Developer's Guide for Oracle Business Intelligence Publisher, Chapter 8 Using the
Delivery Manager Java APIs, Table 8–8 Properties for Delivering Documents over
SFTP is missing information about the SFTP_HOSTKEY_FINGERPRINT property.
See the following section for the correct information.
SFTP_HOSTKEY_FINGERPRINT
Enter the MD5 fingerprint of the SSH host key in a hexadecimal string. Don’t include a
delimiter such as a colon (:) to separate each byte. This property is optional.
When this property is set, the MD5 fingerprint of the host key retrieved from the server
at runtime is verified to match the supplied value. If it doesn't match, then the
connection is terminated as the fingerprint mismatch indicates that the SSH client is
connecting to an unintended host, possibly as a result of a man-in-the-middle attack.
When this property isn't set, the connection to the host is made without host key
fingerprint verification.
22
Field Description
boolean notifyHttpWhenSkipped Optional. Specify true to send an HTTP
notification when a job is skipped. Default is
false.
boolean notifyWhenSkipped Optional. Specify true to send an email
notification when a job is skipped. Default is
false.
boolean saveOutputOption Optional. Specify true to save the report output
generated by the scheduled request to a
database. Default is false.
boolean scheduleBurstingOption Optional. Specify true to enable bursting for
the scheduled job. Default is false.
23
Sample Code for Merging PDF Documents with Input/Output File Names:
import java.io.*;
import oracle.xdo.common.pdf.util.PDFMerger;
.
.
.
public static void main(String[] args)
{
try
{
// Initialize PDFMerger - last argument is PDF file name for
output
merger = new PDFMerger(new File(args[args.length - 1]));
24
• PDF Document (OutputStream)
Merging PDF Documents with Input/Output Streams
import java.io.*;
import oracle.xdo.common.pdf.util.PDFDocMerger;
.
.
.
public boolean mergeDocs(InputStream[] inputStreams, OutputStream
outputStream)
{
PDFMerger merger = null;
try
{
// Initialize PDFMerger
merger = new PDFMerger(outputStream);
25
The following code demonstrates how to merge two PDF documents using input
streams to generate a single merged output stream. You can add page numbers to the
PDF.
To merge documents and number pages:
1. Create a background PDF template document that includes a PDF form field in the
position that you'd like the page number to appear on the final output PDF
document.
2. Name the form field @pagenum @.
3. Enter the number in the field from which to start the page numbering. If you don’t
enter a value in the field, the start page number defaults to 1.
Input:
• PDF Documents (InputStream Array)
• Background PDF Document (InputStream)
Output:
• PDF Document (OutputStream)
Sample Code for Merging PDF Documents with Background to Place Page Numbering
import java.io.*;
import oracle.xdo.common.pdf.util.PDFDocMerger;
.
.
.
public boolean mergeDocs(InputStream[] inputStreams, InputStream
backgroundStream, OutputStream outputStream)
{
PDFMerger merger = null;
try
{
// Initialize PDFMerger
merger = new PDFMerger(outputStream);
// Set Background
merger.setBackground(backgroundStream);
26
finally
{
if (merger != null)
{
// Close the merged document
try
{
merger.close();
}
catch (Exception exc)
{
exc.printStackTrace();
return false;
}
}
}
return true;
}
27
The following example shows how to set these properties and then call the
PDFDocMerger.
Input:
• PDF Documents (InputStream)
Output:
• PDF Document (OutputStream)
Sample Code for Setting a Text Watermark in PDF Documents
import java.io.*;
import oracle.xdo.common.pdf.util.PDFDocMerger;
.
.
.
public boolean mergeDocs(InputStream[] inputStreams, OutputStream
outputStream)
{
PDFMerger merger = null;
try
{
// Initialize PDFMerger
merger = new PDFMerger(outputStream);
28
}
catch (Exception exc)
{
exc.printStackTrace();
return false;
}
}
}
return true;
}
import java.io.*;
import oracle.xdo.common.pdf.util.PDFDocMerger;
.
.
.
public boolean mergeDocs(InputStream[] inputStreams, OutputStream
outputStream, String imageFilePath)
{
PDFMerger merger = null;
try
{
// Initialize PDFMerger
merger = new PDFMerger(outputStream);
29
FileInputStream wmStream = new FileInputStream(imageFilePath);
float[] rct = {100f, 100f, -1f, -1f};
merger.setImageWatermark(wmStream, rct);
return true;
}
30
Table Corrected Parameters for downloadXLIFF() Method
Parameter Description
String objectAbsolutePath The path to the XLIFF object to download.
String locale The locale of the XLIFF object (for example,
en_US).
String userID Specifies the BI Publisher user name.
String password Specifies the password for the user name.
For the outputJobID parameter, you need to provide the outputId generated when
you run the job. To get the outputId of a specific job, run the
getScheduledReportOutputInfo() method of ScheduleService.
Oracle Fusion Middleware Release Notes for Oracle Business Intelligence, 12c (12.2.1.4)
E91530-10
Copyright © 2010, 2024, Oracle and/or its affiliates. All rights reserved.
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, software documentation, data (as defined in the Federal Acquisition Regulation), or related documentation that is delivered to the U.S. Government or anyone
licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed, or activated on delivered
hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end users are
"commercial computer software," "commercial computer software documentation," or "limited rights data" pursuant to the applicable Federal Acquisition Regulation and agency-
specific supplemental regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/or adaptation of i)
Oracle programs (including any operating system, integrated software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract.
The terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are granted to the U.S.
Government.
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.
Oracle®, Java, MySQL, and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks
of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open
Group.
This software or hardware and documentation may provide access to or information about 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 unless otherwise set forth in an applicable
agreement between you and Oracle. 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, except as set forth in an applicable agreement between you and Oracle.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/
topic/lookup?ctx=acc&id=docacc.
31
Access to Oracle Support
Oracle customer access to and use of Oracle support services will be pursuant to the terms and
conditions specified in their Oracle order for the applicable services.
32