# Module To Base Links

> Konwertuje linki utworzone w module na linki między artefaktami bazowymi, aby identyfikowalność podążała za wymaganiem do każdego modułu, który je wykorzystuje.

Source: https://widgets.doorsnext.com/pl/widgets/module-to-base-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 w kontekście modułu, linki artefaktów bazowych, konwersja linków, identyfikowalność, ponowne użycie linków, linki modułu do artefaktów bazowych, ponowne wykorzystanie wymagań, module context links, base artifact links, traceability, IBM DOORS Next
- Wersja: 3.42 (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 modułowy (W razie potrzeby: Albo Selection: artefakty zaznaczone w module) → 3. Convert now, sprawdź i potwierdź → 4. Linki bazowe zamiast linków modułowych (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ć w kontekście modułu lub między artefaktami bazowymi. Linki utworzone w module są widoczne tylko w nim. Gdy wymagania są ponownie wykorzystywane w innych modułach albo gdy zespół uzna, że identyfikowalność powinna należeć do artefaktów bazowych, istniejące linki modułu trzeba przekonwertować: utworzyć taki sam link między artefaktami bazowymi, a następnie usunąć link modułu.

Ręcznie trwa to długo, a link modułu usunięty, zanim powstanie jego link bazowy, zostaje utracony. Module To Base Links konwertuje linki całego modułu i usuwa każdy link modułu dopiero wtedy, gdy istnieje już jego link bazowy.

## Jakie problemy rozwiązuje
- Identyfikowalność widoczna w jednym module, ale nieobecna w innych modułach wykorzystujących te same wymagania.
- Niespójna strategia linkowania po importach lub po pracy kilku zespołów stosujących różne podejścia.
- Ręczna konwersja: odnalezienie artefaktów bazowych obu końców, 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
- **Spójna identyfikowalność** we wszystkich modułach, które ponownie wykorzystują dane wymaganie.
- **Żadnych utraconych linków:** najpierw tworzony jest link bazowy, a link modułu 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 modułu 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 modułowe i ile linków zostanie przekonwertowanych, a **Module links** je wypisuje.
3. Kliknąć **Convert now** i potwierdzić przyciskiem **Convert N links**.
4. Wynik pokazuje przekonwertowane linki, zmienione artefakty, linki już istniejące na artefaktach bazowych i błędy, z **Retry** i **Log**. Ikona pobierania przy **Module links** zapisuje każdy link wraz z wynikiem do Excela.

## Warto wiedzieć
- Domyślnie oba końce linku stają się artefaktami bazowymi; odpowiednie ustawienie pozwala pozostawić koniec docelowy bez zmian.
- Linki, które już istnieją między artefaktami bazowymi, 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.
- W bardzo dużych modułach można kliknąć **Stop**, przeładować stronę i kliknąć **Continue from …**, aby kontynuować od następnego artefaktu.