Business Objects products in this release may contain redistributions of software
licensed from third-party contributors. Some of these individual components may
also be available under alternative licenses. A partial listing of third-party
contributors that have requested or permitted acknowledgments, as well as required
notices, can be found at: http://www.businessobjects.com/thirdparty
The notes contained in this document cover important information about this
product release, including: installation notes, details regarding known issues
with this release, and important information for customers.
Please read this document in its entirety before installing your Business
Objects software. Be sure to visit the Business Objects support web site for
additional notes and information that may become available following the
release of this document.
http://support.businessobjects.com/documentation/
About the Crystal Reports Viewer XI
The Crystal Reports Viewer XI provides you with an easy way to view and
share your Crystal reports (.rpt files).
When you view a report, you can work with it interactively:
•You can navigate through the report, using convenient tools that help you
find the exact information you're looking for.
•You can explore report data to see background information. (Background
information is often found in hidden sections of the report that you normally
don't want to see.)
•You can export the report to one of several formats that are available.
For example, you can export your report to PDF.
•You can open a report from BusinessObjects Enterprise, or you can share
a report on crystalreports.com.
You can also share a report by simply e-mailing the report and providing a
hyperlink to the Crystal Reports Viewer XI. The recipient can download the
free viewer and carry out any of the navigating and searching that you can
do.
The Crystal Reports Viewer XI also gives you access to other content:
•You can look for additional reports on your local system, on
crystalreports.com, or on BusinessObjects Enterprise.
•You can use hyperlinks that take you to free trials and evaluation software.
•You can enable auto-update to download updates and enhancements to
the viewer.
6Crystal Reports Viewer XI Release Notes
Installation
2
Installation
2
Overview
Overview
You can launch the Crystal Reports Viewer XI installation in two ways: using
an interface, or using the silent mode.
Note: If you have installed the Beta version of the Crystal Reports Viewer
XI, you must uninstall it before you begin.
Installing using the interface
1. Double-click CRViewerXI.exe to launch the installation.
The program automatically detects the locale of your machine and runs
the installation in the language that corresponds to that locale.
2. Review the License Agreement, select "I accept the License Agreement,"
and then click Next.
3. Click Next in the Start Installation dialog box to begin the installation of
the Crystal Reports Viewer XI.
Wait while the appropriate files are installed and the necessary
configuration is carried out.
At the end of the installation, the program creates an association between
the viewer and any .rpt files found on your machine (only if no other
association for .rpt files exists).
4. Select the option to launch the Crystal Reports Viewer if you want to
launch the viewer immediately after you complete the installation.
5. Click Finish to complete the installation.
Installing using the silent mode
Running the Crystal Reports Viewer XI installation in silent mode consists
of the command "CRViewerXI", followed by one of several options listed in
the following table. To use an option, place it on the command line after the
CRViewerXI command. For example, type "CRViewerXI CLIENT
LANGUAGE=FR/qn+" if you want to run the installation in silent mode without
displaying any installation dialogs, but you want to display a prompt in French
when the installation is complete.
8Crystal Reports Viewer XI Release Notes
Installation
Uninstalling Crystal Reports Viewer
The following table describes the command line options available for a silent
install. To use an option, place it on the command line after the setup
command.
DescriptionOptions
2
INSTALLDIR
CLIENTLANGUAGE
/qn
/qb
Use this to specify the installation directory for Crystal
Reports Viewer XI.
Use this to specify the Language version code for the
installation.
•For English, enter EN
•For French, enter FR
•For German, enter DE
•For Spanish, enter ES
•For Japanese enter JP
•For Simplified Chinese, enter CHS
•For Traditional Chinese, enter CHT
•For Korean, enter KO
•For Dutch, enter NL
•For Swedish, enter SV
•For Italian, enter IT
•For Portuguese, enter PT
Use this option so the user is not prompted during the
install, or when the installation is complete. To prompt
when the installation is complete, specify "/qn+".
Use this option to display a progress indicator during
the installation. To prompt when the installation is
complete, specify "/qb+".
Uninstalling Crystal Reports Viewer
1. In Windows, click Start, point to Settings, and then select Control Panel.
2. Double-click Add/Remove Programs.
3. Select Crystal Reports Viewer XI and click Remove.
Crystal Reports Viewer XI Release Notes9
Installation
2
Installing on a Mac
4. When the Add/Remove Programs dialog box prompts to confirm that you
want to remove Crystal Reports Viewer XI from your computer, click Yes.
Wait while files are removed and the necessary configuration is carried
out.
5. Click Finish.
The Crystal Reports Viewer has been uninstalled, and you are returned to
the Add/Remove Program Properties dialog box.
Installing on a Mac
1. Browse to the location where you downloaded CRViewerXI.dmg.
2. Double-click CRViewerXI.dmg.
A dialog box displays the progress of the disk image mounting. After
mounting is complete, the contents of the disk image are automatically
displayed.
Note: This step is unnecessary if you downloaded CRViewerXI.dmg over
the web via a web browser; in this scenario, the disk image automatically
mounts.
3. Select the Crystal Reports Viewer XI icon and drag it to the adjacent
folder called "Drop Crystal Reports Viewer XI Here To Install."
A copy-progress dialog box appears. Once copying is complete, the
Applications directory is displayed. The Crystal Reports Viewer is now
present with the other applications.
4. To open the viewer, double-click the Crystal Reports Viewer XI icon in
the Applications folder.
A loading banner for the viewer appears.
5. Accept the User License Agreement.
Note: This step is necessary only the first time you run the Crystal Reports
Viewer. If you do not accept the license agreement, you cannot use the
viewer.
The Crystal Reports Viewer opens.
10Crystal Reports Viewer XI Release Notes
Installing on Linux
1. Download CrystalReportsViewerXI.bin to a directory that you have
write permissions in.
2. From a command shell, navigate to that directory and type sh Crystal
ReportsViewerXI.bin.
The binary extracts the viewer to a subfolder called CrystalReportsView
erXI. The extraction may take a few minutes.
3. Go to the Eclipse website, download the 3.2.2 version of the SWT library,
and place it in the plugins folder in the new CrystalReportsViewerXI
folder.
At the time of this writing, the steps are as follows:
a. Download Eclipse from http://archive.eclipse.org/eclipse/down
c. Copy org.eclipse.swt.gtk.linux.x86_3.2.2.v3236.jar from the
plugins folder in the Eclipse distribution to the plugins folder in
CrystalReportsViewerXI.
Installation
Installing on Linux
2
Note: The names of URLs may change over time.
4. To run the viewer, go to the CrystalReportsViewerXI installation
directory and type ./CrystalReportsViewerXI from the command shell.
The Crystal Reports Viewer opens.
Crystal Reports Viewer XI Release Notes11
Installation
Installing on Linux
2
12Crystal Reports Viewer XI Release Notes
Supported Platforms and
Report Versions
3
Supported Platforms and Report Versions
3
Supported platforms
Supported platforms
The Crystal Reports Viewer is supported and has been tested on the following
platforms:
•Windows XP SP2 Professional
•Windows Vista
•Windows Server 2003 Standard Edition
•Windows 2000 SP4 Professional
•Mac OS X versions 10.4 and 10.5
•Linux (only for Tech Preview—not officially supported)
Supported report versions
The Crystal Reports Viewer supports reports created in Crystal Reports
version 9 and later. You cannot open reports that were created in earlier
versions.
14Crystal Reports Viewer XI Release Notes
Differences Between the
Crystal Reports Viewer and
Crystal Reports
4
Differences Between the Crystal Reports Viewer and Crystal Reports
4
Overview
Overview
This section lists differences between the Crystal Reports designer and the
Crystal Reports Viewer that were intentionally implemented.
Types of reports that will not load in the
viewer
Types of reports that will not load in the viewer
When you try to open one of the following types of reports, you will receive
an error message:
•Reports without saved data that require data to format.
•Reports that use Business Views as a data source.
•Reports that use universes as a data source. (Static instances of reports
that use universes will open if these reports are downloaded from
BusinessObject Enterprise.)
•Reports that use Crystal Dictionaries as a data source.
•Reports that use Crystal Queries as a data source.
•Reports that depend on UFLs.
•Reports that are successfully using "Perform Grouping on Server". (That
is, the generated report SQL contains a "group by" clause.)
Types of reports that will have different
data
Shared variables in formulas
Reports that use shared variables in formulas will produce differences in
data between the Crystal Reports designer and the viewer.
Print Date versus Data Date
Reports that depend on Print Date, Print Time, or related formulas (such as
Last60Days) as part of their record selection formula and do not have the
PrintDate and Time locked, will display a smaller set of data.
16Crystal Reports Viewer XI Release Notes
Differences Between the Crystal Reports Viewer and Crystal Reports
Types of reports that will have different data
The viewer uses the last saved print date in the report. The smaller data set
occurs only if the data date is different from the last print date.
Group Header versus Group Footer formatting
Group name fields are consistent in Crystal Reports Viewer no matter whether
they are in the Group Header or Group Footer section or in the Group Tree.
Crystal Reports might have different values in the Group Footer.
Current CE User special field
Reports that use the Current CE User special field as part of their record
selection may produce a smaller set of data unless the Current CE User
information is part of the report's saved data.
Original-order grouping
Reports that use original-order grouping may display the records in a different
order when opened in the viewer.
This behavior occurs only when the viewer needs to recycle saved data upon
loading a report (for example, when the report contains a print time or print
date).
4
Sorting
In general, sorting may be slightly different because the Crystal Reports
designer uses a word-based sort, but the viewer uses a Unicode sort. Certain
characters, such as hyphens and apostrophes sort differently in the viewer.
UFLs
Crystal Reports Viewer does not support state full C\COM or Java UFLs.
The following functions inside the UFL will not be called: InitForJob,
TermForJob, StartJob, EndJob, SaveState, and RestoreState.
Hierarchical grouping and Group Selection formulas
For reports that use Hierarchical grouping, and have a Group Selection
formula that filters out all records, the number that appears in the Group
Header or Group Footer may be different.
Crystal Reports Viewer XI Release Notes17
Differences Between the Crystal Reports Viewer and Crystal Reports
4
Types of reports that will have different layout
Types of reports that will have different
layout
Note: The issues that can cause a report to have different data will often
also cause the reports to have a different layout.
Report objects that are not displayed
Instead of displaying the objects that are listed in the following table, the
viewer replaces the object with a text object that is the same size and contains
the text "<object> not supported". Because this object is displayed in the
size it was in the design view of Crystal Reports, formatting differences might
occur.
What you will seeReport object
Map
OLAP Grid / OLAP
Chart
Subreports
Right-to-left (RTL) languages
A placeholder is displayed and, similarly, the placeholder is used for exporting and printing.
A placeholder is displayed and, similarly, the placeholder is used for exporting and printing.
In general, subreports with saved data display correctly. There are, however, some exceptions:
•Linked subreports or subreports in hidden or condi-
tionally suppressed sections will not display if they
do not have saved data.
•Linked subreports that depend on the print-time
formula state for the link might have formatting differences.
•You cannot drill into on-demand subreports, but
rendering, exporting, and printing are not otherwise
affected.
The object is not supported for exporting to PDF format. Rendering, exporting, and printing might be affected.
18Crystal Reports Viewer XI Release Notes
Thai ligatures
Differences Between the Crystal Reports Viewer and Crystal Reports
Types of reports that will have different layout
What you will seeReport object
The object is not supported for exporting to PDF format. Rendering, exporting, and printing might be affected.
When exporting to RTF, the object is not supported.Cross-tabs
4
Images
Font-related differences
•Fonts in the Crystal Reports Viewer appear to be taller than the same
font in Crystal Reports. This difference leads to line-height differences.
As a result, reports where you have a multi-line text object next to which
you have placed other objects to align them vertically, may not appear
correctly.
•The difference in line height also leads to sections taking up more vertical
space, which means that some reports are paginated differently.
•When a report uses a font that is not found on the machine, the viewer
substitutes a font from the machine (if no matching font can be found, the
viewer defaults to Arial). This action may lead to text measurements that
are not the same.
Chart appearance
Charts may appear differently in the viewer. However, the general layout
and overall meaning of the chart will not change. There are a few specific
differences that you might notice:
•Axis labels that were moved manually are moved to their default positions.
•2D charts are automatically arranged to create an attractively formatted
chart. This sometimes leads to differences in label settings and frame
size so that labels won't overlap.
•Smooth-style trend lines will not appear.
When exporting to RTF, images are exported one to
a line.
Suppress blank subreport
Crystal Reports allocates space to an empty subreport, even though you
have selected the 'Suppress Blank Subreport' option. This behavior causes
Crystal Reports Viewer XI Release Notes19
Differences Between the Crystal Reports Viewer and Crystal Reports
4
Printing limitations
sections containing blank sub-reports to grow larger. The behavior does not
occur in the Crystal Reports Viewer.
Printing limitations
The following table summarizes the major printing limitations that you might
encounter in the Crystal Reports Viewer.
Printer
specified
on the report consumer's
machine?
Page settings
changed?
Printer
specified
on the report author's machine?
Crystal Reports —
what you
view is
what you
print
Crystal Reports Viewer — what
you view is
what the
report was
created
with
Printing
8.5 x 11
rendered
NNN
YNN
NYN
YYN
using no
printer setting
8.5 x 11
rendered
using no
printer setting
8.5 x 11
rendered
using no
printer setting (viewing only)
Use the default printer
settings of
the report
consumer
machine
8.5 x 11
rendered
using no
printer setting
8.5 x 11
rendered
using no
printer setting
8.5 x 11
rendered
using no
printer setting (viewing only)
Use the default printer
settings of
the report
consumer
machine
N/A
Use local
printer setting
N/A
Use local
printer setting
20Crystal Reports Viewer XI Release Notes
Page settings
changed?
Differences Between the Crystal Reports Viewer and Crystal Reports
Printing limitations
Crystal RePrinter
specified
on the report author's machine?
Printer
specified
on the report consumer's
machine?
NNY
YNY
Crystal Reports —
what you
view is
what you
print
Not applicable; cannot
change report page
size without
a printer
specified on
the report
author's
machine
Not applicable; cannot
change report page
size without
a printer
specified on
the report
author's
machine
ports View-
er — what
you view is
what the
report was
created
with
Printing
4
Custom
page size
with "No
NYY
Printer"
configuration (viewing only)
Crystal Reports Viewer XI Release Notes21
Use custom
page size;
"No Printer"
configura-
tion (view-
ing only)
N/A
Differences Between the Crystal Reports Viewer and Crystal Reports
4
Printing limitations
Printer
Page settings
changed?
Note: If you open a report in which the paper size selected by the report
specified
on the report author's machine?
Printer
specified
on the report consumer's
machine?
YYY
designer is not available, the Crystal Reports Viewer will display the report
in its original paper size. If you print the report from the viewer, the output is
reduced to fit to the default paper size.
Crystal Reports —
what you
view is
what you
print
Custom
page size
with local
printer configuration
Crystal Re-
ports View-
er — what
you view is
what the
report was
created
with
Use custom
page size;
create best
match be-
tween new
printer set-
tings and
original
printer
Printing
Use local
printer setting
22Crystal Reports Viewer XI Release Notes
Other Issues
5
Other Issues
5
Date/Time parsing in languages
Date/Time parsing in languages
Date/Time parsing may not be carried out correctly in languages other than
English. The following functions in the formula language use the Date/Time
parser to parse input strings into a Date, Time, or DateTime value according
to the locale setting on the machine running the viewer:
•CDate(String)
•CTime(String)
•CDateTime(String)
•IsDate(String)
•IsTime(String)
•IsDateTime(String)
•DateTimeValue(String)
•TimeValue(String)
•DateValue(String)
These functions may behave differently in the viewer as a result of the
Date/Time Parser differences.
Here are the known issues with the Date/Time Parser as used in the viewer:
•Date and Time strings must use delimiters to separate their component
parts. (The delimiters cannot be omitted.)
•The set of recognized delimiters within a date string is limited to the
following characters: space, comma, period, forward slash, hyphen, and
colon.
•The set of recognized delimiters within a Time string is limited to the
following characters: colon, space, and period.
•The types of words recognized within a Date string are limited to full month
names or shortened month names for the given locale.
•The types of words recognized within a Time string are limited to AM/PM
names for the given locale.
Drill-down behavior
The drill-down functionality of Crystal Reports has been redesigned in the
Crystal Reports Viewer to make navigation easier for the user. Here are
some differences that you might notice:
24Crystal Reports Viewer XI Release Notes
End-User License Agreement (EULA)
•To drill down on a section that is not hidden, you must right-click the
section instead of double-clicking it.
•You cannot use the Group Tree (Contents Panel) to navigate to a page
within the parent node of a hidden section. (When you navigate to the
parent node of a hidden section, you can immediately drill down on the
group view instead of going to a page in the main report view.)
End-User License Agreement (EULA)
In the About dialog box, the End-User License Agreement appears in English
no matter the language in which you chose to install the software.
Error messages
Some reports that can't be opened because of unsupported features (such
as unsupported functions) or errors (such as formulas that can't be compiled)
display generic errors, such as "you may not have permissions to view this
file" and "file may be locked by another application."
Other Issues
5
Exporting to Excel
Text objects that contain many formatting options (changes in font, size,
colour, and so on) may create an invalid Excel file format.
Exporting to PDF
•When you export a report that uses fonts that cannot be embedded in a
PDF, the viewer does not produce a warning message. The export is
successful, but the font is not used in the PDF.
•Some Asian fonts (MS Gothic, MS Mincho, MS PGothic, MS PMincho)
cannot be correctly exported to PDF.
Help installation
Help is not installed for languages other than the supported languages. To
install English help for non-supported languages, set your machine's Regional
Crystal Reports Viewer XI Release Notes25
Other Issues
5
Improved searching
Options to English before you install. You can change the Regional Options
to the original language after you install the viewer.
Improved searching
Search is now available in a side panel that makes it easier to display and
navigate through your search results. In addition, the entire document will
now be searched—including any hidden sections in your report that might
contain more information.
Interacting with BusinessObjects
Enterprise
Sharing reports to BusinessObjects Enterprise XI R2 with Service Pack 2 is
now available.
Note: Sharing to any version of BusinessObjects Enterprise earlier than XI
R2, SP 2 is not supported.
Administrators must configure connections to interact with BusinessObjects
Enterprise:
•To take a report offline, you can configure either a BusinessObjects
Enterprise server connection or a Web Services connection to a
BusinessObjects Enterprise server.
•To share a report online, you must configure a Web Services connection
to a BusinessObjects Enterprise server.
For information on configuring a connection to a BusinessObjects Enterprise
server, see "To configure a BusinessObjects Enterprise server" in the CrystalReports Viewer XI Online Help.
To configure a WebServices connection, go to the "Configure Server
Connections" dialog box in the Crystal Reports Viewer, select Business
Objects WebServices from the list on the left-hand side, and then click Add.
Enter the following information, and then click OK.
26Crystal Reports Viewer XI Release Notes
Web Services URL
System Display Name
Other Issues
Linux support
DescriptionField name
The connection URL to the BusinessObjects Enterprise server hosting your web services. For
example, http://myserver:8080/dswsbob
je/services.
The name of your connection for use within the
Crystal Reports Viewer. You'll see this name on
the File menu of your viewer. If you do not enter
a display name before you click OK, the program
makes the display name the same as the system
name.
5
User Name
Authentication Type
If you connect to the Internet via a web proxy server, you must specify the
proxy server settings.
Password
The valid name of a user in the BusinessObjects
Enterprise system that your are connecting to.
The password for the corresponding user.Password
The authentication type of the user account that
you entered above.
DescriptionField name
The name of the proxy server to connect to.Server
The port number of the proxy server.Port
The valid name of a user for the proxy server.User Name
The password for the corresponding proxy server
user.
Linux support
The Linux version of the Crystal Reports Viewer XI has the following known
issues.
Crystal Reports Viewer XI Release Notes27
Other Issues
5
Locale-dependent functions
Note:
•The in-product customer feedback options are disabled.
•The in-product automated error reporting dialog box is disabled.
•The in-product update service does not work.
•Sending reports via email directly from the viewer is disabled.
•The "File" dialog box does not remember the last directory you opened
or saved a file from or to.
•Side panel buttons in the toolbar have a black background on some
versions of Linux.
•You must select a download directory in the Open from BusinessObjects
Enterprise and Open from crystalreports.com dialog boxes before
saving.
•Sometimes the navigation path text is truncated.
•Rendering performance may be slow, especially when you use the Zoom
slider or when you are scrolling up or down a page.
•Not all hot keys function.
•The link to the third-party licenses folder, from the "About" dialog box,
does not work on all versions of Linux.
Locale-dependent functions
The following locale-dependent functions are not supported in locales other
than English:
•Totext() (Number, Currency, Date, Time, DateTime)
•CStr() (This function is the same as ToText())
•CDate(String)
•CTime(String)
•CDateTime(String)
•IsDate(String)
•IsTime(String)
•IsDateTime(String)
•DateTimeValue(String)
•TimeValue(String)
•DateValue(String)
28Crystal Reports Viewer XI Release Notes
Mac support
Crystal Reports Viewer XI now runs on Mac OS X.
Note:
•When viewing your reports on a Mac, you may notice different formatting
for date, time, and number fields.
•When printing your reports from a Mac, the viewer uses the default printer
settings instead of the printer setting saved with the report.
•Printed output does not look clear when printing from Mac OS X. This
problem does not occur on Mac OS X 10.5.
•Tooltips for hyperlinks are not supported on Mac.
•Mac users cannot interact with BusinessObjects Enterprise by using a
WebServices connection. You must use a Business Objects Servers
connection.
•Mac users cannot paste images or report objects copied from the viewer
into Word (Mac), Preview, or PaintBrush. For Word, you can drag the
object from viewer directly into Word. However, this method does not
work with Preview or PaintBrush.
•Dragging a report into the viewer as a way of opening it does not work
until you have opened a previous report by using the File menu.
•When opening a report from crystalreports.com, the viewer may not move
beyond the logon dialog box until you press a key or move your mouse.
Other Issues
Mac support
5
Page size
When you open a report that does not have a default printer but does have
a default page size, the report may have different page sizes on different
versions of the Windows operating system.
Printer and page settings
When you choose a specific printer to use in a report, the viewer will try find
and use that printer. If the printer cannot be found, the viewer will try to find
the default printer of the local system. If there is no default printer, the viewer
won't use any printer.
Crystal Reports Viewer XI Release Notes29
Other Issues
5
Supported authentication types
When a printer is identified and used by the viewer, the page size and related
margins are fetched from the device. Otherwise the viewer uses hard-coded
settings.
Related Topics
•Printing limitations on page 20
Supported authentication types
In the Crystal Reports Viewer, only two Authentication Types—Enterprise
and LDAP—are supported for BusinessObjects Enterprise server-connection
configuration. Wndows AD is not supported.
Supported fonts
The Crystal Reports Viewer supports only TrueType and Postscript Type 1
fonts. It does not support bitmap fonts.
Time-zone information
You may notice differences in time-zone information between Crystal Reports
and the Crystal Reports Viewer. Crystal Reports gets time zone-information
from the operating system, while the viewer gets the same information from
the JVM. The strings that the JVM returns for a given time zone are not
necessarily the same as those returned by the OS. Also, if you change the
time zone in the OS, the JVM time zone may not change, even when you
restart the JVM.
Feedback
If report objects or other features that are not supported are having a major
impact on your use of the Crystal Reports Viewer XI, please let us know
through the feedback mechanism in the viewer.
30Crystal Reports Viewer XI Release Notes
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.