Business Objects's Crystal Reports is one of the leading report writers delivering Windows reports. For more information on this product visit the Crystal Reports web site at www.businessobjects.com.
Clarion's Crystal Report interface is comprised of templates, libraries, and DLLs that communicate with Crystal Reports, versions 8 or 9 (see below). The DLL is accessed by a Class Interface and is hooked to your application using simple standard Clarion code. This interface allows a seamless integration of previously defined Crystal reports within a Clarion application. The Crystal report engine accesses data and creates the report. The report can be previewed in a Clarion window.
Clarion's Crystal Reports implementation is compatible with both the ABC and Legacy templates. It can only be used in 32-bit applications.
Crystal Reports Files
The files that make up Clarion's Crystal Reports interface are:
Clacr8.inc Crystal Class Definition
Clacr8L.inc Crystal Class Definition Local Compile
Clacr8.tpl Templates
Clacr8.lib Crystal LIB
Clacr8L.lib Crystal Local LIB
Clacr8.dll Crystal DLL
Files to Distribute
To distribute an application that includes the Crystal Report interface, the following files must be distributed.
Clacr8.dll Crystal DLL
This DLL file must be included in distribution when an application is compiled using the Standalone (ClaRUN.DLL) Run-Time library.
Other Runtime Distribution Files
According to the latest Crystal Reports documentation (Version 9), the required runtime files for an application developed using the Crystal Report Print Engine API (crpe32.dll) are listed below.
The Crystal Reports Print Engine is now considered a legacy API and will no longer expose calls for any the new features included in Crystal Reports. For more information, see “Retired Developer APIs” in Crystal Reports Developer's Guide (CrystalDevHelp.chm).
File Developer/Distribution Locations Description
(Locations are the same unless listed separately.)
crpe32.dll \Program Files\Common Files\Crystal Decisions\2.0\bin Interface to the Crystal Report Engine
crqe.dll \Program Files\Common Files\Crystal Decisions\2.0\bin Crystal Query Engine
Implode.dll \Program Files\Common Files\Crystal Decisions\2.0\bin Compression Library
msvcrt.dll \Windows\system32 or \WINNT\system32 (NT only) Microsoft (R) C Runtime Library
querybuilder.dll \Program Files\Common Files\Crystal Decisions\2.0\bin Crystal Query Builder
riched20.dll \Windows\system32 or \WINNT\system32 (NT only) Rich Text Edit Control, v3.0
ufmanager.dll \Program Files\Common Files\Crystal Decisions\2.0\bin Manager for loading UFL's
unicows.dll See the note below. Unicode Layer for Win9x
usp10.dll \Windows\system32 or \WINNT\system32 (NT only) Uniscribe Unicode script processor
The following DLLs need only be included under these circumstances:
Include Implode.dll only for applications using reports created in versions previous to Crystal Reports 8.
Include unicows.dll only for applications installed on Win9x machines. Due to licensing restrictions, you must get unicows.dll from the Microsoft web site.
Go to http://www.microsoft.com/msdownload/platformsdk/sdkupdate/default.htm? and select “Microsoft Layer for Unicode on Windows 95/98/ME Systems (MSLU) version 1.0”.
If your application uses any of the following functions,
CrPEExportToDisk CrPEExportToExch crPEExportToMapi
CrPEExportToHTML CrPEExportToODBC crPESelectPrinter
CrPEGetSelectedPrinter
you must include:
crwrap32.dll \Program Files\Common Files\Crystal Decisions\2.0\bin
Print Engine Wrapper (intended as a sample of how to prototype structured calls for languages that do not support structures)
See your Crystal Reports Documentation for any additional runtime requirements.