Crystal Reports for Visual Studio 2005

Release Notes

Crystal Reports for Visual Studio 2005

Patents Business Objects owns the following U.S. patents, which may cover products that are offered
and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and
6,289,352.

Trademarks Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise are
trademarks or registered trademarks of Business Objects SA or its affiliated companies in the
United States and other countries. All other names mentioned herein may be trademarks of
their respective owners.

Copyright Copyright © 2005 Business Objects. All rights reserved.

Contents
Chapter 1 Crystal Reports for Visual Studio 2005 3
About these notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Business Objects information resources . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2 Crystal Reports 5

Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Crystal Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Data source connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Formatting reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Printing and Exporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Web sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
XML related issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
User-defined type related issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Language specific issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Accessibility related issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Appendix A Business Objects Information Resources 15

Documentation and information services . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
What’s in the documentation set? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Where is the documentation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Send us your feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Customer support, consulting and training . . . . . . . . . . . . . . . . . . . . . . . . . 17
How can we support you? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Looking for the best deployment solution for your company? . . . . . . . 18
Looking for training options? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Crystal Reports for Visual Studio 2005 Release Notes 1

Contents

2 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports for Visual
Studio 2005

chapter
1 Crystal Reports for Visual Studio 2005
About these notes

About these notes

Welcome to Crystal Reports for Visual Studio 2005. With Crystal Reports for
Visual Studio 2005, you can create interactive, professional reports and
integrate them into Visual Studio applications.
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 existing customers.
Please read the entire document before you install Crystal Reports for Visual
Studio 2005.

Business Objects information resources

For more information and assistance, see “Business Objects Information
Resources” on page 15. This appendix describes the Business Objects
documentation, customer support, training, and consulting services, with links
to online resources.
For acknowledgements of third party contributors and applications, in addition
to related license information, please see http://www.businessobjects.com/
thirdparty.

4 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports

chapter
2 Crystal Reports
Registration

Registration
• You must have administrator access to enter or change the registration
key.

Crystal Services
• After expanding the Server Explorer, you may see the following error
message: “Enterprise connectivity has not been detected on this
machine. Please install the BusinessObjects Enterprise .NET SDK from
Crystal Reports Server or BusinessObjects Enterprise and try again."
Workaround: Install the BusinessObjects Enterprise XI Release 2 .NET
SDK and Crystal Reports XI Release 2.

Migration
• Parameter prompting is a new feature. After you have migrated your
application, when you refresh a report, the application prompts for the
value of the parameter, instead of fetching the value of the parameter in
the code. To turn off parameter prompting, set
ReuseReportParametersOnRefresh to false on the CrystalReportVeiwer
control.
• To set the viewer selection formula to display all records in a report, use
the empty string instead of the null string. The null string fails to override
the original report-selection formula. The empty string is represented as
"" or String.Empty. The null string is represented as null in C# or Nothing
in Visual Basic.
• References to the CrystalDecisions.ReportSource,
CrystalDecisions.Shared, and CrystalDecisions.Windows.Forms
assemblies are lost when a Windows Project from Crystal Reports 9 or
Crystal Reports 10 is migrated to Crystal Reports for Visual Studio 2005.
After migration, add the references manually, or upgrade to Crystal
Reports XI Release 2. Note that, when migrating Crystal Reports 9 and
Crystal Reports 10 projects to Visual Studio 2005, you may lose some of
the functionality that you had from the full version.

6 Crystal Reports for Visual Studio 2005 Release Notes

 Crystal Reports
Data source connectivity 2
Data source connectivity
• An application may fail to load a report when it connects to SQL Server
through OLEDB on a machine that runs Windows 98 SE. To resolve this
problem, install Microsoft Data Access Components (MDAC) version 2.8
or higher.
• When you change the location of a table to a different database at run
time, ensure that the new database contains a table that uses the same
name as the one found in the original report. If the table names do not
match, the connection fails.
• Reports that are created from an Oracle stored procedure and that use
the Oracle OLEDB Driver will generate a Query engine error. Instead,
use the Microsoft OLEDB driver for Oracle.
• A problem may occur when the data source of a Crystal report is
reassigned to an AccessDataSource at runtime. The Crystal report fails
to recognize the aliased names in the AccessDataSource, under these
conditions:
• An AccessDataSource has been created from the Data Source
wizard.
• Specific columns have been assigned in the Access query.
• The columns have been aliased with the "As" clause.
To fix the problem, examine the Select Command inside the
AccessDataSource tag and remove any aliases.
• A bug in the 64-bit Oracle OLEDB driver causes the driver to return only
the first column in each table. This results in errors when opening Crystal
reports that use this driver. The 64-bit Oracle OLEDB driver is not
supported.
• On Windows 95/98/Me platforms, when you run a Crystal Reports
application that calls SetDataSource() to set to a Classic ADO Recordset
as the data source for the report, the following error message may
appear: "The data source object is invalid."
• When using the functions ReportDocument.DataSourceConnections,
Table.ApplyLogOnInfo(), or Table.Location to change a database
location from Oracle database to another Oracle database, you must
verify the database with ReportDocument.VerifyDatabase() before
viewing the report.

Crystal Reports for Visual Studio 2005 Release Notes 7

2 Crystal Reports
Formatting reports

Formatting reports
• When you add a Special Field to a report, although the Special Field has
been successfully added, a checkmark icon beside the field fails to
appear in the Field Explorer.
• After a field is re-mapped in the report designer, the Field Explorer fails to
display the new field name. The field name in the report is correctly
modified; however, the name in the Field Explorer does not update
correctly.

Printing and Exporting

• You may see an error when you print with ActiveX from a webform
application.
Workaround: Add the URL of the website to your trusted sites list on
every Internet Explorer client.
• Internet Explorer may continue to prompt you to install the
PrintControl.cab when you click Print, even when the print control has
already been installed.
Workaround: Specify the version number of the print control in the web
site's web.config file:
<businessObjects>
<crystalReports>
<printControl>
<add key="url" value="http://
support.businessobjects.com/CRforVS2005/
PrintControl.cab#1,2,0,1078" /
</printControl>
</crystalReports>
</businessObjects>
• In a WebForm, the method report.PrintToPrinter throws an exception if a
printer has not been configured for your ASP.NET account.
Workaround: Add a printer to your ASP.NET account or have ASP.NET
impersonate a user with a printer.
• On a 64-bit machine, printing reports from a Winform application does not
work.
Workaround: Visit the Business Objects Customer Support web site and
download the first patch to resolve this issue.

8 Crystal Reports for Visual Studio 2005 Release Notes

 Crystal Reports
Web sites 2
• An exception may be thrown when users export or print a report from a
CrystalReportViewer control. This problem happens when the web page
includes a CrystalReportViewer control and Microsoft Web Controls and
is viewed in the Firefox web browser.
Workaround: Set EnableEventValidation to False in the ASP page to
allow users to print or export a report in Firefox.

Web sites
• If you run a project with a version 6 or earlier Crystal report that is based
on a query with saved data, an error message may appear. The cause of
the problem is that the refresh feature for query reports is not supported
in Crystal Reports version 7 and later.
• When you open a report that was created in Crystal Reports version 6 or
earlier, the chart template is automatically removed from the report.
• Reports created in Crystal Reports version 10 or earlier that contain
textured charts may contain X’s rather than the correct texture.
• When you view a report that has tables with the data source set to
IDataReader for each one, and many of the tables are linked together,
you may see the following error message: "Invalid database argument."
Calls made to SetDataSource() from an IDataReader are supported only
for reports that contain one table.
Workaround: To use an IDataReader with multiple tables, create a
report with one command table that selects the necessary fields.
• If the DataSource tag of a CrystalReportSource tag is bound to an object
that has more than two dependencies, the viewer will show incorrectly
filtered data when a page is first loaded.
Workaround: In the Page_Init() or OnInit() method of your application,
call control.DataBind(), where “control” is the control to which your
DataSource is bound.
• When you change the SelectionFormula property of a webform viewer at
run time, a new set of data isn't retrieved until you click Refresh.
Workaround: To refresh the report and display the report using the new
selection formula, call ReportDocument.Refresh().
• SetDataSource does not support strongly typed datasets with NULL
values that have been cast to an IEnumerable object.
Workaround: Convert the IEnumerable into a DataTable and use
SetDataSource(DataTable).

Crystal Reports for Visual Studio 2005 Release Notes 9

2 Crystal Reports
Web sites

• When parameter values are set with tags, and then a parameter that
doesn't exist in the report is entered as the first parameter value, an error
message may appear at run time.
Workaround: Only add parameters that exist in the report.
• Verifying a database through code that uses the
ReportDocument.VerifyDatabase() method may throw an exception. This
problem happens when you use a strongly typed report class that needs
no database logon, such as Access or ADO.NET.
Workaround: Call the SetDatabaseLogon() method before you call the
VerifyDatabase() method. For example:
ReportDocument rpt = new ReportDocument();
rpt = new StrongReportClass();
rpt.SetDatabaseLogon("","");
rpt.VerifyDatabase();
• When you use the New Project dialog box to create a Crystal Reports
Web Application, some report formatting may display incorrectly. The
cause of the problem is a missing link from the default.aspx page of the
Crystal Template Web application to the CrystalReportWebFormViewer3/
css/default.css file. The absence of this link causes formatting problems
for certain report objects that use customized formats, such as the CSS
style Class Name.
Workaround: To ensure that report objects with customized formats will
display properly, add the following link to the default.aspx page: <link
href="/aspnet_client/System_Web/2_0_50727/
CrystalReportWebFormViewer3/css/default.css" rel="stylesheet"
type="text/css" />
• When you view the parameter list of a CrystalReportSource control in the
Crystal Reports Parameter Collection Editor, all the parameters in the
main report and subreports are displayed. The radio buttons in the
Crystal Reports Parameter Collection Editor show whether the currently
selected parameter is a main report or a subreport parameter. The
buttons do not filter the parameter list.
• The webform CrystalReportViewer fails to let you set the
SelectionFormula property at run time when you use the viewer's View
list.
Workaround: Clear the View list, by setting the ReportSource of the
viewer again after you set the SelectionFormula property.
• Object borders will not display when viewing a Crystal report with the
CrystalReportViewer in an XHTML 1.1 document.

10 Crystal Reports for Visual Studio 2005 Release Notes

 Crystal Reports
XML related issues 2
Workaround: Remove the following line from your aspx page:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://
www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
• If a webform viewer is bound to a report that requires database logon,
and at runtime, you minimize the web part that displays the database
logon prompting page, the following error message may appear: "Cannot
move focus to the control because it's invisible, not enabled, or of a type
that does not accept the focus."
Workaround: Restore the web part so that the database logon is visible.

XML related issues

• Crystal Reports for Visual Studio 2005 does not support reading SQL
Server 2005 XML fields where the XML schema does not have a
targetNamespace set within it.
Workaround: Create a command, and enter the SQL you need, to
extract data from the XML fields.
• When you view a report that contains a record selection formula based
on a boolean XML instance field, the following error message may
appear: "The operator "=" cannot be applied to xs:boolean and xs:integer
operands."
• Record selection formulas that are based on string XML instance fields
and use the "equal to" operator will fail to return a value. This problem
happens because string data in the XML document is padded with
spaces to fill the string to maximum length. The extra spaces disrupt the
formula.
Workaround: In the selection formula, the extra spaces can be moved to
the end of the string, so that the formula isn’t disrupted. Alternatively,
when you define an XML element for the string type, you can define it to
delete padded spaces:
<xsd:simpleType name = "myString">
<xsd:restriction base = "xsd:string">
<xsd:maxLength value="255"/>
<xsd:whiteSpace value = "collapse"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:element name="col1">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="col1" type="myString" />
</xsd:sequence>

Crystal Reports for Visual Studio 2005 Release Notes 11

2 Crystal Reports
XML related issues

</xsd:complexType>
• For XML fields that contain simple content only, a report can only display
the value in XML format.
• When performing “group by” on a server based on XML instance fields,
the following MS SQL Server error message may appear: "XML methods
are not allowed group by clause."
Workaround: Disable “perform grouping on server” for the report.
• For XML fields that contain only complex-type content or contain
attributes, a report will fail to display the hierarchical structure of the field.
• XML instances of certain XML string types are unable to be displayed in
the Field Explorer. Those XML string types are as follows:
• token
• language
• NMTOKEN
• Name
• ID
• NCName
• anyURI
• After you change the name of a child field for an XML field in a report, and
then view the report, an error message may be displayed. The cause of
the problem is that the verify function fails to be called, even when the
report option verify on first refresh is enabled.
Workaround: Explicitly call the verify method.
• Fields cannot be remapped to a sub-component of an XML table. When
you map fields to an XML table, only the first level of columns for the
target table are displayed.
• When you create a SQL expression field based on an XML instance field
in the SQL expression editor, the following error message may appear:
"Invalid object name."
• When you view a link report based on XML tables where the XML
instance fields have same instance name, the following error message
may appear: "The correlation name is defined multiple times in FROM
Clause."
• A report based on an XML table will fail to load if the first relational field in
the XML table has been deleted.
Workaround: Add the field back to the database table.

12 Crystal Reports for Visual Studio 2005 Release Notes

 Crystal Reports
User-defined type related issues 2
• The Field Explorer displays XML child tables that do not belong to the
parent tables it is displaying. This problem happens after you set the data
source location of a report, which is based on a database table with
multiple SQL Server 2005 XML fields that link to different tables.

User-defined type related issues

• If you create a SQL expression field based on a UDT field, an error
message may appear.
Workaround: Change the "/" to "." in the command for the SQL
expression.
• At design time, after the data source location has been set for a report
that is based on a table with a UDT field that is mapping to a general
database table, the child fields in that UDT field remain in the report,
rather than be removed.
• A report based on a UDT table fails to load if the first relational field in the
UDT table is deleted.
Workaround: Add the field back to the database table.

Language specific issues

• When the regional setting of your operating system is set to Turkish, an
error message may appear. This problem happens when you view a
report created with a command, based on ODBC to AccessDB, and the
name for the table row is typed in mixed case.
• Japanese characters encoded as Shift-JIS fail to appear correctly in an
ASP.NET Web Application that has been migrated from Visual Studio
2002 or 2003 to Visual Studio 2005. Before migration, convert all of your
ASPX pages to UTF-8.

Accessibility related issues

• When using a screen reader, the Zoom list in the Windows Forms
CrystalReportViewer cannot be activated using the keyboard.
• In the Windows Forms CrystalReportViewer, the Tab key cannot be used
to navigate to some of the toolbar buttons.

Crystal Reports for Visual Studio 2005 Release Notes 13

2 Crystal Reports
Accessibility related issues

Workaround: Use the arrow keys to navigate to the other toolbar

buttons.
• The Jaws screen reader does not read out loud the group names in the
group tree in the winform viewer.
Workaround: Press the Tab key to go to the toolbar, and then press the
Tab key again to go back to the group tree. The highlighted group name
will be then read out loud by Jaws.
• While narrator.exe is running, if you click a hyperlink in a report in the
winform viewer, the application may terminate unexpectedly.
Workaround: Visit the Business Objects Customer Support web site and
download the first patch to resolve this issue.

14 Crystal Reports for Visual Studio 2005 Release Notes

Business Objects Information
Resources

appendix
A Documentation and information services

Documentation and information services

Business Objects offers a full documentation set covering its products and
their deployment. Additional support and services are also available to help
maximize the return on your business intelligence investment. The following
sections detail where to get Business Objects documentation and how to use
the resources at Business Objects to meet your needs for technical support,
education, and consulting.

Documentation
You can find answers to your questions on how to install, configure, deploy,
and use Business Objects products from the documentation.

What’s in the documentation set?

View or download the Business Objects Documentation Roadmap, available
with the product documentation at http://support.businessobjects.com/
documentation/.
The Documentation Roadmap references all Business Objects guides and
lets you see at a glance what information is available, from where, and in
what format.

Where is the documentation?

You can access electronic documentation at any time from the product
interface, the web, or from your product CD.

Documentation on the web

Documentation for Crystal Reports for Visual Studio 2005 is available on the
web:
http://support.businessobjects.com/documentation/product_guides/cr_net/
vs_2005.

Documentation on the product CD

Look in the docs directory of your product CD for versions of guides in Adobe
PDF format.

16 Crystal Reports for Visual Studio 2005 Release Notes

 Customer support, consulting and training A
Send us your feedback
Do you have a suggestion on how we can improve our documentation? Is
there something you particularly like or have found useful? Drop us a line,
and we will do our best to ensure that your suggestion is included in the next
release of our documentation: documentation@businessobjects.com.
Note: If your issue concerns a Business Objects product and not the
documentation, please contact our Customer Support experts. For
information about Customer Support visit: http://
support.businessobjects.com/.

Customer support, consulting and training

A global network of Business Objects technology experts provides customer
support, education, and consulting to ensure maximum business intelligence
benefit to your business.

How can we support you?

Business Objects offers customer support plans to best suit the size and
requirements of your deployment. We operate customer support centers in
the following countries:
• USA
• Australia
• Canada
• United Kingdom
• Japan

Online Customer Support

The Business Objects Customer Support web site contains information about
Customer Support programs and services. It also has links to a wide range of
technical information including knowledgebase articles, downloads, and
support forums.
http://support.businessobjects.com/

Crystal Reports for Visual Studio 2005 Release Notes 17

A Customer support, consulting and training

Looking for the best deployment solution for your

company?
Business Objects consultants can accompany you from the initial analysis
stage to the delivery of your deployment project. Expertise is available in
relational and multidimensional databases, in connectivities, database design
tools, customized embedding technology, and more.
For more information, contact your local sales office, or contact us at:
http://www.businessobjects.com/services/consulting/

Looking for training options?

From traditional classroom learning to targeted e-learning seminars, we can
offer a training package to suit your learning needs and preferred learning
style. Find more information on the Business Objects Education web site:
http://www.businessobjects.com/services/training

18 Crystal Reports for Visual Studio 2005 Release Notes


Useful addresses at a glance
Address
Business Objects product
information
http://www.businessobjects.com
Product documentation
http://support.businessobjects.com/
documentation
Business Objects Documentation
mailbox
documentation@businessobjects.com
Online Customer Support
http://support.businessobjects.com/
Business Objects Consulting
Services
http://www.businessobjects.com/
services/consulting/
Business Objects Education
Services
http://www.businessobjects.com/
services/training
Crystal Reports for Visual Studio 2005 Release Notes 19
Useful addresses at a glance A
Content
Information about the full range of
Business Objects products.
Business Objects product
documentation, including the
Business Objects Documentation
Roadmap.
Send us feedback or questions
about documentation.
Information on Customer Support
programs, as well as links to
technical articles, downloads, and
online forums.
Information on how Business
Objects can help maximize your
business intelligence investment.
Information on Business Objects
training options and modules.
A Useful addresses at a glance

20 Crystal Reports for Visual Studio 2005 Release Notes