Tag List Editor Lesson 1 – Selection Methods

In this first lesson, we will learn about the various selection (and un-selection) methods available in the Tag List Editor.
Navigate to the project "BranchManager Tutorial for <your username>" and start the Tag List Editor using the menu "Configuration Mgt" -> "Edit Tag Lists"

To begin, navigate to the project created by the setup script.
Start the Tag List Editor script by choosing the Configuration Mgt > Edit Tag Lists menu option.
Quick description of the Tag List Editor GUI parts:
  1. Tree View
    The tree view is similar to the tree view on the left side of the DOORS Database Explorer, except the Tag List Editor tree view also shows modules and their baselines.
  2. Module List
    The module list will show the modules (and possibly their baselines) being considered for the tag list. If the module is included, its checkbox will be checked; if not, its checkbox will be empty.
  3. Selection Buttons
    The selection buttons on the right side of the GUI allow you to select and unselect groups of modules at one time. The search button will be described in a subsequent lesson.
  4. Insert all from From Button
    This button will add all the modules in the current folder, recursively (i.e. including those in subfolders), to the module list.
  5. Show Complete Database Button
    When checked, the tree view will be rooted at the database root, when unchecked the tree view will be rooted in the current project.
  6. Tag Lists and Baselines Tabs
    These tabs and their contents will be described in a subsequent lesson.
  7. Close Button
    The button in the lower right will close the Tag List Editor and pass the selected modules and their possible baselines to the application that started the Tag List Editor. If the Tag List Editor was started by itself, it will simply be a Close button.
When the Tag List Editor is started, the tree view will be rooted in the current project. When you press the "+" (plus) sign next to the name of a project or folder, it will expand to show its contents. When you press the "-" (minus) sign next to the name of a project or folder, it will contract to hide its contents.

(The name of your project will differ of course; your DOORS username will appear instead of "DOORSuser").
When the Show Complete Database button is checked, the tree view above will change its root to that of the database root.
From the database root, you can see that the original starting project can be navigated too through the tree view.
When the Show Complete Database button is unchecked, the tree view above will change its root back to the original starting project.
From the starting project, navigate to the Tag List Editor folder, then to the "B Folder". In this folder you can see some formal modules.
When you press the "+" (plus) sign next to "C Folder", which is empty, the "+" (plus) sign will disappear.
The Tag List Editor used in this example does not allow the current state of a module to be chosen, so when a module’s the "+" (plus) sign is clicked, only baselines are shown. If this Tag List Editor allowed the current state of a module to be chosen, "current" would also be shown.
Because this Tag List Editor used in this example does not allow the current state of a module to be chosen, when a module is expanded that does not have any baselines, the "+" (plus) sign will disappear. If this Tag List Editor allowed the current state of a module to be chosen, "current" would be shown.
When a baseline or current label is double-clicked in the tree view, the module is added to the module list.

(The IDs of your modules will differ from those of this example.)
When a module name is double-clicked in the tree view, the module is expanded with its baselines and the current module is added to the module list.
When a module name is double-clicked in the tree view that has no baselines, the module is not expanded but is still added to the module list.
When a line in the module list is double-clicked, that module (or baseline) will be opened.
The checkboxes in the module list indicate whether or not the module (or baseline) is included in the current tag list. When a checked checkbox is clicked, the check will disappear and the module is no longer included in the current tag list.
Pressing the Invert Selection button will invert the checks in the module list. Thus, those modules that were in the current tag list are removed from it, and those modules that were not in the current tag list are now included.
Pressing the Remove Selected button will remove from the module list any line with a check in its checkbox.
Pressing the Select All button will select every line in the module list to be included in the current tag list.
Pressing the Unselect All button will uncheck every line in the module list, removing all the modules from the current tag list.
Pressing the Insert all from Folder button will add all the modules in the current folder or project, recursively (i.e. including those in subfolders and projects), to the module list. These modules will be included as their current state, not as baselines.