# Attribute Linker

> Trasforma ID e chiavi salvati in un attributo in veri link, per un intero modulo o una selezione, dopo una conferma.

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

- Disciplina: Link e tracciabilità
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: creare link da attributo, importare tracciabilità, Parent ID, link da importazione Excel, importazione ReqIF, migrazione DOORS 9, ID legacy, creazione massiva di link, tracciabilità
- Versione: 1.19 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Settings: attributo dei riferimenti, tipo di link, direzione → 2. Whole module (Se serve: Oppure selezionare artefatti: Selection) → 3. Create links: dopo la conferma → 4. Controllare l'elenco e i riferimenti non risolti → 5. Report delle modifiche in Excel

## Che cos'è e perché esiste
Quando i requisiti arrivano da Excel, ReqIF o DOORS 9, la tracciabilità arriva raramente come link. Arriva come testo: una colonna come "Parent ID", "Satisfies" o "Derived from" con uno o più ID o chiavi legacy. Nell'interfaccia standard ognuno di questi riferimenti va trasformato in link a mano, artefatto per artefatto.

Attribute Linker legge quell'attributo, trova l'artefatto che ogni riferimento indica e crea i link in un'unica esecuzione. Le destinazioni si trovano tramite il loro ID DOORS Next in tutto il progetto, oppure tramite il valore di un attributo (per esempio "Legacy ID") in un modulo di destinazione.

## Problemi che risolve
- Tracciabilità importata come testo in un attributo invece che come link.
- Centinaia o migliaia di link da creare a mano dopo una migrazione.
- Riferimenti che non puntano a nulla, o a più artefatti, scoperti molto più tardi.
- Nessuna traccia di quali link sono stati creati e quali riferimenti non sono stati risolti.

## Vantaggi
- **Nessun riferimento trascurato:** dopo l'esecuzione ogni riferimento è elencato come Linked, Already linked, Not found, Ambiguous o Self reference.
- **Non tira mai a indovinare:** un riferimento che corrisponde a più artefatti viene escluso ed elencato con i candidati.
- **Corrispondenza flessibile:** per ID DOORS Next, o per una chiave legacy in un attributo di un modulo di destinazione; elenchi separati da virgole, punti e virgola, spazi o a capo.
- **Impostazioni sicure:** i link vengono creati nel contesto del modulo, come fa DOORS Next all'interno di un modulo; sugli artefatti base solo se lo scegliete.
- **Esecuzioni che si riprendono:** i link esistenti vengono saltati, avanzamento e Stop, ripresa dopo uno stop sui moduli molto grandi, errori con Retry, un elenco Excel dei riferimenti non risolti e un report delle modifiche in Excel.

## Come si usa
1. Aggiungete il widget all'ELM Mini Dashboard accanto al modulo.
2. In **Settings** fate clic su **Change** e indicate i **Reference attributes** con i riferimenti, i separatori, come trovare le destinazioni (**Artifact ID** o **Attribute in a module** di un modulo di destinazione), il **Link type** e la **Direction**, poi fate clic su **Done**.
3. In **Links**, scegliete **Whole module**, oppure selezionate degli artefatti e scegliete **Selection**.
4. Fate clic su **Create links**, leggete la conferma e confermate. Il widget trova i riferimenti e crea i link mancanti in un'unica esecuzione.
5. Controllate il blocco dei risultati e l'elenco **References**: il filtro **Not resolved** mostra ogni riferimento che non è stato possibile collegare, con il motivo. Esportateli in Excel se serve e scaricate il report delle modifiche con **Log**.

## Da sapere
- I riferimenti ambigui e quelli all'artefatto stesso non vengono mai collegati; sono elencati e si possono esportare in Excel.
- Se il valore di un attributo cambia durante l'esecuzione, quell'artefatto non viene toccato e viene elencato: eseguite di nuovo Create links.
- Un'impostazione opzionale svuota l'attributo quando tutti i suoi riferimenti sono collegati; è disattivata per impostazione predefinita.
- Quando lavorate in una configurazione globale, il modulo di destinazione e gli artefatti trovati per ID possono trovarsi anche in un altro componente della stessa configurazione globale; i link collegano allora i componenti. In un singolo stream o baseline si usa solo il componente aperto.
- Lavorate sempre in un change set: scartarlo è l'unico modo per annullare i link creati.