# Base To Module Links

> Konwertuje linki między artefaktami bazowymi na linki w otwartym module, aby identyfikowalność należąca do jednego modułu pozostała w tym module.

Source: https://widgets.doorsnext.com/pl/widgets/base-to-module-links/

- Dyscyplina: Linki i identyfikowalność
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: linki artefaktów bazowych, linki w kontekście modułu, konwersja linków, identyfikowalność, ponowne wykorzystanie wymagań, linki bazowe do modułu, linki specyficzne dla modułu, base artifact links, module context links, traceability, IBM DOORS Next
- Wersja: 2.11 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Zaznacz typy linków do konwersji → 2. Find links: wypisuje każdy link bazowy (W razie potrzeby: Albo Selection: artefakty zaznaczone w module) → 3. Convert now, sprawdź i potwierdź → 4. Linki modułu zamiast linków bazowych (W razie potrzeby: Błędy: Retry) → 5. Wynik z Log, każdy link w Excelu

## Czym jest i dlaczego powstał
W DOORS Next link można utworzyć między artefaktami bazowymi lub w kontekście modułu. Link między artefaktami bazowymi jest widoczny w każdym module, który ponownie wykorzystuje te wymagania. Gdy link jest prawdziwy tylko dla jednego modułu, na przykład dla jednego wariantu produktu lub jednego wydania, jego miejsce jest w kontekście tego modułu: trzeba utworzyć taki sam link w module, a następnie usunąć link bazowy.

Wykonywane ręcznie trwa to długo i łatwo o pomyłkę. Base To Module Links konwertuje linki w całych modułach bez utraty choćby jednego linku. Działa odwrotnie niż Module To Base Links.

## Jakie problemy rozwiązuje
- Identyfikowalność należąca do jednego modułu, ale widoczna w każdym innym module wykorzystującym te same wymagania.
- Linki utworzone na poziomie bazowym przez pomyłkę lub przez import, które powinny być linkami modułu.
- Ręczna konwersja: odnalezienie w module artefaktu każdego końca, utworzenie nowego linku i usunięcie starego, dla każdego linku z osobna.
- Ryzyko utraty linków, gdy konwersja przebiega w niewłaściwej kolejności.

## Korzyści
- **Identyfikowalność specyficzna dla modułu:** każdy moduł pokazuje tylko należące do niego linki.
- **Żadnych utraconych linków:** najpierw tworzony jest link modułu, a link bazowy jest usuwany dopiero po powodzeniu tej operacji.
- **Wybór zakresu konwersji:** tylko wskazane typy linków.
- **Podgląd i eksport do Excela** każdego linku bazowego przed konwersją i po niej.
- **Raport zmian** z wynikiem dla każdego linku.

## Jak używać
1. Otworzyć moduł. W sekcji **Link types** kliknąć **Change**, zaznaczyć typy linków do konwersji i kliknąć **Done**.
2. W sekcji **Convert** wybrać **Whole module** lub **Selection** (najpierw zaznaczyć artefakty w module) i kliknąć **Find links**. Nic się jeszcze nie zmienia: wynik pokazuje, ile artefaktów sprawdzono, ile ma linki bazowe i ile linków zostanie przekonwertowanych, a **Base links** je wypisuje.
3. Kliknąć **Convert now** i potwierdzić przyciskiem **Convert N links**.
4. Wynik pokazuje przekonwertowane linki, zmienione artefakty, linki już istniejące w module i błędy, z **Retry** i **Log**. Ikona pobierania przy **Base links** zapisuje każdy link wraz z wynikiem do Excela.

## Warto wiedzieć
- Przekonwertowany link bazowy znika z każdego innego modułu, który używa tych artefaktów; warto pracować w zestawie zmian (change set), aby najpierw przejrzeć wynik.
- Opcja **Keep base link** tworzy link w module i zachowuje oryginalny link bazowy, więc nic nie jest usuwane.
- Domyślnie drugi koniec linku staje się swoim artefaktem w tym samym module, jeśli się w nim znajduje; odpowiednie ustawienie pozwala pozostawić go bez zmian.
- Linki, które już istnieją w module, są rozpoznawane i nie są duplikowane.
- Linki do innych aplikacji ELM (przypadki testowe, elementy pracy) nigdy nie są zmieniane.
- Dla całego modułu **Convert now** działa także bez wcześniejszego wyszukiwania: po tym samym potwierdzeniu znajduje i konwertuje linki w jednym przebiegu.
- Artefakt użyty w module kilka razy jest wypisany i liczony raz.
- W bardzo dużych modułach można kliknąć **Stop**, przeładować stronę i kliknąć **Continue from …**, aby kontynuować od następnego artefaktu.