# Base To Module Links

> Converte i link tra artefatti di base in link all'interno del modulo aperto, così la tracciabilità che appartiene a un modulo resta in quel modulo.

Source: https://widgets.doorsnext.com/it/widgets/base-to-module-links/

- 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: link agli artefatti base, link nel contesto del modulo, convertire i link, tracciabilità, riutilizzo dei requisiti, link da base a modulo, link specifici del modulo, base artifact links, module context links, traceability
- Versione: 2.11 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Spuntare i tipi di link da convertire → 2. Find links: elenca ogni link base (Se serve: Oppure Selection: artefatti selezionati nel modulo) → 3. Convert now, controllare e confermare → 4. Link di modulo al posto dei link base (Se serve: Errori: Retry) → 5. Risultato con Log, ogni link in Excel

## Che cos'è e perché esiste
In DOORS Next un link può essere creato tra gli artefatti di base oppure nel contesto di un modulo. Un link tra artefatti di base compare in ogni modulo che riutilizza quei requisiti. Quando un link vale solo per un modulo, ad esempio una variante di prodotto o una release, appartiene al contesto di quel modulo: si crea lo stesso link nel modulo e poi si elimina il link base.

Fatto a mano, richiede molto tempo ed è facile sbagliare. Base To Module Links converte i link di interi moduli senza perdere un solo link. È l'operazione inversa di Module To Base Links.

## Problemi che risolve
- Tracciabilità che appartiene a un modulo ma compare in ogni altro modulo che riutilizza gli stessi requisiti.
- Link creati a livello base per errore, o da un'importazione, che avrebbero dovuto essere link di modulo.
- Conversione manuale: trovare nel modulo l'artefatto di ciascuna estremità, creare il nuovo link ed eliminare quello vecchio, per ogni link.
- Il rischio di perdere link se la conversione viene eseguita nell'ordine sbagliato.

## Vantaggi
- **Tracciabilità specifica del modulo:** ogni modulo mostra solo i link che gli appartengono.
- **Nessun link perso:** prima viene creato il link di modulo e il link base viene eliminato solo dopo che l'operazione è riuscita.
- **Scegliete che cosa convertire:** solo i tipi di link selezionati.
- **Anteprima ed esportazione in Excel** di ogni link base prima e dopo la conversione.
- **Report delle modifiche** con l'esito di ogni link.

## Come si usa
1. Aprite il modulo. In **Link types** fate clic su **Change**, spuntate i tipi di link da convertire e fate clic su **Done**.
2. In **Convert** scegliete **Whole module** o **Selection** (selezionate prima gli artefatti nel modulo) e fate clic su **Find links**. Non cambia ancora nulla: il risultato indica quanti artefatti sono stati controllati, quanti hanno link base e quanti link verranno convertiti, e **Base links** li elenca.
3. Fate clic su **Convert now** e confermate con **Convert N links**.
4. Il risultato mostra i link convertiti, gli artefatti modificati, i link già presenti nel modulo e gli errori, con **Retry** e il **Log**. L'icona di download di **Base links** salva in Excel ogni link con il relativo esito.

## Da sapere
- Un link base convertito scompare da ogni altro modulo che usa questi artefatti; lavorate in una serie di modifiche (change set) per esaminare prima il risultato.
- Con **Keep base link** il link del modulo viene creato e il link base originale resta, quindi non viene eliminato nulla.
- Per impostazione predefinita l'altra estremità di un link diventa il suo artefatto nello stesso modulo, se è presente; un'impostazione la lascia invariata.
- I link già esistenti nel modulo vengono riconosciuti e non duplicati.
- I link verso altre applicazioni ELM (casi di test, elementi di lavoro) non vengono mai modificati.
- Sull'intero modulo **Convert now** funziona anche senza una ricerca: trova e converte i link in un solo passaggio, dopo la stessa conferma.
- Un artefatto usato più volte nel modulo viene elencato e contato una sola volta.
- Nei moduli molto grandi potete fare clic su **Stop**, ricaricare la pagina e poi su **Continue from …** per proseguire dall'artefatto successivo.