56 FileMaker Pro Advanced Development Guide
Note In order to facilitate proper script debugging, the Script
Debugger overrides some script steps. The Allow User Abort script
step with the option set to off will not prevent you from stopping the
execution of a script. The Adjust Window script step with the options
of hide or minimize will not hide or minimize the window when
encountered through the Step or Step Into buttons.
Viewing sub-scripts
You can view sub-scripts when you step through scripts in the Script
Debugger. For example, if Script A calls Scripts B, which then calls
Script C, you can view the steps in all three scripts.
To view sub-scripts:
1. Enable the Script Debugger. See “Stepping through scripts” on
page 55.
2. Select a script step that calls a sub-script.
3. Click the Step Into button.
The Active Scripts list displays the sub-script.
4. Select a script in the Active Script list to view that script’s steps in
the display area.
Note The Set Next Step feature is only available for the currently
executing script.
Choose To
Step Execute the script one step at a time.
If the script step is Perform Script, the Script Debugger
will execute the sub-script and proceed to the next line of
the calling script. The Script Debugger will execute all
sub-script steps until it encounters a breakpoint.
Step Into Execute the script one step at a time.
If the script step is Perform Script, the Script Debugger
will step to the first line of the sub-script and await user
input before proceeding to the next sub-script step.
Step Out Execute all script steps in the current script and, if the
script is a sub-script, return to the line after the Perform
Script step in the calling script.
If the script is not a sub-script, the Step Out command will
cause the Script Debugger to execute all script and sub-
script steps until it encounters a breakpoint.
Run Execute all script steps until a breakpoint is encountered.
Halt Script Halt execution of a script and close Script Debugger.
Set Next Step Set the step execution pointer to the highlighted script step.
This command passes control to the highlighted step but
does not perform the step. The highlighted step is
performed when script execution is resumed. Any script
steps between the last executed step and the assigned next
step are not executed. Click a step to highlight it, then click
the Set Next Step button.
Set/Clear
Breakpoint
Set or clear a breakpoint from the selected line.
Breakpoints can be set or cleared from the Script Debugger
or from ScriptMaker. Breakpoints are saved with the file
that contains the script. Breakpoints are ignored by
FileMaker Pro and when the Script Debugger is not in use.
Breakpoints allow the Script Debugger to perform large
sections of the script that do not need to be looked at
closely.
Remove
Breakpoints
Clear all the breakpoints from the current script.
The Remove Breakpoints command is only available by
choosing Tools menu > Debugging Controls.
ScriptMaker Halt script execution and open ScriptMaker so you can edit
the script.
Data Viewer Open (or close) the Data Viewer window so you can
monitor specified fields, variables, and calculations.
Choose To
