Reality ColdFusion: Intranets and Content Management (0321124146)

Chapter V: User Interaction

Application Installation Instructions:

Note: You must already have ColdFusion MX Server installed.


Short Version:

I. Unzip "UserInteraction.zip" to a temporary directory on your computer.
II. Place the extracted folder "UserInteractionSite" containing the ColdFusion templates inside your web root.
III. Attach the "UserInteraction.mdb" database as ODBC data source "UserInteraction".
IV. Install the "CFX_Make_Tree" custom tag.
V. Verify your installation, and enjoy the site.


Long Version:

I. Unzip "UserInteraction.zip"

1. Unzip "UserInteraction.zip" to a temporary directory on your computer, making sure to extract both files and paths (this is the default on most zip programs).

2. Make sure the extracted files contain three directories "CFX_Make_Tree," "Database," and "UserInteractionSite."


II. Place the ColdFusion templates in your web root.

1. Move the entire "UserInteractionSite" directory into the Web root of your computer (the default CFMX root is "C:\CFusionMX\wwwroot\" but yours may be different, depending on your configuration).

2. Optionally, you may change the name of the "UserInteractionSite" directory itself, if you want, but do not rename or delete any of the files or directories inside it.


III. Attach the "UserInteraction.mdb" database as ODBC data source "UserInteraction".

1. Move the file "UserInteraction.mdb" from the "Database" directory to wherever you store databases on your computer.  For security reasons, this should usually be a directory outside your web root.

2. Attach this database as an ODBC data source named "UserInteraction."  You can do this through the ColdFusion administrator "Data Sources" page.  Use the Data Source Name "UserInteraction" and the Driver "Microsoft Access."

3. Optionally, if you wish to view or edit this database directly, you may do so using Microsoft Access, version 97, 2000, XP, or later.  Access is not required for the application to work - only for directly viewing or editing the database.  Depending on your version of Access (2000, XP, or later), Access may prompt you to convert the database to a newer version, which is fine.  Converting the database will enable you to view and edit the data directly in your version of Access, and the application will still work just fine after conversion.


IV. Install the "CFX_Make_Tree" custom tag.

1. Move the file "CFX_Make_Tree.dll" from the extracted directory "CFX_Make_Tree" to your ColdFusion custom tags directory, usually located at "C:\CFusionMX\CustomTags".

2. Add the custom tag through the ColdFusion Administrator "CFX Tags" page (under "EXTENSIONS").  Select the "Register C++ CFX" button, then enter the Tag Name "cfx_make_tree" and the Server Library (.dll) "C:\CFUSION\CustomTags\CFX_MAKE_TREE.dll" and select the "Submit" button to add the custom tag.


V. Verify your installation.

1. Open the user interaction home page in your browser.  If you used the default installation directories, it will be at "http://127.0.0.1/UserInteractionSite/"

2. Log in - you can use the username "Administrator" and the password "pass."

3. Enjoy the site!

