Terms Linker
Turns every use of a glossary term in your requirements into a link to its definition, across a whole module in one run.
What it is and why it exists
A shared glossary is one of the best tools against ambiguous requirements: every term has one agreed definition. It only helps, however, when readers can reach the definition from the place where the term is used, and when you can see which requirements depend on which term.
In DOORS Next this means creating a hyperlink in the text and a References Term link for every occurrence, by hand. For a module with hundreds of requirements and dozens of terms that is days of work, and nobody keeps it up to date. Terms Linker does it automatically, the same way for every author.
Problems it solves
- Glossary terms used in requirements without any link to their definition.
- No traceability between terms and the requirements that use them, so the impact of changing a definition is unknown.
- Hours of manual linking that are inconsistent between authors.
- Links that are only partly created after earlier manual or interrupted work.
Benefits
- Unambiguous requirements: readers open the definition of a term with one click.
- Impact analysis: References Term links show which requirements are affected when a definition changes.
- Consistency: whole words only, the longest term first (for example "brake system" before "brake"), and no links inside existing links.
- Preview before changing: the widget lists the artifacts, the terms found and how often they occur.
- Reversible: Terms Remover removes exactly what Terms Linker created.
How to use
- You1Find the terms or pick them
- You3Check the artifacts and their terms
- DOORS Next4Link terms: hyperlinks and term linksIf needed: Very large module: Link terms without searching
- Result5Change report in Excel
- Under Terms, click Find terms to use every glossary term of the project, or Pick terms to choose specific ones. Show terms lists the chosen terms.
- Open a module, choose Whole module under Link and click Find usage. Nothing changes yet: the widget shows how many artifacts use terms, how many occurrences there are and the most used terms. Click an artifact to see its terms and how often they occur.
- Review the list, then click Link terms, read the confirmation and click Link terms in it. The hyperlinks and the term links are created in batches, with progress and Stop. Click Log in the result to download the change report.
- To link only some artifacts, select them in DOORS Next and choose Selection · N: the widget checks them at once. Then click Link terms and confirm.
- For very large modules, click Link terms on the whole module without searching first: every artifact is read and linked in a single pass, and the numbers are reported at the end.
Screenshots
1All 8 glossary terms of the project, ready to be linked 2120 artifacts searched: 99 use terms, with the most used terms 3One artifact opened: the terms it uses and how often 4Confirmation before 243 occurrences become hyperlinks and term links 5Terms linked: 243 hyperlinks added and 238 term links created
Good to know
- The artifact type of glossary terms (by default Term) and whether matching ignores case are set under Settings: click Change, and Done when you are finished.
- Links are created on the base artifact, so they are visible in every module that reuses the requirement.
- Run it in a change set and keep the change report as a record of what was linked.
- The list of artifacts with terms can be searched by ID, name or term and saved to Excel with the icon at the right of its heading.
- If the browser gets slow on a very large module, Stop the run, reload the page and open the module again: Continue from … links the rest of the module with the same terms and matching.
What's new in version 5.60
· Change titles are published in English.
- Confirmation when only term links are missing