Managing Projects

About projects

Projects contains resources such as ColdFusion components, interfaces, and HTML and CFML pages that are used to develop ColdFusion applications.

Each project is stored in a default workspace. The workspace stores your projects and other metadata. The preferred workspace location is the ColdFusion document root

You can associate a project with a ColdFusion server. By doing so, you can test the project before final deployment.

To do any CFML development in ColdFusion Builder, you first create a ColdFusion project. To know more about creating a project in ColdFusion Builder, see Creating a ColdFusion project.

Creating a ColdFusion project

The Project Builder wizard guides you through the steps of creating a ColdFusion project.

Enter project information

1. Right-click in the Navigator area and click New > ColdFusion Project.
2. In the Project Builder wizard, specify the project name.
3. To change the default project location, deselect Use Default Location.
4. Click Next to specify the ColdFusion server details.

Enter server details

1. Select a server from the Server pop-up menu. If you have not configured a ColdFusion server, then click Add Server to add a server. For more information about setting up a ColdFusion Server, see Adding ColdFusion servers.

   Note: If the project is in the server web root, then the Sample URL box is automatically populated with the server URL. For example, http://127.0.0.1:8500/eval, where 127.0.0.1 is the server host, 8500 is the port number, and eval is the project name.

2. Specify your preview settings to use an external web browser by selecting a web browser installed on your computer. The internal browsers are selected, by default.
3. Click Next.

Add existing sources

1. In this step, you can:
   • Link existing resources folder to the project.
   • Select previously configured applications with the current project.
2. Click Add to select the folder to link to the project.
3. Click Finish to build a new ColdFusion project.

For more information about linking resources, see Link to resources outside the workspace.

Configure properties for projects and servers

You can use the Properties dialog box in ColdFusion Builder to configure project properties and server settings.

To open this dialog box, right-click the project in the Navigator view and select Properties.

Configure project properties

1. Select ColdFusion Project from the left pane of the Properties dialog box. You can add and remove external projects as links here.

Configure variable mappings

You use variable mappings to provide Code Assist for component variables that are not defined in the file being edited or in the included files.

1. In the Properties dialog box, you see a tree-view structure on the left. Select ColdFusion Variable Mappings.
2. Click New.
3. In the Variable Name field, specify the name of the variable to map, for example, application.cfc1
4. In the Mapped To field, enter the fully qualified name of the project variable, for example, com.adobe.mycfcs.cfc1

Configure server settings

• To open the ColdFusion Server Settings page, select ColdFusion Server Settings in the left pane of the Properties dialog box.
• To create a ColdFusion Server instance, use the Servers pop-up menu.If you have already configured a server instance, you can assign it to your ColdFusion project. For more information about creating a server instance, see Adding ColdFusion servers.

Add ColdFusion pages, interfaces, and components

ColdFusion Builder provides wizards that guide you through the creation of ColdFusion pages, interfaces, and components.

Create a ColdFusion page

1. Right-click the ColdFusion project in the Navigator.
2. Click New > ColdFusion Page.
3. In the New ColdFusion Page wizard, specify a name for the ColdFusion (CFM) page.
4. Click Finish.

Create a ColdFusion component

1. Right-click the ColdFusion project in the Navigator.
2. Click New > ColdFusion Component.
3. In the New ColdFusion Component wizard, specify the following:
   • Component name
   • Hint to identify the component (optional).
   • Any component that you want to extend.
   • Any interface that you want to implement.
4. Select the output type to be true or false.
5. Click Next.
6. Click Add to specify the component property details, such as the property name, display name, hint, and default value.
7. Enter or select a property type from the Type drop-down list.
8. (optional) Select Add Getter and select its access type from the Access drop-down list.
9. (optional) Select Add Setter and select its access type from the Access drop-down list.
10. Click OK to return to the New ColdFusion Component wizard.
11. To add functions to the ColdFusion component, click Add Function.
12. In the New Function wizard, specify the functions details, such as the function name, display name, hint, access type, return type, roles, and output type.
13. Click OK.
14. To add arguments to the selected function, click Add Argument.

15. In the New Function Argument dialog box, specify the argument name, display name, hint, argument type, and the default value of the argument.

    Note: The options for the argument type are the same as the argument type options for ColdFusion Interface.

16. Click OK.

17. Click Finish to create a ColdFusion component (CFC file).

    Note: You can use Outline View to navigate through the functions and tags that you add to your ColdFusion page or ColdFusion component.

Create a ColdFusion interface

1. Right-click the ColdFusion project in the Navigator.
2. Click New > ColdFusion Interface.
3. In the New ColdFusion Interface wizard, specify the interface name, hint, and display name.
4. To extend another interface, browse or specify the name of the CFC.
5. Click Add Functions to add a function and specify its details, such as the function name, function hint, return type, roles, and output (true or false).
6. Click Add Arguments to specify the arguments for the selected function. Enter or select an argument type from the Type drop-down list.
7. Click Finish to create a ColdFusion interface.

Add other files

You can also add the following types of files to your ColdFusion project:

• .html
• .js
• .css
• .lxr (lexer file)
• .col (colorization file)
• .sdoc (ScriptDoc file)
• Untitled versions of the preceding files

In addition, you can create generic text files, folders, and projects. You add these files to a project much as you add ColdFusion pages or components. To add any of these files to a project, do the following:

1. Right-click the project.
2. Select New > Other.
3. Expand Project Files to specify a filename or expand Untitled Files to create an untitled file.
4. Select the file that you want to create.
   • If you are creating an untitled file, click Finish.
   • If you selected Project Files, click Next and specify the filename. Then click Finish.

Create CFM/CFC files outside the workspace

You can create CFM/CFC files outside the workspace using the File view.

1. In the File view, right-click the local folder in which you want to create the CFM/CFC file.
2. Select New > ColdFusion Page/ColdFusion Component/ColdFusion Interface and then specify the details.

Set Launch Page

You can designate a specific file as the Launch Page for your project. This page is loaded when you run/debug a file in the project.

1. In the Navigator view, select the page to set as Start Page.
2. Right-click the page and then select Set As Start Page.

To disable a page from being the Launch Page,

1. In the Project View, right-click the project and then select Properties > ColdFusion Project.
2. In the Start Page Setting, deselect Use Start Page.

Dynamically generate Start Page URL for framework applications using extensions

See Extension support for setting Launch Page----

Set URL Prefix

1. In the Navigator view, select the project or folder for which you want to specify a URL prefix.
2. Right-click the selected project or folder and select Set URL Prefix.
3. Enter the URL for the selected resource.

Import, export, and delete projects

Import projects

You can import both ColdFusion and non-ColdFusion projects into ColdFusion Builder.

1. Right-click in the Navigator view and select Import.
2. In the Import wizard, select ColdFusion > Import Existing Projects.
3. In the Import ColdFusion Project dialog box, browse and select the project location. A list of all projects is displayed.
4. Click Refresh to search and refresh the project list.
5. Select Show All Projects to display all non-ColdFusion and non-ColdFusion Builder projects in the same location.
6. Select Add ColdFusion Nature To Non-ColdFusion Projects to apply ColdFusion Builder functionality, such as preview, editing, and debugging, to non-ColdFusion Builder projects.

7. Select the appropriate projects and click Finish.

   Note: Importing a project retains the project properties including the server details, launching settings, browser details, application details, and linked folders.

Export projects

You can export files and folders from a ColdFusion Builder or non-ColdFusion Builder project to a designated location. However, for ColdFusion Builder projects, ColdFusion Builder functionality like server settings, preferences, and such are not exported.

1. Right-click in the Navigator view and select Export.
2. In the Export wizard, select ColdFusion > Export.
3. In the Export Project dialog box, browse and select the location where you want to export the project.
4. Click Select All to export all files and folders within the project, or click Filter Types to specify the files that you want to export.
5. Click Finish to export your project to the designated location.

Delete projects

When you delete a project, you remove the project from the current workspace. You can also remove the project from your computer’s file system at the same time.

1. Right-click in the Navigator view and select Delete.
2. To remove the project from the workspace and the file system, select Delete Project Contents On Disk. The project is then permanently removed from the file system; you cannot undo the command.

Cloak projects and files

In ColdFusion Builder, you can cloak or hide files, file types, and folders from all synchronization, upload, download operations. This feature is useful if you have a large directory of files that you want to exclude from your synchronization or uploads.

You can cloak a file or folder in two ways:

• Right-click the file or folder in the Navigator view and select Synchronize > Cloak this file type. To uncloak the file type, right-click the file or folder and select Synchronize > Uncloak this file type.
• Set up your preferences to cloak certain file types, using wildcards and regular expressions by performing the following actions:
  1. Right-click the file or folder in the Navigator view and select Synchronize > Advanced Cloaking Preferences.
  2. In the Preferences dialog box, click the  icon.
  3. In the Ignore File/Folder dialog box, specify the file or folder name.
  4. Click OK. The specified file or folder is displayed in the list of files on which cloaking has been applied.

Link to resources outside the workspace

You can link to resources outside the project and workspace. This feature is useful when you have to use resources that are available on shared locations. The linked resource or the folder that contains linked resources appear as follows:

Link to resources outside workspace

1. In the Navigator view of ColdFusion Builder, right-click the project to add the linked resources to.
2. Select the resource that you want to link. For example, if you want to link to a folder, select New > Folder.
3. Enter a name for the resource that you are linking. If you do not enter a name, the default name of the resource is taken.
4. Click Advanced.
5. Select Link to folder in the file system. Enter or browse to the resource location.
6. Click Finish to link the resource to your project.

Use path variables to link to resources

When you link to resources, you can define path variables instead of providing the full path to where the resource is stored. You can define a path variable and then set the path to the resource that you want to link to.

1. In the Navigator view of ColdFusion Builder, right-click the project to add the linked resources to.
2. Select the resource that you want to link. For example, if you want to link to a folder, select New > Folder.
3. Enter a name for the resource that you are linking. If you do not enter a name, the default name of the resource is taken.
4. Click Advanced.
5. Select Link to folder in the file system. Enter or browse to the resource location.
6. Click Variables.

7. You can select an existing path variable or click New to create a path variable.

   Note: The list of existing resource variables is also available by selecting Window > Preferences from the main menu and then selecting General > Workspace > Linked Resources. You can edit and create linked resource variables using the Linked Resources dialog box.

8. To create a path variable, enter a name for the resource and browse to or provide the full path to the resource. Click OK to add the path variable to the path.
9. Click Finish to link the resource to your project.

Deploy projects over FTP and Secure FTP connections

ColdFusion Builder lets you deploy ColdFusion projects on a web server using File Transfer Protocol (FTP).

ColdFusion Builder also supports file transfers using Secure File Transfer Protocol (SFTP) and File Transfer Protocol Secure (FTPS) connections. SFTP and FTPS are a secure form of FTP, which encrypt the files that you send and receive to a remote server.

Create an FTP or secure FTP connection in ColdFusion Builder

1. Right-click the project in the Navigator view.
2. Click Synchronize > Create New Synchronize Connection.
3. Specify a name for the connection.
4. Select the ColdFusion project or file to deploy by selecting the Local drop-down list and the location that contains the file or project.
5. Select a remote server, and enter the following details in the New Connection Dialog Box.
   1. Site name: Name of the new remote site.
   2. Select the connection type.
   3. Server: URL of the site to connect to (for example, admin.myWebSite.com). You can also enter the IP address of the site.
   4. Username/Password: User name and password of the server.
   5. Use Public Key Authentication: This option is available only if you select SFTP as the connection type. Public key authentication lets you select a key-pair on your computer, and you copy the public key to the server.
   6. Remote path: If you want to connect to a subfolder under the root of the remote site, specify the folder path.
   7. Click Advanced Options to specify the following:
   • Port: If you want to use a port other than 22, specify the port.
   • If you want the FTP connect session to run in the background, select Use Passive Mode.
   • If you work in a team environment, you sometimes want to upload files that overwrite others' changes. If so, select Calculate Server/Client Time Offset Automatically as a precaution.

1. Click OK to add the FTP connection.

Upload, download, or synchronize projects, files, and folders

1. Right-click the project or file in the Navigator view and select Synchronize > Upload or Download.
2. From the Choose Site Connection dialog box, select the connection.
3. Click OK.

Import Ajax libraries

1. In the Navigator view, right-click the project in which you want to import Ajax libraries, and click Import.
2. In the Import wizard, select ColdFusion > Ajax Library Import Wizard, and click Next.
3. Select the Ajax libraries that you want to import, and click Finish.

Working with Flash Builder projects

To work with a Flash Builder project in ColdFusion Builder, import the Flash Builder project into ColdFusion Builder. After that, apply ColdFusion Builder functionality by selecting the Flash Builder project in the Navigator view, then right-click and select Apply ColdFusion Nature.

Applying ColdFusion Builder functionality to the Flash Builder project lets you preview, edit, and debug the Flash Builder project from within ColdFusion Builder.

Developing AIR applications

Adobe ColdFusion Builder provides you with tools to create Adobe® AIR® projects, debug, package, and digitally sign Adobe AIR applications.

Create an AIR project

1. Select File > New > Project.
2. In the Create Project wizard, select HTML Projects > Adobe AIR Project, and click Next.
3. Enter the project name and the location of the files in the project.
4. Specify the HTML start page that contains the sandbox application code. You can also select non-application sandbox code. Click Next.
5. Specify the following properties of the application XML file, and click Next.
   • ID: Unique application ID that is the identifier string for the application.
   • Name: Application name
   • Filename: Name of the file and folder where the application is installed
   • Version: Application version
   • Icon: Icon files that represent the application. If you don't specify an icon, the operating system uses a default icon.
6. Specify the window style, dimension, sizing options, and click Next.
7. Select the AIR frameworks to import into the project, and click Next.
8. Select the Ajax JavaScript libraries that you want to import, and click Finish to create your AIR project.

Run and debug an AIR application

1. From the Navigator view, open the source file (Application.XML) for the application.
2. Click Run on the main toolbar to launch the AIR application.
3. To debug the application, click  in the workbench toolbar.

The application launches and runs in the ADL application (AIR Debugger Launcher). The ColdFusion debugger catches any breakpoints or runtime errors and you can debug the application like any other ColdFusion application. For more information, see Debugging Applications

Package and digitally sign an AIR application

When your application is complete and ready to be distributed, you package it into an AIR file. Packaging consists of the following steps:

1. From the Navigator view, right-click the AIR project that you want to package, and click Export.
2. In the Export wizard, select Adobe AIR > Adobe AIR Package, and click Next.
3. Select the AIR project and the application descriptor file.
4. You can select the default AIR SDK or configure a different Adobe AIR SDK, and click Next. To configure a different AIR SDK, click Configure Adobe AIR SDKs, and select an AIR SDK. You can also add a new AIR SDK, or edit and remove an existing AIR SDK.
5. You can digitally sign your AIR application by selecting an existing digital certificate or by creating a self-signed certificate. Digitally signing your AIR application provides assurance to the users that the application has been signed with a trusted certificate and displays the publisher identity.
   1. Select Digitally Sign Exported AIR Application.
   2. Select an existing digital certificate, or click Configure Certificates to select a different digital certificate. Click Add to create a self-signed certificate.
   3. Specify the password for your digital certificate.
   4. If you select TimeStamp AIR Package, when signing the installation package, the AIR Developer Tool (ADT) automatically contacts a time-stamp authority to verify the time. The time-stamp information is included in the AIR file. An AIR file that includes a verified time stamp can be installed at any point in the future.
   5. Select Migrate AIR Application to migrate an AIR application to a new certificate. When you do so, sign the AIR file with both new and old certificates. Select the previous certificate from which you want to migrate and the previous certificate password.
      You also have the option of packaging your AIR application without a digital signature. To do so, deselect Digitally Sign Exported AIR Application. When you package your AIR application without a digital signature, an intermediate AIR file (.airi) is created. An intermediate AIR file cannot be deployed or installed. It is generally used for testing (by the developer) and can be launched using the AIR ADT command-line tool.
6. Click Next to optionally select files to exclude from the exported AIR file. By default, all the files are included.
7. Click Finish to generate the AIR file.