This section shows you how to add report viewing functionality to your BEA WebLogic Workshop projects. It shows you how to add new or existing reports to your projects. In addition, it shows you how to edit reports using the Crystal Reports for BEA WebLogic Workshop Designer. A migration section is included for reports created with Crystal Reports version 8.5 or earlier.
Click the appropriate link to jump to that section:
Crystal Reports for BEA WebLogic Workshop allows you to add report files to your web projects. Adding report files to your BEA WebLogic Workshop project enables them to be managed as part of your project, and deployed with your web applications. Both existing reports and new reports can be added.
Click the appropriate link to jump to that section:
BEA WebLogic Workshop integrates the process of creating a
new report in your web projects. If you are working on a Windows
The New File dialog box is displayed.
Note: By default, the report is created in your BEA WebLogic Workshop project's root directory. Use the Browse button to designate another location.
The designer is now launched. While the designer is running, a message in the main window informs you that the report is being edited.
You can add your existing reports to your BEA WebLogic Workshop projects and use them without further modification.
If your report was created with Crystal Reports version 8.5 or earlier, it must be updated using the report migration tool. The report migration tool updates the report format to ensure it is compatible with the additional features provided in Crystal Reports 9 and above. Use the report migration tool to ensure that your existing reports display correctly. For more information about updating existing reports, see Migrating reports.
The Java viewer allows reports to be displayed in a standard web browser. The Crystal Reports Viewer Wizard is the most efficient way to add a report viewer to your JSP page. The wizard uses the Viewer Tag Library to automatically insert and set all necessary tags. It also ensures that all dependencies are added correctly.
While you can use the wizard to simplify the process, you can also insert and set viewer tags manually.
Note that the tags encapsulate commonly used functions of the Viewer Java SDK. Using the Viewer Java SDK allows you to access the actual classes and methods that drive the report viewing process, giving you the greatest amount of flexibility and configurability.
Click the appropriate link to jump to that section:
The viewer is not installed by default for each web project. To use the Crystal Reports Viewer Wizard or Viewer Tag Library, you must first install the viewer for your particular project.
The Viewer Tag Library allows you to access the report viewer through modular and reusable tags. Using tags allows you to reduce the amount of embedded Java code in a JSP page by moving the functional implementation into the tag and its implementing class. Doing so effectively abstracts the details of the code from the presentation of the actual page, allowing web page authors to concentrate on developing JSP pages. Using the Viewer Tag Library allows you to access the functionality of the Crystal report viewers without writing Java code. For more information on how to use the Viewer Tag Library, consult the Crystal Reports for BEA WebLogic Workshop Developer's Guide.
The Crystal Reports Viewer Wizard allows you to add a viewer to your JSP page. The wizard guides you through adding report functionality, and automatically inserts the viewer tag code.
Tag properties and values displayed in the wizard are the default values; if you do not explicitly set a value, the attribute is not set in the inserted code.
This starts the Crystal Reports Viewer Wizard.
The name uniquely identifies this particular instance of the viewer. If you have multiple viewers on the same page, ensure that their names are unique.
You can customize the appearance and behavior of the viewer. Use the tabs to navigate between categories, and set values.
The viewer code required to display the report you specified is inserted.
The Viewer Tag Library only encapsulates commonly used functions of the Viewer Java SDK. The Crystal Reports functionality provided by Crystal Reports for BEA WebLogic Workshop can also be accessed directly through the Viewer Java SDK. The SDK provides access to classes and methods that customize the report viewing functionality provided by the viewer. These classes and methods allow you to enable and disable viewer functionality, set default parameter values, specify database logons, and configure a wide range of different report viewing options. For more information on how to use the Viewer Java SDK, consult the Crystal Reports for BEA WebLogic Workshop Developer's Guide.
Crystal Reports for BEA WebLogic Workshop also allows you to edit reports you have added to your projects. Although report editing cannot be done directly in the BEA WebLogic Workshop environment, on Windows systems the reports can be edited through the Crystal Reports for BEA WebLogic Workshop Designer.
The Crystal Reports for BEA WebLogic Workshop Designer launches. While the designer is running, a message in the main window informs you that the report is being edited.
Reports created in Crystal Reports version 8.5 or earlier
require the report migration tool. The migration tool converts the reports to a
format that is compatible with all versions of Crystal Reports 9 and above. You
can convert the report to either version 9 or 10. Make sure to convert all pre
You can download Crystal Reports for BEA WebLogic Workshop Designer and sample reports when you register your copy of Crystal Reports for BEA WebLogic Workshop. For more information on registering your product, see Product registration.
You are then prompted to specify the location of the reports you wish to convert.
If you chose to convert multiple reports, you can add multiple directories containing reports that you wish to convert. Selecting Include Subdirectories before clicking Add Directory causes the Report Converter Wizard to recursively search through subdirectories for reports.
You can choose to overwrite the existing reports or output the converted reports to a new location.
For multiple reports, prefixing or suffixing the report names with v9 allows them to be written to the same directory without overwriting the old reports.
If there were any errors during the conversion process, click View Log to see them.
Crystal Decisions http://www.crystaldecisions.com/ Support services http://support.crystaldecisions.com/ |