Progress
Results Administration
and Development Guide


Converted Information

This section describes the information that the Converter converts from character-based to graphical format. The Converter converts the following information:

NOTE: Before converting your files, note that the graphical Results procedure library (aderes.pl) and the Converter r-code ($DLC/gui) must be in your PROPATH.

File Conversions

When the Converter converts Progress Version 6 or Version 7 character-based files, it converts them to the closest Progress Version 9 graphical equivalent.

Table 5–1 lists the original character-based files and their graphical equivalents.

Table 5–1: File Conversions
Character-based File
Description
Graphical
File
Description
table-name.f
table-name.i
table-name.p 
Files generated when the application is built. There is a set of three files for each table in the database.
A form view QUE0000n.p is created for each set of files per table name. They are added to the public.qd7 directory.
N/A
database.QC 
Configuration file
database.QC7 
Configuration file
username.QD 
Query directory that contains the list of queries created by username.
username.QD7 
Query directory that contains the list of queries created by username.
EXP0000n.p 
Export view queries
QUE0000n.p 
No distinction in name for queries in different views. The query type is now part of the file information.
LBL0000n.p 
Label view queries
REP0000n.p 
Report view queries
RES0000n.r 
Fastload files that contain application information in compiled form that speeds up load time.
bases.r
baser.r
base00n.r
basef.r
basemt.r 
Fastload files. By default, the Fastload name is the first five characters of the logical database name with additional characters to indicate the specific function.

Printer Information

For each printer definition, the Converter creates a feature and adds it to the Results Query Print menu. The printer type dictates how the information is converted. Table 5–2 lists the printer conversion information.

Table 5–2: Printer Conversion
Printer Type
Character-based Description
Graphical Conversion
TERMINAL
Print Preview.
No conversion, Print Preview.
FILE
Print to a file.
No conversion, Print File.
PRINTER
Print to default printer.
No conversion, Print Printer.
term
TERMINAL, Output to Terminal Paged.
No conversion, Print Preview.
to
TO, Output to Printer/File.
Create feature, connect to u-to.p or u-cto.p.
thru
THROUGH a spooler or filter.
No conversion because this definition is not supported in Windows.
view
Send the report to a file and execute the application’s 4GL.
Create feature, connect to u-pview.p.
page
To a screen with next-prev page support.
No conversion, Print Preview.
prog
Send procedure file to application’s 4GL program to start/end output stream.
Create feature, connect to u-pprog.p.
file
Ask the user for filename, then send the output to the file.
No conversion, Print File.

Auto Selection of Label Fields

The label field information in the configuration file converts without any changes.

Module and Query Function Permissions

Module permission provides site security for each module. Query function permissions provide security for each type of query. The Converter converts both types of permissions and adds the information to the security portion of the graphical configuration file. When there is no corresponding graphical feature for a character-based feature, the Converter does not convert the character-based feature. Table 5–3 lists the query feature conversions.

Table 5–3: Query Feature Conversions
Character-based Feature
Graphical Feature
query-add
Record Add
query-browse
Browse View
query-copy
Copies a record
query-delete
Record Delete
query-exit
Exit
query-first
N/A
query-help
Help menu
query-info
N/A
query-join
Joins to related records
query-last
N/A
query-module
Each type of View
query-next
N/A
query-order
Switches to a different sort index
query-prev
N/A
query-query
QBE for a form
query-total
Calculates the total number of records in the current set
query-update
Record Update
query-user
N/A
query-view
File Open
query-where
Selection

Report Layout

The report layout portion of the configuration file sets the default layout for a report. The converter converts all of this information, except for the header and footer information.

Relationships

The relationships portion of the configuration file identifies the relationships or joins for an application. All of this information converts to the graphical version of the configuration file.

View Files

The graphical and character-based versions of Results use the same basic techniques for saving query information. Both versions include a comment holding the query information at the beginning of a form, label, or export file. Both versions read this section to lay out the view in the user interface.

However, while both version have these similarities, the following differences exist between the two versions:

Queries

The converter uses the character-based query directory file as an index to find all the user queries when it converts them.


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