Creating a custom toolbar

Crystal Enterprise supports five different Report Viewers, including a DHTML Report Viewer with frames. In order to write a DHTML Report Viewer with a custom toolbar, you should first look at the default DHTML Report Viewer provided by Crystal Decisions. It is located in the Crystal Enterprise folder under \Viewers\en\html. The file ToolBar.html shows you a good example of to use the HTML Frame API.

Before you read this section, it is recommended that you read both the Tutorial and the chapter on Architecture.

Writing your own toolbar consists of the following steps:

1. Create a main CSP page which will setup the browser into two frames, or however many you wish, but at least two in which to fit the viewer and your custom toolbar.
2. Create a custom toolbar page using the HTML Frame API.
3. Copy the file HTMLViewer.js from the Crystal Enterprise folder into the folder where you store your own viewer files.

For a description of the functions and features in the HTML Frame API, see DHTML with Frames.

This section describes the following:

• Creating the main CSP page
• Creating a Custom Toolbar