Specifications

Server Behaviors 147

For example, the moveTo_declareParam.edml file contains the following code:

<![CDATA[

<% var MM_paramName = ""; %>

]]>

</insertText>

</searchPatterns>

</participant>

When Dreamweaver adds a server behavior to a document, it needs to have detailed information,

including where to insert the code, what the code looks like, and what parameters the

Dreamweaver author or data replaced at runtime. Each participant EDML file describes these

details for each block of code. Specifically, the participant file describes the following data:

• The code and where to put the unique instance. These are defined by the insertText tag

parameters, as shown in the following example:

• How to recognize instances already on the page, as shown in the following example:

</searchPatterns>

In the searchPatterns block tag, each searchPattern contains a pattern that finds instances of

runtime code and extracts specific parameters. For more details, see “Server behavior techniques”

on page 183.

The script file

Each server behavior also has an HTML file that contains functions and links to the scripts that

manage the integration of the server behavior code with the Dreamweaver interface. The

functions that are available for editing in this file are discussed in “Server behavior

implementation functions” on page 156.

Hello World example

This example takes you through the creation of a new server behavior so you can see the files that

Dreamweaver creates and how to handle them. Again, see “Adding Custom Server Behaviors” in

the Getting Started with Dreamweaver MX manual for details about working with the Server

Behavior Builder interface. The example displays “Hello World” from the ASP server. The Hello

World behavior has only one participant (a single ASP tag) and does not modify or add anything

else on the page.

Note: This example refers to functions that are defined later in this chapter.

Create a new dynamic page document.

1 In Dreamweaver, select the File > New menu option.

2 In the New Document dialog box, select:

Category: Dynamic Page

Dynamic Page: ASP JavaScript