# Module Diff

> Mostra che cosa è cambiato in un modulo da una baseline, in fretta e in un unico elenco, con il testo vecchio e quello nuovo affiancati.

Source: https://widgets.doorsnext.com/it/widgets/module-diff/

- Disciplina: Configurazione e governance
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Sola lettura
- Keywords: confronto modulo, confronto con baseline, modifiche ai requisiti, che cosa è cambiato, revisione delle modifiche, diff, confronto tra stream, gestione della configurazione, audit
- Versione: 1.14 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Aprire il modulo → 2. Scegliere una baseline o uno stream e gli attributi → 3. Confronta il modulo con quella configurazione → 4. Totali ed elenco delle differenze → 5. Aprire un requisito: prima e dopo, affiancati → 6. Log Excel per una revisione o un audit

## Che cos'è e perché esiste
«Che cosa è cambiato in questo modulo dall'ultima baseline?» è una delle domande più frequenti prima di una revisione, di un rilascio o di un audit. DOORS Next sa confrontare le configurazioni, ma su un modulo grande il confronto richiede molto tempo e il risultato è difficile da scorrere.

Module Diff risponde alla domanda all'interno dell'ELM Mini Dashboard, accanto al modulo. Scegliete una baseline dello stream corrente, oppure un altro stream o un'altra baseline dello stesso componente, e il widget elenca ogni requisito aggiunto, rimosso, modificato o spostato, con il testo prima e dopo. Il widget legge soltanto. In DOORS Next non cambia nulla.

## Problemi che risolve
- Confrontare un modulo grande con una baseline richiede troppo tempo, quindi si salta o si fa solo alla fine.
- I revisori devono trovare i pochi requisiti modificati tra migliaia di requisiti invariati.
- I requisiti spostati e le modifiche alla struttura sfuggono facilmente.
- Le revisioni delle modifiche e gli audit richiedono una traccia di ciò che è cambiato, difficile da raccogliere a mano.

## Vantaggi
- **Veloce:** l'altra configurazione viene letta a blocchi e dei testi si conservano solo brevi impronte, così anche i moduli grandi vengono confrontati rapidamente.
- **Un unico elenco:** requisiti aggiunti, rimossi e modificati nell'ordine del modulo, con i loro titoli per orientarsi, oppure tutti i requisiti con **All artifacts**.
- **Prima e dopo:** aprite un requisito per vedere il testo vecchio e quello nuovo riga per riga, il nome, il tipo di artefatto, la posizione nel modulo e ciò che avete scelto di confrontare: link per tipo di link, tag, commenti e attributi.
- **Facile da consultare:** i titoli risaltano nell'elenco e si chiudono con la loro casella +/−, e la ricerca e gli elenchi sopra lo restringono per testo, tipo di artefatto o titoli.
- **In entrambe le direzioni:** **Swap** inverte subito il confronto, senza rileggere nulla.
- **Anche la struttura:** i requisiti spostati in un altro capitolo, o che hanno cambiato ordine o livello, sono segnalati come tali.
- **Pronto per una revisione o un audit:** il confronto va in Excel con lo stesso layout di ogni log SmarterWidgets, con i conteggi e il nome di entrambe le configurazioni.
- **Sicuro per tutti:** il widget legge soltanto, quindi chiunque può usarlo in qualsiasi momento.

## Come si usa
1. Aprite il modulo. In **Compare**, **From** mostra la configurazione in cui lavorate. In **To** scegliete la baseline o lo stream da confrontare: prima le baseline di questo stream, poi gli altri stream e le baseline del componente. **Swap** inverte il confronto.
2. In **Attributes to compare** fate clic su **Change** e selezionate cosa confrontare: Primary Text (Contents), Tags, Comments, attributi come stato o priorità e tipi di link, oppure **Select all**. Nome, tipo di artefatto e posizione nel modulo vengono sempre confrontati.
3. Fate clic su **Compare module**. Una barra di avanzamento mostra a che punto è; potete fermarlo in qualsiasi momento.
4. Il risultato conta i requisiti aggiunti (solo in To), rimossi (solo in From), modificati e invariati. **Differences** elenca le modifiche sotto i loro titoli; il campo di ricerca e gli elenchi sopra restringono l'elenco per testo, tipo di artefatto o titoli, e **All artifacts** elenca tutti i requisiti.
5. Aprite un requisito per vedere il testo prima e dopo, riga per riga, e i suoi attributi affiancati. **Show in module** vi porta a esso.
6. **Log** accanto al risultato (o l'icona di download di **Differences**) salva il confronto in Excel per una revisione o un audit.

## Buono a sapersi
- I testi vengono confrontati come testo semplice: una modifica solo di formattazione (grassetto, colore) non conta come modifica.
- Link, tag e commenti vengono letti allo stesso modo in entrambe le configurazioni, così sono elencate solo le differenze reali.
- In una configurazione globale il modulo viene confrontato all'interno del proprio componente, con gli stream e le baseline di quel componente.
- I moduli molto grandi possono essere confrontati a più riprese: fermate l'esecuzione, ricaricate la pagina, riaprite il modulo e fate clic su **Continue** per riprendere da dove si era fermata.
- I requisiti che non è stato possibile leggere nell'altra configurazione sono elencati come non confrontati, con il motivo.