Siebel Developer's Reference > SWE Tags >

swe:for-each-node, swe:for-each-indent, swe:indent-img, swe:node, swe:applet-tree-list

These SWE tags are used for implementing explorer views—that is, views containing a tree applet and a corresponding list applet for viewing the details of the nodes under a selected node in the tree.

The explorer-style (or tree) applet presents hierarchically structured information in an expandable tree control. The tree control is displayed in a frame on the left side of the applet content area. Detailed information for a selected tree node is displayed in the details applet in a frame to the right. The separate vertical frames allow the contents of the tree applet to be scrolled independently from the details applet. This is important because tree structures can typically grow very large in length and width.

A tree control can have repository tree nodes and field values as elements in the tree. The term "tree item" refers to a tree element regardless of its type. A repository tree node is called a "tree node."

In order to display a tree, the logic iterates over each item of the tree in a top-down, depth-first fashion and displays one item at time.

Each tree item is indented to place the text at the correct indent level relative to the root, and to display the expand/collapse button, the text of the item, and the hyperlinks. The indentation is accomplished using a series of GIF images, or just white spaces (when in text-only mode). The expand/collapse button and the item are displayed using images (or just text, in text-only mode). The list applet associated with the currently selected tree node is displayed as part of the view.

The following new tags have been implemented to accomplish the above: swe:for-each-node, swe:for-each-indent, swe:indent-img, swe:node, and swe:applet-tree-list.

swe:for-each-node

Purpose

Iterates over each visible item in the tree control in a top-down, "depth-first" fashion. This tag is used to display tree nodes and field values. If "count" is not specified, the tag iterates over all nodes in the tree.

swe:for-each-indent

Purpose

Iterates over each level of a tree item. Used for creating indentation when displaying tree items.

Attributes

None.

swe:indent-img

Purpose

Provides a placeholder for a GIF image corresponding to a tree item's current indentation level. At each level, SWE determines which GIF file to use in the <img> tag to output. The GIF image can be either a blank space or a vertical bar.

Attributes

None.

swe:node

Purpose

Provides a placeholder for an item in the tree. A tree item can be a repository tree node or a field value. The display name is printed if the tree item is a tree node. Otherwise, the field value is generated. The expand/collapse button, the item's icon, and the links are also parts of a tree item. Depending on the configuration file settings, the expand/collapse button is shown as either a GIF image or text. The expand/collapse button is only shown for tree items with child items. There are two links associated with each item. There is a link for the expand/collapse button to expand or collapse the item and a link for the item image for selecting the item (or for going to next or previous workset). The item selection allows the user to access the list applet associated with the tree node. This tag should use <swe:this> as a child tag.

Attributes

state. Possible values are "Active" and "Inactive." "Active" state is used to show a selected node. Nonselected nodes are in an "Inactive" state.

type. Set to "DisplayName" or "FieldValue." Outputs the repository tree node's Display Name if "DisplayName." Otherwise, the type outputs field values.

swe:applet-tree-list

Purpose

Provides a placeholder for a list applet to be displayed as the result of selecting or expanding a tree item. The list applet to be shown depends on the type of the item that is currently selected.

Attributes

None.