# Image Linker

> 将每个工件链接到其文本中的图片，使更改后的图片出现在影响分析中。

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

- 学科: 链接与可追溯性
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 嵌入图片, 需求中的图片, 影响分析, 可追溯性, 链接图片, 嵌入工件, 图表, 批量创建链接, IBM DOORS Next
- 版本: 1.21 (发布日期 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. Settings：链接类型、方向、计入范围 → 2. Find embedded pictures in module (如有需要: 或选择工件：自动检查) → 3. 检查工件及其图片 → 4. Create links：确认后创建 → 5. Excel 变更报告

## 它是什么，为何存在
需求中经常包含图片：屏幕布局、图表、照片、信号表。在 IBM DOORS Next 中，放在工件文本中的图片本身就是一个工件，但没有任何链接将需求与它关联。当有人替换或编辑图片时，影响分析和可追溯性视图不会显示哪些需求依赖于它。

Image Linker 找出模块中（或所选工件中）每个工件文本里嵌入的图片，并在一次受控运行中从每个工件到其图片创建所选类型的链接。如有需要，它也可以链接其他嵌入工件，例如嵌入的表格或图表。

## 解决的问题
- 需求文本中的图片在影响分析中不可见。
- 图表或屏幕布局更改后，无人能找到受影响的需求。
- 数百张嵌入图片需要逐个工件手动链接。
- 无法记录哪些图片链接已存在、哪些图片来自 DOORS Next 之外。

## 优势
- **任何更改之前先预览:** 每张嵌入图片都显示为 To link、Already linked 或 Not resolvable。
- **从不猜测:** 来自其他网站或服务器、或直接存储在文本中的图片只会列出，绝不会被链接。
- **您的链接类型和方向:** 项目中的任何链接类型，传出或传入；仅图片或任何嵌入工件。
- **安全的默认设置:** 链接在模块上下文中创建，与 DOORS Next 在模块内的做法一致；仅在您选择时才在基础工件上创建链接。
- **长时间运行也在掌控之中:** 任意大小的整个模块，跳过已有链接，进度显示和 Stop，超大模块停止后可继续，失败项可 Retry，并提供 Excel 变更报告。

## 使用方法
1. 将小部件添加到模块旁边的 ELM Mini Dashboard。
2. 在 **Settings** 中点击 **Change**，选择 **Link type**、**Direction**（**Outgoing** 或 **Incoming**）和 **What counts**（**Pictures only** 或 **Any embedded artifact**）；仅当链接应建在基础工件上时才勾选 **Create the links on base artifacts**。点击 **Done**。
3. 在 **Links** 下选择 **Whole module** 并点击 **Find embedded pictures**，或选择工件后选择 **Selection**：所选内容会自动检查。在 **Embedded items** 中查看工件及其图片。
4. 点击 **Create links**，阅读确认信息后点击 **Create N links**。如未先搜索，在整个模块上点击 **Create links** 会在一次运行中完成查找和链接。
5. 查看结果区块，如有需要可通过 **Log** 下载变更报告。

## 须知
- 在创建链接之前会重新读取每个工件，因此搜索后添加或删除的图片都会被考虑在内。
- 同一张图片在一个文本中出现两次只创建一个链接；在多个工件中使用的图片会从每个工件各获得一个链接。
- 只能链接存储在同一服务器上 DOORS Next 中的图片；其他图片显示为 Not resolvable。
- 列表显示名称和 ID 而非缩略图，因此即使是非常大的模块，浏览器负担也很小。
- 请始终在 change set 中工作：只有丢弃它才能撤销已创建的链接。