User Guide

Database connection functions 87
MMDB.needToRefreshColdFusionDsnList()
Availability
Dreamweaver MX.
Description
This function tells the Connection Manager to empty the cache and get the ColdFusion data
source list from the application server the next time a user requests the list.
Arguments
None.
Returns
Nothing.
MMDB.popupConnection()
Availability
Dreamweaver MX.
Description
This function invokes a connection dialog box. This function has the following three signatures:
• If the argument list consists only of dialogFileName (a string), the popupConnection()
function makes Dreamweaver open the Connection dialog box so you can define a
new connection.
• If the argument list consists only of connRec (a connection reference), the
popupConnection() function makes Dreamweaver launch the Connection dialog box in edit
mode for editing the named connection. In this mode, the name text field is dimmed.
• If the argument list consists of connRec and the Boolean value bDuplicate, the
popupConnection() function makes Dreamweaver open the Connection dialog box in
duplicate mode. In this mode, the name text field is blanked out, and the remaining properties
are copied to define a duplicate connection.
Arguments
dialogFileName
or
connRec
or
connrec, bDuplicate
• The dialogFileName argument is a string that contains the name of an HTML file that
resides in the Configuration/Connections/server-model folder. This HTML file defines the
dialog box that creates a connection. This file must implement three JavaScript API functions:
findConnection(), inspectConnection(), and applyConnection(). Typically, you create
a JavaScript file that implements these functions and then include that file in the HTML file.
(For more information on creating a connection, see “The Database Connectivity API”
on page 103.)
000_DW_API_Print.book Page 87 Wednesday, August 20, 2003 9:14 AM