# Terms Linker

> Zamienia każde wystąpienie terminu ze słownika w wymaganiach w link do jego definicji, w całym module, w jednym przebiegu.

Source: https://widgets.doorsnext.com/pl/widgets/terms-linker/

- Dyscyplina: Jakość treści
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: terminy słownika, linkowanie słownika, terminologia, link References Term, hiperłącza do terminów, spójna terminologia, słownik wymagań, glossary terms, IBM DOORS Next
- Wersja: 5.53 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Znajdź wszystkie terminy lub wybierz je → 2. Znajduje, gdzie występują terminy → 3. Sprawdź artefakty i ich terminy → 4. Podlinkuj terminy: hiperłącza i linki do terminów (W razie potrzeby: Bardzo duży moduł: Link terms bez wyszukiwania) → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Wspólny słownik to jedno z najlepszych narzędzi przeciwko niejednoznacznym wymaganiom: każdy termin ma jedną uzgodnioną definicję. Pomaga on jednak tylko wtedy, gdy czytelnik może dotrzeć do definicji z miejsca, w którym termin jest użyty, i gdy widać, które wymagania zależą od którego terminu.

W DOORS Next oznacza to ręczne tworzenie hiperłącza w tekście oraz linku *References Term* dla każdego wystąpienia. W module z setkami wymagań i dziesiątkami terminów to dni pracy, a nikt potem nie utrzymuje tego w aktualności. Terms Linker robi to automatycznie, w ten sam sposób dla każdego autora.

## Jakie problemy rozwiązuje
- Terminy słownika używane w wymaganiach bez żadnego linku do ich definicji.
- Brak identyfikowalności między terminami a wymaganiami, które z nich korzystają, przez co wpływ zmiany definicji pozostaje nieznany.
- Godziny ręcznego linkowania, wykonywanego przez różnych autorów w niespójny sposób.
- Linki utworzone tylko częściowo po wcześniejszej ręcznej lub przerwanej pracy.

## Korzyści
- **Jednoznaczne wymagania:** czytelnik otwiera definicję terminu jednym kliknięciem.
- **Analiza wpływu:** linki References Term pokazują, których wymagań dotyczy zmiana definicji.
- **Spójność:** tylko całe słowa, najpierw najdłuższy termin (np. „brake system” przed „brake”) i żadnych linków wewnątrz istniejących linków.
- **Podgląd przed zmianą:** widżet wyświetla listę artefaktów, znalezionych terminów i liczbę ich wystąpień.
- **Odwracalność:** Terms Remover usuwa dokładnie to, co utworzył Terms Linker.

## Jak używać
1. W sekcji **Terms** kliknąć **Find terms**, aby użyć wszystkich terminów słownika projektu, lub **Pick terms**, aby wybrać konkretne. **Show terms** pokazuje wybrane terminy.
2. Otworzyć moduł, wybrać **Whole module** w sekcji **Link** i kliknąć **Find usage**. Nic się jeszcze nie zmienia: widżet pokazuje, ile artefaktów zawiera terminy, ile jest wystąpień i jakie terminy są najczęściej używane. Kliknięcie artefaktu pokazuje jego terminy i liczbę wystąpień.
3. Przejrzeć listę, następnie kliknąć **Link terms**, przeczytać potwierdzenie i kliknąć w nim **Link terms**. Hiperłącza i linki do terminów są tworzone partiami, z widocznym postępem i przyciskiem **Stop**. Kliknięcie **Log** w wyniku pobiera raport zmian.
4. Aby połączyć tylko wybrane artefakty, zaznaczyć je w DOORS Next i wybrać **Selection · N**: widżet od razu je sprawdza. Następnie kliknąć **Link terms** i potwierdzić.
5. W przypadku bardzo dużych modułów można kliknąć **Link terms** na całym module bez wcześniejszego wyszukiwania: każdy artefakt jest odczytywany i linkowany w jednym przebiegu, a liczby są podawane na końcu.

## Warto wiedzieć
- Typ artefaktu terminów słownika (domyślnie *Term*) oraz dopasowanie bez rozróżniania wielkości liter ustawia się w **Settings**: kliknąć **Change**, a po zakończeniu **Done**.
- Linki są tworzone na artefakcie bazowym, dzięki czemu są widoczne w każdym module, który ponownie wykorzystuje dane wymaganie.
- Uruchamiać widżet w zestawie zmian (change set) i zachować raport zmian jako zapisu tego, co zostało połączone.
- Listę artefaktów z terminami można przeszukiwać po ID, nazwie lub terminie i zapisać do Excela ikoną po prawej stronie jej nagłówka.
- Jeśli przy bardzo dużym module przeglądarka zwalnia, należy zatrzymać przebieg przyciskiem **Stop**, przeładować stronę i ponownie otworzyć moduł: **Continue from …** linkuje resztę modułu z tymi samymi terminami i dopasowaniem.