# Base To Module Links

> 将基本工件之间的链接转换为已打开模块内的链接，使属于某一模块的可追溯性只留在该模块中。

Source: https://widgets.doorsnext.com/zh/widgets/base-to-module-links/

- 学科: 链接与可追溯性
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 基本工件链接, 模块上下文链接, 链接转换, 需求可追溯性, 需求复用, 基本链接转模块链接, 模块专属链接, base artifact links, module context links, traceability
- 版本: 2.11 (发布日期 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. 勾选要转换的链接类型 → 2. Find links：列出每个基本链接 (如有需要: 或 Selection：模块中选择的工件) → 3. Convert now，检查并确认 → 4. 模块链接取代基本链接 (如有需要: 有失败：Retry) → 5. 带 Log 的结果，每个链接在 Excel 中

## 它是什么，为何存在
在 DOORS Next 中，链接可以在基本工件之间创建，也可以在模块上下文中创建。基本工件之间的链接会出现在每个复用这些需求的模块中。当某个链接只对一个模块成立时，例如只针对一个产品变体或一个发行版，它就应属于该模块的上下文：在模块中创建相同的链接，然后删除基本链接。

手动完成这项工作耗时很长，而且容易出错。Base To Module Links 转换整个模块的链接，且不丢失任何一个链接。它是 Module To Base Links 的反向操作。

## 解决的问题
- 属于某一模块的可追溯性，却出现在复用相同需求的所有其他模块中。
- 因误操作或导入而在基本工件层面创建、本应是模块链接的链接。
- 手动转换：对每个链接都要在模块中查找每一端的工件、创建新链接并删除旧链接。
- 转换顺序出错时可能丢失链接。

## 优势
- **模块专属的可追溯性：** 每个模块只显示属于它的链接。
- **不丢失链接：** 先创建模块链接，只有在成功之后才删除基本链接。
- **自主选择转换内容：** 只转换您选定的链接类型。
- **预览和 Excel 导出**：转换前后的每个基本链接一览无余。
- **变更报告**：记录每个链接的转换结果。

## 使用方法
1. 打开模块。在 **Link types** 下单击 **Change**，勾选要转换的链接类型，然后单击 **Done**。
2. 在 **Convert** 下选择 **Whole module** 或 **Selection**（先在模块中选择工件），然后单击 **Find links**。此时不会更改任何内容：结果显示检查了多少工件、多少工件有基本链接以及将转换多少链接，**Base links** 中列出这些链接。
3. 单击 **Convert now**，并用 **Convert N links** 确认。
4. 结果显示已转换的链接、已更改的工件、模块中已存在的链接以及失败项，并提供 **Retry** 和 **Log**。**Base links** 处的下载图标可将每个链接及其结果保存到 Excel。

## 须知
- 已转换的基本链接会从使用这些工件的所有其他模块中消失；请在变更集中操作，以便先检查结果。
- 启用 **Keep base link** 后，会创建模块链接并保留原始基础链接，因此不会删除任何内容。
- 默认情况下，如果链接另一端的工件也在同一模块中，该端会变为它在模块中的工件；可通过一项设置让它保持原样。
- 模块中已存在的链接会被识别，不会重复创建。
- 指向其他 ELM 应用程序的链接（测试用例、工作项）绝不会被更改。
- 对整个模块，**Convert now** 也可以不先查找：经过同样的确认后，一次性查找并转换链接。
- 在模块中多次使用的工件只列出并计数一次。
- 对于非常大的模块，可以单击 **Stop**，重新加载页面，然后单击 **Continue from …** 从下一个工件继续。