Running The Interactive Debugger; The Debugger Toolbar - MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION STUDIO Use Manual

86

Running the Interactive Debugger

Running the debugger helps you find problems in code by tracing the way ColdFusion
evaluates the page, step by step. You do this by placing breakpoints in the page to stop
execution of the page, and then step through subsequent lines of code, checking the
values of variables and expressions to make sure the code is behaving as you'd expect.
After you've set up remote development settings and file mappings, you can use the
commands on the Debug menu and the Debug toolbar to run the debugger.

The Debugger toolbar

Note
To run the interactive debugger:
1. Open the first page in the application you want to debug.
The Debug toolbar appears at the bottom of the application window. You can
undock the toolbar by double-clicking on the undock bars on the left-hand side of
the toolbar, drop it into the QuickBar, or keep it docked.
2. In your ColdFusion application page, set breakpoints in your code by clicking in
the gutter on the left side of the editor window.
The breakpoint lines are colored red. Choose Debug > Toggle Breakpoints to turn
breakpoints on and off. Use Debug > Clear Breakpoints to delete all breakpoints in
the current document.
3. In the Debug toolbar, hit the Start/Continue tool.
The Remote Development Settings dialog box appears. It shows the default local
server.
4. Specify the Start URL, which is the URL you use to view the page, and click OK. The
list box shows the pages currently open in ColdFusion Studio.
Enter a fully qualified file path relative to your local ColdFusion server -- for
example, http://127.0.0.1/SomeServerPath/index.cfm.
The Debug Start dialog box displays every time you press the Start button in the
Debugger. Use the check box on the Debug Start pane to disable the display of this
box the next time you hit the Run button.
Whenever possible, the Studio tries to calculate the URLs of open file using the RDS
development mappings, which you can set in the Mappings tab. These mappings
are also required to develop on remote servers.
Based on the RDS Security settings at your site, you'll see a login prompt to access
protected resources.
You cannot debug encrypted CFML templates.