# Structure Writer

> Trasforma la struttura di un modulo in valori di attributi (il percorso dei capitoli, un ID in stile documento e un numero di ordinamento) per tutti gli artefatti insieme.

Source: https://widgets.doorsnext.com/it/widgets/structure-writer/

- Disciplina: Struttura dei moduli
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: attributo percorso gerarchico, percorso dei capitoli, numero di sezione in attributo, ID formattato, migrazione ID da DOORS 9, prefisso e suffisso ID, numero di sequenza, attributo di ordinamento, numerazione automatica, esportazione in ordine di modulo, IBM DOORS Next
- Versione: 1.16 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. In Rules attivare i valori e scegliere gli attributi di destinazione → 2. Aprire un modulo, scegliere Whole module o Selection → 3. Write e confermare: percorso, ID e numero → 4. Report delle modifiche in Excel

## Che cos'è e perché esiste
In un modulo DOORS Next la posizione di un requisito (in quale capitolo si trova, che numero ha, dove compare nel documento) è visibile solo nella vista del modulo. Appena gli artefatti compaiono in una vista su più moduli, in un'esportazione, in un filtro, in un report o in un altro strumento, quel contesto si perde. I team che arrivano da DOORS 9 sentono anche la mancanza dei loro ID di documento come «SRS-1234».

Structure Writer copia la struttura negli attributi, così viaggia insieme all'artefatto. Per ogni artefatto di un modulo può scrivere il percorso dei capitoli superiori («1 Introduzione > 1.2 Ambito»), un ID formattato composto da prefisso, ID dell'artefatto e suffisso («SRS-001234-A») e un numero che cresce nell'ordine del modulo, per l'ordinamento. Scegli tu quali dei tre valori ti servono e in quale attributo va ciascuno.

## Problemi che risolve
- Le esportazioni e le viste su più moduli perdono il capitolo a cui appartiene un requisito.
- Fuori dal modulo i requisiti non si possono ordinare nell'ordine del documento.
- I progetti migrati hanno bisogno di ID in stile documento con prefisso, ma scriverli a mano è lento e soggetto a errori.
- I vecchi strumenti di numerazione modificavano un artefatto alla volta e impiegavano minuti ogni cento artefatti.
- Dopo lo spostamento o l'inserimento di un capitolo, percorsi e numeri tenuti a mano diventano sbagliati senza che nessuno se ne accorga.

## Vantaggi
- **Tre valori in un'unica esecuzione:** percorso gerarchico, ID formattato e numero di sequenza, ognuno facoltativo e ognuno nel proprio attributo.
- **Percorso flessibile:** ogni livello come numero di sezione e nome, solo numero, solo nome, ID oppure ID e nome, con il tuo separatore, con o senza l'artefatto stesso.
- **Moduli interi, velocemente:** nessun limite di 200 artefatti; la struttura si legge una volta e i valori si salvano a blocchi.
- **Verificato prima:** per una selezione il riquadro Write indica quanti artefatti cambiano e la conferma quanti percorsi, ID e numeri vengono scritti; i valori già corretti non vengono mai salvati di nuovo.
- **Resta corretto:** dopo una ristrutturazione basta eseguirlo di nuovo e si aggiornano solo i valori cambiati.
- **Evidenza:** un report delle modifiche in Excel con ogni valore prima e dopo.

## Come si usa
1. In **Rules** attiva i valori che ti servono e scegli l'attributo di destinazione di ciascuno: il percorso gerarchico (formato del livello e separatore), l'ID formattato (prefisso, suffisso, riempimento con zeri) e il numero di sequenza (inizio e passo).
2. Se vuoi, limita l'esecuzione a un tipo di artefatto, escludi le intestazioni o riempi solo le destinazioni vuote (**Additional settings**).
3. Apri un modulo, scegli **Whole module** e fai clic su **Write**: leggi la conferma e fai clic su **Write values**. I valori vengono scritti nell'intero modulo in un solo passaggio e vengono salvati solo quelli che cambiano davvero.
4. Oppure seleziona alcuni artefatti nel modulo e scegli **Selection**: il riquadro **Write** indica quanti di essi cambiano; fai clic su **Write** e conferma con **Write values**. I loro percorsi e numeri derivano comunque dall'intero modulo.
5. Il risultato conta gli artefatti scritti, già corretti, saltati e non salvati; **Log** salva il report delle modifiche se ti serve una traccia.

## Buono a sapersi
- Lavora sempre in un change set: per impostazione predefinita i valori esistenti vengono sovrascritti, perché i valori seguono la struttura. Attiva «Only fill empty targets» per conservare i valori scritti a mano.
- I valori degli attributi appartengono all'artefatto, non alla sua posizione: un artefatto usato due volte nel modulo riceve i valori della prima posizione, e uno usato anche in un altro modulo riceve quelli del modulo in cui il widget è stato eseguito per ultimo.
- Gli artefatti di primo livello non hanno un capitolo superiore, quindi ricevono un percorso solo se è incluso l'artefatto stesso.
- Il numero di sequenza conta solo gli artefatti scritti, nell'ordine in cui compaiono nel modulo.
- Nei moduli molto grandi puoi fermare un'esecuzione, ricaricare la pagina e continuare da dove si era fermata, con le stesse impostazioni.