# Base To Module Links

> Преобразует связи между базовыми артефактами в связи внутри открытого модуля, чтобы трассируемость, относящаяся к одному модулю, оставалась в этом модуле.

Source: https://widgets.doorsnext.com/ru/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 …**, чтобы продолжить со следующего артефакта.