# Find and Replace

> Trova una parola o una frase in tutto un modulo, mostra ogni punto con il nuovo testo e la sostituisce ovunque in una volta.

Source: https://widgets.doorsnext.com/it/widgets/find-and-replace/

- Disciplina: Qualità dei contenuti
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: trova e sostituisci DOORS Next, sostituire testo nei requisiti, sostituzione di testo in blocco, rinominare un termine nel modulo, sostituzione globale, cerca e sostituisci requisiti, modifica in blocco DOORS Next
- Versione: 2.10 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Scrivere cosa cercare e cosa mettere al suo posto → 2. Cerca nel modulo e mostra ogni punto → 3. Controllare l'elenco e confermare (Se serve: Solo alcuni: selezionarli e usare Selection) → 4. Testo sostituito in tutti → 5. Rapporto delle modifiche in Excel

## Che cos'è e perché esiste
Cambia il nome di un prodotto, un termine viene rinominato, un segnaposto come «TBD» ha finalmente il suo valore o una vecchia unità deve sparire. In una specifica di centinaia di requisiti lo stesso testo deve cambiare in molti artefatti contemporaneamente.

DOORS Next permette di modificare un solo artefatto alla volta. Find and Replace cerca in un intero modulo o in una selezione, mostra ogni punto in cui si trova il testo e come risulterà, e lo sostituisce ovunque dopo una sola conferma. Cambia solo il testo visibile: formattazione, link, immagini e tabelle restano come sono.

## Problemi che risolve
- Aprire centinaia di artefatti uno per uno per cambiare la stessa parola o frase.
- Punti dimenticati: un vecchio termine che resta in alcuni requisiti che nessuno ha trovato.
- Modifiche in blocco che rompono la formattazione o i link perché il testo salvato è stato modificato alla cieca.
- Nessuna traccia di cosa ha fatto una modifica in blocco e nessun modo semplice per tornare indietro.

## Vantaggi
- **Vedere prima di cambiare:** ogni artefatto con il testo e, per ogni punto, il vecchio testo barrato e il nuovo dopo.
- **Corrispondenze esatte:** Match case e Whole words only, così «pump» non cambia «pumps» né «Pump» se non lo si vuole.
- **La formattazione resta:** grassetti, elenchi, link e immagini sono conservati; cambia solo il testo cercato.
- **Anche i nomi:** se si vuole, cerca anche nei nomi degli artefatti oltre che nel testo principale.
- **Interi moduli in un'unica esecuzione,** senza il limite di 200 artefatti delle selezioni, e un rapporto delle modifiche in Excel con ogni testo prima e dopo.

## Come si usa
1. In **Settings** (fare clic su **Change** se è chiuso), digitare il testo in **Find what** e il nuovo testo in **Replace with** (lasciarlo vuoto per rimuovere il testo). Scegliere **Match case**, **Whole words only** e dove cercare: **Primary text**, **Name** o entrambi. **Done** riduce Settings a una riga.
2. Aprire un modulo, scegliere **Whole module** in **Replace** e fare clic su **Find**. Il risultato mostra quanti artefatti contengono il testo e quante volte; aprire una riga per vedere ogni punto con il vecchio testo barrato e il nuovo subito dopo.
3. Fare clic su **Replace**, leggere la conferma e fare clic su **Replace in N artifacts**. Una scheda di avanzamento mostra l'esecuzione e si può premere **Stop** in qualsiasi momento. Fare clic su **Log** nel risultato per scaricare il report delle modifiche.
4. Per modificare solo alcuni artefatti, selezionarli in DOORS Next e scegliere **Selection · N**: il widget li cerca subito. Fare clic su **Replace** e confermare.

## Da sapere
- Eseguire Find and Replace in un change set, per poterlo scartare se il risultato non è quello voluto.
- Il testo viene cercato esattamente come scritto, spazi compresi; non ci sono caratteri jolly. Uno spazio trova anche uno spazio unificatore.
- Un testo diviso dalla formattazione (parte di una parola in grassetto) non viene sostituito; la ricerca conta questi punti per correggerli a mano.
- Immagini e altri file mantengono il loro contenuto; cambia solo il nome se si sceglie Name.
- Sull'intero modulo, **Replace** funziona anche senza una ricerca preliminare: ogni artefatto viene letto e il testo viene sostituito dove si trova; i numeri sono noti alla fine.
- Nei moduli molto grandi il browser può rallentare. Fermare l'esecuzione con **Stop**, ricaricare la pagina e riaprire il modulo: **Continue from …** riprende da dove si era fermata, con le stesse impostazioni.