Progress
ADM 2 Guide
Reviewing Conversion Results
This section describes the specific changes that occur when converting Version 8 SmartObjects to Version 9 SmartObjects. The changes that it describes include Version 8 to Version 9 SmartObject conversions, specific ADM file-conversion changes, and additional conversion changes.
Table B–5 lists the Version 8 to Version 9 SmartObject file conversions that the Conversion Utility attempts to perform.
Table B–6 identifies specific Version 8 to Version 9 file conversion changes.
NOTES: A variable that contains a list is not converted. You must write your own get and set property functions for any customized attributes.Some common Version 8 ADM attribute names are automatically converted to the corresponding Version 9 ADM property names (for example, Current–Page to Current Page), based on entries in the fileprotools/v89names.dat
. You can extend this list as described in the "Customizing the Conversion Utility" section.This list identifies operations that the Conversion Utility performs for all converted files:
- Removes the following prefixes from procedures and procedure dispatches:
- Replaces all strings found in the “++ Old Name” column of
protools/v89names.dat
file with the corresponding string in the “++ New Name” column.- Removes all procedures and attribute references found in the
protools/v89names.dat
file “++ Remove List.”- Replaces local–exit procedures with exitObject procedures.
- Edits the ADM–SUPPORTED–LINKS preprocessor to reflect the Version 9 link types.
- When TABLES–IN–QUERY–... and ENABLED–TABLE–IN–QUERY... have more than one table, generates SECOND–TABLE–IN–QUERY–..., SECOND–ENABLED–TABLE–IN–QUERY ... preprocessors up to the TENTH–TABLE... .
- When converting a SmartViewer or SmartBrowser, generates an include file with a reasonably appropriate set of field definitions for the Version 9 SmartDataObject RowObject temp–table and flagged with an &MESSAGE statement to indicate that it should be replaced with an include file from an appropriate SmartDataObject.
- Removes external table definitions.
- If a procedure is dispatched inside of an instance of itself (for example, dispatching abc inside local–abc), converts this to RUN SUPER syntax.
- Converts Init–Object procedures to constructObject procedures. This includes the conversions of variable attributes to their new Version 9 names. For example, Layout becomes ObjectLayout, Edge–Pixels becomes EdgePixels, SmartPanelType becomes PanelType, Right–to–Left becomes RightToLeft, and so forth.
- Converts the procedure settings to the new Version 9 format. These new formats are required by the AppBuilder to re-establish the correct state when reading the
.w
file.- Creates appropriate field definitions in the Runtime Attribute Settings when converting a Version 8 SmartQuery to a Version 9 SmartDataObject.
- Converts states based on the values of the cStateVals and cStateProps variables in the
_convt89.p
procedure.- Removes the entire Method Library section and replaces it with the appropriate Version 9 include files based on the type of object to which it is being converted. The utility determines this by reading the Version 8 template type found in the Definitions section, as shown:
If the utility does not find this line, the SmartObject cannot be properly converted. Be sure to restore the line in the Definitions section before attempting the conversion.
If a SmartObject has Version 8 custom method libraries that you need to retain, you will need to re-insert them after the conversion. Generally, you will have to convert these custom method libraries, as they might not work in Version 9.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |