Module To Base Links
Converts links created inside a module into links between the base artifacts, so traceability travels with the requirement into every module that reuses it.
What it is and why it exists
In DOORS Next a link can be created in the context of a module or between the base artifacts. Links created in a module are visible only there. When requirements are reused in other modules, or when a team decides that traceability belongs to the base artifacts, the existing module links have to be converted: create the same link between the base artifacts, then delete the module link.
By hand this is slow, and a module link deleted before its base link exists is lost. Module To Base Links converts the links of a whole module and deletes each module link only after its base link exists.
Problems it solves
- Traceability that is visible in one module but missing in other modules that reuse the same requirements.
- An inconsistent link strategy after imports or after several teams worked in different ways.
- Manual conversion: finding the base artifacts of both ends, creating the new link and deleting the old one, for each link.
- The risk of losing links when the conversion is done in the wrong order.
Benefits
- Consistent traceability across every module that reuses a requirement.
- No lost links: the base link is created first and the module link is deleted only after that succeeds.
- Choose what to convert: only the link types you select.
- Preview and Excel export of every module link before and after the conversion.
- Change report with the result of every link.
How to use
- You1Tick the link types to convert
- You3Convert now, check and confirm
- DOORS Next4Base links replace module linksIf needed: Some failed: Retry
- Result5Result with Log, every link in Excel
- Open a module. Under Link types, click Change, tick the link types to convert and click Done.
- Under Convert, choose Whole module or Selection (select artifacts in the module first) and click Find links. Nothing changes yet: the result shows how many artifacts were checked, how many have module links and how many links will be converted, and Module links lists them.
- Click Convert now and confirm with Convert N links.
- The result shows the links converted, the artifacts changed, the links already on the base artifacts and any failures, with Retry and the Log. The download icon at Module links saves every link and its result to Excel.
Screenshots
1Link types opened again after a search: the number of module links of each type, two types ticked, the other end linked to its base artifact too 2Search finished: each artifact with module links, one opened to show its links 3Confirmation under the tiles: both ends become base artifacts, each module link is deleted once its base link exists 4Links converted: the numbers of the run with the Log, some links already existed on the base artifacts 5An artifact locked by another user: its links are listed with the reason, with Retry
Good to know
- By default both ends of a link become base artifacts; a setting keeps the target end as it was.
- Links that already exist between the base artifacts are recognized and not duplicated.
- Links to other ELM applications (test cases, work items) are never changed.
- On the whole module, Convert now also works without a search: it finds and converts the links in one pass, after the same confirmation.
- On very large modules you can Stop, reload the page and click Continue from … to go on from the next artifact.
What's new in version 3.47
· Change titles are published in English.
- Search result wording