Holarch
Capitoli del corso

Formazione · Percorso 2. Requisiti e verifica · Capitolo 2.4 di 6

2.4 Baseline e collegamenti da rivedere 2:40

Congelare la specifica in una baseline, modificare un requisito ed esaminare che cosa tocca la modifica.

Mostra Holarch 2.13.

Che cosa si impara

  • Salvare una baseline di documento con un record di approvazione
  • Spiegare che cosa comporta la modifica di un requisito approvato per il suo stato e i suoi collegamenti
  • Esaminare un collegamento segnalato con Differenze e segnarlo come rivisto con una nota
  • Confrontare una baseline con la versione corrente ed esportare le modifiche

Congelare la specifica della Bike-Share Dock in una baseline con un’approvazione, modificare un requisito approvato, vederlo tornare in revisione con i suoi collegamenti segnati da rivedere, esaminare il collegamento e segnarlo come rivisto con una nota, ed elencare ogni modifica dalla baseline.

File di progetto

  • Progetto iniziale (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)
  • Progetto completato (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)

Il video viene riprodotto da holarch.app; vedere l’Informativa sulla privacy.

Esercitazione

Provare in prima persona in Holarch, sul progetto demo CubeSat EO-1.

  1. Aprire il proprio progetto demo EO-1 (oppure crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)).
  2. Aprire EO-1 System Requirements Specification, fare clic su Versione ▾ nel blocco del titolo e scegliere Salva baseline…. Chiamarla PDR Baseline, compilare una riga di approvatore con il proprio nome e ruolo e fare clic su Crea.
  3. Cambiare nella descrizione di 3.3 Depth of Discharge il valore da 30% a 25%, e leggere la notifica: il requisito è di nuovo In revisione e i suoi collegamenti vanno rivisti.
  4. Aprire Esigenze e requisiti → Collegamenti da rivedere. In una riga per 3.3, fare clic su Differenze, poi su Segna come rivisto…, scrivere che cosa si è controllato e fare clic su Segna come rivisto.
  5. Nel documento, scegliere Versione ▾ → Confronta versioni… con Da PDR Baseline e A Versione corrente, e fare clic su Modifiche (Excel).
  6. Aprire Controllo e revisioni → Baseline e versioni e trovare PDR Baseline accanto a SRR Baseline. Per congelare l’intero modello anziché un documento, si userebbe + Salva baseline… nell’intestazione di questa pagina.

L’esercizio è completato quando il report delle modifiche da PDR Baseline elenca la modifica a 3.3 e il collegamento rivisto non compare più in Collegamenti da rivedere.

Verifica

  1. Perché la modifica di un requisito segna i collegamenti che ne dipendono, e non solo il requisito?
  2. Qual è la differenza tra una baseline di documento e una baseline di progetto?
  3. Quando si segna un collegamento come rivisto, perché scrivere una nota?
Mostra le risposte
  1. Perché la modifica di un requisito segna i collegamenti che ne dipendono, e non solo il requisito?

    Gli elementi all’altra estremità, come la funzione che lo soddisfa o il test che lo verifica, erano stati controllati rispetto al vecchio testo. Ogni collegamento va ricontrollato per vedere se vale ancora.

  2. Qual è la differenza tra una baseline di documento e una baseline di progetto?

    Una baseline di documento congela un documento e le sue approvazioni (Versione ▾ → Salva baseline…). Una baseline di progetto congela ogni elemento e ogni relazione (Baseline e versioni → + Salva baseline…).

  3. Quando si segna un collegamento come rivisto, perché scrivere una nota?

    La nota registra che cosa è stato controllato e perché il collegamento vale ancora. Viene aggiunta ai commenti dell’elemento collegato, così un revisore può seguire la decisione in seguito.

Per saperne di più

Trascrizione

Mostra la trascrizione (narrazione e contenuto dello schermo)

Introduction

Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.

We baseline the Bike-Share Dock specification, then change one of its requirements.

Change control

A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.

On screen: Card: baselines and links to review.

First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.

On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.

Baseline

Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.

On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.

A change

Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.

On screen: 4.1.1 → Item → new description.

The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.

On screen: The toast and the status.

Links to review

Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.

On screen: Links to Review → Diff.

The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.

On screen: Mark Reviewed… → note → Mark Reviewed.

Changes since the baseline

To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.

On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.

The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.

On screen: The change report.

Recap

Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.

Next, you plan and run the tests that verify the requirements.