The Connection Api; Findconnection() - MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API Reference

The Connection API

To create a new type of connection, including the dialog box with which users interact, you must
implement the following three functions:
applyConnection()
implementation file that is associated with your new connection type (see Step 2
JavaScript file that implements at least the following elements:" on page
The
applyConnection()
examples of the HTML source in

findConnection()

implement
findConnection()
that returns from
following two JavaScript files:
•
connection_ado_conn_string.js
•
connection_common.js
When the user opens a site, Dreamweaver goes through each file in the Connections folder, opens
it, and passes the contents to
valid connection,
connection objects in the Database Explorer panel.
When the user opens a connection dialog box and selects to create a new connection or duplicate
or edit an existing connection, Dreamweaver calls the
back the same connection object that
populate the dialog box with the connection information.
When the user clicks OK in a connection dialog box, Dreamweaver calls the
applyConnection()
that is located in the Configuration/Connections folder. The
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 recordset 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()
value.
null
Argument
htmlSource
. You write these three functions and include them in the JavaScript
function returns an HTML source within an include file. You can see
"The generated include file" on page
function takes the HTML source and extracts its properties. You can
to use the search patterns in XML files to extract the information
. For an example of such an implementation, see the
applyConnection()
is located in Configuration/Connections/Shared folder.
findConnection()
returns a connection object. Dreamweaver then lists all the
findConnection()
findConnection()
function to build the HTML, which is placed in the connection include file
returns a connection object; otherwise, this function returns a
findConnection()
is located in Configuration/Connections/ASP_Js folder.
. If the contents of a file match the criteria for a
inspectConnection()
created. This process lets Dreamweaver
,
inspectConnection()
"Create a
104).
108. The
function and passes
applyConnection()
The Connection API
, and
function
105