# Attribute Linker

> 将属性中保存的 ID 和键转换为真正的链接，适用于整个模块或所选工件，确认后执行。

Source: https://widgets.doorsnext.com/zh/widgets/attribute-linker/

- 学科: 链接与可追溯性
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 从属性创建链接, 导入追溯性, Parent ID, Excel 导入链接, ReqIF 导入, DOORS 9 迁移, 旧系统 ID, 批量创建链接, 追溯性
- 版本: 1.19 (发布日期 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. Settings：引用属性、链接类型、方向 → 2. Whole module (如有需要: 或选择工件：Selection) → 3. Create links：确认后创建 → 4. 检查列表和未解析的引用 → 5. Excel 变更报告

## 它是什么，为何存在
当需求来自 Excel、ReqIF 或 DOORS 9 时，追溯关系很少以链接的形式到达，而是以文本形式出现：例如 "Parent ID"、"Satisfies" 或 "Derived from" 这样的列，其中包含一个或多个 ID 或旧系统键。在标准界面中，每一个引用都必须手动转换为链接，逐个工件处理。

Attribute Linker 读取该属性，找到每个引用所指的工件，并在一次运行中创建链接。目标可以通过其 DOORS Next ID 在整个项目中查找，也可以通过目标模块中某个属性（例如 "Legacy ID"）的值查找。

## 解决的问题
- 追溯关系以文本形式导入到属性中，而不是链接。
- 迁移后需要手动创建成百上千个链接。
- 指向不存在或指向多个工件的引用，往往很久之后才被发现。
- 没有记录哪些链接已创建、哪些引用无法解析。

## 优势
- **每个引用都有交代：** 运行后，每个引用都列为 Linked、Already linked、Not found、Ambiguous 或 Self reference。
- **从不猜测：** 与多个工件匹配的引用会被跳过，并连同候选项一起列出。
- **灵活匹配：** 按 DOORS Next ID，或按目标模块属性中保存的旧系统键；支持用逗号、分号、空格或换行分隔的列表。
- **安全的默认设置：** 链接在模块上下文中创建，与在模块内建立链接时 DOORS Next 的做法一致；只有在您选择时才在基础工件上创建。
- **可以恢复的运行：** 跳过已有链接，显示进度并可停止，超大模块停止后可继续，失败项可 Retry，未解析引用的 Excel 列表以及 Excel 变更报告。

## 使用方法
1. 将小部件添加到模块旁边的 ELM Mini Dashboard。
2. 在 **Settings** 中单击 **Change**，填写保存引用的 **Reference attributes**、分隔符、查找目标的方式（**Artifact ID**，或目标模块中的 **Attribute in a module**）、**Link type** 和 **Direction**，然后单击 **Done**。
3. 在 **Links** 下选择 **Whole module**，或选择工件后选择 **Selection**。
4. 单击 **Create links**，阅读确认信息并确认。小组件会在一次运行中找到引用并创建缺失的链接。
5. 查看结果区块和 **References** 列表：**Not resolved** 筛选器显示每个无法链接的引用及其原因。如有需要可将其导出到 Excel，并通过 **Log** 下载变更报告。

## 须知
- 有歧义的引用和指向工件自身的引用永远不会被链接；它们会被列出，并可导出到 Excel。
- 如果运行期间属性值发生变化，该工件不会被处理并会列出：请再次运行 Create links。
- 一个可选设置会在属性的所有引用都已链接后清空该属性；默认关闭。
- 在全局配置中工作时，目标模块和按 ID 找到的工件也可以位于同一全局配置的另一个组件中；此时链接会连接这些组件。在单个 stream 或 baseline 中，只使用当前打开的组件。
- 请始终在 change set 中工作：只有丢弃它才能撤销已创建的链接。