Structure Writer

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.