Specifications

The Database Connectivity API 339
The applyConnection() function returns an HTML source within an include file. You can see
examples of the HTML source in the “The generated include file” on page 341. The
findConnection() function takes the HTML source and extracts its properties. You can
implement
findConnection() to use the search patterns in XML files to extract the information
that returns from
applyConnection(). For an example of such an implementation, see the
following two JavaScript files:
When the user opens a site, Dreamweaver goes through each file in the Connections folder, opens
it, and passes the contents to
findConnection(). If the contents of a file match the criteria for a
valid connection,
findConnection() returns a connection object. Dreamweaver then lists all the
connection objects in the Database Explorer panel.
When the user opens a connection dialog box and chooses to create a new connection or
duplicate or edit an existing connection, Dreamweaver calls
inspectConnection() and passes
back the same connection object that
findConnection() created. In this way, Dreamweaver can
populate the dialog box with the connection information.
When the user clicks OK in a connection dialog box, Dreamweaver calls
applyConnection() to
build the HTML, which is placed in the connection include file that is located in the
Configuration/Connections folder. The
applyConnection() function returns an empty string
that indicates there is an error in one of the fields and the dialog box should not be closed. The
include file has the default file extension type for the current server model.
When the user adds to the page a server behavior that uses the connection, such as a record set or
a stored procedure, Dreamweaver adds a statement to the page that includes the connection
include file.
findConnection()
Availability
Dreamweaver UltraDev 4
Description
Dreamweaver calls this function to detect a connection in the specified HTML source and to
parse the connection parameters. If the contents of this source file match the criteria for a valid
connection,
findConnection() returns a connection object; otherwise, this function returns a
null value.
Argument
htmlSource
htmlSource is the HTML source for a connection.
connection_ado_conn_string.js
Located in Configuration/Connections/ASP_Js
folder
connection_common.js
Located in Configuration/Connections/Shared
folder