Tag List Editor
Start Menu Path: Project Explorer Menu / Configuration Mgt / Edit Tag Lists
Function: The Tag List Editor tool is used to select and store lists of module versions (baseline or current). These lists can be used in different ways:
- These lists can be used in the BranchManager tools for quickly selecting modules in the BranchManager tools.
- The lists can be used like a favorite list to quickly access relevant modules in the whole database.
- BranchManager allows storing public and private tag lists and therefore can assist for configuration management in DOORS. Public tags can be used like labels on sets of baselines and are superior to baseline sets, since one baseline can be contained in different Tag Lists.
- Tag Lists can be saved and read as text and therefore can be sent by email or embedded in configuration management documents.
Additional to the tag lists, the Tag List Editor features a complex 'search' tool which can help to quickly locate modules of a certain type in the database.
The Tag List Editor looks like this, depending on the context in which it was called:

- Text Label - when the Tag List Editor is embedded in a tool, it can have a label at the top of the dialog explaining to the user why and what kinds of modules he is supposed to choose.
- Database Tree view - The database tree view can be rooted to a specific project (normally the current project) or the complete database. To switch between both modes, the user can check the "Show Complete Database" checkbox. If there is no current project (because the current folder has no parent project), then this option will be disabled and the tree view will be rooted to the database automatically. Inside the tree, the GUI shows the DOORS projects, folders and formal modules. Formal Modules can be expanded to show the baselines of the module.
When double clicking on a module, the current version of the module will be added to the module list. When double clicking on a baseline of a module, that baseline will be added to the module list.
- Insert all from Folder button - The "insert all from folder" button will insert the current version of all formal modules that are inside the selected folder or project. Using this button in combination with the "Load Most Recent Baselines" button on the baselines tab, the user can quickly create a list of the most recent baselines of a complete folder or project.
- Module List - the module list shows the selected modules. Double Clicking on a module of the list will open the activated module version. The module versions in the module list contain checkboxes. Using the checkboxes, one can quickly select a subset of modules by unchecking all modules and re-checking some of them. The selection buttons "Select All", "Unselect All", "Invert Selection" and "Remove Selected" help with quickly selecting the right module versions.
- Action Button - normally when used in the context of another tool, the action button will fit to the purpose of the selection, e.g. "Use selected Modules". On the Tag List Editor itself, the action button will read only "Close" because the Tag List Editor has only the purpose of manipulating the stored Tag Lists. After closing the Tag List Editor nothing will happen.
- Selection Tools:
- Select All - will check all module versions from the module list.
- Unselect all - will uncheck all module versions from the module list.
- Invert Selection - will invert the selection in the module list. The modules that are checked will be unchecked and the unchecked modules will be checked.
- Remove Selected - will remove all checked module versions from the module list. To remove all unchecked module versions, use the "Invert Selection" button followed by "Remove Selected", followed by "Invert Selection".
- Tag List Tools:
- Load Tag List - From this combo box, one of the available private tag lists or public tag lists can be loaded by selecting the item from the list.
- Save Tag List - When pressing this button, the user will be presented with a dialog to store the tag list. Depending on his access to the global tag list configuration module, he has the option to store a public tag list. If he has no write access to the module, then the user can only store a private tag list. Therefore by controlling access to the global configuration module, it is possible to control which users have the right to store public tag lists.
- Edit Tag List - When pressing this button, the user is presented with a dialog where he can edit the tag list in text form. Here the user could, for example, post a tag list from an email or also use the text to quickly edit a large list of modules. When pressing the OK button, the current module list will be replaced by the contents of the text. The text is parsed for module identifiers followed by an optional baseline string in parentheses. Therefore any list of module identifiers can be pasted to form a tag list. Text in between the module identifiers - like the name of the module is optional.
- Baseline Tools (in Branch Modules context only):
- Load Most Recent Baselines - Using this button, the user can load the most recent baselines for all modules in the module list.
- Load Baseline Set

This button will present the dialog for loading a module list from a baseline set. The dialog shows a tree view containing the folder hierarchy of the database and for each folder the number of baseline sets that are stored in that folder. By selecting a folder that contains baseline set definitions, the right side the list of baseline set definitions will be populated with the baseline set definitions of the folder. After choosing the baseline set definition and confirming with OK, a dialog for choosing the baseline set pops up, where the user can select the wanted baseline set. From that baseline set, the module list of the Tag List Editor will be populated.

- Save Tag List - When pressing this button, the user will be presented with a dialog to store the tag list. Depending on his access to the global tag list configuration module, he has the option to store a public tag list. If he has no write access to the module, the user can only store a private tag list. Therefore, by controlling access to the global configuration module, the users which have the right to store public tag lists can be controlled.
- Search - The search button brings up the search dialog of the Tag List Editor. This dialog is described in the next chapter.
Search Dialog

The search dialog of the Tag List Editor allows the user to specify a query to look for certain modules in a database. The Search will check all items in the database or in the current folder and match their name either against a regular expression or perform a plaintext search, i.e. to list all modules that have the word "test" in their name.
- Mode - if set to "Add result to list", then the result of the query will be added to the module list of the tag list editor, otherwise the contents of the module list will be replaced by the search result.
- Search Items:
- Search for Folders - If activated, the resulting item list will also contain folders. Not relevant in the context of BranchManager, since tag lists handle here only formal modules.
- Search for Link Modules - If activated, the resulting item list will also contain link modules. Not relevant in the context of BranchManager, since tag lists handle here only formal modules.
- Search for Formal Modules - this should be activated by default and stay active. The search will return formal modules.
- Options
- Use Regular Expressions - the search expression entered in the field at the top is evaluated as a regular expression. If turned off, a plain text search is performed.
- Search in full path - If turned on, not only the item name is matched against the search expression, but the full path (rootName_) of the module.
- Match Case - If checked, then a case sensitive search is performed. If unchecked, then the module name is turned to lower case before matching against the search expression.
- Search the complete database - if the complete database shall be searched instead of the items of the current folder.
- Attribute Search
If activated, then each found item can be queried for a module attribute value. This is especially useful to find modules of a certain type, most commonly identified by a type enumeration attribute on the module. If only the attribute search is wanted, then for the search expression a dot shall be entered and regular expressions shall be activated. An empty search expression is not valid. The attribute value of the specified attribute is matched against the regular expression supplied in the Regexp value field. Only items with matching attribute values will be put to the result list.