# Link Switcher

> Trasforma i link di un tipo in un altro o ne inverte la direzione, in un intero modulo o in una selezione, senza eliminarli e ricrearli a mano.

Source: https://widgets.doorsnext.com/it/widgets/link-switcher/

- 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: cambiare tipo di link, convertire link, invertire direzione dei link, copiare link come altro tipo, modifica del modello di tracciabilità, aggiornamento massivo dei link, Link To in Satisfies
- Versione: 1.21 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. From: spuntare i tipi di link da cambiare → 2. To: scegliere il nuovo tipo e la direzione → 3. Find links: mostra cosa diventa ciascuno (Se serve: Oppure Selection: artefatti selezionati in DOORS Next) → 4. Change: dopo la conferma (Se serve: Errori: Retry) → 5. Risultato con il Log in Excel

## Che cos'è e perché esiste
I modelli di tracciabilità cambiano. Un team parte con link generici «Link To» e in seguito decide che devono essere «Satisfies»; un'importazione crea link «Validated By» nella direzione sbagliata; un nuovo modello richiede un secondo tipo di link accanto a quello esistente. Nell'interfaccia standard ognuno di questi link va eliminato e ricreato uno alla volta, ed è facile perderne qualcuno.

Link Switcher cambia i link esistenti in blocco e in sicurezza: si scelgono i link da cambiare, il tipo di link che assumono e la nuova direzione, si vede ogni link prima di qualsiasi modifica e si esegue il cambiamento in un unico passaggio controllato. Può anche copiare i link come un altro tipo mantenendo gli originali.

## Problemi che risolve
- Centinaia di link del tipo sbagliato dopo un'importazione, una migrazione o un cambio del modello di tracciabilità.
- Link orientati nella direzione sbagliata che vanno invertiti.
- Eliminare e ricreare link a mano: lento e con il rischio di perderne.
- Un nuovo tipo di link che deve convivere con quello vecchio durante una transizione.
- Nessuna traccia di quali link sono stati cambiati.

## Vantaggi
- **Modifica in blocco:** qualsiasi numero di tipi di link diventa un nuovo tipo, nella stessa direzione o in quella inversa.
- **Ordine sicuro:** prima viene creato il nuovo link, solo dopo viene rimosso l'originale; se la creazione non riesce, l'originale resta.
- **Modalità copia:** «Keep the original links» aggiunge una copia con il nuovo tipo e lascia invariati gli originali.
- **Anteprima:** ogni link è elencato per artefatto con ciò che diventerà, e i conteggi sono mostrati prima dell'esecuzione.
- **Sicuro per impostazione predefinita:** si cambiano solo i link nel contesto del modulo, a meno di includere quelli sugli artefatti base; l'opzione si disattiva dopo ogni esecuzione.
- **Esecuzioni lunghe sotto controllo:** avanzamento, Stop e ripresa per moduli molto grandi, elenco dei link non cambiati con Retry e report delle modifiche in Excel.

## Come si usa
1. In **Link types** fate clic su **Change**. In **From** spuntate i tipi di link da cambiare e scegliete la loro **Direction**: **All directions**, **Outgoing** o **Incoming**. L'elenco deriva dai tipi di link definiti nel vostro progetto.
2. In **To** scegliete il **New link type** e la **Direction of the new link**: **Same as original** o **Reversed**.
3. Se serve, spuntate **Keep the original links** (copiare invece di cambiare) e **Change links in the module and on base artifacts**, poi fate clic su **Done**.
4. In **Change** scegliete **Whole module** o **Selection** (artefatti selezionati in DOORS Next) e fate clic su **Find links**. Non cambia ancora nulla: aprite una riga di **Links** per vedere ogni link e ciò che diventa.
5. Fate clic su **Change** (o **Copy**), leggete la conferma e confermate con **Change N links** (o **Copy N links**).
6. Il risultato mostra i link cambiati, i nuovi link già presenti, i link sugli artefatti base e gli errori, con **Retry**. Il **Log** salva il report delle modifiche in Excel.

## Da sapere
- Un link bidirezionale resta bidirezionale: cambia solo il suo tipo e la scelta Reversed non si applica.
- Se i link scelti hanno già il nuovo tipo e la nuova direzione, non c'è nulla da cambiare e il widget lo segnala.
- Un link tra due artefatti dello stesso modulo viene cambiato una sola volta.
- I link sugli artefatti base cambiano in tutti i moduli che riutilizzano quegli artefatti; usate questa opzione con consapevolezza.
- Lavorate sempre in un change set: scartarlo è l'unico modo per recuperare i link originali.
- Sull'intero modulo **Change** funziona anche senza una ricerca, in un solo passaggio dopo la stessa conferma. Nei moduli molto grandi un'esecuzione fermata prosegue con **Continue from …**, anche dopo aver ricaricato la pagina.
- Fuori da un modulo il widget lavora sugli artefatti selezionati in DOORS Next.
- Se l'artefatto base di un artefatto non può essere letto, i suoi link nel modulo vengono comunque cambiati e un avviso indica l'artefatto.