Link Switcher

Czym jest i dlaczego powstał

Modele identyfikowalności (traceability) się zmieniają. Zespół zaczyna od ogólnych linków „Link To”, a później ustala, że powinny to być „Satisfies”; import tworzy linki „Validated By” skierowane w złą stronę; nowy model wymaga drugiego typu linku obok istniejącego. W standardowym interfejsie każdy taki link trzeba usunąć i utworzyć od nowa, jeden po drugim, a po drodze łatwo jakiś link zgubić.

Link Switcher zmienia istniejące linki zbiorczo i bezpiecznie: wybierasz, które linki zmienić, na jaki typ i w jakim kierunku, widzisz każdy link, zanim cokolwiek się zmieni, i wykonujesz zmianę w jednym kontrolowanym przebiegu. Może też skopiować linki jako inny typ i zostawić oryginały.

Jakie problemy rozwiązuje

• Setki linków niewłaściwego typu po imporcie, migracji lub zmianie modelu identyfikowalności.
• Linki skierowane w złą stronę, które trzeba odwrócić.
• Ręczne usuwanie i ponowne tworzenie linków, które jest powolne i grozi utratą linków.
• Nowy typ linku, który przez okres przejściowy musi istnieć obok starego.
• Brak zapisu, które linki zostały zmienione.

Korzyści

• Zmiana zbiorcza: dowolna liczba typów linków staje się jednym nowym typem, w tym samym lub odwróconym kierunku.
• Bezpieczna kolejność: najpierw powstaje nowy link, a oryginał jest usuwany dopiero potem; jeśli utworzenie się nie uda, oryginał zostaje.
• Tryb kopiowania: „Keep the original links” dodaje kopię z nowym typem i nie rusza oryginałów.
• Podgląd: każdy link jest pokazany przy swoim artefakcie razem z tym, czym się stanie, a liczby widać przed uruchomieniem.
• Domyślnie bezpiecznie: zmieniane są tylko linki w kontekście modułu, chyba że dołączysz linki na artefaktach bazowych; ta opcja wyłącza się sama po każdym przebiegu.
• Długie przebiegi pod kontrolą: postęp, Stop i kontynuacja na bardzo dużych modułach, lista linków, których nie udało się zmienić, z przyciskiem Retry oraz raport zmian w Excelu.

Jak używać

1. W sekcji Link types kliknąć Change. W części From zaznaczyć typy linków do zmiany i wybrać ich Direction: All directions, Outgoing lub Incoming. Lista pochodzi z typów linków zdefiniowanych w projekcie.
2. W części To wybrać New link type i Direction of the new link: Same as original lub Reversed.
3. Opcjonalnie zaznaczyć Keep the original links (kopiowanie zamiast zmiany) i Change links in the module and on base artifacts, a potem kliknąć Done.
4. W sekcji Change wybrać Whole module lub Selection (artefakty zaznaczone w DOORS Next) i kliknąć Find links. Nic się jeszcze nie zmienia: rozwinięcie wiersza w Links pokazuje każdy link i to, czym się stanie.
5. Kliknąć Change (lub Copy), przeczytać potwierdzenie i potwierdzić przyciskiem Change N links (lub Copy N links).
6. Wynik pokazuje zmienione linki, nowe linki, które już istniały, linki na artefaktach bazowych i błędy, z Retry. Log zapisuje raport zmian do Excela.

Warto wiedzieć

• Link dwukierunkowy pozostaje dwukierunkowy: zmienia się tylko jego typ, a wybór Reversed go nie dotyczy.
• Jeśli wybrane linki mają już nowy typ i kierunek, nie ma czego zmieniać i widget o tym informuje.
• Link między dwoma artefaktami tego samego modułu jest zmieniany raz, a nie dwa razy.
• Linki na artefaktach bazowych zmieniają się w każdym module, który używa tych artefaktów; korzystaj z tej opcji świadomie.
• Zawsze pracuj w change secie: jego odrzucenie to jedyny sposób na przywrócenie oryginalnych linków.
• Dla całego modułu Change działa także bez wcześniejszego wyszukiwania, w jednym przebiegu po tym samym potwierdzeniu. W bardzo dużych modułach zatrzymany przebieg można kontynuować przyciskiem Continue from …, także po przeładowaniu strony.
• Poza modułem widżet działa na artefaktach zaznaczonych w DOORS Next.
• Jeśli nie da się odczytać artefaktu bazowego danego artefaktu, jego linki w module i tak są zmieniane, a ostrzeżenie wskazuje ten artefakt.