VS2005 Release Notes

22
 Crystal Reports for Visual Studio 2005 Release Notes Crystal Reports for Visual Studio 2005

Transcript of VS2005 Release Notes

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 1/22

 

Crystal Reports for Visual Studio 2005

Release Notes

Crystal Reports for Visual Studio 2005

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 2/22

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 theUnited States and other countries. All other names mentioned herein may be trademarks of 

their respective owners.

Copyright Copyright © 2005 Business Objects. All rights reserved.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 3/22

  Crystal Reports for Visual Studio 2005 Release Notes 1

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Accessibility 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 . . . . . . . . . . . . . . . . . . . . . . . . . 17How 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

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 4/22

Contents

2 Crystal Reports for Visual Studio 2005 Release Notes

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 5/22

 

   c     h   a   p    t   e   r

Crystal Reports for Visual

Studio 2005

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 6/22

Crystal Reports for Visual Studio 2005

 About these notes1

4 Crystal Reports for Visual Studio 2005 Release 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 andintegrate 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 InformationResources” 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 7/22

 

   c     h   a   p    t   e   r

Crystal Reports

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 8/22

6 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports

Registration2

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, usethe 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 andCrystal Reports 10 projects to Visual Studio 2005, you may lose some of 

the functionality that you had from the full version.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 9/22

Crystal Reports for Visual Studio 2005 Release Notes 7

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 thisproblem, 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 isreassigned 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 10/22

8 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports

Formatting reports2

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 toappear 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/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 11/22

Crystal Reports for Visual Studio 2005 Release Notes 9

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 newselection 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).

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 12/22

10 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports

Web sites2

• 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 13/22

Crystal Reports for Visual Studio 2005 Release Notes 11

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 atargetNamespace 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 withspaces 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>

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 14/22

12 Crystal Reports for Visual Studio 2005 Release Notes

Crystal Reports

 XML related issues2

</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 FROMClause."

• 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 15/22

Crystal Reports for Visual Studio 2005 Release Notes 13

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 areport 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 16/22

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 17/22

 

   a   p   p   e   n     d     i   x

Business Objects Information

Resources

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 18/22

Documentation and information servicesA

16 Crystal Reports for Visual Studio 2005 Release Notes  

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 helpmaximize 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.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 19/22

Customer support, consulting and training  A

  Crystal Reports for Visual Studio 2005 Release Notes 17

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: [email protected].

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/

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 20/22

Customer support, consulting and training A

18 Crystal Reports for Visual Studio 2005 Release Notes  

Looking for the best deployment solution for yourcompany?

Business Objects consultants can accompany you from the initial analysisstage 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

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 21/22

Useful addresses at a glance A

  Crystal Reports for Visual Studio 2005 Release Notes 19

Useful addresses at a glance

Address ContentBusiness Objects productinformation

http://www.businessobjects.com

Information about the full range of Business Objects products.

Product documentation

http://support.businessobjects.com/documentation

Business Objects productdocumentation, including theBusiness Objects DocumentationRoadmap.

Business Objects Documentationmailbox

[email protected]

Send us feedback or questionsabout documentation.

Online Customer Support

http://support.businessobjects.com/

Information on Customer Supportprograms, as well as links totechnical articles, downloads, andonline forums.

Business Objects ConsultingServices

http://www.businessobjects.com/services/consulting/

Information on how BusinessObjects can help maximize your business intelligence investment.

Business Objects Education

Serviceshttp://www.businessobjects.com/services/training

Information on Business Objects

training options and modules.

8/8/2019 VS2005 Release Notes

http://slidepdf.com/reader/full/vs2005-release-notes 22/22

Useful addresses at a glanceA