Progress
Report Builder
User’s Guide


Report Builder Search Rules

Because Report Builder supports relative pathnames, you must understand the Report Builder search rules so that you know where Report Builder looks for files.

This section describes the locations and order in which Report Builder and Report Engine search for the following files:

The following sections describe the search order and locations for each type of file. Each section contains a table that lists the path specification, then the locations where Report Builder and Report Engine search for the files. Grayed areas in the tables indicate that Report Builder and Report Engine do not search the specified location. “N/A” indicates that you cannot specify the path in that manner.

Image Files

Table A–5 lists the search order and locations where Report Builder and Report Engine search for image files.

Table A–5: Image File Search Order 

Path Specification
First
Location
Second Location
Third
Location
Absolute path specified in report definition
(drive:\path\filename)
Specified
drive:\filename
Specified filename in default directory
Specified filename in current working directory
Relative path specified in report definition
(path\filename)
Specified path\filename relative to default image directory
Specified path\filename relative to current working directory

Memo Files

Table A–6 lists the search order and locations where Report Builder and Report Engine search for memo files.

Table A–6: Memo File Search Order 

Path Specification
First
Location
Second Location
Third
Location
Absolute path specified in report definition (drive:\path\filename)
Specified drive:\path\filename
Specified filename in current working directory
Relative path specified in report definition (path\filename)
Specified path\filename relative to current working directory
Absolute path specified using Report Engine parameter (drive:\path\filename in RB-MEMO-FILE)
Specified drive:\path\filename
Specified filename in current working directory
Relative path specified using Report Engine parameter (path\filename in RB-MEMO-FILE)
Specified path\filename relative to current working directory

Database Files

Table A–7 lists the search order and locations where Report Builder and Report Engine search for local database files.

Table A–7: Database Files Search Order 

Path Specification
First
Location
Second Location
Third
Location
Absolute path specified in report definition
(drive:\path\filename)
Specified drive:\path\filename
Relative path specified in report definition
(path\filename)
Specified path\filename relative to current working directory
Absolute path specified using Report Engine parameter
(drive:\path\filename in RB-DB-CONNECTION)
Specified drive:\path\filename
Relative path specified using Report Engine parameter
(path\filename in RB-DB-CONNECTION)
Specified path\filename relative to current working directory

Notice that Report Builder does not search the default database directory for a database file. The default database directory setting is used only to specify the directory that initially appears in the Find Database dialog box in Report Builder.

Report Libraries

Table A–8 lists the search order and locations where Report Builder and Report Engine search for report libraries.

Table A–8: Report Library Search Order 

Path Specification
First
Location
Second Location
Third
Location
Absolute path specified in Report Builder
(drive:\path\filename)
Specified drive:\path\filename
Relative path specified in Report Builder
(path\filename)
N/A
N/A
N/A
Absolute path specified using Report Engine parameter
(drive:\path\filename in RB-REPORT-LIBRARY)
Specified drive:\path\filename
Relative path specified using Report Engine parameter
(path\filename in RB-REPORT-LIBRARY)
Specified path\filename relative to default library directory
Specified path\filename relative to current working directory


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095