Attribute Linker

它是什么，为何存在

当需求来自 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 中工作：只有丢弃它才能撤销已创建的链接。