Finddynamicsources() – Adobe Extending Dreamweaver CS4 User Manual
Page 306
300
EXTENDING DREAMWEAVER CS4
Data sources
Arguments
sourceName, bindingName
•
The sourceName argument is the name of the top-level node to which the child node is associated.
•
The bindingName argument is the name of the child node.
Returns
Dreamweaver expects a Boolean value:
true
if the function has handled the edit;
false
otherwise.
findDynamicSources()
Availability
Dreamweaver UltraDev 1.
Description
This function returns the top-level nodes from the data source tree that appears in the Dynamic Data or Dynamic Text
dialog box or in the Bindings panel. Each data source file has an implementation of the
findDynamicSources()
function. When Dreamweaver refreshes the tree, Dreamweaver reads through all the files in the DataSources folder
and calls the
findDynamicSources()
function in each file.
Returns
Dreamweaver expects an array of JavaScript objects where each object can have as many as five properties, which are
described in the following list:
•
The
title
property is the label string that appears to the right of the icon for each parent node. The
title
property
is always required.
•
The
imageFile
property is the path of a file that contains the icon (a GIF image), which represents the parent node
in the tree control in the Dynamic Data or Dynamic Text dialog box or in the Bindings panel. This property is
required.
•
The
allowDelete
property is optional. If this property is set to
false
, when the user clicks this node in the
Bindings panel, the Minus (-) button is disabled. If this property is set to
true
, the Minus (-) button is enabled. If
the property is not defined, the default is
true
.
•
The
dataSource
property is the simple name of the file in which the
findDynamicSources()
function is defined.
For example, the
findDynamicSources()
function in the Session.htm file, which is located in the
Configuration/DataSources/ASP_Js folder, sets the
dataSource
property to
session.htm
. This property is
required.
•
The
name
property is the name of the server behavior that is associated with the data source, if one exists. Some data
sources, such as recordsets, are associated with server behaviors. When you create a recordset and name it
rsAuthors
, the
name
attribute must equal
rsAuthors
. The
name
property is always defined, but can be an empty
string (
""
) if no server behavior is associated with the data source (such as a session variable).
Note: A JavaScript class that defines these properties exists in the DataSourceClass.js file, which is located in the
Configuration/Shared/Common/Scripts folder.