MACROMEDIA ColdFusion Server 5 Use Manual Download

Page: 9 / 328

Contents

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

Summary of Contents for ColdFusion Server 5

Page 1: ...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...

Page 2: ...d 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...

Page 3: ...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...

Page 4: ...g 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 t...

Page 5: ...s 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...

Page 6: ...s 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 Exp...

Page 7: ...gger 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 Si...

Page 8: ...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 expres...

Page 9: ...LTextArea 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 cont...

Page 10: ...ager 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 26...

Page 11: ...ou 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 t...

Page 12: ...eral 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 T...

Page 13: ...s 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 site...

Page 14: ...ions 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 a...

Page 15: ...ars 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 s...

Page 16: ...play 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 se...

Page 17: ...arning 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 Fra...

Page 18: ...xviii About This Book...

Page 19: ...p 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...

Page 20: ...e 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 ro...

Page 21: ...et In Windows you can reset your system language from the Control Panel in Regional Settings or Regional Options Note If you need to run HomeSite ColdFusion Studio or JRun Studio simultaneously see Kn...

Page 22: ...es if necessary and then click Finish The initial configuration is complete and you can start using ColdFusion Studio Setting up from a previous version This section explains how to complete the Initi...

Page 23: ...he current version For example to carry over color coding customizations select Color Settings Or if Auto Completion was enabled in the previous version and you want to keep it turned on in the curren...

Page 24: ...cription of memory usage on Windows 98 ME systems see the Windows 9 x System Resources article on InfiniSource After reclaiming these resources if you still encounter difficulties with system resource...

Page 25: ...ar again unless your system resources drops another 5 for example when GDI resources drop to 9 Configuring the monitor Users should configure the Resource Level Monitor if their system crashes without...

Page 26: ...8 Chapter 1 Setting Up the Product...

Page 27: ...uring Browsers and Servers This chapter contains instructions for setting up browsers and servers Contents Configuring the Internal Browser 10 Configuring External Browsers 11 Working with Files on Re...

Page 28: ...ited in its support of HTML and browser extensions You can only use one internal browser at a time but you can change this setting as needed Restart the program for the change to take effect Select th...

Page 29: ...open 2 Make sure the browser is already installed on your machine then click Add 3 Complete the Browser dialog box as follows In the Name box type a name for the new browser Click the file button bes...

Page 30: ...ocument when opening it in an external browser Prompt to save changes to the current document Asks you whether or not to save the active document before opening it in the external browser Automaticall...

Page 31: ...e Extension SNE node lets you work with files on configured remote servers in the application and in Windows Explorer You can add FTP and RDS servers from the SNE node If you set the Drive list to My...

Page 32: ...emote host RDS features include Secure server access Data source browsing and SQL query building Remote file access CFML debugging Note An RDS server connection is required to access data sources and...

Page 33: ...of the FTP server but it is required if the account specifies an initial directory Relative from server assigned directory Option to specify if the Initial Directory should be set from the server ass...

Page 34: ...Secure FTP Ipswitch FTP technology installed with ColdFusion Studio offers data security via Secure Sockets Layer SSL to servers that support 40 bit encryption and decryption A default certificate an...

Page 35: ...gures basic security for the server and by default requires a password for the ColdFusion Administrator and for ColdFusion Studio To change the default security settings 1 Open ColdFusion Administrato...

Page 36: ...in the Files pane and also in Windows Explorer Managing servers You can easily change server configurations as needed To view and edit the configuration for a server 1 Right click the server name in...

Page 37: ...then return it to the browser This is valuable for previewing applications and site elements in a test environment before deploying the site You establish this routing by associating the physical dir...

Page 38: ...n the same machine Studio debugging on a remote ColdFusion server using drive mappings Studio debugging on remote server using Network Neighborhood Studio debugging on a remote server using RDS file a...

Page 39: ...twork Neighborhood to access a file on a remote server For example a developer might access a file on myserver webprojects where webprojects is the name of the shared directory in the network server m...

Page 40: ...pping For more information on setting up server mappings see Knowledge Base Articles 8347 and 8500 on the Macromedia Web site Note that the information in these articles applies to Studio as well as t...

Page 41: ...ary and click Update To change to a different mapping Select the mapping to switch to in mappings list To set a mapping as the default 1 Select Options Settings and click Browse 2 Select the entry tha...

Page 42: ...24 Chapter 2 Configuring Browsers and Servers...

Page 43: ...s on customizing the workspace to make all of your development work as productive as possible Contents The Workspace Areas 26 Working in the Resources Window 27 Creating and Browsing Files in the Docu...

Page 44: ...lus development menus Below the menus are toolbars that provide one click access to commands and application tools To the right is the QuickBar a tabbed toolbar for inserting JSP HTML and other langua...

Page 45: ...the standard copy move and paste commands between tabs If you undock one or both of the tabs you can drag files and folders between them To move them drag them To copy them drag them while holding dow...

Page 46: ...resources You can customize the help by adding help files and editing existing help files For more information see Extending the Help system on page 39 Tag Inspector tab Lets you edit in an interactiv...

Page 47: ...from text files Microsoft Office applications or directly from the Web You can easily create templates to insert common content The Edit toolbar extends vertically to the left of the Document window b...

Page 48: ...n the cursor in a tag and press F1 On the Help Resources tab open a page from the Help References tree Tracking Your Work in the Results Window The Results window presents the results of document oper...

Page 49: ...the left of the workspace provide standard Windows commands plus access to tools such as external browsers the Style Editor Code Validation and the Link Checker The QuickBar on the right of the works...

Page 50: ...also resets the default settings for which toolbars are shown or hidden However it does not affect the contents of any toolbar so any changes made to buttons within a toolbar are preserved Tip As an...

Page 51: ...tion other than UltraDev which already has a button in the Editor toolbar select Launch external application complete the Filename box with the full path of the program s executable file and complete...

Page 52: ...is removed from the toolbar 4 Click Close to return to working in the product To add a toolbar 1 Select Options Customize from the menu to open the Customize dialog box 2 Click Add Toolbar to the rig...

Page 53: ...To display Help text on the Help tab press F1 For more information see Help tab on page 30 Editing Help in tag editors and Tag Chooser Using the Visual Tools Markup Language VTML you can edit Help tex...

Page 54: ...5 Click OK to add the bookmark to the Help Bookmarks list 6 Click Close to save your changes and return to the Help Resources tab To open a bookmarked Help document 1 Click the down arrow next to the...

Page 55: ...References for the first time on your system you should allow the program to index the files that is to generate a full text search database from the Help reference tree contents This greatly improve...

Page 56: ...he Help system You can comment directly on our online documentation or view others comments To view or make comments in the online documentation 1 Display the page in the online documentation for whic...

Page 57: ...TML file to files with txt dtd and pdf extensions if you use Internet Explorer as the internal browser Web graphics files GIF JPG PNG are viewable in Help files This extensibility enables you to Write...

Page 58: ...der s location on your system To add a folder to a specific location in the Help tree 1 In Windows Explorer open the Help root directory make a backup copy of the booktree xml file and copy the new fo...

Page 59: ...ght copy an Images folder into your custom help folder In your custom documents references to media content supply a URL or accessible file location for remote files For example you might reference a...

Page 60: ...42 Chapter 3 Exploring the Workspace...

Page 61: ...uble Byte Character Support files The tasks described in this chapter do not replace the need for creating a project to organize the files in a Web site or Web application For instructions on how to u...

Page 62: ...indows Explorer Having two Files tabs reduces the amount of file system navigation needed to work across multiple directories and drives Several operations such as opening and saving files backing up...

Page 63: ...ode page Unicode Unicode Big Endian UTF 8 Processing files from Unicode encoding formats involves code page checking detection of file encoding and format conversions Therefore enabling non ANSI file...

Page 64: ...ocument 3 Select one of the following startup folder options to Open the folder that was last active in the Files tab Open the folder that was last selected in the File Open dialog box Specify a defau...

Page 65: ...ying moving renaming or deleting a file You can right click a file in the file list and select a command in the popup menu to copy move rename or delete the file Adding a link to an open file To creat...

Page 66: ...ormat from the Encoding drop down list 3 Optional Select Check the document character set This displays a warning message if the Save As encoding selection conflicts with the file s document character...

Page 67: ...n open the last backup version of a lost file from the backup location 6 A Timed Backup file is deleted when the original file is saved or when the application closes normally Using Auto Backup This s...

Page 68: ...isplays Web documents only Web Images displays Web images only JPEG JPG PNG and GIF All Web Files displays both Web documents and Web images All Files displays all files in the selected directory Note...

Page 69: ...ct Favorite Folders Organize Favorites from the menu to see the Favorite Folders dialog box 2 Select a folder and use the up and down arrows to move its location in the favorite folders list 3 Select...

Page 70: ...nsert it into a document use Windows copy and paste commands Note that page formatting is not preserved To copy the code behind a Web page use the browser s command to view the page source code and th...

Page 71: ...namic sites This chapter describes basic techniques for creating Web content and application code Contents Inserting Code 54 Using Inline Tools to Enter Code 57 Using Code Generating Tools 60 Adding D...

Page 72: ...ectly into the document or for tags that require attributes opens a tag editor In addition to toolbars for product tools and standard Windows commands you can display toolbars for HTML CFML JSP script...

Page 73: ...ouble click it Tags that are inserted directly into a document are listed with brackets in the right pane such as HTML HTML All other tags have individual editors that open when the tag is selected 5...

Page 74: ...details for a tag 1 In the Editor position the cursor in the tag to complete 2 Right click and select Edit Current Tag from the popup menu 3 Complete the Tag Editor dialog box For help click the Embe...

Page 75: ...st Click the item in the list and click Delete It is immediately deleted from the list 5 Click Apply To view the attributes and values for a tag 1 Position the cursor inside the tag and press F2 to op...

Page 76: ...ironment on page 169 4 Click Apply To insert arguments using Function Insight 1 Type a function name followed by a left parenthesis to display a drop down list of recognized arguments 2 Select an argu...

Page 77: ...define a code template 1 Open Options Settings Editor Code Templates 2 In the Code Templates pane click Add 3 In the Add Code Template dialog box type a keyword a description of the code template and...

Page 78: ...the Custom tab Wizards File New generate HTML DHTML CFML Java and JSP code The Wizards for Deployment Scripts and Initial Configuration are in the Custom tab The JavaScript Tree provides quick access...

Page 79: ...the Common QuickBar tab to define internal and external links For other supported languages such as WML and SMIL use the appropriate link syntax To insert a file into a document 1 Select File Insert F...

Page 80: ...instructions see the UltraDev tutorials and online help 3 When you are done save your work and close UltraDev The page displays in Studio again with the changes you made in UltraDev To insert Microsof...

Page 81: ...s print command to print the document You can change key combinations and assign keys to the commands in the list To assign a key combination 1 In the Options Customize Keyboard Shortcuts tab select...

Page 82: ...n file names such as slashes special characters or double quotes 5 In the Start Text window type or paste an opening code block You can set a default spacing between the blocks by pressing the Enter k...

Page 83: ...k OK 3 In the Snippets panel right click and select Create Shared Folder The folder button changes color to show that it is shared Anyone with access to the shared folder can now add edit and delete s...

Page 84: ...s graphics and animations and using clear descriptive text for page elements and navigation can make a world of difference to a visually impaired user s experience of your site Validation tools are av...

Page 85: ...keys to scroll the list 5 To open the list in the external browser press Shift F10 to open the context menu then select the Browse command You can change any of the current key combinations and you ca...

Page 86: ...ollowing list describes some ways to work productively in the user interface You can use Windows Explorer instead of the Files tabs for working with the file system network drives and remote servers T...

Page 87: ...Contents Setting Editor Options 70 Selecting Code and Text Blocks 72 Saving Text to the Multiple Entry Clipboard 72 Collapsing Text 73 Editing Referenced Files 74 Using Tag Editors 76 Navigating a do...

Page 88: ...olbar The column between the Document window and the Resources window contains the Editor toolbar These toolbuttons give you quick access to commands for Handling documents Formatting Switching betwee...

Page 89: ...tter Bookmarks are not saved when you close the file Using the Settings dialog box Open Options Settings Editor to configure the editor display options Expand the Editor node to view and set options f...

Page 90: ...n the Options Settings Editor pane When the maximum number of clipboard entries is reached the next copy operation deletes the oldest clipboard entry and adds the new copied text to the bottom of the...

Page 91: ...on and then easily collapse it again Set file save and file open options for the collapsed text To collapse text in the current document do one of the following Select text then click one of the colla...

Page 92: ...or right click an img tag and select Edit in Macromedia Fireworks The image tag must be complete and the file path and file name for the src attribute must refer to an actual file 2 If the image you s...

Page 93: ...editor right click in one of these tags cfinclude cfmodule script jsp include include jsp forward vtinclude wizinclude include 2 Select Edit Include file from the pop up menu The file src template or...

Page 94: ...ls and accessibility options not found in the standard Anchor Tag Editor For information about VTML see Customizing the Development Environment To use a VTML Tag Editor instead of a standard Tag Edito...

Page 95: ...ee as you edit the document click the Refresh button on the Tag Tree toolbar 4 To display the contents of the selected tag in a single node on the Tag Tree click the Collapse button on the Tag Tree to...

Page 96: ...o edit the tag list for the selected outline profile 4 In the Tag Settings pane you can add a caption and tool button to a tag 5 Click Done The outline profiles are updated for the Tag Tree You can im...

Page 97: ...ports ColdFusion Server 5 Setting the display You can select buttons at the top of the Inspector pane to control the way attributes and scripting events are displayed There are three display options V...

Page 98: ...nspector pane 2 You can either click the event in the Attributes list or in the Events list 3 Open the drop down list in the values column and select a script language for the event handler 4 In the S...

Page 99: ...s structure evolves styles can be globally changed added and deleted giving developers greater freedom and time to achieve design goals A site can be retrofitted with CSS although this requires delet...

Page 100: ...82 Chapter 6 Editing Pages...

Page 101: ...against different language specifications and working with tag definitions For information about building SQL statements see Using SQL Builder for Database Queries on page 112 Contents About Language...

Page 102: ...nguage IMFL partial support Real time Markup Language RTML partial support There are also coding tools controls options wizards color coding schemes CodeSweepers and validation support to accomodate m...

Page 103: ...ocument content as HTML In the case of XHTML when you enable Options Set Document as XHTML the program treats the document as XHTML even if there is no change to the DOCTYPE declaration On a character...

Page 104: ...ly but if you use RGB values the same color appears in every browser Force filenames to lowercase when inserting links When dragging a file to the editor the inserted link contains a lowercased filena...

Page 105: ...tiveX toolbutton to a toolbar Option Result when selected Minimize empty tags e g br If the current document is set or recognized to be an XHTML document the buttons on the QuickBar for empty tags ins...

Page 106: ...as well as on XML systems so you can switch to XML without excluding anyone or waiting for XML based browsers to become more prevalent Because XHTML is so similar to HTML it is not difficult to switc...

Page 107: ...Working with Tag Definitions on page 106 Enabling XHTML support in a document This section describes how to enable XHTML support for a document Once the program recognizes a document as XHTML it disp...

Page 108: ...se various operators to combine smaller expressions simple regular expressions can be concatenated into complex criteria For more information see Anchoring a regular expression to a string on page 93...

Page 109: ...gh they were special characters A period matches any character including a new line To match any character except a new line use chr 13 chr 10 which excludes the ASCII carriage return and line feed co...

Page 110: ...pression For example a z matches zero or more lowercase characters A one character regular expression or grouped subexpressions followed by a plus matches one or more occurrences of the regular expres...

Page 111: ...r to the nth parenthesized subexpression One example of how you can use back references is searching for doubled words for example to find instances of is is or the the in text The following example s...

Page 112: ...underscores in its text A Za z A Za z0 9_ A ColdFusion variable with no qualifier A Za z A Za z0 9_ A Za z A Za z0 9_ A ColdFusion variable with no more than one qualifier for example Form VarName bu...

Page 113: ...SQL Text VisualBasic Script VBScript Visual Tools Markup Languahe VTML To change the color coding scheme to use in your documents 1 In the Options Settings Editor Color Coding pane select the color co...

Page 114: ...e preview pane shows the options that are set for the selected scheme 4 Select an item from the Elements list 5 To change either the foreground or background color for the element first clear the Use...

Page 115: ...t formatting your documents to be XHTML compliant go to the Macromedia Developer Center for an article called An XHTML Aware Editor and read the section entitled An XHTML CodeSweeper HTML Tidy HTML Ti...

Page 116: ...hlight a CodeSweeper entry in the list and click the Set as Default button 3 Click Apply Managing CodeSweepers You can create new CodeSweepers edit existing ones and remove them as needed To add a new...

Page 117: ...al options Following are the general options you can set Set the case for tag attribute and event names You can select to preserve the case as it is found in the document or change to all upper or all...

Page 118: ...handy for getting rid of superfluous and unwanted tags that are inserted by code generation tools To set rules for a tag 1 Select Options Settings CodeSweeper 2 Select a CodeSweeper from the list 3 Ed...

Page 119: ...Apply Editing a profile The HTML Tidy CodeSweepers pane gives you access to all the supported options but you can also edit a profile directly This can be useful in a couple of situations If you want...

Page 120: ...le pound is an error and the single pound is correct To configure the validator 1 Open the Options Settings Validation pane 2 Select the tag sets against which to validate Some tag sets are built on t...

Page 121: ...add versions to language families A version inherits everything from the parent language You can add tags to a new family on the Tags tab or you can back up the validator vtv files in the Extensions a...

Page 122: ...Add Required Attribute dialog box type alt and click OK The Versions tab is for if I need to extend the tag sets against which I can validate and the Values tab is for validating regular expressions T...

Page 123: ...s HTML validation tool you can run it from ColdFusion Studio The CSE Validator supports multiple languages and contains other useful features For more information open the Options Settings Validation...

Page 124: ...ocument right click it and choose Edit Tag the SMIL Tag Editor appears because no other directory contains a region tag On the other hand if you edit a servlet tag either the Java or JRun version of t...

Page 125: ...r Tag Insight and Tag Tips and also ensures that Large Fonts display properly on user systems To edit a tag definition using Tag Inspector 1 Click the Edit Tag Definitions button to open the Tag Defin...

Page 126: ...108 Chapter 7 Using Web Development Languages...

Page 127: ...er describes how to use the visual tools in ColdFusion Studio to accelerate development of data driven ColdFusion applications Contents Introduction to Database Tools 110 Working with Data Sources 110...

Page 128: ...ces A set of ODBC drivers and sample data is installed with ColdFusion Server Native database drivers are installed with the Enterprise version OLE DB drivers are installed with the Professional and E...

Page 129: ...n ColdFusion Studio To open a data source 1 In the Resources window click the Database tab 2 In the top pane select a server from the drop down list Accessing a large database on a remote servers migh...

Page 130: ...also use SQL Builder to test your queries To open SQL Builder do one of the following In the Database tab right click a database name or a table and select New Query Select Tools SQL Builder from the...

Page 131: ...to update SQL pane Displays the SQL statement as it is being constructed The SQL pane does not support reverse editing so any changes that you make in this pane are not made in the Properties pane or...

Page 132: ...er or outer join right click the join and select the appropriate command 4 Drag the columns to display onto the Column section of the Properties pane 5 Optional Set additional query attributes in the...

Page 133: ...tatement from SQL Builder click the Copy SQL to Clipboard button on the toolbar and close SQL Builder ColdFusion Studio prompts you to save the query Then you can paste the statement into your page To...

Page 134: ...y button looks like this 2 ColdFusion Studio prompts you to enter values for the variables in the query Editing queries If you save a query you can edit it later However pages containing the query are...

Page 135: ...isolate and correct problems A tabbed debug window provides breakpoints variables recordsets tag and page hierarchies and page output From these panes you can set watches manage breakpoints and evalu...

Page 136: ...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 u...

Page 137: ...same computer as ColdFusionStudio select the server in the Debug on RDS Server box on the Debug Start tab 4 If ColdFusion Server is not installed on the same computer as Studio perform the following...

Page 138: ...splays the description and start page URL of the RDS server 5 Optional Select the option called Don t prompt for these settings at next debug session 6 Click the Mappings tab 7 Complete the fields as...

Page 139: ...r or you can drop the toolbar into the QuickBar The Debug Start dialog box displays each time you press the Start button in the Debugger To disable the display of this box select the option on the che...

Page 140: ...ntil you click the Start Continue button The server processes the code to the next breakpoint When you click Start Continue after the last breakpoint ColdFusion executes the page and outputs it to the...

Page 141: ...uired The cursor location must be below the current position If there are breakpoints between the current position and the cursor Run to Cursor stops at them Evaluating an expressions and setting a wa...

Page 142: ...n the evaluator list box to the list of watched expressions select Watch The Watch area shows the values of watched expressions and any error messages in resolving these parameters 5 To continue debug...

Page 143: ...jects This chapter describes how to use a ColdFusion Studio project to manage the files in a Web site Contents Understanding Projects 126 Creating a Project 128 Working with a Project 132 Managing a P...

Page 144: ...f the files you need to build your Web site located in a central easily accessible location This means having access to the files the physical files themselves can be located anywhere on your local ne...

Page 145: ...d a description of when you should use each folder type About the project file Both physical and virtual folders point to files in your file system These pointers or references are contained in the pr...

Page 146: ...Specify project options as needed The following table provides information about each setting 3 When you are done click Apply Setting Description Maximum recent projects Maximum number of projects to...

Page 147: ...r to a project you must decide where that folder falls within the project tree You can add a folder to the project root or you can add a folder to an existing folder There are some limitations to wher...

Page 148: ...e the file extension of each type of file to include in the folder separated by semicolons 8 Click OK 9 Complete the Include Files in New Folder dialog box To include all files inside the directory cl...

Page 149: ...files to the folder To remove files from a manual inclusive or virtual folder 1 Select the folder in the project tree The files contained in the selected folder appear in the Project file list 2 Righ...

Page 150: ...ect Project Open Project from the menu The project structure appears on the Projects tab 2 Expand the project node to see the project s folders and resources 3 To close the project select Project Clos...

Page 151: ...L and Images You can easily edit the default resource types and also add new ones Note To prevent slow execution of project link verification and extended search and replace operations caused by parsi...

Page 152: ...ject to remove and clicking Delete The resource is removed from the table immediately without asking you to confirm its deletion 7 Click Apply to save your changes You can also add edit or remove a re...

Page 153: ...team members to do the following Share files on a LAN without overwriting work or accidentally modifying files simultaneously Track versions of files and modifications as files are changed Control th...

Page 154: ...project root select Source Control then select Choose Source Control Provider 3 Map your project to the directory that you use for your source control application for example to check out and check in...

Page 155: ...your source from within ColdFusion Studio Use the Source Control toolbar or right click in the project files list To open the source control application Click the Source Control Application button Di...

Page 156: ...ledge Base article 14856 covers the steps required to set up multiple user access to project files in source control Administering multiuser projects in VSS If you are responsible for setting up Visua...

Page 157: ...more host servers You can specify a deployment path for the entire project or for individual folders and files This chapter describes how to specify options and deploy files to a server Contents Setti...

Page 158: ...es Makes the directory structure on the server match the directory structure on the client If this is not selected and you add a new directory to the client then when you try to deploy you will receiv...

Page 159: ...you do not want a confirmation to appear for future deployments 4 Click Deploy to finish deploying the selected file or folder To deploy to multiple servers 1 On the Projects tab right click a file a...

Page 160: ...select specific files to deploy Setting Project Level Deployment To set the deployment for a project just enter an absolute path for the location Note The Relative to the Parent Folder Deployment Loca...

Page 161: ...rectory ParentFolder then the child folder s deployment location is a subdirectory of ParentFolder for example ServerDirectory ParentFolder ChildFolder The product calculates child paths for you autom...

Page 162: ...t For a full description of configuration options for FTP and RDS servers see Working with Files on Remote Servers on page 13 To add a deployment server 1 Right click the Deployment Servers node of yo...

Page 163: ...s such as file compression and custom logging When you deploy to multiple servers the project files are copied to identical locations on each server for example C Web MyApps So unless you are deployin...

Page 164: ...es of deployment scripts Project wide upload script Copies the files in a project to the host server s just as if you were deploying the project directly During a project wide upload the project is op...

Page 165: ...servers to deploy to and click Next 11 Click Finish to generate the script Managing deployment scripts To edit a deployment script 1 In the top pane of the Projects tab expand the Deployment Scripts n...

Page 166: ...view the results of the last deployment 1 Select View Results Deployment from the menu 2 Right click in the Deployment pane to select display options Each succeeding deployment overwrites the Results...

Page 167: ...st its accuracy completeness and efficiency ColdFusion Studio provides a full set of tools to accomplish these necessary tasks Contents Working in the Results Window 150 Searching Documents 152 Checki...

Page 168: ...e Results window The Results window displays output from these operations Extended Find or Extended Replace Validate code Verify links Display image thumbnails Deploy a project The Results window disp...

Page 169: ...eration on the appropriate tab even when you move from one tab to another or close the Results window However results are discarded when you repeat the same operation or close ColdFusion Studio For ex...

Page 170: ...lection you can select the Selection option in the Relace dialog box Optionally you can configure ColdFusion Studio so that when you do not select any search text it selects the word nearest to the cu...

Page 171: ...search on the current document For instructions see Performing an extended search on page 154 4 Click the Find Next button to sequentially highlight each match in the document 5 If the search dialog b...

Page 172: ...ocument to search the current document only using more advanced options than are available in a basic search All open documents to search all open documents even those that are not yet saved In folder...

Page 173: ...t Caution An extended replace operation cannot be undone For best results select the Make backups option Also an extended replace operation skips all read only files To perform an extended replace 1 S...

Page 174: ...tents of the line in which the match was found This slows down the performance in large searches Make backups Select this for folder and project replace operations because an extended replace cannot b...

Page 175: ...l browser You can print the list from the browser To clear the search results Right click in the search results pane and select Clear Replacing extended and special characters You can replace special...

Page 176: ...abling Regular expressions disables the Skip tags while searching option 3 If replacing text in a project or folder select Make Backups and specify a backup location If replacing in the current docume...

Page 177: ...view Spell Check options 2 In the Main Dictionaries box select every dictionary that you want to use By default dictionaries for American English and HTML are installed To spell check the content of H...

Page 178: ...naries By default this user dictionary is contained in a file called userdct txt which is located in the UserData folder underneath the application root directory To use a different user dictionary 1...

Page 179: ...M character set Correctly identifies Chinese characters on a Windows system that uses a Chinese keyboard Recheck misspelled words as separate smaller words Splits a misspelled word into two or more sm...

Page 180: ...n the current document select Tools Mark Spelling Errors from the menu This marks mispellings in the document as it is when you select this command This does not mark mispellings as you type To correc...

Page 181: ...erification on large binary files such as EXE PDF ZIP and media file types This would significantly slow down the operation Therefore ColdFusion Studio installs a list of excluded file extensions in t...

Page 182: ...e Status column displays OK for successful links and for failed links a File not found message or the server generated code 3 To end the link validation before it completes click the Stop button Field...

Page 183: ...tes click the Stop button To verify a single link In the Results window on the Links tab right click a link in the list and select Verify this Link To produce a report of failed links In the Results w...

Page 184: ...nk in the current document 1 Click the link in Site View to highlight it in the document 2 Edit the link text as necessary 3 To update Site View right click in the Site View pane and select Refresh To...

Page 185: ...odem speeds Only image files GIF JPG PNG are tested and included in the Dependencies list The following graphic shows a sample Document Weight list To test the current document s download time 1 Selec...

Page 186: ...t the root URL for an FTP server 1 In the Resources window click a Files tab 2 In the Drive List select Macromedia FTP RDS 3 Right click a server name and select Properties 4 In the Configure FTP Serv...

Page 187: ...nd build custom wizards to gather user input and to drive application output The online VTML Reference contains the full syntax and descriptions of both languages The term Visual Tools is used in this...

Page 188: ...Help text You can also create your own editors Many custom tag developers use VTML to build tag editors to distribute with their tags libraries You can find a selection of custom dialogs and tag edit...

Page 189: ...in the list by displaying both start and end tags and are inserted directly into the document Tag Chooser content and behavior is determined by a set of VTML files which can be identified by opening t...

Page 190: ...ustom tags in previous versions you will notice a significant change in the Extensions folder and in the Extensions MarkUpTags file In previous releases the MarkUpTags file was a repository of VTML co...

Page 191: ...cat cat sub category No 2 e e cat cat The following section explains how to create and update category and element tags Category tag The cat tag defines a category in the Category tree The Category tr...

Page 192: ...language directories to prevent possible name conflicts between various markup languages Whenever you make changes to a VTM file or create a new one save the file then press Ctrl Alt Shift C to apply...

Page 193: ...can use the attrib tag to define the following attributes Attribute value types Enumerated values for the align attribute The optional caption attribute specifies the form in which the option appears...

Page 194: ...idth 70 control name txtCode type TextBox anchor lblCode corner NE width 30 container editorlayout tag You can name the above template mytag vtm and test it by attempting to edit an empty mytag tag Th...

Page 195: ...owing special variables can be used TAGBODY This special tag attribute name is used when a control needs to be populated by the body of a tag An example of such a tag editor is the editor for the HTML...

Page 196: ...ing lowercase EDITORTagIndentString Maintains indentation for tag attributes and body OPTIONLinearLayout Returns true or false Specifies whether the tag should be generated with its attributes in a si...

Page 197: ...al tag string but are not supported by the editor For example you can write an editor for the HTML tag input that provides editing capabilities for all basic attributes however the editor will not cov...

Page 198: ...n is typically used in the application cfm file to set defaults for a specific ColdFusion application tagdescription Providing Help from an external file As the Help content grows it may become cumber...

Page 199: ...nt embedded controls container container Panel editorlayout height 225 container name MainTabDialog type TabDialog width maximum height maximum container name TabPage1 type TabPage caption mytag Tag c...

Page 200: ...l caption Align anchor lblSource corner SW down 11 width 50 control name dropAlign type DropDown anchor lblAlign corner NE width 100 item value TOP caption TOP item value MIDDLE caption MIDDLE selecte...

Page 201: ...ption Skip Neither saves the file nor throws an error item value overwrite caption Overwrite Replaces the existing file if name conflict occurs item value makeunique caption Makeunique Automatically g...

Page 202: ...nfo anchor numTimeout corner NE right 10 down 4 width maximum container control name lblSQLStatement type Label caption SQL Statement anchor Panel1 corner SW down 10 right 0 width 110 control name txt...

Page 203: ...ard Markup Language WIZML If you have worked with VTML to create or edit tag dialog boxes you are familiar with building interface containers and controls and with defining page layout You can use the...

Page 204: ...ntax PARAM name RowsPerPage value 10 REQUIRED ParameterExists Customize Or to customize the OUTPUTFILE attribute of the TEMPLATE tag using a name attribute entered by the user you would use the follow...

Page 205: ...caption HTML 2 0 value HTML 2 0 item caption HTML 3 2 value HTML 3 2 item caption HTML 4 0 value HTML 4 0 control control name lblTitle type label anchor lblDocType corner SW down 20 width 90 caption...

Page 206: ...page PAGE name MetaKeywords type DYNAMIC caption Meta Keywords IMAGE images main bmp PAGELAYOUT control name chkMetaKeywords type CheckBox caption Add meta keywords down 15 right 10 width maximum con...

Page 207: ...URL parameters Parameters can be output directly or can be used to customize the type of output generated The values of these wizard parameters can originate from several locations From a value set by...

Page 208: ...ther wizard output template WIZLOOP Iterates over a set of output WIZBREAK WIZCONTINUE Assists in loop flow control WIZIF WIZELSEIF WIZELSE Sets conditional flow control Special considerations Strings...

Page 209: ...ApplicationName param ApplicationName required yes validationMsg You cannot leave the Application Name field blank INPUT name editLocation param Location required yes validationMsg You cannot leave th...

Page 210: ...emoveParams value SearchFields ResultFields DetailFields UniqueIdentifier INPUT name lstTables param Tables required yes validationMsg You did not select any tables Please select at least one before p...

Page 211: ...select at east one before proceeding PAGE SelectField PAGE name IDField type SelectField caption Unique Identifier image images UniqueIDDetail bmp PARAM name DataSource value DataSource PARAM name Tab...

Page 212: ...194 Chapter 13 Customizing the Development Environment...

Page 213: ...y for use in their applications This chapter describes how to write and execute scripts in Visual Tools It also provides the syntax and examples of the Visual Tools objects Contents Writing and Execut...

Page 214: ...ry simple the Application object is the parent of all the other objects and none of the other objects is a parent The VTOM hierarchy can be illustrated as follows Application ActiveDocument DocumentCa...

Page 215: ...Dim app set app Application create application object variable app WindowState 2 maximize the window End Sub The Application object is only available from scripts that are executed within the Visual...

Page 216: ...b 2 Click Add Custom Button 3 In the Custom Toolbutton dialog box select the Execute an ActiveScript file option 4 Enter a path and file name in the Script File box 5 Make selections in the Button Ima...

Page 217: ...tionType integer read only Description The current application type Sample ApplicationType script Tests Application ApplicationType property 0 HomeSite 1 CF Studio 2 JRun Studio function Main var iApp...

Page 218: ...path in a variable CurrentFolder Syntax CurrentFolder OleString Description Path currently displayed in the local file list Example function Main with Application CurrentFolder C InetPub wwwroot Curr...

Page 219: ...rentView 2 sMessage You are now in Browse View of your VersionText MessageBox sMessage VersionText 0 CurrentView 3 sMessage You are now in Help View of your VersionText MessageBox sMessage VersionText...

Page 220: ...dex of the current document DocumentIndex Syntax DocumentIndex Integer Description Tab index of current document Example function Main Var sMessage with Application sMessage There are sMessage sMessag...

Page 221: ...ents n sMessage sMessage Width Width n Get Width sMessage sMessage Height Height n Get Height HInstance Syntax HInstance integer read only Description Instance handle of the application hWnd Syntax hW...

Page 222: ...n sMessage sMessage Width Width n Get Width sMessage sMessage Height Height n Get Height ResourceTabShowing Syntax ResourceTabShowing WordBool Description Boolean Specifies whether the resource tab di...

Page 223: ...eft sMessage sMessage And the following measurements n sMessage sMessage Width Width n Get Width sMessage sMessage Height Height n Get Height VersionText Syntax VersionText OleString read only Descrip...

Page 224: ...te integer Description Set and get window state The following values are allowed 0 Normal 1 Minimized 2 Maximized Example function Main var iNormal 0 var iMinimized 1 var iMaximized 2 with Application...

Page 225: ...on Closes all open documents If wbPromptToSave is True the user is prompted to save any changes Returns True if successful that is the user didn t cancel if wbPromptToSave is True Example function Mai...

Page 226: ...ntax ExtractFilePath const wsFile WideString WideString Description Returns the path of the passed file includes trailing Example function Main Var sFilePath Var sFullFilePath sFullFilePath C Temp MyS...

Page 227: ...nction Main with Application aFileObj new ActiveXObject Scripting FileSystemObject aFolder aFileObj GetFolder CurrentFolder aFiles new Enumerator aFolder files sExtToTest gif sFile for aFiles atEnd aF...

Page 228: ...er Description Returns the width in pixels of the passed image Returns 0 on error Example See the GetImageHeight example GetMemoryStatus Syntax GetMemoryStatus iMemType Description Returns an integer...

Page 229: ...r sRelativePath Var sFullPath2 sFullPath1 http www macromedia com sFullPath2 http www macromedia com software with Application sRelativePath GetRelativePath sFullPath1 sFullPath12 GetTabIndexForFile S...

Page 230: ...ing Description Retrieves a URL and returns its contents Example Tests GetURLResponse GetURLStatusCode function Main with Application sURL_1 http www macromedia com sURL_2 http www this_should_not_exi...

Page 231: ...with Application HideProgress Hides the progress bar HTMLConvertTagCase Syntax HTMLConvertTagCase const wsHTML WideString const wbUpperCase WordBool WideString Description Boolean Converts the case o...

Page 232: ...e tag sWidth HTMLGetAttribute table width 100 width HTMLGetTitle Syntax HTMLGetTitle const wsFile WideString WideString Description Returns the contents of an HTML file s title tag This only operates...

Page 233: ...rue if the passed file is open in the Document tab and was modified Example function Main with Application Save current file if it is modified if IsFileModified ActiveDocument FileName ActiveDocument...

Page 234: ...gMemoryStatus D Test MemLog txt Application Start MessageBox Syntax MessageBox const wsText wsCaption WideString nType Integer Integer Description Displays a message dialog box for obtaining a user re...

Page 235: ...wsFile WideString WordBool Description Boolean Opens the passed file Returns if the file opens or is already open Passing an empty string to OpenFile displaysthe Open File dialog box which enables the...

Page 236: ...ent PreviousDoc Syntax PreviousDoc Description Moves to the previous document in the Document tab If the first document is showing wraps to the last Example function Main with Application Create a new...

Page 237: ...l WordBool Description Boolean Saves all open documents Returns True if successful Example function Main with Application SaveAll SaveResultsToFile Syntax SaveResultsToFile const wsFile WideString Des...

Page 238: ...tsType Description Boolean Sets the active page in the Results tab The following values are allowed resSearch resValidator resLinks resThumbnails Example function Main with Application SetActiveResult...

Page 239: ...le function Main with Application SetProgress 15 SetStatusText Syntax SetStatusText sMessage OleString Description Sets the text that displays in the status area Example function Main with Application...

Page 240: ...and then reload it ShellToAppAndWait notepad exe ActiveDocument Filename ActiveDocument Reload false ShowProgress Syntax ShowProgress Description Shows the progress bar Example function Main with Appl...

Page 241: ...StatusWarning Current document is read only TagCase Syntax TagCase const wsTag WideString WideString Description Changes the case of the passed string based on the Lowercase all inserted tags setting...

Page 242: ...ies each toolbar The name of the toolbar displays in the title bar caption when the toolbar is not docked Toolbars are loaded from files in the toolbar directory which can be obtained from the Toolbar...

Page 243: ...nd wsHint wsCaption wsImageFile WideString WordBool Description Boolean Adds a tag toolbutton inserts tag pair when clicked to the passed toolbar Fails if toolbar does not exist Returns True if a tool...

Page 244: ...sToolBarName DeleteToolbar Syntax DeleteToolbar wsToolbarName WideString WordBool Description Boolean Physically deletes the toolbar Fails if the toolbar does not exist or if the toolbar is one of the...

Page 245: ...olbarName WideString WordBool Description Boolean Displays a toolbar if it is not already showing Fails if the toolbar does not exist Example function Main Var sToolBarName MyToolBar with Application...

Page 246: ...plication if app ToolbarExists TB_NAME app CreateToolbar TB_NAME app AddAppToolbutton TB_NAME c windows explorer exe Explorer app AddAppToolbutton TB_NAME c windows explorer exe app CurrentFolder Expl...

Page 247: ...amepath with Application fnamepath sToolBarName InputBox VersionText Enter the Toolbar name MyToolbar while ToolbarExists sToolBarName 0 sToolBarName InputBox VersionText Please chose another name MyT...

Page 248: ...cription Boolean Returns True if changes can be re done Example function Main var sMessage sMessage CanRedo with Application If ActiveDocument CanRedo sMessage sMessage Yes Else sMessage sMessage No M...

Page 249: ...Syntax CaretPosY integer read only Description The Y axis caret position Example function Main with Application if ActiveDocument CaretPosY 1 ActiveDocument CursorDocStart false Filename Syntax Filen...

Page 250: ...t using the Lines property might be slow especially for large documents For best results only use Lines to evaluate single lines of text If you must use Lines to update many lines you can increase per...

Page 251: ...SelStart Syntax SelStart integer Description Gets and sets the start of the current selection Example function Main with Application with ActiveDocument Select entire document SelStart 0 CursorDocEnd...

Page 252: ...ation if ActiveDocument TabIndex 0 DocumentIndex 0 Text Syntax Text OleString Description Gets and sets the complete document text Methods BeginUpdate Syntax BeginUpdate Description Turns off screen u...

Page 253: ...then the current selection is extended to the new cursor position The following values are allowed CursorLeft CursorRight CursorWordLeft CursorWordRight CursorDown CursorUp CursorPageDown CursorPageU...

Page 254: ...this function along with GetPreviousChar in long loops the code can run slowly GetPreviousChar Syntax GetPreviousChar OleVariant Description Returns the previous character GetTagAtCursor Syntax GetTag...

Page 255: ...sEndTag Syntax GotoPreviousEndTag wbSelect WordBool WordBool Description Boolean Moves the previous end tag and selects it if wbSelect is True Returns False if no tag is found Example function Main wi...

Page 256: ...veDocument InsertTag a href http www macromedia com a true InsertText Syntax InsertText InsertStr OleVariant wbOverwriteSelection WordBool Description Boolean Inserts the passed string at the current...

Page 257: ...ves changes to the active document Returns True if successful SaveAs Syntax SaveAs wsFileName widestring WordBool Description Boolean Saves changes to the active document to the file specified in the...

Page 258: ...ent column line TextPosToEditorPos Syntax TextPosToEditorPos var nPos OleVariant WordBool Description Boolean Converts an index in a text string in a VBScript script to the corresponding editor positi...

Page 259: ...ough the array var app Application for idx 0 idx app DocumentCount idx sFile app DocumentCache idx Filename Example This VBScript shows how to loop through the array set app Application for idx 0 to a...

Page 260: ...it was last saved Example function Main var sMessage sMessage Modified with Application If DocumentCache 0 Modified sMessage sMessage Yes Else sMessage sMessage No MessageBox sMessage VersionText 0 Re...

Page 261: ...xt Syntax Text OleString read only Description File contents of the cached document Example function Main var sMessage sMessage Your document contains the following text n with Application sMessage sM...

Page 262: ...x AddFileToProject const wsFilename WideString WordBool Description Boolean Adds the passed file to the active project The main project folder or a subfolder of the main project must contain the file...

Page 263: ...loadProjectDlg WordBool Description Boolean Displays the upload project dialog box for the active project UploadProject Syntax UploadProject const wsTargetDir WideString const wbForceLCase wbUp loadOn...

Page 264: ...ntax IsDirty WordBool read only Description Boolean Differences exist between the project as viewed in the Visual Tools and the underlying disk structure IsFileSelected Syntax IsFileSelected WordBool...

Page 265: ...t Syntax CreateProject ProjectName OleVariant ProjectPath OleVariant Description Creates a new project DeployScriptList Syntax DeployScriptList OleVariant Description List scripts associated witht the...

Page 266: ...der methods FolderAddFile Syntax FolderAddFile Folder OleVariant Filename OleVariant Description Add a file to the specified folder FolderAllFiles Syntax FolderAllFiles Folder OleVariant OleVariant De...

Page 267: ...e OleVariant Description Removes file from specified folder FolderRenameFile Syntax FolderRenameFile Folder OleVariant OldName OleVariant NewName Ole Variant Description Renames a file within a projec...

Page 268: ...eVariant Description Lists all project deployment scripts DeploymentScriptRemove Syntax DeploymentScriptRemove ScriptName OleVariant Description Removes a deployment script from the project Deployment...

Page 269: ...ProjectManager Object 251 DeploymentServerRemove Syntax DeploymentServerRemove ServerName OleVariant Description Removes a deployment server from a project...

Page 270: ...hether the deployment engine creates the missing folders on the target server EncryptCFML Syntax EncryptCFML WordBool read write Description Boolean Determins whether the deployment engine encrypts al...

Page 271: ...of the project s stored deployment server list but is added temporarily for custom deployment tasks The following ITServerType values are allowed 1 FTP 2 RDS CheckServerFolders Syntax CheckServerFolde...

Page 272: ...dBool Description Boolean Checks to see if a file exists GetDeployServerName Syntax GetDeployServer nServer integer WideString Description Returns the name of the server in the server list based on th...

Page 273: ...ring nIndex Integer Wide String Description Returns the extension of a folder file based on the passed folder name For details see Project folder names on page 257 GetFolderFileName Syntax GetFolderFi...

Page 274: ...ing project file PathExists Syntax PathExists const wsFolderName WideString WordBool Description Boolean Checks to see if a path exists SetDeployState Syntax SetDeployState sServerName WideString bSer...

Page 275: ...loy folders Project folder names Project folder names are stored in the following format Project Folder Subfolder1 SubFolder2 SubFolderN where Project represents the name of the project Folder represe...

Page 276: ...Manager OpenProject D Projects Release Notes version 5 CFS Test1 apf Bypass servers and perform local deployment DeploymentManager IsLocalDeployment true Project Server Selections Project Server Deplo...

Page 277: ...you chose for the folder if DeploymentManager IsFolderDeployable sFolderName Iterate through Folder Files for n 0 n DeploymentManager GetFolderFileCount sFolderName 1 n sFromFile DeploymentManager Ge...

Page 278: ...on of the client that initiates a request Use this property to identify yourself as a client type or emulate a browser AuthorizationRequest Syntax AuthorizationRequest OleVariant read only Description...

Page 279: ...cName Syntax DocName OleVariant read only Description The document name segment from the requested URL LastResponse Syntax LastResponse OleVariant read only Description The most recent response conten...

Page 280: ...Syntax Proxy OleVariant Description Sets and gets the proxy server Use the GetApplicationSetting function with the following setting constants 50 and 51 to extract the users proxy server settings var...

Page 281: ...nd the Reason Phrase is for the human user The following are some of the Status Code Reason Phrase pairs 200 OK 201 Created 202 Accepted 204 No Content 301 Moved Permanently 302 Moved Temporarily 304...

Page 282: ...from a source that does not have its own URI such as input from the user s keyboard Sender Syntax Sender OleVariant Description Sets and gets the sender parameter SendStreamAsString Syntax SendStreamA...

Page 283: ...rname OleVariant Description Sets and gets the Web server access username Methods Abort Syntax Abort Description Aborts the current HTTP operation Get Syntax Get Description Performs an HTTP GET metho...

Page 284: ...httpPro ModifiedSince n Cookie httpPro Cookie n ContentTypePost httpPro ContentTypePost n MultiThreaded httpPro MultiThreaded n State httpPro State n ContentLength httpPro ContentLength n ContentType...

Page 285: ...10 10 99 var PostStream Customer_ID httpPro URLEncode CustomerID ProductNumber httpPro URLEncode ProductID SaleDate httpPro URLEncode DateSold httpPro SendStreamAsString PostStream httpPro Post var sO...

Page 286: ...d script This script downloads a ZIP file using SaveReceivedStreamToFile function Main var hsOKInfo 64 var app Application var httpPro app HTTPProvider httpPro URL http 127 0 0 1 test zip httpPro Get...

Page 287: ...e the page source into the string else sSource font size 2 color 0000ff If the page cannot be displayed post error message and show a reason sSource sSource The request could not be completed br br li...

Page 288: ...the value from 0 to 9 0 represents no compression 1 is fastest compression and 9 is the slowest but most size efficient compression ExtractionDir Syntax ExtractionDir OleVariant Description Sets and g...

Page 289: ...n Main var hsOKInfo 64 var app Application var ZIPPro app ZIPProvider ZIPPro ExtractionDir d ExtractHere ZIPPro ZipFile d downloads test zip var ResultCode ZIPPro Extract somefile exe app MessageBox R...

Page 290: ...neral else if nStatusCode 30 sMessage WarningNoZipFile else if nStatusCode 40 sMessage WarningFilesSkipped else if nStatusCode 50 sMessage WarningEmptyZipFile else if nStatusCode 100 sMessage ErrorNoZ...

Page 291: ...entire directory using wildcards If left an empty string all files are extracted The function returns a status code that you can investigate to determine whether the operation succeeded Extract Synta...

Page 292: ...unction to determine whether a specific element in an archive is a system file The index value can be from 0 to FileCount 1 FileIsVolume Syntax FileIsVolume nIndex Integer WordBool Description Boolean...

Page 293: ...ZIPPro FileName x cfabort vtm app MessageBox quot File found in the archive quot quot ZIPProvider quot hsOKInfo FileSize Syntax FileSize nIndex Integer Double Description Returns the size of an existi...

Page 294: ...color Blue sTable sTable Names and properties of all open documents sTable sTable FONT B br br br sTable sTable TABLE border 1 width 500 newline sTable sTable newline TR TD B Document Name B TD sTable...

Page 295: ...enter No td td center close row sTable sTable td tr newline count increment count by 1 sTable sTable newline table br br sTable sTable b i font color 0000ff You ran this script inside font i b sTable...

Page 296: ...t AllaireClientApp TAllaireClientApp set app Application save the index of the current document so it can be returned to nCurrentIdx app DocumentIndex start the table sTable b font color Blue Names of...

Page 297: ...be the new document created above app ActiveDocument InsertText sTable False switch to browse mode app CurrentView 2 wait for user to re enter edit mode while app CurrentView 1 Wait is a home grown ro...

Page 298: ...re Macromedia Studio5 RunOnce HKEY_CURRENT_USER Software Macromedia JRStudio4 RunOnce After these keys are read the program deletes the entries so that they do not execute again Sample startup script...

Page 299: ...281 add script toolbutton app AddScriptToolbutton TB_NAME app AppPath test bas Script Toolbutton SC add VTM toolbutton app AddVTMToolbutton TB_NAME app AppPath Extensions TagDefs HTML div vtm VTM Too...

Page 300: ...7 CMDID_cmdFileSave 8 CMDID_cmdFileSaveAs 9 CMDID_cmdFileSaveAsTemplate 10 CMDID_cmdFileSaveAll 11 CMDID_cmdFileReload 12 CMDID_cmdFileInsert 13 CMDID_cmdFileConvertTextFile 14 CMDID_cmdFilePrint 15...

Page 301: ...ID_cmdEditDeleteToEOL 47 CMDID_cmdEditDeleteWordLeft 48 CMDID_cmdEditDeleteWordRight 49 CMDID_cmdEditSelectAll 50 CMDID_cmdEditConvertTagCase 51 CMDID_cmdEditGotoLine 52 CMDID_cmdEditGotoPreviousStart...

Page 302: ...k 80 CMDID_cmdToolsSpellCheckAll 81 CMDID_cmdToolsSpellMark 82 CMDID_cmdToolsDocumentWeight 83 CMDID_cmdToolsThumbnails 84 CMDID_cmdToolsVerifyLinks 85 CMDID_cmdToolsValidateDoc 86 CMDID_cmdToolsValid...

Page 303: ...lChar 106 CMDID_cmdViewTagInsight 107 CMDID_cmdViewTagTip 108 CMDID_cmdViewEditorToolbar 109 CMDID_cmdViewEditorTab 110 CMDID_cmdViewToggleQuickBar 111 CMDID_cmdViewResults 112 CMDID_cmdOptionsSetting...

Page 304: ...emplate to use when creating new documents SET_SHOW_RESTAB 6 Display the resource tab SET_CURRENT_RESTAB 7 Page in resource tab active when closed reset at startup SET_RESTAB_ALIGN 8 Set Resources tab...

Page 305: ...AGHELP_DELAY 29 Milliseconds to delay tag insight SET_LOWERCASE_TAGS 30 Lowercase inserted tags SET_HEX_COLORS 31 Always use hex values instead of color names SET_DHTMLED_ALLOW_FRAMES 32 If True allow...

Page 306: ...Set height in pixels for files tab pane SET_PROXY_NAME 50 Set the proxy port name for link verification and open from Web SET_PROXY_PORT 51 Set the proxy port for link verification and open from Web S...

Page 307: ...ocument overrides default template SET_SHOW_SHORTCUT_IN_HINTS 85 Show keyboard shortcuts in toolbutton hints SET_INTERNAL_BROWSE_MOZILLA 86 Use MOZILLA as the internal browser SET_OEM_CONVERSION 87 Co...

Page 308: ...SET_SPECIALCHAR_LAYOUT 131 Layout orientation of special character toolbar SET_DREAMWEAVER_INTEGRATION 140 Set Dreamweaver integration and file save prompt SET_DREAMWEAVER_LAUNCH_TYPE 149 Set Dreamwea...

Page 309: ...ctory SET_DIR_AUTOFORMATTERS 168 Set Codesweeper profile directory SET_DIR_SAVED_SEARCHES 169 Set location of saved searches directory SET_DIR_HTML_HELP 170 Set location of html Help files directory S...

Page 310: ...tips SET_STYLE_EDIT_WND_CLASS 216 Used to dynamically invoke a style editor StyleEd or TopStyle SET_STYLE_EDIT_OLE_OBJECT 217 Used to dynamically invoke a style editor StyleEd or TopStyle SET_EDITOR_F...

Page 311: ...ORDWRAP 323 See fAllaireClientMain ShowEditor Pos SET_EDITOR_LINE_NUMBERS 324 Set line numbers in editor gutter SET_EDITOR_AUTOPOUND 325 Set auto insertion of pound sign SET_EDITOR_CHARSET 326 Set edi...

Page 312: ...when user clicks toolbutton SET_CFS_HELP_SERVER CFStudio only 61 Server to map to in dxWebBrowser DoMSIENewWi ndow when user browses snippets SET_CFS_ADJUST_HELP_EXAMPLES CFStudio only 62 If False th...

Page 313: ...al to the location of the image to display breakpoint Point in your code where the debugger stops processing and waits for your input browser Program that displays markup language documents and other...

Page 314: ...ation that others can access For example your relatives across the country cannot see the online photo album that you created on your computer until you deploy the files to a Web server You can also d...

Page 315: ...rpreting the characters as tag brackets FTP The File Transfer Protocol FTP defines an Internet standard for transferring files between two computers over a given network GIF Graphic Interchange Format...

Page 316: ...mail link This link opens the user s e mail program if he has one and begins a new message to the e mail address contained in the mailto tag mapping Association between the physical directories where...

Page 317: ...Code for a color in hexadecimal 0 9A Fa f notation The code is comprised of three pieces which signify the level of red green and blue in the color Each of these pieces is either a 2 digit number from...

Page 318: ...Languages HTML XHTML thumbnail Miniature depiction of an image Usually thumbnails for several images are placed together so users can preview the thumbnails and decide what to do with the images if an...

Page 319: ...ypertext Markup Language Reformulation of HTML as an XML application It is almost identical to HTML 4 01 but more strict and clean It is designed to replace HTML and it works on most existing HTML bro...

Page 320: ...302 Glossary...

Page 321: ...10 options for internal 10 removing integration from 12 setting file saving behavior 12 viewing integrated 11 viewing pages in external 12 building favorite folders list 51 SQL select statements 114...

Page 322: ...DBCS 3 debugging about debugger 117 118 121 123 breakpoints for 122 debugger output 122 form submittal 123 running debugger 121 setting up sessions for 118 using debugger 118 watches for 123 windows...

Page 323: ...pt 201 VTOM download script 268 VTOM FileName script 274 VTOM GET script 265 VTOM HTTPProvider script 269 VTOM POST script 267 VTOM startup script 280 VTOM toolbar scripts 228 257 VTOM ZIPFile script...

Page 324: ...Japanese support for 3 Java about 84 color coding for 95 JavaScript case sensitivity in CodeSweepers 99 color coding for 95 reference tree 60 wizard 60 JRun 84 JScript color coding for ASP with 95 JS...

Page 325: ...toolbars 31 outline profiles about 77 creating 77 editing 77 78 101 importing 78 output of debugger 122 P passive mode server connections 16 passwords for FTP servers 15 passwords for JRun RDS 18 pdf...

Page 326: ...erting to installed certificate and key 17 reviewing deployment results 148 RGB values 299 root URLs setting for FTP servers 168 RTML 84 rules CodeSweeper 100 validator 102 running CodeSweepers 98 deb...

Page 327: ...s priority of 106 Tag Tree about 77 configuring 78 importing outline profiles for 78 modifying outline profiles in 78 outline profiles in 77 tags adding Help with VTML 180 completing 56 editing 57 edi...

Page 328: ...eDocument Object 230 Application Object 199 DeploymentManager Object 252 DocumentCache Object 241 examples ActiveScripting 276 Add script 272 ApplicationType script 199 cookie script 261 CurrentView s...

Search results

Summary of Contents for ColdFusion Server 5

Reviews:

Related manuals for ColdFusion Server 5

Brands by name

Popular brands

MACROMEDIA ColdFusion Server 5, Use Manual

Search results

Summary of Contents for ColdFusion Server 5

Reviews:

Related manuals for ColdFusion Server 5

Brands by name

Popular brands