# Primary Text Manager

> Svuota il testo di molti artefatti in una volta, gli aggiunge un prefisso o un suffisso o lo sostituisce con il vostro testo, e non modifica nient'altro.

Source: https://widgets.doorsnext.com/it/widgets/primary-text-manager/

- 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: svuotare testo requisiti, svuotare testo principale, aggiungere prefisso ai requisiti, aggiungere suffisso ai requisiti, sostituire testo requisiti, modifica testo in blocco, modifica in blocco DOORS Next
- Versione: 1.14 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Scegliere Empty, prefisso, suffisso o sostituzione → 2. Aprire un modulo e confermare → 3. Testo principale modificato in un solo passaggio (Se serve: Solo alcuni: selezionarli e usare Selection) → 4. Report delle modifiche in Excel

## Che cos'è e perché esiste
Spesso il testo di molti artefatti deve cambiare nello stesso modo: un'indicazione di stato come «DRAFT:» all'inizio, una nota come «(TBC)» alla fine, la stessa frase standard ovunque, oppure nessun testo perché dopo un'importazione è stato spostato in attributi o in nuovi artefatti.

DOORS Next lo consente solo un artefatto alla volta nell'editor di testo formattato. Primary Text Manager lo fa per un intero modulo o una selezione in un'unica esecuzione e modifica solo il testo principale: gli artefatti mantengono ID, attributi, collegamenti e posizione nel modulo.

## Problemi che risolve
- Modificare uno per uno il testo di centinaia di artefatti per aggiungere la stessa indicazione, nota o frase.
- Testo di modello o segnaposto («TBD», testo copiato da una vecchia specifica) che rimane in un nuovo modulo.
- Testo duplicato dopo un'importazione che ha copiato il contenuto in attributi o altri artefatti.
- Nessuna traccia di cosa ha fatto una modifica massiva del testo, né un modo semplice per tornare indietro.

## Vantaggi
- **Quattro modifiche in un widget:** svuotare il testo, aggiungere un prefisso, aggiungere un suffisso o sostituirlo con il vostro testo.
- **Cambia solo il testo.** Nome, attributi, collegamenti e struttura del modulo restano esattamente com'erano.
- **Un clic per un intero modulo:** confermi una volta e ogni artefatto che ha bisogno della modifica la riceve; gli altri vengono saltati.
- **Mai due volte:** un prefisso o un suffisso già presente non viene aggiunto di nuovo, e le intestazioni sono protette per impostazione predefinita.
- **Interi moduli in un'unica esecuzione,** senza il limite di 200 artefatti delle selezioni, e un report Excel con ogni testo prima e dopo.

## Come si usa
1. In **Settings** fate clic su **Change**, scegliete in **What to do** **Empty**, **Add prefix**, **Add suffix** o **Replace text**, digitate il testo e fate clic su **Done**.
2. Aprite un modulo. In **Apply** lasciate **Whole module** e fate clic sul riquadro dell'azione, ad esempio **Add prefix**. Leggete la conferma, che dice cosa verrà scritto, e confermate con il pulsante rosso.
3. Il widget modifica l'intero modulo in un solo passaggio. L'esecuzione mostra l'avanzamento e potete fermarla in qualsiasi momento; alla fine il blocco dei risultati mostra quanti artefatti sono stati elaborati, modificati, non avevano bisogno di modifiche o non sono riusciti, e **Log** scarica il report delle modifiche.
4. Per modificare solo alcuni artefatti, selezionateli in DOORS Next e scegliete **Selection**: la riga sotto il riquadro dice quanti cambieranno e quali restano invariati. Fate clic sul riquadro e confermate.

## Da sapere
- Eseguite Primary Text Manager in un change set, così potete scartarlo se il risultato non è quello voluto.
- Il prefisso o il suffisso viene aggiunto esattamente come digitato, spazi compresi, e prende la formattazione del primo o dell'ultimo paragrafo. Gli artefatti senza testo non ricevono prefisso né suffisso.
- Per aggiungere di nuovo un prefisso o un suffisso già presente, o aggiungerlo anche ai testi vuoti, seleziona **Change even if no change is needed** in Settings.
- Immagini e altri file non vengono mai modificati. Deselezionate **Leave headings as they are** in Settings solo se devono cambiare anche le intestazioni.