# Image Linker

> Collega ogni artefatto alle immagini del suo testo, così un'immagine modificata compare nell'analisi d'impatto.

Source: https://widgets.doorsnext.com/it/widgets/image-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: immagini incorporate, immagini nei requisiti, analisi d'impatto, tracciabilità, collegare immagini, artefatti incorporati, diagrammi, creazione massiva di link, IBM DOORS Next
- Versione: 1.21 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Settings: tipo di link, direzione, cosa conta → 2. Find embedded pictures in module (Se serve: Oppure selezionare artefatti: controllati da soli) → 3. Controllare gli artefatti e le loro immagini → 4. Create links: dopo la conferma → 5. Report delle modifiche in Excel

## Che cos'è e perché esiste
I requisiti mostrano spesso immagini: layout di schermate, diagrammi, foto, tabelle di segnali. In IBM DOORS Next un'immagine inserita nel testo di un artefatto è un artefatto a sé, ma niente collega il requisito all'immagine. Quando qualcuno sostituisce o modifica l'immagine, l'analisi d'impatto e le viste di tracciabilità non mostrano quali requisiti ne dipendono.

Image Linker trova ogni immagine incorporata nel testo degli artefatti di un modulo (o degli artefatti selezionati) e crea, in un'unica esecuzione, un link del tipo scelto da ogni artefatto alle sue immagini. Su richiesta collega anche altri artefatti incorporati, come tabelle o diagrammi incorporati.

## Problemi che risolve
- Immagini nei testi dei requisiti invisibili all'analisi d'impatto.
- Un diagramma o un layout di schermata modificato di cui nessuno trova i requisiti interessati.
- Centinaia di immagini incorporate da collegare a mano, artefatto per artefatto.
- Nessuna traccia di quali link alle immagini esistono e quali immagini vengono da fuori DOORS Next.

## Vantaggi
- **Anteprima prima di ogni modifica:** ogni immagine incorporata è mostrata come To link, Already linked o Not resolvable.
- **Non tira mai a indovinare:** le immagini di altri siti web o server, o salvate nel testo stesso, sono solo elencate, mai collegate.
- **Il vostro tipo di link e la vostra direzione:** qualsiasi tipo di link del progetto, in uscita o in entrata; solo immagini o qualsiasi artefatto incorporato.
- **Impostazioni sicure:** i link sono creati nel contesto del modulo, come fa DOORS Next all’interno di un modulo; link sugli artefatti base solo se lo scegliete.
- **Esecuzioni lunghe sotto controllo:** moduli interi di qualsiasi dimensione, link esistenti saltati, avanzamento e Stop, ripresa dopo uno stop sui moduli molto grandi, errori con Retry e 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 scegliete il **Link type**, la **Direction** (**Outgoing** o **Incoming**) e **What counts** (**Pictures only** o **Any embedded artifact**); spuntate **Create the links on base artifacts** solo se i link vanno sugli artefatti base. Fate clic su **Done**.
3. In **Links** scegliete **Whole module** e fate clic su **Find embedded pictures**, oppure selezionate degli artefatti e scegliete **Selection**: la selezione viene controllata da sola. Controllate gli artefatti e le loro immagini in **Embedded items**.
4. Fate clic su **Create links**, leggete la conferma e fate clic su **Create N links**. Senza una ricerca prima, **Create links** sull'intero modulo trova e collega in un'unica esecuzione.
5. Controllate il blocco dei risultati e scaricate il report delle modifiche con **Log** se serve.

## Da sapere
- Ogni artefatto viene riletto subito prima di creare i suoi link, quindi si tiene conto delle immagini aggiunte o rimosse dopo la ricerca.
- La stessa immagine due volte in un testo dà un solo link; un'immagine usata in molti artefatti riceve un link da ciascuno.
- Si possono collegare solo immagini salvate in DOORS Next sullo stesso server; le altre compaiono come Not resolvable.
- L’elenco mostra nomi e ID, non miniature, così anche i moduli molto grandi pesano poco sul browser.
- Lavorate sempre in un change set: scartarlo è l’unico modo per annullare i link creati.