Frequently Asked Questions
Advantage Crystal Reports Driver
What is the Advantage Crystal Reports Driver?
What versions of Crystal Reports are supported?
What file formats are supported by the Advantage Crystal Reports Driver?
How do I access .DBF tables with .NTX index with the Advantage Crystal Reports
Driver?
How much does the Advantage Crystal Reports Driver cost?
How do I get the Advantage Crystal Reports Driver?
Does the Advantage Crystal Reports Driver work with the Advantage Database
Server and the Advantage Local Server?
What files do I have to distribute with my reports?
How do I convert existing ODBC reports to use the Advantage Crystal Reports
Driver for Crystal Reports versions 6, 7, and 8?
How do I convert existing BDE reports to use the Advantage Crystal Reports
Driver for Crystal Reports versions 6, 7, and 8?
Does the Advantage Crystal Reports Driver use the Advantage SQL engine?
Should I use the Advantage Crystal Reports Driver or the Advantage ODBC Driver
for my reports?
Does the Advantage Crystal Reports Driver work with Seagate Analysis?
How do I change the Advantage alias a report is currently using?
How do I change the Advantage locking mode with the Crystal Reports Driver?
How do I change the Advantage Character Type with the Crystal Reports Driver?
How do I change the Advantage rights checking mode with the Crystal Reports
Driver?
How do I make Crystal show deleted records in a .DBF table with the Crystal
Reports Driver?
Why can't I find my Advantage aliases in Crystal Reports?
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 1 of 7
FAQ - Advantage Crystal Reports Driver
What is the Advantage Crystal Reports Driver?
The Advantage Crystal Reports Driver provides developers with a native interface to the
Advantage Database Server and Advantage Local Server for Crystal Decisions’ Crystal
Reports reporting tool. The Advantage Crystal Reports Driver utilizes the Advantage
SQL engine to provide ODBC-free access to the Advantage Database Server and
Advantage Local Server through Crystal Reports and moves all SQL processing to the
server when using the Advantage Database Server.
What versions of Crystal Reports are supported?
The Advantage Crystal Reports Driver supports Crystal Reports version 6, version 7
MR1 (Maintenance Release 1), version 8, and version 9.
What file formats are supported by the Advantage Crystal Reports Driver?
Advantage supports three file formats. One is an Advantage proprietary format; the other
two are Xbase formats. The Advantage proprietary format is a non-Xbase ISAM, recordbased file format. The Advantage proprietary file format supports many features that are
not possible in Xbase formats and is fully optimized for use by Advantage. The
Advantage proprietary format consists of .ADT tables, .ADI index files, and .ADM memo
files. The two Xbase file formats that Advantage supports are CA-Clipper-compatible file
types and FoxPro-compatible file types. The CA-Clipper-compatible file format consists
of .DBF tables, .NTX index files, and .DBT memo files. The FoxPro-compatible file
format consists of .DBF tables, .CDX and .IDX index files, and .FPT memo files. The
Advantage Xbase file formats are fully compatible with non-Advantage database drivers
that support CA-Clipper-compatible and FoxPro-compatible file formats. The Advantage
Crystal Reports Driver supports access to all Advantage file formats.
How do I access .DBF tables with .NTX index with the Advantage Crystal Reports
Driver?
To gain access to .DBF tables and .NTX index files, create a database (defined in an
Advantage Data Dictionary) and add the tables and the associated .NTX index files to
that database. Then obtain a connection to that database (data dictionary) and use
those .DBF tables as you would normally use any other tables. The .NTX index files will
then get automatically opened when the corresponding .DBF table is opened. You can
use the Advantage Data Architect to create a database and Advantage Data Dictionary.
How much does the Advantage Crystal Reports Driver cost?
The Advantage Crystal Reports Driver is free.
How do I get the Advantage Crystal Reports Driver?
The Advantage Crystal Reports Driver is available as a free download via the Advantage
Database Server Web site Downloads page,
http://www.AdvantageDatabase.com/ADS/Evaluate+Today/Free+Downloads.htm. The
Advantage Crystal Reports Driver can also be downloaded from the Advantage
Developer Zone Web site, http://DevZone.AdvantageDatabase.com, in the Downloads
page.
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 2 of 7
FAQ - Advantage Crystal Reports Driver
Does the Advantage Crystal Reports Driver work with the Advantage Database
Server and the Advantage Local Server?
Yes. The ADS_SERVER_TYPE key in the ADS.INI file can be used to select the
Advantage server type(s) to use when obtaining an Advantage server connection. The
available Advantage Server types are ADS_REMOTE_SERVER which is the Advantage
Database Server, ADS_AIS_SERVER which is for Advantage Internet Server
functionality, and ADS_LOCAL_SERVER which is the Advantage Local Server. These
Advantage server type constants are defined in the ACE.H, ACE.PAS, and ACE32.BAS
files. ADS_REMOTE_SERVER has the value 2, ADS_AIS_SERVER has the value 4,
and ADS_LOCAL_SERVER has the value 1. For example, if you wanted your
Advantage application to attempt to connect to all Advantage server types, if necessary,
you need to set the value for the ADS_SERVER_TYPE key to 7 (1 + 2 + 4 = 7). The
default ADS_SERVER_TYPE value is to use ADS_REMOTE_SERVER and
ADS_AIS_SERVER, which is 6 (2 + 4 = 6).
What files do I have to distribute with my reports?
The following Advantage-specific files must be included in your report distribution:
• P2SADS.DLL (Advantage Crystal Reports Driver DLL for Crystal Reports versions
6, 7, and 8 only)
• CRDB_ADS.DLL (Advantage Crystal Reports DLL for Crystal Reports versions 9
only)
• ADS.INI - This is the most important file to note, as Crystal will not detect this file as
being necessary for the report, so you must manually add this file to your distribution.
• ACE32.DLL (Advantage Client Engine DLL)
• AXCWS32.DLL (Advantage communication layer DLL required if using the
Advantage Database Server)
• ADSLOC32.DLL (Advantage Local Server DLL required if using the Advantage Local
Server)
• ADSLOCAL.CFG (Advantage Local Server configuration file recommended if using
the Advantage Local Server)
NOTE: These files must be in the application folder or in the client search path.
How do I convert existing ODBC reports to use the Advantage Crystal Reports
Driver for Crystal Reports versions 6, 7, and 8?
To convert an existing ODBC report to use the Advantage driver follow these steps:
1. Open the report.
2. Choose 'Database' from the main menu.
3. Choose 'Convert Database Driver...' from the Database menu.
4. Check the 'Convert Database Driver on next Refresh' checkbox.
5. Find and select pdsads.dll in the drop-down list.
6. Click OK
7. If the Advantage Alias dialog does not appear immediately press the F5 key to force
a refresh.
8. You will be prompted for an Advantage alias to use in this report. Either select an
existing alias from the list provided, or click New to create a new alias. NOTE - If
converting from a Paradox ODBC data source do not check the 'Converting Report
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 3 of 7
FAQ - Advantage Crystal Reports Driver
From BDE Driver' checkbox. That checkbox is only for reports that were previously
using pdbbde.dll.
9. Click OK
10. Crystal may report that the base tables have changed and ask you if you want to fix
up the report. Click Yes for each table.
11. If you have modified the original SQL statement in your report for some reason
(possibly to make it work with the Advantage ODBC driver, for example), it is best to
restore the statement to its original format. To do this:
a) Choose 'Database' from the main menu
b) Choose 'Show SQL Query...' from the Database menu
c) Click Reset
d) Refresh the report data (press F5)
How do I convert existing BDE reports to use the Advantage Crystal Reports
Driver for Crystal Reports versions 6, 7, and 8?
To convert an existing BDE report that is currently using pdbbde.dll follow these steps:
1. Disable "smart" linking.
a) Choose 'File' from the main menu
b) Choose 'Options'
c) Select the 'Database' tab
d) Uncheck the 'Auto-SmartLinking' option
2. Open the report
3. Choose 'Database' from the main menu
4. Choose 'Convert Database Driver...' from the Database menu
5. Check the 'Convert Database Driver on next Refresh' checkbox
6. Find and select pdsads.dll in the drop-down list
7. Click OK
8. If the Advantage Alias dialog does not appear immediately, press the F5 key to force
a refresh.
9. You will be prompted for an Advantage alias to use in this report. Either select an
existing alias from the list provided, or click New to create a new alias.
10. Check the 'Converting Report From BDE Driver' checkbox
11. Click OK. An informational dialog will be shown reminding you to change each link in
your report to the 'outer join' type. See the note below for an explanation.
12. Crystal will report that the base tables have changed and ask you if you want to fix
up the report. Click Yes for each table.
NOTE: All links in the report must be converted to the 'outer join' link type in order to
emulate the BDE flat file driver linking behavior. The BDE flat file driver (pdbbde.dll)
includes all rows in a parent table in the result set, even if a matching key value does not
exist in the child table(s). This is equivalent to an SQL left outer join. By default the
Advantage Crystal Driver uses standard SQL joins (inner joins) and will not return rows
unless they have matching keys in the child table(s). For this reason, all links in a report
previously built using the pdbbde driver must be converted to left outer join links in order
to return the same results the original report returned.
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 4 of 7
FAQ - Advantage Crystal Reports Driver
Follow these steps to change each link type:
1. Choose 'Database' from the main menu
2. Choose 'Visual Linking Expert...' from the Database menu
3. For each link in the report do the following:
a) Select the link by clicking on the link line
b) Click the 'Options...' button
c) Change the 'SQL Join Type' from 'Equal' to 'Left Outer'
4. Close the Visual Linking Expert
NOTE: Crystal Reports will leave the .db file extension on tables referenced in the
report, even after a database conversion has been completed. The Advantage driver
uses the table base name in all instances, so this extension will not affect the report
generation or functionality.
Does the Advantage Crystal Reports Driver use the Advantage SQL engine?
Yes. The SQL statement for the report is generated by Crystal Reports, and the
Advantage Crystal Reports Driver sends this statement to the Advantage Database
Server or Advantage Local Server SQL engine.
Should I use the Advantage Crystal Reports Driver or the Advantage ODBC Driver
for my reports?
Both drivers utilize the Advantage SQL engine, so performance should be nearly
identical. However, the Advantage Crystal Reports Driver is much easier to deploy. The
Advantage Crystal Reports Driver uses one simple INI file for alias configuration, where
ODBC drivers require each client machine's ODBC datasource be configured.
Does the Advantage Crystal Reports Driver work with Seagate Analysis?
No. Seagate Analysis does not attempt to load external database drivers, as Crystal
Decisions’ Crystal Reports does. Because of this design, the Advantage Crystal Reports
Driver is never loaded. Seagate Analysis does, however, load ODBC drivers. This
means the Advantage ODBC driver can be used from Seagate Analysis.
How do I change the Advantage alias a report is currently using?
If a report is currently set up to use the Advantage Crystal Reports Driver, and you need
to change the alias it is using, simply perform a database conversion over again. Follow
the steps provided in the 'converting existing reports,,,' FAQs above, and when
prompted for the Advantage alias to use, select the new alias. This will replace the old
alias specification, and the report will now utilize the new alias.
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 5 of 7
FAQ - Advantage Crystal Reports Driver
How do I change the Advantage locking mode with the Crystal Reports Driver?
By default, the Advantage Crystal Reports Driver uses the Advantage Proprietary
Locking mode. If other Advantage applications are accessing your .DBF data using
compatibility locking mode, or non-Advantage applications have your .DBF data opened
in a writable mode when attempting to open data files or execute reports with the
Advantage Crystal Reports Driver, an error will occur when using the default proprietary
locking mode. To force the Advantage Crystal Reports Driver to use the Advantage
Compatible Locking mode with .DBF tables, add the following two lines to your ads.ini
file:
[Crystal]
LockingMode=0 ; Proprietary locking = 1, Compatible locking = 0
Note: The LockingMode setting only applies to .DBF tables, not .ADT tables.
How do I change the Advantage Character Type with the Crystal Reports Driver?
By default, the Advantage Crystal Reports Driver uses the ADS_ANSI character type
when opening .DBF tables. To force the Advantage Crystal Reports Driver to use the
ADS_OEM character type, add the following two lines to your ads.ini file:
[Crystal]
CharType=2 ; ADS_ANSI=1 ADS_OEM=2
Note: The CharType setting only applies to .DBF tables, not .ADT tables.
How do I change the Advantage rights checking mode with the Crystal Reports
Driver?
By default, the Advantage Crystal Reports Driver uses the ADS_CHECKRIGHTS option
for rights checking on all statements. To force the Advantage Crystal Reports Driver to
use the ADS_IGNORERIGHTS option, add the following two lines to your ads.ini file:
[Crystal]
RightsChecking=2 ; ADS_CHECKRIGHTS=1 ADS_IGNORERIGHTS=2
How do I make Crystal show deleted records in a .DBF table with the Crystal
Reports Driver?
By default, the Advantage Crystal Reports Driver filters out deleted .DBF records. To
force the driver to show deleted records, add the following two lines to your ads.ini file:
[Crystal]
ShowDeleted=1 ; ShowDeleted = 0 means do not show deleted records
Note: The ShowDeleted setting only applies to .DBF tables, not .ADT tables.
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 6 of 7
FAQ - Advantage Crystal Reports Driver
Why can't I find my Advantage aliases in Crystal Reports?
If your ads.ini file is configured correctly, and you still don't see any Advantage aliases in
the Crystal Report designer, there is most likely a version mismatch with the Advantage
Client Engine (ACE32.DLL). Verify the following DLLs are all the same version:
• p2sads.dll (Crystal Reports versions 6, 7, and 8 only)
• crdb_ads.dll (Crystal Reports version 9 only)
• ace32.dll
• axcws32.dll
• adsloc32.dll
www.AdvantageDatabase.com
800-235-7576 ext. 5030
Page 7 of 7
Download PDF
Similar pages