ColdFusion Builder's tooling is divided into several forms called views.
The Navigator is a basic view that comes with Eclipse. It allows you to see and organize your projects and files.
One of the overlooked featured of this view is the concept of “Working Sets”. They allow you to group various projects together and then selectively show or hide groups. This is very effective when you have tens of projects split amongst many clients. This can allow you to only see your current projects without having to go through the trouble of archiving and removing projects that you aren't working on but could pick up at any moment.
To access Working Sets:
- In the Navigator Panel
- Click the down arrow at the top right
- A menu should open with Select Working Set
The File view allows you to navigate the file system of your workstation independent of any projects you may have setup. This is useful if you need to quickly open a file from a project before you started using ColdFusion Builder and Projects. One of the other things the file view can do is connect to FTP/ SFTP servers. This means that you can review remote files, and edit code on them.
We used the Server view previously to add a server. However it can do more. Through this interface you can do the following:
- See current status
- Start/Stop/Restart Server
- Launch the Administrator
- Launch the Server Monitor
When you start your ColdFusion server via the Servers view, the Console output for the server is printed here. This can be very useful for seeing errors occur in real time. Also content that is written to the main application log for your server will show up here. So you can use CFLog to make content appear in the Console.
Tail View allows you to see the contents of a file updated in real time. This is very useful for targeting the error log of your ColdFusion server. However it's important to note that you are not limited to ColdFusion logs. Any text file on your system can be seen this way, like your Web server logs, or mail logs.
The Service Browser shows you all CFCs that are installed under a ColdFusion server's webroot. It allows you to inspect all of the methods, see arguments, and filter for access.
It also allows you to paste code calling these CFCs and methods into your code window.
To paste code from Service Browser:
- Open index.cfm
- Click the Service Browser tab
- Right Click the icon for localhost
- Click Refresh Active RDS Server
- Find and Expand SampleProject in the list
- Expand SampleProject.utility
- Right Click getToday()
- Choose Insert CFInvoke
- Look at index.cfm in editor window; a cfinvoke tag should now be in the code.
This view allows you to install, review information about, refresh, and delete ColdFusion Builder Extensions. These will be discussed separately.
Outline presents organized version of your highlighting major structures in your code. You can use the outline to click through to those structures in your code. It is configurable, sortable and filterable, so you can choose what shows up in the outline.
A great use of this is when you inherit a project where the functions in CFCs aren't alphabetized. You can easily go to the Outline view, filter for functions, and then sort alphabetically.
RDS stands for Remote Development Services in the ColdFusion world. It allows developers to access key pieces of information about a remote server. It has be be setup as part of your ColdFusion server install. Be aware that it is perfectly reasonable to have installed on your local install of ColdFusion, but it is discouraged on public facing or shared hosting machines due to the large amount of information it makes available.
RDS Data view allows you to see and interact with datasources that you've setup on your ColdFusion server. It allows you to see tables, views, columns, and column definitions. Using context menus from this view you can activate the RDS Query Viewer.
RDS Query Viewer
This view is an interactive query window that allows you to test SQL SELECT statements against your datasources. Note that it only allows SELECT, you can not use it to alter data in the datasource.
This allows you to browse the file system on your ColdFusion server. This is obviously much more useful for remote server then for your local system.
Snippets allow you to create brief bits of reusable code, organize them, and pull them into your code. You can even create shortcuts that you can use to pull snippets into your source code using shortcut keys.
To Create a Snippet:
- Go to the Snippet View
- Click the Plus icon
- Set the following values:
You should now have a snippet named “Quick Date” in your Snippet View.
To use a Snippet:
- Open index.cfm
- Double Click “Quick Date” in the Snippets View
- Date code should appear
However we can do that even faster. Delete that quick date in index.cfm.
To use Trigger text:
- In index.cfm type “qd”
- Now hit CTRL + J
- Date code should appear