Terms Linker

Che cos'è e perché esiste

Un glossario condiviso è uno dei migliori strumenti contro i requisiti ambigui: ogni termine ha un'unica definizione concordata. È utile, però, solo se i lettori possono raggiungere la definizione dal punto in cui il termine viene usato e se è possibile vedere quali requisiti dipendono da quale termine.

In DOORS Next questo significa creare a mano, per ogni occorrenza, un collegamento ipertestuale nel testo e un link References Term. Per un modulo con centinaia di requisiti e decine di termini sono giorni di lavoro, e nessuno lo mantiene aggiornato. Terms Linker è stato creato per farlo in modo automatico e coerente.

Problemi che risolve

• Termini del glossario usati nei requisiti senza alcun link alla loro definizione.
• Nessuna tracciabilità tra i termini e i requisiti che li usano, quindi l'impatto della modifica di una definizione è sconosciuto.
• Ore di collegamento manuale, incoerente tra un autore e l'altro.
• Link creati solo in parte dopo un lavoro manuale precedente o interrotto.

Vantaggi

• Requisiti non ambigui: i lettori aprono la definizione di un termine con un clic.
• Analisi d'impatto: i link References Term mostrano quali requisiti sono interessati quando una definizione cambia.
• Coerenza: solo parole intere, prima il termine più lungo (ad esempio "brake system" prima di "brake") e nessun link all'interno di link esistenti.
• Anteprima prima della modifica: il widget elenca gli artefatti, i termini trovati e la frequenza con cui ricorrono.
• Reversibile: Terms Remover rimuove esattamente ciò che Terms Linker ha creato.

Come si usa

1. In Terms (Termini) fate clic su Find all terms per usare tutti i termini del glossario del progetto, oppure su Pick terms per sceglierne alcuni specifici.
2. Aprite un modulo e fate clic su Find usage of terms in module. Il widget mostra gli artefatti che usano termini e i termini più utilizzati.
3. Esaminate l'elenco, quindi fate clic su Link terms (N) e confermate. I collegamenti ipertestuali e i link ai termini vengono creati a batch, con avanzamento e Stop.
4. Per collegare solo alcuni artefatti, selezionateli in DOORS Next e fate clic su Link terms (N) nella sezione Selection.
5. Per moduli molto grandi, Link without searching esegue il collegamento in un unico passaggio e riporta il risultato alla fine.

Da sapere

• Il tipo di artefatto dei termini del glossario (per impostazione predefinita Term) e la corrispondenza senza distinzione tra maiuscole e minuscole si impostano nelle Settings della sezione Terms.
• I link vengono creati sull'artefatto di base, quindi sono visibili in ogni modulo che riutilizza il requisito.
• Eseguitelo in una serie di modifiche e conservate il report delle modifiche come traccia di ciò che è stato collegato.