Updating forms and reports dictionaries

If customers use the Modifier to modify your application’s forms, or the Report Writer to modify your application’s reports, you need to ensure that the forms and reports dictionaries for your application are updated propery. Otherwise, your application may not operate correctly.

Forms dictionary

During the unchunking process, resources in the forms dictionary are updated to make them compatible with the application dictionary. If the user has made any modifications to forms, as many of those changes as possible will be preserved.

Reports dictionary

Updating the reports dictionary is a two-step process. During the unchunking process, resources in the reports dictionary are updated to make them compatible with the application dictionary. The second part of the updating process must be performed by executing the Dict_UpdateReportsDictionary() function. This portion of the report update uses an “input” file that describes how to handle database changes that affect reports. You can also run this portion of the update without using an input file. This is beneficial, because the second portion of the report update performs some “cleanup” operations on the reports dictionary.

We recommend that you call the Dict_UpdateReportsDictionary() function from your install script. Doing so allows the entire update process to be performed immediately after unchunking, making it just a single step for the user installing the update.


Documentation Feedback