Serializing ReportClientDocument

Report Application Server .NET SDK Developer Guide

For applications that must handle a large number of reports, using the Session object becomes a less optimal way to store information. In that case, it's best to switch the RAS Server to operate in a sessionless environment. The ReportClientDocument object is a serializable object that ViewState maintains in a XML file on a client machine, instead of in the Session object that is in memory. This configuration greatly improves the scalability of the RAS server.

Note Note

The serialized ReportClientDocument object may contain the logon information for the current user. It is your responsibility to ensure that your applications protect this file so an instance of the serialized ReportClientDocument object cannot be shared between users. Anyone with read access to the XML file can use this information to view and modify reports as long as the session is valid.

When you configure the RAS server to serialize and write the ReportClientDocument object to disk, you can also do the following:

Run the RAS Server in Web Services applications.
Deploy the RAS server in a Web Farm or Web Garden.

The serialized ReportClientDocument object stores the information that is required to reconnect to the RAS server on the client machine. This way the client machine can connect to the RAS server through any of the web servers found in the Web Farm or Web Garden.

To configure a web application to use sessionless RAS, you must add the following namespace to your Visual Studio project: CrystalDecisions.ReportAppServer.Utilities. It contains the Conversion class, which is used to serialize and de-serialize the ReportClientDocument object.

Also, because the ReportClientDocument object will be written to disk, an option is set to allow only the smallest instance of the ReportClientDocument object to be serialized and stored in ViewState when a report is opened. This option is named CdReportClientDocumentOpenOptionsEnum.cdOpenReportRetrieveNoReportDefinition.

In this section:

http://www.sap.com/sapbusinessobjects/

Support services

http://service.sap.com/bosap-support/

Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator