Terms Linker

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.