6.13   Using the Bookmark Function

The Bookmark function allows the marking of nodes, conditions and modifiers in a selection tree. This makes it easier to find certain elements in a large tree. Bookmarks are added and managed on the Rating Period window, using the Show/hide bookmarks and Add a bookmark icons that appear in the toolbar.

Figure 95   Bookmark icons- Show/hide bookmarks and Add a bookmark

Any node, condition or modifier in the selection tree may be chosen and bookmarked by highlighting the item and selecting the Add a bookmark icon. The bookmark created will by default have the same name as the selection tree item, although it is possible to change the name afterwards.

Selecting the Show/hide bookmarks icon adds an extra field to the Rating Period window, to the left of the selection tree. A list of all of the bookmarks created for the rating period in question appears in this field.

Figure 96   Navigator Window with Bookmarks Field Shown

The bookmarks are path specific, where the full path to the selection tree item bookmarked may be seen by moving the cursor to the bookmark name in the list. Duplicate paths will cause invalid bookmarks. Adding a selection tree path that is identical to another will cause existing bookmarks to be invalid, and make it impossible to add new bookmarks. An error message is shown if an item with a duplicate path and name is chosen as a bookmark.

Figure 97   Navigator Window - Path to the Selected Bookmarked Item

Right-clicking on any bookmark in the field will bring up a context sensitive menu, where it is possible to rename or delete the bookmark, or to go to the bookmarked item in the selection tree.

Figure 98   Bookmarks Dialog

Removing a node without deleting the bookmarks contained in that node will lead to invalid bookmarks. Removing an node, condition or modifier with an associated bookmark will also lead to an invalid bookmark. These appear in red text in the Bookmarks field, and are marked as invalid. The bookmarks should then be deleted manually to avoid an error message.

Renaming a bookmarked item, or a node which contains bookmarked items will not lead to invalid bookmarks, as the path to the bookmark is updated as the item is renamed. However, renaming the node or item so that the path is identical to another item will lead to invalid bookmarks. These appear in red text in the Bookmarks field, and are marked as invalid. One of the selection tree item should then be renamed manually to avoid this state.

The following example describes incorrectly defined bookmarks.

Example: Figure 99 shows two incorrectly defined bookmarks. The nodes named Example2 have the same name and the same path, and are so marked as invalid. The conditions Breakpoint similarly share a name and path, and so are invalid.

Figure 99   An Example of Invalid Bookmarks