Process Engineer Toolkit > User's Guide > Working with Project Webs > Modifying the Treebrowser
This Toolkit page describes how to modify the Treebrowser. This applies to the Rational Unified Process (RUP), and also your project Web if it uses the Treebrowser applet. The RUP Treebrowser organization is defined in five menu files; the main "tree.dat" and four submenu files.
Note that the Project Web Template and the example organization webs included in RUP, use only one menu file; "tree.dat". This file contains all the information regarding the Treebrowser organization.
To modify the Treebrowser:
1. Understanding the Treebrowser and it's corresponding menu files (*.dat)
The left frame contains a Treebrowser with links to all pages in the Web site, as shown here.
Several files control the Treebrowser's behavior:
Each row in the tree.dat file consists of seven fields, separated by a "*". See Toolkit: The Treebrowser applet for a more detailed specification of this format. The following examples show different usage patterns for defining menu items in the Treebrowser. First, a brief description of each of the seven fields :
The target frame in this example is set to a whitespace character to indicate that the page will be opened in the main frame of the same browser session.
The file to open in this example is a URL to an external web site. The target-frame field is set to "_blank" to open a new Web browser window.
The example above shows the format of a reference to a subtree. The first line describes the title of the Treebrowser entry, and a reference to the page to open if selected. The second line indicates that the structure of this sub tree is defined in a separate menu file.
A subtree menu file follows exactly the same format as the main menu file, except that the levels in the tree are local to this subtree. Since the role subtree was included (see example 3) at the top level of the Treebrowser hierarchy, the entries defined as level zero in this subtree (for example, 'Additional Role Set') will be displayed at level one in the Treebrowser. Subsequently, the 'Any Role' entry from the example above, will be displayed at level two in the Treebrowser.
See Treebrowser documentation for further details.
For a detailed explanation of the tree.dat and the subtree files, see "The data files" in the Treebrowser documentation.
An easy way to modify the RUP, and/or your project Web, is to add links to your own material in the Treebrowser.
For example, the beginning of the tree.dat file in the RUP looks like this:
If you want to add entries in the Treebrowser, add new rows in the tree.dat file. For example, if you want to add an entry at the top-level to "Our Own Process" and a link to a page "Our Design Guidelines" one level below, the tree.dat would look as follows:
The modified RUP Treebrowser would then look like this:
<a href="another page" target="_blank">another pages<a>
Starting with the spring 2001 release (version 2001.04.00) of the RUP, the Web site that you are looking at is a result of an automated generation from an underlying RUP process model expressed using The Unified Modeling Language. The modeling and publication of web sites are done in the tool Rational Process Workbench (RPW). See the RPW tool mentor section for further details. Here, we discuss how modifying the treebrowser impacts the process of republishing and future upgrades of the RUP web site.
If you don't use RPW for configuring the RUP, please refer to the page Basic Modification of The Rational Unified Process for details.
However, if you use RPW for process configuration, please be aware of the following issues :
After you have made your changes to the Treebrowser (tree.dat or any of it's subtree files), you will be able to view the result next time you load the RUP Web site. If you don't want to close down your Browser session, you are able to see the result by selecting <Refresh> in your browser. Note that the some Browsers require <Shift> + <Refresh> to reload properly.
If the Treebrowser does not load after a manual change, it is likely that there is an error in one or more of the changed rows. You should inspect the file(s) and carefully check that the format specified in Treebrowser Applet, section The Data Files is followed. Below is a list of typical mistakes :
Rational Unified Process