Specify the different editor preferences that you want to set.
ColdFusion Builder provides a CFML Editor that has feature-rich code editing capabilities for CFM, CFC, HTML, JavaScript, and CSS files. The CFML Editor assists you in writing code by including features like, code completion, and streamlined code navigation. The CFML Editor lets you use different colors and fonts to display your code in the workspace.
You can customize your development environment by setting editor profiles and preferences.
An editor profile lets you group and save the following editor preferences under one profile.
Editor profiles are useful when you have different editor preferences for various development needs. For example, you can select a set of preferences like Code Assist, code colorization, and keyboard shortcut preferences and save them under a single editor profile. You can apply all these settings at once by selecting the editor profile.
To create an editor profile, do the following:
Specify the different editor preferences that you want to set.
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles, and click Create New Profile.
Enter a name for the profile. The current editor preference values that you set are saved under this profile.
You can also modify default settings and save the modified settings as a new profile. Additionally, you can also import or export profiles.
By default, ColdFusion Builder provides three editor profiles:
To select an editor profile, click the Active Profile drop-down list in the Profiles dialog box, and select the profile.
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor.
You can specify default filenames for the CFM and CFC files that you create. To remove any trailing whitespaces in the file, select Trim Spaces Before Saving Files.
You can also specify any text or boilerplate code that must appear, by default, in every CFM and CFC file. For example, suppose you want copyright information to appear in every CFC file that you create. In this case, you can specify the copyright text in the CFC tab under New File Settings.
The editor preferences that you can set include code assist, code colorization, keyboard shortcuts, outline view, syntax checking, and typing preferences.
The preference options that you select affect the performance of ColdFusion Builder. For faster editor performance, you can apply preset editor preferences
To apply preset editor preferences, click Optimize Editor Preferences. The following preference settings are applied:
The following options are deselected.
The following options are selected.
Code Assist is also called Content Assist. These terms are used interchangeably.
Code Assist is designed to assist you with code completion. Depending on the code that you enter, hints relevant to complete the code appear. As you type the code in the CFML editor, Code Assist prompts you with a list of valid CFML tags, parameters, and attributes. These suggestions appear in a pop-up menu. If you have HTML, JavaScript, or CSS content within the CFML code, Code Assist displays code completion hints for this code as well. Double-click or press Enter, to insert the code completion hint in the CFML Editor.
Code Assist is also available for script-based syntax; for example, code hints appear for functions and components in the script syntax. When you import Ajax libraries into ColdFusion projects, Code Assist is available even for the JavaScript code.
Code hints appear whenever the framework or language (CFML, HTML, JavaScript, and CSS) provides options for you to complete the current expression. For example, if you type within a CFML tag, you are prompted with a list of all the attributes of that tag.
In a CFML page, begin entering a CFML tag by typing:<cf Relevant code hints are displayed as follows:
Code hints
Navigate through the list of code hints using the Up Arrow and Down Arrow keys.
Select a code hint and press Enter. The selected tag is added to the editor.
As you continue to enter code, additional code hints are displayed. You can also press Ctrl+<Space> to display code hints while you enter a line of code.
The Smart Tag Assist feature of the CFML editor identifies if a tag attribute is already entered for a particular tag. If you have already entered a tag attribute, that attribute does not appear in the list of suggested attributes.
Displays a list of components that can be extended in the current CFC file.
Code Assist is not supported for comments that are added to component properties. For example, Code Assist is not supported for a comment that you add to the numeric accountID property as follows:/** @ – code assist is not supported here --*/
Many ColdFusion frameworks create CFCs during application startup and store these CFCs as scope variables. To provide Code Assist for such CFCs, ColdFusion Builder must determine the content and data type (fully qualified name of the CFC).
To enable Code Assist for CFCs that are stored in scoped variables, define a project-level mapping for the variable name and its corresponding CFC type. ColdFusion Builder uses this mapping information and displays a list of CFC methods for the mapped variable, without creating an object of that data type. For example, you can map mycfc1 to com.adobe.mycfcs.cfc1. When you type mycfc1 and press Ctrl+<space>, all the methods available for com.adobe.mycfcs.cfc1 appear.
To configure a variable mapping, in the Properties dialog box, Specify the variable to map as mycfc1 and the mapped to value as com.adobe.mycfcs.cfc1. For more information, see Configure variable mappings.
Object Relational Mapping (ORM) is a programming technique that lets you define a mapping strategy using object models. You can use Object Relational Mapping to store and retrieve data from a relational database.
ColdFusion Builder provides Code Assist for the following ColdFusion ORM settings:
For more information about using ColdFusion ORM, see ColdFusion ORM in the ColdFusion Developer Guide.
Code Assist is available for Application.cfm and Application.cfc files.
Application.cfm is considered an included file and Code Assist is available for all variables and functions within the file.
For Application.cfc, Code Assist is available only for scoped variables that are declared in onApplicationStart.
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Code Assist.
Select the Automatically Display Code Assist When Typing check box to automatically display Code Assist when typing.
When editing large-sized files, you can deselect the Automatically Display Code Assist When Typing check box to improve performance of the editor. You can, however, display code hints while you enter a line of code by pressing Ctrl+<Space> or any other keyboard shortcut that is set.
Component names and UDFs are hyperlinked on Ctrl+hover. If you click the hyperlink, the corresponding code is opened in ColdFusion Builder. Code hyperlinks are available for:
Use ColdFusion Administrator to define server mapping for CFCs. The server mappings allow you to view these CFCs as part of Code Assist when you use the extend or implement keywords.
ColdFusion server mappings let cfobject and cfinvoke tags, or functions like createObject or new, access pages and find ColdFusion components outside the document root.
If you specify a path in these tags that starts with the mapping's logical path, ColdFusion looks for the CFC using the mapping's directory path. You can define server mapping for the CFCs using the ColdFusion Administrator. After mapping, you can view the CFCs in Code Assist when you use the extend or implement keywords, and component or method attributes. The CFCs suggested in Code Assist are resolved with their fully qualified names.
Once mappings are created for the CFC name resolution from the server, the server settings are cached and available even when the server is not running. The server settings are collected when the server is started or refreshed from ColdFusion Builder.
From the Windows menu, select Preferences.
In the tree view structure, select ColdFusion > Server Settings.
Select the Build Server Settings check box and the Required check box to indicate the action for collecting server settings. For example, to collect server settings each time you start ColdFusion Builder, select the ColdFusion Builder Started check box.
ColdFusion Builder provides in-built dictionaries that assist you with CFML code completion. The CFML dictionary is an XML file that contains information about each tag and function contained in the library. For example, the CF9 dictionary file (cf9.xml) contains information about all the available CF9 tags and functions.
ColdFusion Builder provides dictionary support for ColdFusion 11, ColdFusion 10, ColdFusion 9, ColdFusion 8, and ColdFusion MX7 versions.
To select a dictionary version, do the following:
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Code Assist.
Select the Code Assist Dictionary version drop-down list and select a dictionary version to assist with code completion.
Click Reload Dictionaries to reload all the dictionaries, including custom dictionaries.
You can create a custom CFML dictionary (XML file) and make it available to use for Code Assist and Tag Editor within ColdFusion Builder.
Within the ColdFusion Builder installation, navigate to the following location:\plugins\com.adobe.ide.coldfusion.dictionary_XXX\dictionary
Create a folder called "Custom" within the Dictionary directory.
Create an XML file to describe the custom tags and functions. For example, in the XML file, you describe each tag within <tag></tag> elements, and enclose all the tag elements within <dictionary></dictionary>elements as follows:
<dictionary> <tags> !-- cfabort showError = "error_message" --> <tag endtagrequired="false" name="cfabort" single="true" xmlstyle="false"> <parameter name="showerror" required="false" type="String"> </parameter> </tag> </tags> </dictionary>
See the cf9.xml or cf8.xml files as reference to create the custom CFML dictionary.
In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Auto Insert Required Tag Attributes to insert the required attributes of a tag.
This is the default setting.
For example, if you select cfpdf "action=write", all the required attributes destination, source, and name are automatically inserted.
If the preference is not selected, the attributes are not inserted but only proposed.
Code Assist prompts you with a list of tag attributes as follows:
Code Assist proposes all objects (and the corresponding arguments) supported by the function createObject.
In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Cycling Code Assist Proposals for cyclical code assistance.
This is the default setting.
Consider the scenario where when you press Ctrl+<Space>:
Cyclic Code Assist does not appear if you manually specify a part of the text for which you want prompt.
In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Filter Proposals Containing Text to filter proposals based on the text you specify.
This is the default setting.
All proposals that contain the filter text you specified are listed with selection set to the proposal that starts with the specified text.
Shows Code Assist proposals based on expected data types.
For example, when you load Code Assist within the function Abs, it shows functions and variables of type numeric, Any, or complex data types such as array, struct, or component.
When you insert a function, all required arguments are automatically inserted. By default, the first argument is selected.
In ColdFusion Builder (the previous release), function context assist appears only after you insert functions from the Code Assist proposals.
Parameter that you currently edit is highlighted in bold.
Smart Code Assist displays connection variables created for tags such as cfexchangeconnection and cfftp.
Based on the type of loop, the required attribute is auto-inserted. For example, if you loop over an array, the attribute index is auto-inserted.
Use the shortcut Ctrl+Alt+B (Windows) or Command+Option+B (Mac) to select tag blocks. The enclosing tag block from the caret position is selected.
Retain the selection and repeat the shortcut for cumulative selection of code.
For example, in the following snippet, when you press Ctrl+Alt+B/Command+Option+B, the cfform tag block is selected. If you retain the selection and then press Ctrl+Alt+B/Command+Option+B, code selection is extended to the next level of enclosure. That is, the entire code block is selected.
<cffunction name="test"> <cfform name="form1"> <!--- caret position ---> </cfform>
Use the shortcut Ctrl+Alt+M (Windows) or Command+Option+M (Mac) to move the caret position from beginning to end or end to beginning of a tag block.
The caret position can be anywhere within the start or end tag (and not exactly on the tag name).
Quick Fix recognizes the usage of methods, classes, and CFC/CFM files in the code and helps you generate them.
For example, if you type a user-defined function {{test() }}that is not defined in the page or any included page, Quick Fix helps you generate the function. The function call is inserted in the file.
When you open/edit a file, ColdFusion Builder automatically identifies the function calls, CFCs, and CFMs that are not defined. A bulb icon appears in the left margin of the editor which, if clicked, prompts you to perform the appropriate quick fix.
The shortcut CTRL+1 also yields the same result.
You can turn off the Quick Fix by unchecking Enable Quick Fix (Window > Preferences > ColdFusion > Profiles > Editor > Syntax Checking).
Quick Fix helps you in the following scenarios:
<cfset o1 = new component1()> <cfset st = structNew()> <cfset result = getResults("abc", 10, st)> <cfinclude template="test3.cfm" > <cfscript > o2 = new component2(); //Assume that component2 exists o2.someFunction(); </cfscript>
Line of code |
Issue |
Prompt |
---|---|---|
<cfset o1 = new component1()> |
Component is not created |
Create CFC |
<cfset result = getResults("abc", 10, st)> |
Function getResults does not exist |
Create the function getResults |
<cfinclude template="test3.cfm" > |
test3.cfm does not exist |
Create test3.cfm |
o2 = new component2(); |
Component does not exist |
Create someFunction in component2. |
To format a section of the code, select it before step 2.
Code Formatter has an off-the-shelf set of preferences defined in a profile. To customize the preferences, create a profile or modify the default profile after giving a new name.
In ColdFusion Builder, select Window > Preferences.
In the tree view, select ColdFusion > Profiles > Editor > Formatter.
Click Add to add a new profile or Edit to edit an existing profile after selecting the profile in the Active Profile.
You cannot edit the default profile.
In the CFML Formatting Profile, add or modify the profile by setting the rules specified in the following table. The code formatting preferences are based on the rules. Each tab in the dialog box represents a rule.
Rule |
Options to |
---|---|
General |
• Specify if you want to maintain the case currently used for tags and attributes, or change it to upper or lowercase. |
Indentation |
• Specify the indentation details and the name of the tags for which you do not want to apply indentation. |
White space |
• Add white space based on your selections. |
Wrapping |
• Specify the number of attributes in a line within a tag and set the column width. |
Braces |
• Specify if the curly braces are placed in the same or new line for component and function declarations and switch, if, else, and try blocks. |
You can share the formatting preferences in XML format.
Use the appropriate buttons in the Formatter section of the Preferences dialog box (Window > Preferences > ColdFusion > Profiles > Editor > Formatter) to export your preferences or import preferences shared by somebody.
ColdFusion Builder automatically indents lines of code and adjusts the ending tag, to improve readability.
Auto-formatting works in the following scenarios:
ColdFusion Builder can highlight the syntax for CFML tag names, attributes, attribute values, keywords, comments, and various other elements in different colors. Code colorization is also supported in script-style coding. You can customize the color preferences and override the default Eclipse editor color preferences.
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Syntax Coloring.
From the Window menu, select Preferences.
n the tree-view, select ColdFusion > Profiles > Editor > Colors. Under Tokens, scroll down to SQL, and select color preferences for comments, keywords, and text.
The CFML editor has an integrated SQL editor that lets you edit, write, and execute SQL statements.
To use the SQL editor, you must have a server configured and running in ColdFusion Builder. The SQL editor does not support offline databases.
The SQL Editor supports Code Assist and code colorization for the following types of SQL statements:
For SQL statements within the cfquery tag, Code Assist is available in the CFML Editor itself. You need not open the SQL Editor for code completion hints.
Do one of the following:
In the SQL Editor, select a server from the Server drop-down list and a database from the Datasources drop-down list.
Enter the SQL statement and do the following:
You can also copy SQL code blocks from the SQL Editor directly into the CFML editor by selecting the code block and pressing Shift+Enter.
To edit a SQL code block in the CFML editor, select the code block, right-click, and select SQL Editor. The selected code block appears in the SQL Editor.
For more information about basic SQL syntax and writing SQL statements, see Using SQLin the ColdFusion Developer Guide.
SQL Code Assist is available only for database table names and field names in the SQL statement.
By default, SQL Code Assist is turned on in ColdFusion Builder, and code hints for SQL statements are automatically displayed in the CFML Editor. To turn off the automatic display of SQL Code Assist, do the following:
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Code Assist.
Deselect Automatically Display SQL Code Assist When Typing.
Even with the automatic display of SQL Code Assist turned off, you can still get code hints within your SQL statements as follows:
Begin entering the SQL statement in the SQL editor and press Ctrl+<Space> to display the database table names or field names.
Navigate through the list of table names or field names using the Up Arrow and Down Arrow keys.
Select a table name or field name and press Enter. The selected table or field is added to the SQL statement.
ColdFusion Builder provides Code Assist for the query attribute of the <cfoutput> tag. For example, when you type, <cfoutput query="">, and press Ctrl+<Space> with the caret position between the double quotes "". A list of queries created in that file or included files appears.
Code Assist is also provided for query names that are used in expressions.
For example, if you create a query like:
<cfquery datasource="dsn1"name="q1"> Select id, firstName, lastName from employee </cfquery>
When you type the expression <cfset name = q1.> and press Ctrl+<Space>, ColdFusion Builder displays the columns selected in that SQL query.
In the CFML editor, SQL code colorization is supported only within the cfquery tag. You can colorize SQL keywords, comments, and text within the cfquery tag. Colorization is supported only for the following types of SQL comments:
To set SQL code colorization preferences, see Set SQL Editor color preferences.
The CFML editor provides many shortcuts for navigating through your code. Shortcuts include folding and unfolding code blocks, opening the source of code definitions, and browsing and opening types. You can collapse and expand multiline code blocks to navigate, view, and manage complex code documents. In ColdFusion Builder, collapsing and expanding multiline code statements is called code folding and unfolding. You can use this feature in a CFM, CFC, or HTML file.
You can hide and display code blocks of your preference. The code folding that you define is saved and therefore is available for future sessions.
Folding a code block hides all but the first line of code.
Move the pointer over the unfold icon to show the folded code in a tool tip.
Unfold a code block to make the code visible
Select the block of code you want to hide.
Do either of the following:
To remove code folding for a block of code,
You cannot have multiple code folding starting with the same line of code.
Syntax checking and highlighting
When you select a tag or code bracket in a CFM file, the matching pair of the tag or bracket is automatically highlighted.
If you type code that is not recognized as valid CFML code, you are notified in the following ways:
Syntax errors are displayed only for open CFM files and are not displayed after you close a CFM file.
Depending on the nature and severity of the errors, your application sometimes does not run properly until the errors are corrected.
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Syntax Checking.
Syntax checking is turned on by default. To turn off syntax checking, deselect Enable Syntax Checking.
To display syntax errors only when opening or saving a file, select Display Syntax Errors Only on File Save. While editing the file, all errors in the file are removed from the Problems view.
Use the shortcuts Ctrl + Shift + Up arrow key and Ctrl + Shift + Down arrow key (Windows) or Command + Shift + Up arrow key and Command + Shift + Down arrow key (Mac) to easily navigate inside your code.
Code navigation works for both tag and script-based syntax.
The following sections explain how code navigation functions in various scenarios:
Caret position changes from a user-defined function to the next or previous one.For example, in the following snippet, if the caret position is on or within func1, if you press Ctrl + Shift + Down arrow key, then the caret position moves to func2 and selects the function name. From anywhere on or within funct2, }}if you press Ctrl + Shift + Up arrow key, then the caret position changes to {{func1 function and selects the function name.
<cffunction name="func1"> </cffunction> <cffunction name="func2"> </cffunction>
Caret position changes
To the top-level members of the CFC, for example to cfproperty directly inside the CFC. For example, in the following snippet, if you navigate from line number 1 (<cfcomponent>) downward, then caret position first changes to line 2 (<cfproperty name="prop1">), and further to line 4 (<cffunction name="func1">), and line 6 (<cffunction name="func2">). Moving upward, the caret position changes, taking the same path in the reverse order.When the caret position changes to cfproperty , the name is selected.
<cfcomponent> <cfproperty name="prop1"> <cfset this.var1 = 100> <cffunction name="func1"> </cffunction> <cffunction name="func2"> </cffunction> </cfcomponent>
For flow-control statements provided in CFScript (for example, in statements if-else, switch-case, and try-catch), in both CFC page and CFM page, caret position changes to the next or previous code blocks if the caret position is within any of these statements.For instance, if you press the same key combination withincfif tag, then caret position changes to the next cfelseif or cfelse statement.In the following example, if you navigate down from
If you do a reverse navigation (Ctrl + Shift + Up arrow key),
<cffunction name="func1"> <cfif a eq 10> <cfset b = 10> <cfelseif a gt 10> <cfset b = 20> <cfelse> <cfset b = 30> </cfif> </cffunction> <cffunction name="func2"> </cffunction>
You can quickly navigate to the next (use Ctrl + ] on Windows or Command + ] on Mac) and previous (use Ctrl + [ on Windows or Command + [ on Mac) function argument or tag attribute.
If caret position is at function call or tag name, for downward navigation, the position changes to the first parameter/attribute value.
For nested function calls, caret position changes to the next or previous parameter when you reach the end/beginning of parameters.
Smart tab navigation is applicable to cffunction arguments also in the case of function definition, for example
<cfscript>function abc(int a, int b) access=”package” output=”false”</cfscript>
In this case, when the caret position is on abc or function, it navigates to int a, int b , package, andfalse.
Smart tab navigation applies to both tag-based and script-based syntax.
Code refactoring is the process of improving the source code of a program without changing the overall result. Generally, code refactoring improves code readability and maintainability.
ColdFusion Builder supports various refactoring techniques like renaming, searching, and previewing of CFCs, CFMs, and UDFs at the project and workspace levels.
When you rename a CFC or CFM, you can refactor all valid instances of the CFM or CFC, including all references to the CFM or CFC.
Right-click the file in the Navigator pane.
Select Refactor > Rename.
Enter the new name and preview the changes. When you preview the changes, you can review the selected instances and deselect any instance that you do not want to rename.
To rename CFCs or CFMs across all projects in the workspace, select Update All Projects In The Workspaces.
You cannot rename a CFC or CFM in HTTP or Web server URLs unless the server is registered and running.
Refactor UDFs in CFC or CFM filesTo undo refactoring, use the keyboard shortcut Ctrl+Z (Windows) or Command+Z (Mac).
Open the CFM or CFC file in the editor.
Point to the function name, right-click, and select Refactor > Rename
Specify the UDF name and click OK.
Currently, function renaming is supported only through the main function declaration and not from function calls.
You can refactor methods created for application variables by creating variable mappings.
For example, consider a scenario where an application variable is defined for a CFC object as follows:
<cfset Application.appVar = createObject("component","abc.AppCFM.a")>
Say, you have a CFC function, Method(), that you call as follows:
<cfset Application.appVar.Method()>
To refactor the Method() function, create a variable mapping for the application variableApplication.appVar as follows:
In the Navigator view, right-click the project and select Properties.
In the Properties dialog box, select ColdFusion Variable Mappings.
Click New, enter the following details in the Add Mappings dialog box:
You can search for a CFC, CFM, or UDF in a project or workspace.
Right-click the project in the Navigator pane.
Click References and select Project or Workspace. The results are displayed in the Search window in ColdFusion Builder.
Other than searching for references at the project or workspace level, you can search for references while working in the CFML code editor. Right-click in the CFML editor and select References > File to search for file references. You can also search for references at the project and workspace level from within the CFML editor.
The Tag Editor assists you in adding tags and their attributes, even if you are not familiar with CFML. To use the Tag Editor in ColdFusion Builder, do the following:
Click the CFML tab in the Source area, if it is not already open.
Click the Tag Editor icon from the CFML toolbar. You can also open the Tag Editor by pressing the Ctrl+Shift+T.
If you do not know the tag, then search for the tag using the Tag Editor dialog box.
Specify the values for the tag attributes. The Tag Editor also displays values specific to an action attribute.
Click OK to add the tag to a CFML page.
The Tag Editor is context sensitive, so you can edit a tag by moving the cursor to the tag and pressing Ctrl+Shift+T. The Tag Editor for that tag is displayed, and you can specify or change the tag attributes.
When typing CFML tags, you can customize your typing preferences. You can specify preferences like the following:
Auto-insertion is enabled, by default. You can auto-insert matching characters for single and double quotes, brackets, and the ’#’ sign.
To turn off auto-insertion, do the following:
From the Window menu, select Preferences.
In the tree-view, select ColdFusion > Profiles > Editor > Typing.
Deselect Enable Auto-insertion.
ColdFusion Builder lets you:
Default shortcuts are the factory defaults listed in the Preferences dialog box (Window > Preferences > ColdFusion > Profiles > Keys).
You can import and export default shortcuts, but cannot change their name or description.
You can temporarily remove default shortcuts or modify them. When you click Restore Defaults in the Keys section of the Preferences dialog box, you lose all shortcuts you added, and any modifications. Also, the default shortcuts you deleted are restored.
For ease of organizing and use, it would be a best practice to follow a standard format for your keyboard shortcuts. For the default shortcuts, ColdFusion Builder follows the following formats:
For tags, Ctrl + T (Windows) or Command+T (Mac). For example, Ctrl + T, A (Windows) or Command+T, A (Mac) for cfabort .
The comma between Ctrl + T/Command+T and A indicates a sequence. That is, you have to first press Ctrl+T/Command+T, release the keys, and then press A for the shortcut to take effect.
Similarly, follow a convention which can make your shortcuts intuitive.
Also, to avoid shortcut conflicts, ensure that you define unique key bindings.
In ColdFusion Builder, select Window > Preferences > ColdFusion > Profiles > Keys.
Click Add.
Specify a unique name and description for the shortcut.
In the Key Binding, specify the shortcut.Conflicts are listed if you do not specify a unique key binding.
In the Inserting Text box, specify the text that must be inserted in the editor when you use the shortcut. The section Define caret position explains how to use macros to specify the caret position in the inserted text.
Click Save and then OK to close the preferences.
You can use macros to define caret position in the text (for which you create the shortcut) when it appears in the editor.
In the Keys section of Preferences dialog box, when you insert the text, specify the $${cp} macro in the position where you want the cursor to appear.
For example, if you specify
if($${cp}){ <cfoutput>#A#</cfoutput>}
with the binding Alt + T, when you use the shortcut, the block of text is inserted in the editor with the cursor between the parentheses that follows{{ if}}.
Quick Assist shows up the catalog of shortcuts for quick reference:
ColdFusion Builder Search provides specialized find and replace functionality to search text or tag. Apart from searching the current document, the scope of search can be any open document, selected resources in the Navigator pane, project, working set, workspace, local directory, FTP location, or RDS location. The feature also supports regular expressions and multi-line search.
To save time, you can run remote search in the background and continue with other tasks. The Search View provides the results with details of matches in each file you search.
ColdFusion Builder search applies only to the following file types: CFC, CFM, HTML, XML, CSS, and JS.
Run the ColdFusion Search dialog box using either of the following options:
From the Window menu, select Search > ColdFusion Search.
If you use this shortcut in any other context, for example, in a TXT file, the Eclipse Find/Replace dialog box appears instead. However, you can purposely open ColdFusion Search dialog box using the option Search > ColdFusion Search.
In the ColdFusion Search dialog box, specify the scope of your search. Depending on the scope, the search options vary.For example, the option Recurse subfolders (used to include subfolders in the search) applies only when your scope is FTP location, RDS location, or local directory.
(If the file is not open) To narrow down the search, specify the filename extension.
Do either of the following:
Select an action, that you want to perform, when the tag is found (such as removing or replacing the tag). If applicable, specify any additional information necessary to perform the action. For example, setting a new attribute for cfimagethickness .
Actions apply only if you use Replace or Replace All.
Use the following options to expand or limit the search:
Ignore White space : Treats all whitespace as a single space for the purposes of matching. For example, with this option selected, this text would match this text and this text but notthistext . This option is not available when the Use Regular Expressions option is selected; you must explicitly write your regular expression to ignore whitespace.
The tags and are not treated as whitespace.
Depending on the search scope, some options are disabled.
Search options are saved when you close ColdFusion Builder.
ColdFusion Builder Search View displays the search results of current search and maintains the history of previous searches.
ColdFusion Builder Search View
If you define tasks as CFML comments, the Task View (Window > Show View > Tasks) displays them based on the priority you set. The tasks are listed according to the default TODO and FIXME tags or the custom task tag prefix.
Open the CFM or CFC file in the editor.
Add the task in the format as shown in the following examples:
<!--- TODO: Fix the bug 268451 --->
or in cfscript
//TODO: Fix the bug 268451
and
/*TODO: Fix the bug 268451*/
The Task View (Window > Show view > Tasks) displays the first line of the CFML task comments.The priority column indicates if the task is of high, normal, or low priority. High priority tasks are indicated using red color.Tasks in all open CFM files are displayed. Since the tasks are saved, they are displayed in the later sessions, when you open the files.
Go to Window > Preferences > ColdFusion > Profiles > Editor > Task Tags.
Click New.
In the Add Task Tag dialog box, specify a unique name for the custom task tag and then select the priority.
Manually delete the tasks from the source code.This is unlike the tasks you manually create in the Task View, which can be deleted in the View itself.
Sign in to your account