User Guide

298 Chapter 16: Data Sources
Arguments
sourceName
, bindingName
• The sourceName argument is the name of the top-level node that is associated with the
child node.
• The bindingName argument is the name of the child node from which you want to generate a
dynamic data object.
Returns
Dreamweaver expects a string, which can be passed to the formatDynamicDataRef() function to
format it before inserting it in a user’s document.
generateDynamicSourceBindings()
Availability
Dreamweaver UltraDev 1.
Description
Returns the children of a top-level node.
Arguments
sourceName
• The sourceName argument is the name of the top-level node whose children you want
to return.
Returns
Dreamweaver expects an array of JavaScript objects where each object can have as many as
four properties, which are described in the following list:
• The title property is the label string that appears on the right of the icon for each parent
node. The
title property is required.
• The allowDelete property is optional. If this property is set to the value false, when the user
clicks this node in the Bindings panel, the Minus (-) button is disabled. If this property is set to
the value
true, the Minus (-) button is enabled. If the property is not defined, the default is
the value
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 is a required property.
• The name property is the name of the server behavior that is associated with the data source, if
one exists. It is a required property. Some data sources, such as recordsets, are associated with
server behaviors. When you create a recordset and name it
rsAuthors, the name property
must equal
rsAuthors. Other data sources, such as session variables, do not have a
corresponding server behavior. Their name property must be the empty string ("").
Note: A JavaScript class that defines these properties exists in the DataSourceClass.js file, which is
located in the Configuration/Shared/Common/Scripts folder.