Migrating your application from the Java Reporting Component to Crystal Enterprise

If your application requires additional scalability and the ability to modify reports, you can upgrade your report server to RAS and quickly migrate your application with minimal changes to existing code. Crystal Enterprise uses the RAS object model. RAS provides additional scalability and report modification features not provided with the Java Reporting Component.

To migrate your web application to use RAS, you must first obtain and install a copy of RAS. Once you have installed and configured RAS correctly, you can migrate your web application.

The migration path from the Java Reporting Component to RAS differs depending on whether your application uses the ReportClientDocument class.

Migrating an application that uses the ReportClientDocument class

If your web application uses the ReportClientDocument class to obtain a report source, you must change the JSP import statements to use the RAS namespace instead of the Java Reporting Component namespace.

For example, change com.crystaldecisions.reports.sdk.* to com.crystaldecisions.sdk.occa.report.application.*.

You also need to specify the location of your RAS server:

ReportClientDocument clientDoc = new ReportClientDocument();

clientDoc.setReportAppServer("SERVERNAME");

Migrating an application that does not use the ReportClientDocument class

Note:    It is recommended that you use the ReportClientDocument class for viewing or exporting reports.

If you web application does not use a ReportClientDocument object, you must change your code to use the appropriate RAS classes in place of the Java Reporting Component classes. The code to do this differs depending on whether you are using managed or unmanaged RAS.

The following is the original Java Reporting Component code:

IReportSourceFactory2 rptSrcFactory = new JPEReportSourceFactory();

Object reportSource = rptSrcFactory.createReportSource(report, request.getLocale());

Crystal Enterprise Professional Edition

In a managed environment like Crystal Enterprise Professional, remove the import statement that imports com.crystaldecisions.reports.reportengineinterface.JPEReportSourceFactory. You must also change the original Java Reporting Component code to the following:

IReportSourceFactory2 rptSrcFactory = (IReportSourceFactory2)enterpriseSession.getService("RASReportFactory");

Object reportSource = rptSrcFactory.createReportSource(report, request.getLocale());

Note:    The above code assumes that you have created a valid enterpriseSession object.

Crystal Enterprise Embedded Edition

In an unmanaged environment like Crystal Enterprise Embedded Edition, remove the import statement that imports com.crystaldecisions.reports.reportengineinterface.JPEReportSourceFactory. Then you must add an import statement to import com.crystaldecisions.sdk.occa.report.application.reportsourcefactory.RasReportSourceFactory. Additionally, you must change the original Java Reporting Component code to the following:

IReportSourceFactory2 rptSrcFactory = new RasReportSourceFactory();

Object reportSource = rptSrcFactory.createReportSource(report, request.getLocale());

In an unmanaged environment, you must also specify the location of the RAS server. See the Report Application Server Java SDK Guide for details about specifying the location of RAS.



Business Objects
http://www.businessobjects.com/
Support services
http://www.businessobjects.com/services/support/