Compiling form scripts

This utility compiles all scripts associated with a form, including form procedure scripts, form function scripts, form pre and post scripts, window scripts, scrolling window scripts, and all field scripts. Use this utility in the following situations:

• If you used the Transfer Window utility to transfer a window into a dictionary, use the Compile Form Scripts utility to compile the scripts for the window.
• If you transferred forms into a dictionary using the Transfer Resources utility, but didn’t have the Compile Scripts option marked, you’ll use the Compile Form Scripts utility to compile those scripts.
• If you transferred resources into a dictionary using the Transfer Resources utility, but some scripts didn’t compile because resources were missing from the destination dictionary, use the Compile Form Scripts utility to compile the uncompiled scripts after the missing resources have been included.
• Before you send out an application, it’s a good idea to compile all scripts using the Compile Form Scripts utility. This ensures that all resources referenced by scripts are included in the dictionary, that the latest version of scripts are being used, and that scripts don’t contain syntax errors.

To begin compiling scripts for a form, select an editable dictionary, then choose Compile Form Scripts from the Scripts menu to display the Compile Form Scripts window.

1. Select a series.

Select the series that includes the form for which scripts are being compiled. The forms in that series will appear in the Forms list.

2. Select compiling options.

The following options control how the scripts will be compiled.

Compiler Errors Only   Mark this option to include only compiler error messages in the status report that is printed after the scripts are compiled. Otherwise, all status messages will be saved to the report.

Compile Debug   Mark this option to include debugging information in scripts, and to compile the debug and assert statements in your code. If you don’t mark this option, you won’t be able to use the Script Debugger, and the debug and assert statements won’t be executed. We recommend unmarking this option in the final version of your application to ensure optimal script performance.

3. Select scripts to compile.

Select the scripts you want to compile by selecting each form name and clicking Insert to add it to the list of selected forms. Double-clicking your selection will perform the same function. You can select and compile scripts from several series at one time. If you want to compile scripts for all forms in the selected series, click the Insert All button. You can use the Remove and Remove All buttons to remove forms from the Selected Forms list.

4. Compile scripts.

Click the Compile button to compile the scripts for the selected forms. The Report File Name dialog box will appear. Enter the name and location for the Compile Form Scripts Status Report file, then click OK to continue the compiling process, or click Cancel to return to the Compile Form Scripts window.

5. Use the status report to verify that scripts compiled.

Once compiling is complete, the status report will be printed to a text file. This report lists each script along with a message that indicates whether the script was compiled successfully. If the script wasn’t compiled successfully, the message will indicate the compiler error that occurred. If you mark Compiler Errors Only, only information about scripts that couldn’t be compiled will appear in the report.

Documentation Feedback

---