Adobe Dreamweaver API Reference CS5 User Manual
Page 90

85
DREAMWEAVER API REFERENCE
The database connectivity API
Last updated 8/27/2013
Note: If you change the format of your include file or define an include file for a new server model, you need to map the
connection parameters with the Dreamweaver UI, Live Data, and Preview In Browser. The following sample EDML file,
which is associated with the default ASP JS server model, maps all connection page variables with their respective live
values before sending the page to the server. For more information on EDML and regular expression search patterns, see
“Server Behaviors” in Extending Dreamweaver.
Tokens in an EDML file—such as
@@filename@@
in this example—map values in the include file to properties of a
connection object. You set the properties of connection objects in the JavaScript implementation file.
All the default connection dialog boxes that come with Dreamweaver use the connection_includefile.edml mapping
file. To let Dreamweaver find this file, its name is set in the JavaScript implementation file, as shown in the following
example:
var PARTICIPANT_FILE = "connection_includefile";
When you create a custom connection type, you can use any mapping file in your custom dialog boxes. If you create a
mapping file, you can use a name other than connection_includefile for your EDML file. If you use a different name,
you need to use this name in your JavaScript implementation file when you specify the value that is assigned to the
PARTICIPANT
_
FILE
variable, as shown in the following example:
var PARTICIPANT_FILE = "myConnection_mappingfile";