User manual MACROMEDIA COLDFUSION STUDIO 5-USING COLDFUSION 5 STUDIO

[. . . ] CFS_MANCVRPG_live. fh9 10/1/01 12:37 PM Page 1 C M Y CM MY CY CMY K macromedia ® Using ColdFusion 5 Studio COLDFUSION®5 STUDIO ® macromedia ® Composite Copyright Notice Copyright 2001 Macromedia, Inc. Macromedia, the Macromedia logo, ColdFusion, Dreamweaver, Dreamweaver UltraDev, Flash, HomeSite, JRun, Quick Tag Editor, Roundtrip, and what the web can be are trademarks or registered trademarks of Macromedia, Inc. Microsoft, Windows, Windows NT, Windows 98, Windows ME, Windows XP and Windows 2000 are registered trademarks of Microsoft , Corporation. Other brand names may be trademarks or registered trademarks of others. This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. [. . . ] For information on debugging ColdFusion applications, see Developing ColdFusion Applications. Contents · Overview of the Interactive Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 · Setting up a Debugging Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 · Using the Interactive Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 118 Chapter 9 Debugging Application Code Overview of the Interactive Debugger You can run the debugger against your application pages to find errors in your code, when Remote Development Services (RDS) is enabled and a server mapping is defined. The debugger lets you perform these tasks: · Set breakpoints and watches · Evaluate variables and expressions · Step through lines of code · Investigate the code stack · Monitor recordsets · Observe variables in all scopes To run debugging processes, use the Debug menu or the Debug toolbar. Setting up a Debugging Session These are the tasks that you perform to set up a debugging session: · Select or configure a RDS server against which to run a debugging session. · Specify server, file, and browser mappings so that ColdFusionStudio can locate the ColdFusion development server and the files to debug. For more information, see "Working with Files on Remote Servers" on page 13. To set up a debugging session: 1 2 Open an application page. Select Debug > Debug Settings. Setting up a Debugging Session 119 The Remote Development Settings dialog box appears: 3 4 If ColdFusion Server is installed on the same computer as ColdFusionStudio, select the server in the Debug on RDS Server box, on the Debug Start tab. If ColdFusion Server is not installed on the same computer as Studio, perform the following steps: a On the Debug Start tab, in the Debug on RDS Server box, select Add RDS Server. The Configure RDS Server dialog box appears: 120 Chapter 9 Debugging Application Code b In the Remote Host box, enter the RDS server description, host name, and port. In the ColdFusion RDS Security box: if ColdFusion RDS Security is implemented on your system, enter a username and password to access the server. The Remote Development Settings dialog box displays the description and start page URL of the RDS server. c d 5 6 (Optional) Select the option called Don't prompt for these settings at next debug session. Click the Mappings tab. 7 Complete the fields as follows: · · · RDS Server Select a RDS server against which to run the debugging session. Studio Path Enter or browse to the path that ColdFusionStudio uses to locate the page you are debugging. CF Server If you debug against a local server, enter the same path as for ColdFusionStudio. The path must be the same as the alias or virtual mapping that your Web server uses. · Browser Path Enter the browser path, or URL, of the application. Click Add. Using the Interactive Debugger 121 8 9 For each debugging mapping, repeat the previous step. The Remote Development Settings dialog box closes You can begin debugging in the Editor. Using the Interactive Debugger Running the interactive debugger helps you find problems in code by tracing how ColdFusion evaluates a page, step by step. You place one or more breakpoints in a page to pause its execution, then step through the code, checking the values of variables and expressions as you go, to ensure that t he code executes as you expect. When you have configured RDS and file mappings, you can use the commands on the Debug menu and the Debug toolbar to run the debugger. You can undock the Debug toolbar by double-clicking on the undock bars on the left-hand side of the toolbar, or you can drop the toolbar into the QuickBar. [. . . ] For more information, see the W3C HyperText Markup Language Home Page at www. w3. org/ MarkUp/. Defines the structure of information, or how the information could be stored in a database. For example, an XML language for cooking could have a <recipe> tag, and <recipe> could contain tags for <header>, <ingredients>, and <instructions>. The power of XML lies in the fact that the information can be stored and retrieved from a database, rendered in a variety of formats, and used for a variety of purposes--for example on a Web page, hand-held computer, or cell phone; or for a cookbook, recipe card club, or book about cilantro. 302 Glossary Index A absolute paths, deploying to 144 accessibility 66 accessing data sources 109 Help 35 project files from VSS 136 ActiveDocument Object in VTOM 230 ActiveScript 88 ActiveScripting examples in VTOM 276 ActiveX 87 administering multiuser projects in VSS 138 advanced search operators 38 anchoring regular expressions to strings 93 answers, finding xvii APF files 127 Application Object in VTOM 199 arguments, inserting with Tag Insight 58 ASP 95, 102 support for 84 assigning keyboard shortcuts 63 attributes viewing 57 Auto Backup 49 about 48 options 49 using 50 Auto Completion 59 auto-inclusive folders about 127 files in 131 B backing up files 48 backups, managing 49 bookmarks. [. . . ]