Implementing additional features of a dynamic tree

Searches in the dynamic tree are performed using a search path. A search path is the entire path, starting at the tree root, separated by forward slashes. For example, your JavaScript may call the dynamic tree function gotoAndHighlight("Item 1.1/Item 1.1.3/Item 1.1.3.5/Item 1.1.3.5.4") to search for Item 1.1.3.5.4. Your databean must accept the gotoNode parameter, and return a vector which contains all of the nodes from the root to the level that contains the specified node or leaf. See the Sample populate() function for an example.

The developer may pass any additional URL parameters to the dynamic tree frame and these parameters can be picked up in the custom data bean to provide further control and processing logic. This should be done in a manner similar to

<frame src="/webapp/wcs/tools/servlet/DnamicTreeView?XMLFile=samples.testTree&myParam=myValue" name="tree">

where myParam is the parameter you want to pass and myValue is the value of said parameter. Any additional parameters should be picked up by the setRequestProperties() method in your data bean.

Developers may open the tree to a specific node when the tree first starts by specifying the URL parameter gotoNode=xxxx (where xxxx is the search path) in the original call to the Dynamic Tree frame. This should be of a form similar to:

<frame src="/webapp/wcs/tools/servlet/DynamicTreeView?XMLFile=samples.testTree&gotoNode=Item 1.1/Item 1.1.4" name="tree">

Font sizes and style are configurable in the centre.css files found in WC_installdir\web\tools\common directory.

The getHighlightedNode() function returns the currently selected node. For example:

var node = parent.tree.getHighlightedNode();

Once the node is retrieved, the developer has public access to all of the node data, which is the same as the DynamicTreeNode fields. Thus, the developer can programmatically modify this data. However, changes are not reflected outside of the tree unless the changes are also programmatically made by the developer. For example, the following JavaScript code shows the name and value of the currently selected node or leaf:

alert("Node name: " + node.name + "\nNode value: " + node.value);

The implementer can obtain the namePath of any node by using getNamePath(node). Use getValuePath(node) to obtain the valuePath of any node.