# Image Linker

> Связывает каждый артефакт с изображениями в его тексте, чтобы изменённое изображение было видно в анализе влияния.

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

- Дисциплина: Связи и трассируемость
- Где работает: Модуль IBM DOORS Next
- Поддерживаемые продукты: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Изменяет данные
- Keywords: встроенные изображения, изображения в требованиях, анализ влияния, трассируемость, связать изображения, встроенные артефакты, диаграммы, массовое создание связей, IBM DOORS Next
- Версия: 1.22 (Выпущено 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.
- Список показывает имена и идентификаторы, а не миниатюры, поэтому даже очень большие модули мало нагружают браузер.
- Всегда работайте в change set: только его отмена возвращает созданные связи.