analyzeServerBehavior()

Availability

Adobe Dreamweaver UltraDev 1

Description

Lets server behaviors set their incomplete and deleted properties.

After the findServerBehaviors() function is called for every server behavior on the page, an array of all the behaviors in the user's document appears. The analyzeServerBehavior() function is called for each JavaScript object in this array. For example, for a Dynamic Text behavior, Adobe Dreamweaver calls the analyzeServerBehavior() function in the DynamicText.htm (or DynamicText.js) file.

One purpose of the analyzeServerBehavior() function is to finish setting all the properties (incomplete, participants, selectedNode, and title) on the behavior object. Sometimes it's easier to perform this task after the findServerBehaviors() function generates the complete list of server behaviors in the user's document.

The other purpose of the analyzeServerBehavior() function is to notice when two or more behaviors refer to the same tag in the user's document. In this case, the deleted property removes all but one behavior from the array.

Suppose the Recordset1, DynamicText1, and DynamicText2 server behaviors are on a page. Both DynamicText server behaviors need Recordset1 to exist on the page. After the server behaviors are found with the findServerBehaviors() function, Adobe Dreamweaver calls the analyzeServerBehavior() function for the three server behaviors. When the analyzeServerBehavior() function is called for DynamicText1, the function searches the array of all the server behavior objects on the page, looking for the one that belongs to Recordset1. If a server behavior object that belongs to Recordset1 cannot be found, the incomplete property is set to the value true so that an exclamation point appears in the Server Behaviors panel, which alerts the user that a problem exists. Similarly, when the analyzeServerBehavior() function is called for DynamicText2, the function searches for the object that belongs to Recordset1. Because Recordset1 does not depend on other server behaviors, it does not need to define the analyzeServerBehavior() function in this example.

Arguments

serverBehavior, [serverBehaviorArray]

• The serverBehavior argument is a JavaScript object that represents the behavior to analyze.
• The [serverBehaviorArray] argument is an array of JavaScript objects that represents all the server behaviors that are found on a page.

Returns

Adobe Dreamweaver expects nothing.