MACROMEDIA ColdFusion Server 5 Use Manual

CFS_MANCVRPG_live.fh9 10/1/01 12:37 PM Page 1

Composite

C M Y CM MY CY CMY K

macromedia

®

Using ColdFusion 5 Studio

COLDFUSION

®

5

STUDIO

macromedia

®

Copyright Notice

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. which may be

registered in the United States and internationally. Java and Solaris are trademarks of

Sun Microsystems, Inc. Microsoft, Windows, Windows NT, Windows 98, Windows

ME, Windows XP, and Windows 2000 are registered trademarks of Microsoft

Corporation. UNIX is a trademark of The Open Group. 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. The

content of this manual is furnished for informational use only, is subject to change

without notice, and should not be construed as a commitment by Macromedia Inc.

Macromedia Inc. assumes no responsibility or liability for any errors or inaccuracies

that may appear in this book.

Except as permitted by such license, no part of this publication may be reproduced,

stored in a retrieval system, or transmitted in any form or by any means, electronic,

mechanical, recording, or otherwise, without the prior written permission of

Macromedia Inc.

Part number: ZCS50M100

Contents

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Developer Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Macromedia Web site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

ColdFusion Web resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

About the Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Documentation conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Printed and online documentation set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Viewing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Printing online documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Getting Answers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Contacting Macromedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Chapter 1 Setting Up the Product . . . . . . . . . . . . . . . . . 1

System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Installing or Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Completing Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

About the Initial Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Setting up for the first time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Setting up from a previous version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Monitoring System Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Releasing system resources taken at start-up . . . . . . . . . . . . . . . . . . . . . . . . . . 6

About the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Using the Resource Level Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 2 Configuring Browsers and Servers . . . . . . . 9

Configuring the Internal Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Setting the internal browser options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Configuring External Browsers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Working with Files on Remote Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Using the SNE node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

iv Contents

Connecting to servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Enabling Secure FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Managing servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Adding server mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Understanding RDS Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 3 Exploring the Workspace . . . . . . . . . . . . . . 25

The Workspace Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Setting workspace options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Working in the Resources Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

About the Resource tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Creating and Browsing Files in the Document Window . . . . . . . . . . . . . . . . . . . . . 29

Edit tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Browse tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Help tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Tracking Your Work in the Results Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Customizing the Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Managing application toolbars and the QuickBar . . . . . . . . . . . . . . . . . . . . 31

Customizing toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Getting the Most from the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Opening Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . 35

Editing Help in tag editors and Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . 35

Accessing Help References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Printing Help topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Bookmarking Help topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Searching Help References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Making and viewing comments in the Help system . . . . . . . . . . . . . . . . . . . 38

Extending the Help system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Adding media content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Chapter 4 Managing Files . . . . . . . . . . . . . . . . . . . . . . . 43

About the Files Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

About File Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Working with Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Setting startup options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Opening files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Copying, moving, renaming, or deleting a file . . . . . . . . . . . . . . . . . . . . . . . . 47

Adding a link to an open file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Saving files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Backing up files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Changing the file list display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Dragging files from Windows Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Building a favorite folders list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Downloading Web pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Contents v

Chapter 5 Writing Code and Web Content . . . . . . . . . 53

Inserting Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Inserting tags from the QuickBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Selecting tags from the Tag Chooser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Completing tags with Tag Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Using Inline Tools to Enter Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Tag Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Function Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Tag Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Auto Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Code Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Extended and special characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Using Code Generating Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Adding Document Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Using Keyboard Shortcuts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Saving Code Blocks as Snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Sharing snippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Adding snippet shortcut keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Making Web Sites Accessible to Visually Impaired Visitors . . . . . . . . . . . . . . . . . . 66

Tips for Visually Impaired Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Assigning keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Working with user interface elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapter 6 Editing Pages . . . . . . . . . . . . . . . . . . . . . . . . 69

Setting Editor Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Using the editor toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Using the Settings dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Selecting Code and Text Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Saving Text to the Multiple-Entry Clipboard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Setting the clip entry limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Collapsing Text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Setting options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Editing Referenced Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Editing image files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Editing included files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Using Tag Editors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

About VTML Tag Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Editing a tag with a Tag Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Navigating a document structure in the Tag Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 77

About outline profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Configuring the Tag Tree display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

vi Contents

Editing code in the Tag Inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Setting the display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Creating and editing event handler script blocks . . . . . . . . . . . . . . . . . . . . . 80

Formatting Pages with Cascading Style Sheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

About the Style Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Chapter 7 Using Web Development Languages . . . . . 83

About Language Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

What languages are supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

How a language is detected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Setting Options for Markup Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Coding in XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

What is XHTML? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Setting options for XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Enabling XHTML support in a document . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Using Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

About regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Special characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Single-character regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Character classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Multicharacter regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Using back references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Anchoring a regular expression to a string . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Expression examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Using Color Coding Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Setting the supported file types for a scheme . . . . . . . . . . . . . . . . . . . . . . . . . 95

Setting the tag display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Preserving Code Formats with CodeSweepers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Selecting a CodeSweeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Running a CodeSweeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Managing CodeSweepers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Setting Macromedia CodeSweeper options . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Setting HTML Tidy options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Validating Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Using the default validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Using the CSE HTML Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Working with Tag Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

About namespace precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Setting namespace precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Editing tag definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Contents vii

Chapter 8 Accessing Data Sources . . . . . . . . . . . . . . 109

Introduction to Database Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Working with Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Configuring data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Connecting to data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Viewing data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Using SQL Builder for Database Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

The SQL Builder user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Writing SQL statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Building a SELECT statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Inserting SQL into a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Testing and editing queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Chapter 9 Debugging Application Code . . . . . . . . . . 117

Overview of the Interactive Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Setting up a Debugging Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Using the Interactive Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

About the Debugger toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Running the Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Debug windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Debugging across multiple pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Stepping through code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Evaluating an expressions and setting a watch . . . . . . . . . . . . . . . . . . . . . . 123

Chapter 10 Managing a Web Site with Projects . . . . 125

Understanding Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

What is a project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Why use projects? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

About project folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

About the project file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Creating a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Creating the initial project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Adding folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Adding files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Working with a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Performing basic operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Working with resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Perform other project-level tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Managing a Project with a Source Control System . . . . . . . . . . . . . . . . . . . . . . . . 135

Why use source control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Supported source control systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Setting up a project in source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Using source control in ColdFusion Studio . . . . . . . . . . . . . . . . . . . . . . . . . 137

viii Contents

Displaying the Source Control toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Sharing project files in Visual SourceSafe . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Administering multiuser projects in VSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Chapter 11 Deploying Files . . . . . . . . . . . . . . . . . . . . . 139

Setting Default Deployment Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Deploying Singles Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Performing Custom Deployments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Selecting folders and files to deploy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Adding Deployment Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Running the Deployment Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Chapter 12 Testing and Maintaining

Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Working in the Results Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Opening the Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Saving results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Searching Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Selecting search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Saving search text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Using basic search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Using extended search commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Searching with regular expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Checking Spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Configuring the spell checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Using the spell checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Verifying Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Using Site View to Check Page Links. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Testing Page Download Times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Chapter 13 Customizing the Development

Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

The Visual Tools Markup Language (VTML). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Customizing the Tag Chooser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Exploring the new VTML structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Dialog Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Category tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Element tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Creating Tag Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Tag definition file structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Defining attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Contents ix

Defining attribute categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Building Tag Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Defining controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Populating dialog boxes with tag data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Generating a tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Using TAGDATAUnknownAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Adding Tag Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Providing Help from an external file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Container/Control Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

TabDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

TabPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

DropDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

ListBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

FontPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

ColorPicker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

RadioGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

TextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

SQLTextArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

FileBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

StyleTextBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

ActiveX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Building Custom Wizards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Saving wizard files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Creating Wizard Definition Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Dynamic expressions in tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Bound controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Wizard definition page example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Creating Wizard Output Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Expressions and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

WIZ Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Special considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Wizard Definition Page Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Chapter 14 Scripting the Visual Tools Object Model 195

Writing and Executing Scripts in Visual Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

The VTOM hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Writing scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Executing scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Creating a custom toolbutton and toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . 198

x Contents

Application Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Toolbar and toolbutton methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

ActiveDocument Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

DocumentCache Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Project Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

ProjectManager Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Folder methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Deployment methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

DeploymentManager Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Project folder names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

HTTPProvider Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

ZIPProvider Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

ActiveScripting Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

JScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Third-Party Add-Ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Running a script at startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Table of CommandID Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Table of SettingID Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

About This Book

Using ColdFusion Studio is designed to familiarize you with the product’s user

interface and productivity tools that you can use to quickly develop high-quality

applications and Web content.

Contents

• Intended Audience.................................................................................................... xii

• Developer Resources................................................................................................. xii

• About the Documentation....................................................................................... xiv

• Getting Answers ...................................................................................................... xvii

• Contacting Macromedia......................................................................................... xvii

xii About This Book

Intended Audience

This book is intended for professional Web developers who have a working

knowledge of HTML and Web server environments. It introduces you to the

ColdFusion Studio user interface and development tools, and provides instructions

for installing, configuring, and using the product.

Developer Resources

Macromedia Corporation is committed to setting the standard for customer support

in developer education, technical support, and professional services. Therefore, the

Macromedia Web site provides a wealth of online resources.

This section also describes other resources available for ColdFusion Studio

developers.

Macromedia Web site

The Macromedia Web site is designed to give you quick access to the entire range of

online resources, as the following table describes.

Resource Description URL

Macromedia Web site General information about Macromedia

products and services

www.macromedia.com

Product Information Detailed product information on Macromedia

products and related topics

http://www.macromedia.com/

software/

Technical Support Professional support programs offered by

Macromedia

http://www.macromedia.com/

support/

Knowledge Base Repository of articles for improving the

performance of Macromedia products and

extending their functionality

http://www.macromedia.com/go/

allaire_kb

Installation Support Support for installation-related issues for all

Macromedia products

http://www.macromedia.com/go/

allaire_installation

Visual Tools Support

Forums

Online access to experienced developers

and Macromedia support staff, where you

can post messages and read replies on

subjects relating to Visual Tools features

http://www.macromedia.com/go/

fp_cfstudio_cfforum

Developer Center All the resources that you need to stay

current in your skills, including online

discussion groups, Knowledge Base,

technical papers and more

http://www.macromedia.com/go/

fp_cfstudio_cfrefdesk

Developer Resources xiii

ColdFusion Web resources

These are just a few of the many sites dedicated to CFML development:

• CF Advisor Online at www.cfadvisor.com/api-shl/engine.cfm.

• Haznet’s Fallout shelter, a CF portal, at www.hudziak.com/haznet/cfml.html.

• ColdFusion Developer’s Journal, an online version of the popular print journal, at

www.sys-con.com/coldfusion/index2.cfm.

Tutorials

The World Wide Web Consortium (W3C) is the source for all things Web-related.

Their Web site has free tutorials on Web languages, technologies, and development

available at www.W3Schools.com.

Another good Web source for tutorials is http://www.findtutorials.com.

Developer Exchange Open repository where you can view,

contribute, and download multiple types of

content that benefit software developers, for

example custom tags, scripts, Web content,

visual tools, and third-party applications

http://www.macromedia.com/go/

fp_cfstudio_exchange

Browser testing sites Browser compatibility is still an important

issue for Web site developers and these

sites provide online testing services.

http://builder.cnet.com/

webbuilding/

0-7255-8-5801921-1.html

Professional Education Information about developer certification

and the classes, on-site training, and online

courses offered by Macromedia

http://www.macromedia.com/

support/training/

Documentation Links to download the latest documentation

and documentation updates.

http://www.macromedia.com/go/

allaire_docs

Macromedia Alliances Connection with the growing network of

solution providers, application developers,

resellers, and hosting services which create

solutions with Macromedia products

http://www.macromedia.com/

partners/

Resource Description URL

xiv About This Book

About the Documentation

The documentation is designed to provide support for the complete spectrum of

participants. The print and online versions are organized to allow you to quickly

locate the information that you need. The online documentation is provided in

HTML and Adobe Acrobat formats.

You can also access release notes, product support information, and several

developer resources from the Help menu.

The rest of this section describes the conventions used in the documentation and the

contents of the ColdFusion Studio documentation set.

Documentation conventions

When reading the documentation, note the following formatting cues:

• Code samples are set in a monospaced font.

• Levels to access a dialog box or pane are separated by the greater than (>) sign,

and the path to access the item is set in bold. Following are two examples:

• “Select File > New” means “Select New from the File menu.”

• “Select Options > Settings > Editor > Auto Completion” means “Select

Settings from the Options menu and then, in the Settings dialog box, expand

the Editor node and select Auto Completion.”

• Book titles and emphasized text are set in italics.

• New terms are set in boldface.

Printed and online documentation set

The ColdFusion documentation set consists of the following titles.

Book Description

Using ColdFusion

Studio

Describes how to use ColdFusion Studio to build, test, and

deploy Web content, including using the built-in editor for a

variety of scripting and markup languages

Installing and

Configuring

ColdFusion Server

Describes system installation and basic configuration for

Windows NT, Windows 2000, Solaris, Linux, and HP-UX

Advanced

ColdFusion Server

Administration

Describes how to connect your data sources to the ColdFusion

Server, configure security for your applications, and how to use

ClusterCATS to manage scalability, clustering, and

load-balancing for your site

Developing

ColdFusion

Applications

Describes how to develop your dynamic Web applications,

including retrieving and updating your data, using structures, and

forms

About the Documentation xv

Viewing online documentation

You can view Help for a specific tag, Help topics in HTML format, or online

documentation in Adobe Acrobat (PDF) format.

To view Help for a tag:

• Position the cursor in a tag and press F1. Help for the selected tag appears,

including syntax and usage information.

F1 Help is available for all supported languages. To view a list of the supported

languages, open the Tag Chooser (Ctrl+E).

To view the online HTML help:

1Select Help > Open Help References Window.

The Help tab of the Resources window appears, displaying a tree of online books

that include several language references as well as the documentation.

2 Find the Help topic you need, using the tree, search engine, index, or bookmarks.

For details, see “Getting the Most from the Help System” on page 35.

3 Double-click the topic you need to display it in the Document window.

To view the PDF documentation:

• Open the PDF documentation from the product CD-ROM or download it from

the Macromedia Web site, from www.allaire.com/developer/documentation/

coldfusion.cfm.

CFML Reference Provides descriptions, syntax, usage, and code examples for all

ColdFusion tags, functions, and variables

CFML Quick

Reference

A brief guide that shows the syntax of ColdFusion tags,

functions, and variables

Book Description

xvi About This Book

Printing online documentation

You can print one Help topic at a time in the HTML Help, or print as many pages of

the Help as you need from the Adobe Acrobat (PDF) format of the Help.

To print a single Help topic in the HTML Help:

1 Display the Help topic you need to print.

For instructions, see “Viewing online documentation” on page xv.

2 Right-click the topic in the Document window and select your browser’s

command to print.

To print several pages from the PDF documentation:

1 Open the PDF documentation from the product CD-ROM or download it from

the Macromedia Web site, from www.allaire.com/developer/documentation/

coldfusion.cfm.

2 Print as many pages of the documentation as you need.

Getting Answers xvii

Getting Answers

One of the best ways to solve particular programming problems is to tap into the vast

expertise of the ColdFusion Studio developer communities on the ColdFusion

Forum. on the Macromedia Web site.

Other developers on the forum can help you figure out how to do just about anything

with ColdFusion Studio. The search facility can also help you search messages from

the previous 12 months, allowing you to learn how others have solved a problem that

you might be facing. The Forums is a great resource for learning ColdFusion Studio,

and it is also a great place to see the ColdFusion Studio developer community in

action.

Contacting Macromedia

Corporate

headquarters

Macromedia, Inc.

600 Townsend Street

San Francisco, CA 94103

Tel: 415.252.2000

Fax: 415.626.0554

Web:macromedia.com

Technical

support

Macromedia offers a range of telephone and Web-based

support options. Go to www.macromedia.com/support/ for

a complete description of technical support services.

All User Forums are listed on the Macromedia Forums

home page at http://www.macromedia.com/support/

forums/. You can post an entry anytime.

Sales

Toll Free: 888.939.2545

Tel: 617.219.2100

Fax: 617.219.2101

E-mail: sales@macromedia.com

Online store: http://dynamic.macromedia.com/bin/MM/

store/US/home.jsp.

xviii About This Book

Chapter 1

Setting Up the Product

This chapter contains instructions for installing or upgrading ColdFusion Studio and

configuring it.

Contents

• System Requirements ................................................................................................. 2

• Installing or Upgrading............................................................................................... 2

• Completing Setup ....................................................................................................... 3

• Monitoring System Resources.................................................................................... 6

2 Chapter 1 Setting Up the Product

System Requirements

Following are the minimum installation requirements:

• Pentium-compatible processor (Pentium II or higher recommended)

• Windows

®

98, ME, NT 4, 2000, XP

• Internet Explorer 4.5 or higher

• 128 MB available RAM

• 256-color monitor capable of 800 x 600 screen resolution

• 200 MB of free hard disk space

• Cold Fusion

®

Server5 (for debugging, database access, and deployment)

• CD-ROM drive (for installing CD version)

Installing or Upgrading

This section contains instructions for installing ColdFusion Studio.

Do not install an earlier version of ColdFusion Studio over a later version; however,

later versions are backward-compatible with earlier versions. If both this version and

a previous version are installed on your machine, you can run either version, but the

earlier version will reflect changes made in the current version to searching, source

control and projects, debugging, FTP, RDS, and validation.

ColdFusion Studio records any errors that are encountered during installation to a

.log file in the root directory. Please be ready to send this file to Technical Support if

you need help with installation.

To install:

1 Close all open applications and insert the ColdFusion Studio CD-ROM.

2 When the opening screen displays, click Install.

3 Follow the instructions in the Installation Wizard.

4 Once the program files are copied to your system, select the option to restart your

machine and click Finish to complete the installation.

The installation is completed.

To upgrade:

1Do not uninstall the previous version before installing the current version.

2Do not delete the UserData and AutoBackup folder. This allows you to import

your customizations into the current version and to files created by the backup

feature.

3 Close all open applications and insert the ColdFusion Studio CD-ROM.

4 When the opening screen displays, click Install.

Page is loading ...

MACROMEDIA ColdFusion Server 5 Use Manual

This manual is also suitable for

MACROMEDIA ColdFusion Server 5 Use Manual

Related papers

Other documents