Specifications

Chapter 28344
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
XML 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 XML and regular expression
search patterns, see “Server Behaviors” on page 145.
<participant name="connection_includefile" version="5.0">
<quickSearch>
<![CDATA[// HTTP=]]></quickSearch>
<insertText location="">
<![CDATA[<%
// FileName="@@filename@@"
// Type="@@type@@" @@designtimeString@@
// DesigntimeType="@@designtimeType@@"
// HTTP="@@http@@"
// Catalog="@@catalog@@"
// Schema="@@schema@@"
var MM_@@cname@@_STRING = @@string@@
%>
]]>
</insertText>
<searchPatterns whereToSearch="directive">
<searchPattern paramNames="filename">
<![CDATA[/\/\/\s*FileName="([^"]*)"/]]></searchPattern>
<searchPattern paramNames="type,designtimeString">
<![CDATA[/\/\/\s+Type="(\w*)"([^\r\n]*)/]]></searchPattern>
<searchPattern paramNames="designtimeType" isOptional="true">
<![CDATA[/\/\/\s*DesigntimeType="(\w*)"/]]></searchPattern>
<searchPattern paramNames="http">
<![CDATA[/\/\/\s*HTTP="(\w+)"/]]></searchPattern>
<searchPattern paramNames="catalog">
<![CDATA[/\/\/\s*Catalog="(\w*)"/]]></searchPattern>
<searchPattern paramNames="schema">
<![CDATA[/\/\/\s*Schema="(\w*)"/]]></searchPattern>
<searchPattern paramNames="cname,string">
<![CDATA[/var\s+MM_(\w*)_STRING\s*=\s*([^\r\n]+)/]]></searchPattern>
</searchPatterns>
</participant>
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 .js
implementation file.
All the default connection dialog boxes that come with Dreamweaver MX use the
connection_includefile.edml mapping file. To let Dreamweaver MX find this file, its name is set
in the .js 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 .js 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";