Skip to content
SmarterWidgets 2.0Documentation
SmarterProcess - https://doorsnext.com
Terms Linker icon: white open book on a teal square

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.

Supported products: RM = IBM Engineering Requirements Management DOORS Next (Requirements Management)Content qualityChanges dataVersion 5.60 · released 2026-11-19

Discipline
Content quality
Works in
IBM DOORS Next module
Supported products
  • RM IBM Engineering Requirements Management DOORS Next (Requirements Management)
Version
5.60
Released

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

  1. You1Find the terms or pick them
  2. Widget2Finds where the terms are used
  3. You3Check the artifacts and their terms
  4. DOORS Next4Link terms: hyperlinks and term linksIf needed: Very large module: Link terms without searching
  5. Result5Change report in Excel
  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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

All changes to this widget

  • IBM Champion 2026 badge: purple square with the IBM logo and the text IBM Champion 2026, awarded through the IBM Champion program
  • IBM Champion 2025 badge: purple square with the IBM logo and the text IBM Champion 2025, awarded through the IBM Champion program
  • IBM Champion 2024 badge: purple square with the IBM logo and the text IBM Champion 2024, awarded through the IBM Champion program
  • IBM Champion 2023 badge: purple square with the IBM logo and the text IBM Champion 2023, awarded through the IBM Champion program
  • IBM Champion 2022 badge: purple square with the IBM logo and the text IBM Champion 2022, awarded through the IBM Champion program
  • IBM Champion 2021 badge: purple square with the IBM logo and the text IBM Champion 2021, awarded through the IBM Champion program
  • IBM Champion 2020 badge: purple square with the IBM logo and the text IBM Champion 2020, awarded through the IBM Champion program
  • IBM Champion 2019 badge: purple square with the IBM logo and the text IBM Champion 2019, awarded through the IBM Champion program