- •Seagate Crystal Web Reports Server Overview
- •What is the Web Reports Server?
- •Who should use the Web Reports Server?
- •Web Reports Server Features
- •New Features in Version 7
- •The Web Reports Server vs. Active Server Pages
- •Sample Web Sites
- •Implementing the Web Reports Server
- •Choosing a Web Reports Server
- •System Requirements
- •Installing the Web Reports Server
- •Confirming Correct Installation
- •Virtual Directories
- •Creating a Web Site
- •For More Information
- •Crystal Web Reports Server Administration
- •The Web Reports Server Configuration Application
- •Page Server Tab
- •Image Server Tab
- •Report Exporting Tab
- •Server Mappings Tab
- •Report Viewing Tab
- •The Page Server and the Image Server
- •Smart Navigation
- •Drilling Down on Data
- •Database Location
- •Web Reports Server Commands
- •The Crystal Web Reports Server Command Expert
- •Constructing Report Requests
- •Changing Selection Formulas in Web Reports
- •SQL and ODBC Data Sources
- •SQL Stored Procedures and Parameter Fields
- •Report Exporting
- •Refreshing Web Report Data
- •Web Reports Server Architecture
- •The Web Reports Server Extension
- •The Seagate Crystal Web Image Server
- •The Seagate Crystal Web Page Server
- •Report Processing
- •Job Manager Overview
- •Seagate Crystal Report Engine Automation Server
- •Visual InterDev Design-time ActiveX Control
- •Using an Existing Report
- •Building a Report at Runtime
- •Editing Active Server Pages
- •Customizing the Crystal Smart Viewer
- •Modifying the Report
- •Session Timeout
- •Sample Web Site
- •Crystal Smart Viewer Overview
- •Features of the Crystal Smart Viewers
- •Printing from the Crystal Smart Viewers
- •Using Crystal Smart Viewers in Applications
- •Crystal Smart Viewer for HTML
- •Limitations of HTML Reports
- •Crystal Smart Viewer for Java
- •Adding the Viewer to a Web Page
- •Crystal Smart Viewer for ActiveX
- •AuthentiCode Certification
- •Adding the Viewer to a Web Page
- •Downloading the Viewer from the Server
- •ActiveX Viewer Example
- •Introduction to the Crystal Report Engine
- •Before using the Crystal Report Engine in your application
- •Using the Crystal Report Engine
- •Crystal Report Engine API
- •Declarations for the Crystal Report Engine API (REAPI)
- •Using the Crystal Report Engine API
- •The Print-Only Link
- •The Custom-Print Link
- •Working with Parameter Values and Ranges
- •Working with section codes
- •Crystal Report Engine API variable length strings
- •Crystal Report Engine API structures
- •Working with subreports
- •Changing report formats
- •Exporting reports
- •PEExportTo Overview
- •PEExportOptions Structure
- •Considerations when using the export functions
- •Handling Preview Window Events
- •Distributing Crystal Report Engine Applications
- •Additional Sources of Information
- •Using the Crystal Report Engine API in Visual Basic
- •When to Open/Close the Crystal Report Engine
- •Embedded Quotes in Visual Basic Calls to the Crystal Report Engine
- •Passing Dates/Date Ranges in Visual Basic using the Crystal Report Engine API Calls
- •Identifying String Issues in Visual Basic Links to the Crystal Report Engine
- •Hard-coded Nulls in Visual Basic User Defined Types
- •Visual Basic Wrapper DLL
- •Crystal ActiveX Controls
- •Adding the ActiveX Control to your Project
- •Using the ActiveX Controls
- •Upgrading from the Crystal Custom Control
- •Crystal Report Engine Automation Server
- •Adding the Automation Server to your Visual Basic Project
- •Using the Automation Server in Visual Basic
- •Object Name Conflicts
- •Viewing the Crystal Report Engine Object Library
- •Handling Preview Window Events
- •Distributing the Automation Server with Visual Basic Applications
- •Sample Applications
- •Active Data Driver
- •Data Definition Files
- •Using the Active Data Driver
- •Creating Data Definition Files
- •Using ActiveX Data Sources at Design Time
- •Crystal Data Object
- •CDO vs. the Crystal Data Source Type Library
- •Using the Crystal Data Object
- •Crystal Data Object Model
- •Crystal Data Source Type Library
- •Creating a new project and class
- •Adding the type library
- •Implementing the functions
- •Passing the CRDataSource object to the Active Data Driver
- •Crystal Data Source Projects
- •Grid Controls and the Crystal Report Engine
- •Bound Report Driver and Bound Report Files
- •Crystal ActiveX Control Properties
- •Creating a Bound Report using the Crystal ActiveX Control
- •Creating a Formatted Bound Report
- •Creating a Formatted Bound Report at Runtime
- •Sample Application
- •ActiveX designers
- •The Report Designer Component vs. Seagate Crystal Reports
- •Data Access
- •No drag and drop between reports – use copy and paste
- •Conditional Formatting
- •Preview Window
- •Pictures
- •Guidelines
- •Subreports
- •The dual formula environment
- •Application Distribution
- •Installing the Report Designer Component
- •System Requirements
- •Installation
- •Using the Seagate Crystal Report Designer Component
- •Adding the Report Designer Component to a Project
- •Selecting Data
- •The Report Expert
- •Adding the Smart Viewer
- •Running the Application
- •CrystalReport1 - The Report Designer Component
- •CRViewer1 - The Smart Viewer Control
- •The Code
- •Report Packages
- •Working with data
- •ADO and OLEDB
- •Connecting to data with ADO
- •Connecting to data with RDO
- •Connecting to data with DAO
- •Data Environments
- •Data Definition Files
- •Report Templates
- •ODBC, SQL, and PC data sources
- •Report Designer Overview
- •Introduction to the Report Designer Component
- •Report Designer Architecture
- •Report Designer Object Model Programming
- •Report Designer Object Model Introduction
- •Obtaining a Report object
- •Displaying the report in the Smart Viewer
- •Setting a new data source for the report
- •Using ReadRecords
- •Passing fields in the correct order
- •Working with secure data in reports
- •Handling the Format event
- •Changing the contents of a Text object
- •Changing OLE object images
- •Working with Sections
- •Working with the ReportObjects collection
- •Working with the FieldObject object
- •Working with the SubreportObject object
- •Working with the Database and DatabaseTables objects
- •Working with the CrossTabObject object
- •Exporting a report
- •The Application object
- •Report events
- •Microsoft Access Sessions
- •Programmatic ID
- •Report Distribution Considerations
- •Distributing reports as part of the application
- •Saving reports as external files
- •Saving data with reports
- •VCL Component Overview
- •Installation
- •Delphi 2
- •Delphi 3 & 4
- •C++ Builder 3
- •Programming Overview
- •Introduction to the Object Inspector
- •Changing Properties in the Object Inspector
- •Changing Properties at Runtime
- •Delphi Programmers introduction to the SCR Print Engine
- •Dealing with SubClass Objects
- •Consistent Code
- •Using the Retrieve method
- •Working with subreports
- •Other Guidelines
- •Programming Tips
- •Always Set ReportName First
- •Discard Saved Data
- •Verify Database
- •Connecting to SQL Servers
- •Changing Tables & Formulas
- •Changing Groups & Summary fields
- •Using the Send methods
- •Using the JobNumber property
- •TCrpeString
- •Introduction
- •TCrpeString VCL Properties
- •Using the TCrpeString
- •Using Variables with Formulas
- •Introduction
- •Examples
- •About Section Names
- •Introduction
- •Methodology
- •StrToSectionCode
- •C++ Builder 3
- •Introduction
- •Code Syntax
- •Additional Code Examples
- •Known Problems
- •Retrieving ParamFields from a Subreport
- •DialogParent and Temporary Forms
- •Technical Support
VCL Component Overview
The Seagate Crystal Reports Component has been designed for the Visual Component Library (VCL) of the Inprise (formerly Borland) Delphi development environment. The Component encapsulates the functionality available in the Seagate Crystal Reports Print Engine DLL(CRPE32.DLL), and can be easily added to any Delphi project and compiled into your final executable application. At this time, the Component is not available in a 16-bit version. Like the Seagate Crystal ActiveX control, the Component provides all the reportprocessing power available in the Seagate Crystal Reports Print Engine for your Delphi projects.
Installation
The following topics are covered in this section.
Delphi 2, Page 194
Delphi 3 & 4, Page 195
C++ Builder 3, Page 198
Delphi 2
Installing the Component
1Select Component | Install from the Delphi Main Menu.
2Select Add from the Install Components Dialog Box.
3Browse Files of type unit (*.DCU).
4Select the UCRPE32.DCU file.
5Click OK (in the Add Module dialog to return to the Install Components dialog). The directory where UCRPE32.DCU is selected will automatically be installed in the Component Search Path.
6Select OK (in the Install Components dialog). When Delphi is finished rebuilding the Component Library, a Crystal Reports icon will appear on the Data Access page of the Component Palette.
Installing the Help file
1Copy the UCRPE32.HLP, UCRPE32.CNT, and UCRPE32.KWF to the Delphi2 Help directory.
2Run the HELPINST.EXE from the Delphi2 Help/Tools directory.
3Choose File | Open and load the DELPHI.HDX file (normally in the Delphi2 Bin directory).
4Click on the + button, or choose Add Keyword File... from the Keywords menu.
5Choose the UCRPE32.KWF file that you copied to the Delphi2/Help directory, and then click OK.
6Choose File | Save and then File | Exit. Context-sensitive help should now be available from the Delphi2 IDE (choosing the F1 key while a property is selected should bring up the appropriate item in the UCRPE32.HLP file).
Seagate Crystal Visual Component Library |
194 |
Delphi 3 & 4
Installing the Component
The Package Collection file, CrystalVCL.dpc, contains all the files required for Delphi 3. If you are using Delphi 4, the Package Collection is called CrystalVCL4.dpc. To install this Package Collection, the following steps should be followed:
1Go to the Component menu, choose Install Packages.
2Choose Add.
3Change the Files of Type extension to Package collection (*.dpc).
4Locate the CrystalVCL.dpc, select it and choose Open.
5Follow the steps in Delphi's Install Package Collection dialog. The install path can be changed, and the Sample App, Help, and Source files are optional and can be de-selected if desired.
When the install process is finished, The Crystal VCL should appear under the Data Access tab of the VCL Component palette.
NOTE: It is also necessary to add the Crystal VCL install path to Delphi's Library Path string (Tools | Environment Options | Library) in order for the Component files to be found by Delphi.
Problems
If another UCRPE32.DCU or CRYSTAL.DPL (CRYSTAL.BPL for Delphi 4) is found in the search path, the package might not install. Since the installation of the package comes after the files have been copied to the hard-drive, they should all be available in the directory chosen during install, and it is not necessary to run the install again. All that needs to be done in this case is to first remove any older copies of the component that Delphi found, and then add the package using one of the three ways described below.
1.The package included (DPL/BPL) can be directly installed.
2.The component (DCU) can be installed into a new package.
3.The component (DCU) can be installed into another package (Not recommended).
Installing the included Package
1Go to the Component menu, choose Install Packages.
2Choose Add.
3Locate the CRYSTAL.DPL (or CRYSTAL.BPL) file and load it.
4Choose OK.
The Crystal VCL should appear under the Data Access tab of the VCL Component palette.
Seagate Crystal Visual Component Library |
195 |
Installing the Component into a new Package
1Go to the Component menu, choose Install Component.
2Choose the Into new package tab.
3Browse the Unit file name to locate the UCRPE32.DCU.
4Browse the Package file name to set the destination for the new package.
5Enter a descriptive line in the Package description area. This description will appear in the list of installed packages.
6Choose OK, then Yes to the prompts that follow.
The Crystal VCL should appear under the Data Access tab of the VCL Component palette.
Installing the Component into an existing Package
This method is not recommended, because if you install the Component into one of the Delphi standard packages, it is quite difficult to get it out of those packages. These are the steps:
1Go to the Component menu, choose Install Component.
2Choose the Into existing package tab.
3Browse the Unit file name to locate the UCRPE32.DCU.
4Choose OK, then Yes to the prompts that follow.
The Crystal VCL should appear under the Data Access tab of the VCL Component palette.
Installing the Help file
With Delphi 3 and 4, and the latest VCL, we have provided a Help Installer program that can be used to automate the process. See the UCRPEHLP.EXE in the HelpInstaller directory. Also, with Delphi 4, another easy way to install context-sensitive Help is by using the built-in OpenHelp installer:
1Copy the UCRPE32.HLP and UCRPE32.CNT to the Delphi 4 Help directory.
2Run Delphi 4 and go to the Help menu. Choose Customize (the OpenHelp installer can also be run outside the Delphi 4 environment by going to the Delphi 4 Bin directory and running OpenHelp.exe).
3With the Contents tab selected, right-click (or go to the Edit menu) and choose Add Files. Locate the UCRPE32.CNT file and add it to the list.
4With the Index tab selected, right-click (or go to the Edit menu) and choose Add Files. Locate the UCRPE32.HLP file and add it to the list.
5Choose File | Save Project.
Seagate Crystal Visual Component Library |
196 |
Installing context-sensitive Help manually with Delphi 3 and Delphi 4
1Copy the UCRPE32.HLP and UCRPE32.CNT to the Delphi Help directory.
2 Load the DELPHI3.CFG file (or DELPHI4.CFG for Delphi 4), located in the Delphi/Help directory, into an editor such as Notepad. At the bottom of the file, you will see something like this:
Third-party Help:
;==============
:Link quickrpt.hlp
:Link teechart.hlp
:Link imagedit.hlp
3 Add the following line to the bottom of the Third-party Help section:
:Link Ucrpe32.hlp
4Save the DELPHI3.CFG (or DELPHI4.CFG) file.
5Load the DELPHI3.CNT (or DELPHI4.CNT) file (located in the Delphi/Help directory) into an editor such as Notepad. At the top of the file you will see something like this:
:Base delphi3.HLP>main :Title Delphi Help
; Index section ;==============
:Index VCL Object and Component Reference=vcl3.hlp
:Index Object Pascal Reference=obpascl3.hlp
At the bottom of the Index section add the following line: :Index Crystal Reports Component Help=ucrpe32.hlp
6Go to the bottom of the DELPHI3.CNT (or DELPHI4.CNT) file and you should see an "Include section" something like this:
;Include section
;================ :include vcl3.cnt :include obpascl3.cnt :Include win32sdk.toc :Include winhlp32.cnt
At the bottom of the Include section add the following line: :Include ucrpe32.cnt
Seagate Crystal Visual Component Library |
197 |