Apama 10.7.2 | Building and Using Apama Dashboards | Building Dashboard Clients | Reusing Dashboard Components | Working with multiple display panels | Using old tags to configure the panels in a window | Using tree panels
 
Using tree panels
The tags described in this topic are deprecated. They will be removed in a future release. You should change to the new tags. See Using new tags to configure the panels in a window.
With tree panels, you define the contents of a tree-structured navigation pane by specifying an xml file (navtree.xml in this example) as the value of the navtreedata attribute in an RTViewNavTreePanel element:
<?xml version="1.0" ?>
<panels xmlns="www.sl.com" version="1.0">
<BorderPanel>
  <RTViewPanel region="north" name="title_panel" display="title_panel"/>
  <CardPanel region="center">
    <RtViewPanel title=" Overview " name="main" display="main_panel"/>
  </CardPanel>
  <RtViewNavTreePanel region="west" width="192" height="480"
     lineStyle="Angled" navtreedata="navtree.xml">
  </RtViewNavTreePanel>
</BorderPanel>
</panels>
The file that you specify for the navtreedata attribute must be in XML, and must start with the following:
<?xml version="1.0" ?>
<navtree xmlns="www.sl.com" version="1.0">
The navtreedata file must end with the following:
</navtree>
The following tags are supported:
Tag
Description
node
Add a node to the navigation tree.
treefont
Set the font used in the navigation tree.
treecolor
Set font and background color in the navigation tree. Specify in hexadecimal RGB format: # rrggbb (for example, #00FFFF for cyan) or the following: black, white, red, blue, green, yellow, cyan, magenta, gray, lightGray, darkGray, orange, pink.
The node tag supports the following attributes:
Attribute
Description
display
Name of the display (.rtv) file.
label
Label for this node in the navigation tree. Defaults to display name if no label is set. Specify the font and color of the label using HTML. For example, to draw a green label using a 50-point italic monospaced font:
label="<html><p style=
'font-family:monospaced;font-style:italic;
font-size:50;color:green'>
Your Label Goes Here"
HTML font settings specified here override treecolor and treefont settings for this node.
mode
If the attribute value is keepalive, the display is kept in memory the entire time the application is running.
subs
Substitutions to apply to the display. Substitutions are optional and must use the following syntax:
$subname:subvalue $subname2:subvalue2
If a substitution value contains a single quote, it must be escaped using a / :
$filter:Plant=/'Dallas/'
If a substitution value contains a space, it must be enclosed in single quotes. Do not escape these single quotes:
$subname:subvalue $subname2:'sub value 2'
A substitution string cannot contain any of the following characters:
: | . tab space , = < > ' " & / \ { } [ ] ( )
The treefont tag supports the following attributes:
Attribute
Description
name
Specifies the font family name.
style
Can be set to plain, bold, italic, or bold italic.
size
Font point size.
The treecolor tag supports the following attributes:
Attribute
Description
text
Specifies the font color for tree labels.
background
Specifies the background color for the tree and non-selected tree labels.
selection
Specifies the background color for a selected tree label.
Here is an example:
<?xml version="1.0" ?>
<navtree xmlns="www.sl.com" version="1.0">
<node label="Nav Tree Example">
  <node label="Main Displays" display="main_panel">
    <node label="100 Displays">
      <node label="Panel 101" mode="keepalive" display="med_panel"
subs="$title:101">
      </node>
      <node label="Panel 102" mode="keepalive" display="med_panel"
subs="$title:102">
      </node>
      <node label="Panel 103" mode="keepalive" display="med_panel"
subs="$title:103">
      </node>
    </node>
    <node label="200 Displays">
      <node label="Panel 201" display="med_panel" subs="$title:201">
      </node>
      <node label="Panel 202" display="med_panel" subs="$title:202">
      </node>
      <node label="Panel 203" display="med_panel" subs="$title:203">
      </node>
    </node>
  </node>
</node>
</navtree>
Nodes can be nested. You can only specify one top-level node.