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:
- Image files
- Memo files
- Database files
- Report libraries
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
|
–
|