Created

22 March 2010

Requirements 

     
Prerequisite knowledge
This tutorial is intended for:
  • Developers who are exploring tutorials in the Flex and ColdFusion mini learning center that are based on the Fictitious Sales Planner example.
  • Experienced ColdFusion developers without previous Adobe Flex framework or Adobe Flash Builder 4 experience.
  • ColdFusion developers who are familiar with ColdFusion components.
 
User level
All
Required products
Adobe ColdFusion Enterprise Edition (2016 release) (Download trial)
Flash Builder (Download trial)
Sample files
 

   

In Part 1, you learned how to set up a ColdFusion data source and Flash Builder project. In this section, you will generate the ColdFusion components (CFCs) using ColdFusion Builder. This section is optional, as you can use the CFCs provided in the next section to import into the Flash Builder Data Service. You can skip to the next section, or continue to see how easy it is to generate Object-relational mapping (ORM) components. In Part 3, you will set up a Flash Builder data service project with ColdFusion for use with the Fictitious Sales Planner sample application.
 

 
Register the local ColdFusion server in ColdFusion Builder

In this section, you will register the local ColdFusion Server with ColdFusion Builder. This will allow you to access all the data sources on the server from within ColdFusion Builder.  
 
  1. Open ColdFusion Builder, then click on the Add Server button in the Servers view as shown in Figure 1.
The Add Server button within the Servers view.
Figure 1. The Add Server button within the Servers view.
  1. Since you are using a local server, type "localhost" for the name.
  2. Since you are using a local server, set the host name to "localhost" as well.
  3. For default installations of the standalone ColdFusion server, the web server port should be 8500.
    You should be able to ignore the Context Root and Application Server Name fields. These are only needed if using ColdFusion deployed on a J2EE server.
     
  4. Enter the RDS User Name and RDS Password you assigned during installation.
    If you did not specify an RDS username when installing, then the default user name is admin.
     
    The Server Settings window should appear as shown in Figure 2.
     
The Server Settings window.
Figure 2. The Server Settings window.
  1. Click Next.
  2. Specify the Server Home directory. This is not the web root. This is the folder into which ColdFusion itself is installed. On Microsoft Windows machines using a local development server, this is likely to be: c:\ColdFusion9  (/Applications/ColdFusion9/ for Mac)
  3. Enter the Document Root (the web root directory). On Windows machines using a C:\ColdFusion9\wwwroot  (/Applications/ColdFusion9/wwwroot/ for Mac)
  4. From the Version drop-down menu, choose 9.0.x as shown in Figure 3.
    Note: This step is not available on the MAC version of ColdFusion Builder.
     
The Local Server Settings window.
Figure 3. The Local Server Settings window.
  1. Click Finish.
 
Create a ColdFusion Builder project
ColdFusion Builder makes it easy for developers to manage the entire ColdFusion development cycle from concept to production in one easy-to-use tool. In this section you will create a project to hold all the files for the FictitiousSalesPlanner application.
 
  1. Select File > New > ColdFusion Project.
  2. Enter the Project Name “F4CF_FictitiousSalesPlanner”.
  3. Uncheck the Use Default Location check box. Enter the path for your project in the Project Location field. To find the path, browse to your Document Root folder, likely:
         C:\ColdFusion9\wwwroot
     
         (/Applications/ColdFusion9/wwwroot/ on Mac)
     
         Create a new folder inside the Document Root named F4CF_FictitiousSalesPlanner as shown in Figure 4.
     
The ColdFusion Project Information window.
Figure 4. The ColdFusion Project Information window.
  1. Click Next.
  2. Use the Servers drop down list to select localhost, the server you defined above (See Figure 5).
     
     
Figure 5. The Server Details within the New ColdFusion Project window.
Figure 5. The Server Details within the New ColdFusion Project window.
  1. Click Finish.
 
Use the CFC Generator extension to create an ORM CFC
You can generate the data management services for this application using the ColdFusion Builder CFC Generator. The code will use object-relational mapping (ORM) which will manage the database logic and connectivity without writing any SQL.
 
  1. In the RDS view, expand the localhost server to reveal the FictitiousSalesPlanner data tables.
  2. Select the SALESTARGETS table and right-click.
  3. Choose Adobe CFC Generator > Create ORM CFC. See Figure 6.
Select Create ORM CFC.
Figure 6. Select Create ORM CFC.
  1. In the Adobe CFC Generator dialog box, click the Browse button.
  2. In the Select Folder dialog box, select the FictitiousSalesPlanner folder and click OK (See Figure 7).
Create ORM CFC within the Adobe CFC Generator window.
  1. Click OK.
  2. Within the Create ORM CFC wizard, scroll to the bottom of the page and click Generate Code (See Figure 8).
    Note: For Mac users, if this page appears blank, then close it, navigate to Preferences >  ColdFusion > Extensions and check the box next to Use Mozilla browser for extensions. Click Apply. Click OK. Then repeat from Step 3.
     
Generate the ORM CFC code.
Figure 8. Generate the ORM CFC code.
  1. You should see a message showing the path of the generated CFCs. Click Close (See Figure 9).
ORM CFC generated successfully.
  1. Within the Navigator view, right-click the FictitiousSalesProject project and select Refresh.
  2. Expand the project to reveal the generated CFCs.

 
Where to go from here

In this section, you have learned how to generate the ColdFusion components (CFCs) using ColdFusion Builder. In Part 3, you will set up a Flash Builder data service project with ColdFusion for use with the Fictitious Sales Planner sample application.