MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manual page 294

Dreamweaver goes through each file in the appropriate server model folder, calling the
3
findDynamicSources()
Dreamweaver calls the
new list of all the fields in each data source for the user's document. Those fields are presented
to the user as a tree control in the Dynamic Data or the Dynamic Text dialog box or in the
Bindings panel. The data source tree for an ASP document might appear as shown in the
following example:
Recordset (Recordset1)
ColumnOneInRecordset
ColumnTwoInRecordset
Recordset (Recordset2)
ColumnOfRecordset
Request
NameOfRequestVariable
NameOfAnotherRequestVariable
Session
NameOfSessionVariable
If the user double-clicks on a data source name in the Bindings panel to edit the data source,
4
Dreamweaver calls the
If the user clicks the Minus (-) button, Dreamweaver gets the current node selection from the
5
tree and passes it to the
added earlier with the
the function returns an error message. After the
Dreamweaver refreshes the data source tree by calling the
generateDynamicSourceBindings()
If the user selects a data source and clicks OK in the Dynamic Data or the Dynamic Text dialog
6
box, or clicks Insert or Bind in the Bindings panel, Dreamweaver calls the
generateDynamicDataRef()
current insertion point.
If the user displays the Dynamic Data or the Dynamic Text dialog box to edit an existing
7
dynamic data object, the selection in the data source tree needs to be initialized to the dynamic
data object. To initialize the tree control, Dreamweaver goes through each file in the
appropriate server model folder (for example, the Configuration/DataSources/ASP_Js folder),
calling the implementation of the
Dreamweaver calls the
object back from the code in the user's document to an item in the tree. (This process is the
reverse of what occurs when the
inspectDynamicDataRef()
Dreamweaver shows with a visual cue which item in the tree is bound to the current selection.
Every time the user changes the selection, Dreamweaver calls the
8
function to determine whether the new selection is dynamic text or a tag with a dynamic
attribute. If it is dynamic text, Dreamweaver displays the bindings for the current selection in
the Bindings panel.
Using the Dynamic Data or the Dynamic Text dialog box or the Bindings panel, it's possible
9
to change the data format for a dynamic text object or a dynamic attribute that the user has
already added to the page. When the format changes, Dreamweaver calls the
generateDynamicDataRef()
passes that string to the
on page 311). The string that the
user's document.
294 Chapter 16: Data Sources
function in each file. For each value in the returned array,
generateDynamicSourceBindings()
editDynamicSource()
deleteDynamicSource()
addDynamicSource()
functions.
function. The return value is inserted in the document at the
inspectDynamicDataRef()
inspectDynamicDataRef()
generateDynamicDataRef()
function returns an array that contains two elements,
function to get the string to insert into the user's document and
formatDynamicDataRef()
formatDynamicDataRef()
function in the same file to get a
function to handle the user edits within the tree.
function, which deletes the code that was
function. If it cannot delete the current selection,
deleteDynamicSource()
findDynamicSources()
function in each file.
function to convert the dynamic data
function is called.) If the
inspectDynamicDataRef()
function (see "formatDynamicDataRef()"
function returns is inserted in the
function returns,
and the