Adobe 38040334 - Dreamweaver CS3 User Manual page 77

For example, the default ADO connection dialog box for an ASP JavaScript document on a Windows platform is
stored in the ASP_Js/Win folder and is named Connection_ado_conn_string.htm.
Note: At runtime, Dreamweaver dynamically builds the list of connection types that are available to the user from the
collection of dialog boxes that are in the ASP_Js/Win folder.
The Configuration/ServerModels folder has HTML files that define each server model. Inside each HTML file is the
getServerModelFolderName()
model. The following example shows the function for the ASP JavaScript document type:
function getServerModelFolderName()
{
_
return "ASP JS";
}
You can also look at the MMDocumentTypes.xml file, which is located in the Configuration/DocumentTypes folder,
to determine the mapping between server models and document types.
Create a JavaScript file that implements at least the following elements:
2
Element
A set of variables
A set of buttons
Connectivity functions
You can select any name for this implementation file, but it must have a .js extension (for example, myConnec-
tionImpl.js). You can store this implementation file on either your local or a remote computer. You might want to
store your implementation file in the appropriate subfolder within the Configuration/Connections folder.
Note: The HTML file that you defined in Step 1, "Create the layout for the connection dialog box. " on page 71 must
include this connection type implementation file.
Unless you need to define connection parameters other than the ones provided in the standard
connection_includefile.edml file, these two steps are the minimum to create a new connection dialog box.
Note: The title of the dialog box that the user sees is in the
The functions listed in the next section let you create a connection dialog box. Along with implementing the calls
for generating include files for the user, you can register your connectivity type within the server model section of
the connection XML file.
For information about the Database Connectivity API that is associated with creating a new connection, see
"Database connection functions" on page 47.
function, which returns the name of the folder that is associated with the server
Description
Each variable defines a specific connec-
tion property
Each button appears in the connection
dialog box
Together, these functions define the
Connectivity API
Examples
Type of connection, data source
name, and so on
Test, Help, and so on (OK and
Cancel are automatically included)
findConnection()
applyConnection()
inspectConnection()
tag, which is specified in the HTML document.
title
DREAMWEAVER CS3 72
API Reference