no text exists for this slide

Hidden Gems in Editing
Hidden Gems in Editing
Hidden Gems in Configuring the IDE
Hidden Gems in Troubleshooting
Hidden Gems in Connecting to CF Servers
Hidden Gems in Editing Code on Remote Servers
Miscellaneous Hidden Gems
Some Gotchas
Resources for Learning More

no text exists for this slide

Lots of tips to share
Lots of tips to share
No time to detail each of them
Will often point to URL with more info
Presentation PDF posted at carehart.org/presentations
More to come
Will develop more detailed discussions as blog entries (carehart.org/blog)
Can watch for them
May also develop half-day class on CFB gems
As well as daylong class on Intro to CFB

May include those new to/expert in Eclipse
May include those new to/expert in Eclipse
May be coming from CFEclipse
May never have gotten into it, or tried and passed on it
May be coming from Dreamweaver/HomeSite+/CFStudio
There are some things that address each group
And there are some that fail to satisfy each group
Remember, it’s a v1 product
In fact, still in beta
Share your thoughts, but be patient
Be patient as well with this talk as well 
Yes, some may already know some of these things
Just sharing. Not expert. You likely know things I don’t

Available standalone and as plug-in
Available standalone and as plug-in
Most features should work the same
But be aware there can be differences
Bundles Aptana Studio (commercial plugin)
Many important features come from that
Note that installing own Aptana may conflict
Also, different base editions of Eclipse can impact
Be aware that it’s now in public beta 2
Some changes, which we will see
Of course, works with any version of CF
OK, on with the tips

When I refer in talk to CFBuilder Preferences
When I refer in talk to CFBuilder Preferences
it’s in Window>Preferences on Windows
   but in Adobe ColdFusion Builder>Preferences on Mac
I’ll just start with to Preferences> avoid confusion
But note that Window menu option does exist on Mac, used for other things, like Window>Show View
And of course, if I say ctrl-click something, on Mac that’s command-click

First some things DW/HS+ users may “miss”, and others like…
First some things DW/HS+ users may “miss”, and others like…
You don’t HAVE to work in projects
Available File tab (Window>Show View>File)
Has full access to file system
Also available FTP support (more on this later)
You CAN now open files from the OS
And it doesn’t open entire new workbench
http://www.carehart.org/blog/client/index.cfm/2009/7/28/cfbuilder_tip_opening_files_from_outside_editor

“edit included file” – and cfcs, and more
“edit included file” – and cfcs, and more
Ctrl-hover (command-hover on Mac) + click link
To open included file, invoked CFC/method/UDF
Whether in tag or script or using “new” keyword
Can even jump to specific method
Also html tags, like <script src=>
Obviously won’t work for paths stored in variables
Beware, may seem not to work hard-coded paths
Seems to be problem with linked folders
Also, if it doesn’t work at all, try closing and reopening file
http://blogs.adobe.com/cfbuilder/2009/07/code_hyperlinking.html

Split window
Split window
Use Window>New Editor
Can then right-click on tab to move to be above/below, side by side
Turning on word wrap
Preferences>HTML>Editors (no need to expand)
Then click Advanced tab
and click on Enable word wrap option
Also an available plugin
http://blogs.adobe.com/cfbuilder/2009/08/enable_word_wrap.html
Creating new blank page, without file name
File>New>Other>Untitled file

Turning on line numbers
Turning on line numbers
Right-click on gutter, “show numbers”…or…
Preferences>general>editors>text editors
Filter feature, in Preferences dialogue
Also useful in many other places in IDE
Local history – poor man’s version control!
Eclipse keeps tracks of changes (made in IDE)
Right-click text or file, Compare With>Local History
How far back are changes saved?
Preferences>General>Workspace>Local History

Find/search across multiple files
Find/search across multiple files
Ctrl-h or Search>Search
Can choose between entire workspace (all projects)
Or selected resource (if one is selected in navigator)
Finding currently open file in Project navigator tree
Right-click and choose Show In>Navigator
Wish tab inserted spaces instead?
Preferences>General>Editors>Text Editors (don’t expand)
Click Insert spaces for tabs

Switch among open files
Switch among open files
ctrl-f6 either choose from list or just toggle back and forth
ctrl-e opens list with just names, not paths. can either mouse down and select or type letters to filter and select
ctrl-pgup/dn common eclipse shortcut, and shift-tab/ctrl-shift-tab don’t work as expected
They switch between source and internal browsing
alt-left/right moves among opened tabs, but not in obvious order
ctrl-q takes you back to last file being edited

Be sure to explore (all in docs, and some blogs)
Be sure to explore (all in docs, and some blogs)
Refactoring
http://blogs.adobe.com/cfbuilder/2009/07/refactoring_in_coldfusion_buil.html
Snippets, trigger text, sharing
Snippets (in Window>Show View>Other>HTML Standard Views) as opposed to CF snippets (Window>Show View>Other>ColdFusion)
http://blogs.adobe.com/cfbuilder/2009/08/use_your_snippets_across_ides.html
Outline view (Windows>Show View>Outline)

As well as (discussed in docs)
As well as (discussed in docs)
Content assist in many places
http://blogs.adobe.com/cfbuilder/2009/07/content_assist_tips.html
Discussed as both code assist and smart assist in docs
Note available Ctrl-space to request assist anytime
Code folding
Equivalent of code collapse in DW, HS+
Moving, maximizing, resizing views
Just remember that you can
Editing more than just CFML
And much more

Code assist is quite configurable
Code assist is quite configurable
When, when not to assist, how fast, colors, shortcuts, etc
See Docs, “Code Assist” chapter:
http://help.adobe.com/en_US/ColdFusionBuilder/Using/WS0ef8c004658c1089-554789f8121af8f0c8c-7ffb.html
Available “editing profiles”
Can choose between Default, Eclipse, Dreamweaver
Preferences>ColdFusion>Editor Profiles
Can control Code Assist, Colors, Keys, Syntax checking, Typing, Outline
More in docs and at http://sandeepp.org/blog/?p=113

Keyboard shortcuts configurable, 2 ways
Keyboard shortcuts configurable, 2 ways
Preferences>ColdFusion>Editor Profiles>Editor>Keys
Preferences>General>Keys
CFB may overtake keys familiar in Eclipse/CFEclipse (ctrl+3)
Remember filter feature—can type name of keystroke to find and change
Customizable CFML dictionaries
For different versions of CF, different CFML engines
See docs, “Code Assist” chapter
“Recently opened files” setting
Preferences>General>Editors then Size of recently opened files list
Certainly much more, but need to move on

I lied, one more…
I lied, one more…
Saved perhaps best for last (in this section)
Those who don’t care for CF Servers feature miss being able to browse internally…
Beta 2 adds URL Prefix option for browsing, etc
Without needing to have defined a server and linked your project to a server
Can now right-click project/folder in , Set URl Prefix
Applies also to debugging
To browse, use Ctrl-tab/Ctrl-shift-tab or Ctrl Pgup/PgDn
http://blogs.adobe.com/cfbuilder/2009/07/previewing_a_file_in_123_steps.html

Problems with memory? What are 2 tips?
Problems with memory? What are 2 tips?
Can (perhaps should) increase default heap size
Especially if implementing FlashBuilder or other plugins
http://www.adrocknaphobia.com/post.cfm/update-your-coldfusion-builder-beta-settings-for-flash-builder-4-beta
Can view current memory use! Can request GC
Preferences>General then click Show heap status

Wondering why things are slow? Find out!
Wondering why things are slow? Find out!
Some may know common Eclipse troubleshooting views
Window>show view>
Console – shows various Eclipse operations
Problems – shows syntax errors in code, and more
Server – shows what’s going with CF server processing
Other>General>Error Log – shows errors with IDE itself
But many may miss the most important view!
Other>General>Progress - shows background processing (indexing of CFCs, FTP operations, much more)
CFB may seem slow at startup, due to “building server settings”
May see operations “indexing CFCs of server xxx”
“indexing files from webroot”
Shown in Progress view. Watch for it

Mac users may find that Time Machine is the culprit
Mac users may find that Time Machine is the culprit
Not saying “don’t use it”, but find if it’s the issue and report details to Adobe
For more thoughts, see
http://blogs.adobe.com/cfbuilder/2009/10/issues_on_mac_-_some_tips.html
If things aren’t working as expected, and you’ve used previous versions of CFBuilder or Eclipse
try creating a new workspace (File>Switch Workspace), to see if that helps

Also note available Workbench error log
Also note available Workbench error log
may help understand some problems
Help>Product Details>Configuration Details>View error log (opens log in browser window)
On OS X, it’s under Adobe ColdFusion Builder>About Adobe ColdFusion Builder>Configuration Details>View error log
(Indeed, in older Windows versions, it was at Help>About ColdFusion Builder>Configuration Details>View error log )
Adobe is also now recommending obtaining a stack trace (using a given tool) for knotty problems
http://blogs.adobe.com/cfbuilder/2009/10/cfbuildercfb_performance.html
http://forums.adobe.com/message/2328981#2328981

No time to get into all the challenges of connecting to servers, local or remote
No time to get into all the challenges of connecting to servers, local or remote
See CFBuilder docs for much more (important) explanation
See also Adobe Team blog entries
http://blogs.adobe.com/cfbuilder/2009/07/server_manager.html
http://blogs.adobe.com/cfbuilder/2009/07/remote_server_setup_is_it_real.html
http://blogs.adobe.com/cfbuilder/2009/07/remote_server_setup_-_multiser.html
http://blogs.adobe.com/cfbuilder/2009/08/importing_rds_server.html
Benefits are far more than just start/stop
“What does not work in content assist if a server is not associated with a project”
http://blogs.adobe.com/cfbuilder/2009/09/what_does_not_work_in_content.html

Beta 2 adds important changes for Server config (see docs)
Beta 2 adds important changes for Server config (see docs)
Adds virtual Host support
Can configure server settings to use web server virtual hosts
Applies to browsing, debugging, code assist, more
Adds support for non-JRun servers
Can now point to other than JRun (JBOSS, WAS etc) when configuring server settings
Can't start-stop-restart the server, but do get other benefits (recall previous page)
Adds various other bug fixes for server connection

Yes, CFBuilder supports FTP (and SFTP/FTPS)
Yes, CFBuilder supports FTP (and SFTP/FTPS)
and no, you don’t NEED to use Projects
For use in projects, can set during project creation
or in project properties (right-clicking file/text in project
Can also do without projects, in Files view
Right-click to edit text or file or folder, choose Synchronize>Create New Synchronize Connection
But wait, there’s more (I know some wonder)…

Yes, there is an available shortcut to upload
Yes, there is an available shortcut to upload
Right-click on text, Synchronize>Upload
No, there is option to auto-save to remote
Yes, there are options to sync many files
Right-click on text, Synchronize>Synchronize
Or available Sync Explorer view (don’t miss!)
Window>Show View>Other>HTML Standard Views>Sync Explorer
How to Edit FTP server configurations
Window>Show View>Other>HTML Standard Views>Sync Manager

Don’t miss available web services browser
Don’t miss available web services browser
In Services Browser view
Allows browsing, building of code to call web svcs
Not much doc at all. See:
http://www.carehart.org/blog/client/index.cfm/2009/8/7/cfbuilder_browsing_web_services
Linked folders (outside of project location)
See doc section, and:
http://blogs.adobe.com/cfbuilder/2009/08/link_folders.html
More about CFML debugging
See CFB docs and:
http://blogs.adobe.com/cfbuilder/2009/07/debugging_in_cfbuilder.html

Can turn off splash screen in Preferences>ColdFusion>Startup
Can turn off splash screen in Preferences>ColdFusion>Startup
To do find/replace within file, use Edit>Find, (ctrl-f) not Search>Search (ctrl-h)
The former does just within file operations
The latter does cross-file/project operations
Warning: people used to using ctrl-h to do file find/replace from other tools may inadvertently do replace across entire workspace. Ouch!
Apply cfnature to project
http://blogs.adobe.com/cfbuilder/2009/07/apply_cf_nature.html
Many available additional plug-ins for Eclipse
Version control, database integration, lots more

Beta 2 also adds…
Beta 2 also adds…
SQL editor
While inside CFQUERY, right-click and choose SQL Editor or use Ctrl+alt+s
Context-sensitive CFML help (F1 on tag, function)
Didn’t seem to work on Mac for me, though
Also, help opened in Mac can’t be copy/pasted.
Workaround: http://onflash.org/ted/2007/08/flex-builder-tip-preferences-general.php
See docs for more on each

Finding that tag completion of HTML tags doesn’t work?
Finding that tag completion of HTML tags doesn’t work?
Problem is if you have no enclosing <HTML> tag in template, which is a bummer
Very common for CFML developers to skip this
Might even be appropriate to do so in some coding
Features lost when editing file not in a project
(Meaning: files opened using files tab, not navigator)
Local history
Recent files list
Perhaps more
Web service browsing trap
http://www.carehart.org/blog/client/index.cfm/2009/8/7/cfbuilder_browsing_web_services

This has not been the ultimate list
This has not been the ultimate list
We have only 50 minutes
We have different audiences
We have different tools under the covers
Eclipse, Aptana, CFBuilder
Goal certainly wasn’t to show all, or even most, features
You can find many more tips and hidden gems
Besides CFB docs, many resources available on Eclipse, Aptana
Can learn much from those
Can even learn from CFEclipse resources
Just beware some CFE-specific things were not ported

CFBuilder Installation Guide
CFBuilder Installation Guide
http://help.adobe.com/en_US/ColdFusionBuilder/Installing/index.html
CFBuilder User Guide
http://help.adobe.com/en_US/ColdFusionBuilder/Using/index.html
CFBuilder Forum/List
http://forums.adobe.com/community/labs/coldfusionbuilder/
CFBuilder Adobe Team Blog
http://blogs.adobe.com/cfbuilder/
CFBuilder Bug Tracker
http://cfbugs.adobe.com/bugreport/flexbugui/cfbugtracker/main.html
Akbersait’s list of CFBuilder tutorials and resources
http://www.akbarsait.com/cfbuildertutorials.cfm

Eclipse, Eclipse Getting Started resources
Eclipse, Eclipse Getting Started resources
http://www.eclipse.org
http://www.eclipse.org/resources/?category=Getting%20Started
Aptana Studio resources
http://www.aptana.org/
(http://www.aptana.com covers Studio and more)

Hope everyone here has learned at least some new gem. Did I succeed?
Hope everyone here has learned at least some new gem. Did I succeed?
Remember, we have different audiences here
We covered
Hidden Gems in Editing
Hidden Gems in Configuring the IDE
Hidden Gems in Troubleshooting
Hidden Gems in Connecting to CF Servers
Hidden Gems in Editing Code on Remote Servers
Miscellaneous Hidden Gems
Some Gotchas

Charlie Arehart
Charlie Arehart
charlie@carehart.org
I’d really appreciate your feedback
http://carehart.org/feedback/
Available for ColdFusion troubleshooting
Remote or on-site
No time minimum, satisfaction guarantee
http://carehart.org/consulting/