# Attribute Linker

> Zamienia identyfikatory i klucze zapisane w atrybucie na prawdziwe linki, w całym module lub w zaznaczeniu, po potwierdzeniu.

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

- 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: tworzenie linków z atrybutu, import identyfikowalności, Parent ID, linki z importu Excel, import ReqIF, migracja z DOORS 9, legacy ID, zbiorcze tworzenie linków, traceability
- Wersja: 1.19 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Settings: atrybut z odwołaniami, typ linku, kierunek → 2. Whole module (W razie potrzeby: Albo zaznacz artefakty: Selection) → 3. Create links: po potwierdzeniu → 4. Sprawdź listę i nierozwiązane odwołania → 5. Raport zmian w Excelu

## 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.