User Guide

The generated include file 107

The generated include file

The include file that applyConnection() generates declares all the properties of a

connection.The filename for the include file is the connection name and has the file extension

that is defined for the server model associated with the current site.

The following sections illustrate some sample include files that

applyConnection()

generates for various default server models.

ASP JavaScript

The ASP and JavaScript include file should be named MyConnection1.asp, where

MyConnection1 is the name of the connection. The following sample is an include file for an

ADO connection string:

// Filename="Connection_ado_conn_string.htm"

// Type="ADO"

// HTTP="true"

// Catalog=""

// Schema=""

var MM_MyConnection1_STRING = "dsn=pubs";

The server behavior file includes this connection by using the relative file include statement,

as shown in the following example:

ColdFusion

When you use UltraDev 4 ColdFusion, Dreamweaver relies on a ColdFusion include file to

get a list of data sources.

NOTE

Connections are shared, so set the allowMultiple value to false. This ensures that the

connection file is included in the document only once and that the server script remains

in the page if any other server behaviors use it.

NOTE

To create a new connection include file format, you need to define a new EDML

mapping file, which should be similar to connection_includefile.edml, as shown in “The

definition file for your connection type” on page 109.

NOTE

For regular Dreamweaver ColdFusion, Dreamweaver ignores any include files and,

instead, makes use of RDS to retrieve the list of data sources from ColdFusion.

000_DW_API_Print.book Page 107 Wednesday, July 20, 2005 11:58 AM