MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION..., Use Manual

Page: 176 / 236

184
Wizard Definition Page Library
A set of seven page definition files is available in ColdFusion Studio and JRun Studio.
The library can be used to quickly build data access capabilities into wizards.
This section is included for HomeSite users who may want to upgrade to use these
additional features.
SelectNameAndLocation
This page collects application name and location where the destination directory for
the output templates. It allows the user to select the directory from the local or remote
server. This page is required if any of the following pages are included in the wizard.
Exposes controls
editApplicationName (textbox) — After the page is submitted, the content of this
textbox are copied to the SafeApplicationName parameter with all non-allowed
characters stripped out. This value can be then used as part of the file names.
editLocation (textbox) — This control should be bound to the Location parameter. The
value of this parameter is preset to the directory opened in the left pane.
Example
<PAGE name="SelectWizardNameAndLocation" type="SelectNameAndLocation"
caption="Data Drill-Down Application"
image="..\\images\\Main.bmp">
<INPUT name="editApplicationName" param="ApplicationName"
required="yes"
validationMsg="You cannot leave the Application Name field
blank">
<INPUT name="editLocation" param="Location"required="yes"
validationMsg="You cannot leave the Location field blank">
</PAGE>
SelectDataSource
This page displays a list of available data sources on the selected local or remote server.
Uses controls
cbDataSources (dropdown) — This control lists all available data sources. The control
exchanges with the bound parameter the name of the selected data source.
Reads parameters
ListBoxLabel — Caption for the dropdown control.
ListBoxDescription — More detailed description for the dropdown control.
ResetParams — Comma-delimited list of parameters that should be emptied if user
reselects the data source.