Attribute Linker

Czym jest i dlaczego powstał

Gdy wymagania przychodzą z Excela, ReqIF lub DOORS 9, identyfikowalność (traceability) rzadko przychodzi jako linki. Przychodzi jako tekst: kolumna taka jak „Parent ID”, „Satisfies” czy „Derived from”, w której jest jeden lub kilka identyfikatorów albo starych kluczy. W standardowym interfejsie każde takie odwołanie trzeba zamienić na link ręcznie, artefakt po artefakcie.

Attribute Linker czyta ten atrybut, znajduje artefakt, na który wskazuje każde odwołanie, i tworzy linki w jednym przebiegu. Cele są wyszukiwane po identyfikatorze DOORS Next w całym projekcie albo po wartości atrybutu (na przykład „Legacy ID”) w module docelowym.

Jakie problemy rozwiązuje

• Identyfikowalność zaimportowana jako tekst w atrybucie zamiast linków.
• Setki lub tysiące linków do ręcznego utworzenia po migracji.
• Odwołania, które nie wskazują na nic albo wskazują na kilka artefaktów, wykrywane dopiero dużo później.
• Brak zapisu, które linki utworzono, a których odwołań nie udało się rozwiązać.

Korzyści

• Każde odwołanie rozliczone: po przebiegu każde odwołanie jest na liście jako Linked, Already linked, Not found, Ambiguous lub Self reference.
• Nigdy nie zgaduje: odwołanie pasujące do kilku artefaktów jest pomijane i pokazane na liście razem z kandydatami.
• Elastyczne dopasowanie: po identyfikatorze DOORS Next albo po starym kluczu zapisanym w atrybucie modułu docelowego; listy rozdzielone przecinkami, średnikami, spacjami lub nowymi wierszami.
• Bezpieczne ustawienia domyślne: linki powstają w kontekście modułu, tak jak robi to DOORS Next wewnątrz modułu; linki na artefaktach bazowych tylko wtedy, gdy to wybierzesz.
• Przebiegi, które można wznowić: istniejące linki są pomijane, postęp i Stop, kontynuacja po zatrzymaniu na bardzo dużych modułach, błędy z przyciskiem Retry, lista nierozwiązanych odwołań w Excelu oraz raport zmian w Excelu.

Jak używać

1. Dodaj widget do ELM Mini Dashboard obok modułu.
2. W Settings kliknij Change i wskaż Reference attributes z odwołaniami, separatory, sposób wyszukiwania celów (Artifact ID albo Attribute in a module w module docelowym), Link type i Direction, a potem kliknij Done.
3. W sekcji Links wybierz Whole module albo zaznacz artefakty i wybierz Selection.
4. Kliknij Create links, przeczytaj potwierdzenie i zatwierdź. Widżet w jednym przebiegu znajduje odwołania i tworzy brakujące linki.
5. Sprawdź blok wyniku i listę References: filtr Not resolved pokazuje każde odwołanie, którego nie udało się połączyć, wraz z przyczyną. W razie potrzeby wyeksportuj je do Excela i pobierz raport zmian przez Log.

Warto wiedzieć

• Odwołania niejednoznaczne i odwołania do samego artefaktu nigdy nie są linkowane; są pokazane na liście i można je wyeksportować do Excela.
• Jeśli wartość atrybutu zmieni się w trakcie przebiegu, ten artefakt zostaje pominięty i trafia na listę: uruchom Create links ponownie.
• Opcjonalne ustawienie czyści atrybut, gdy wszystkie jego odwołania zostały zalinkowane; domyślnie jest wyłączone.
• Gdy pracujesz w konfiguracji globalnej, moduł docelowy i artefakty znalezione po ID mogą być także w innym komponencie tej samej konfiguracji globalnej; linki łączą wtedy komponenty. W pojedynczym strumieniu lub baseline używany jest tylko otwarty komponent.
• Zawsze pracuj w change secie: jego odrzucenie to jedyny sposób na wycofanie utworzonych linków.