Holarch
Capitoli del corso

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

2.1 Scrivere requisiti e il controllo di qualità 3:37

Scrivere requisiti con i loro attributi e lasciare che il controllo di qualità trovi le formulazioni deboli.

Mostra Holarch 1.27.

Tutti i capitoli · 2.2 Tracciare i bisogni fino ai requisiti →

Che cosa si impara

  • Scrivere un requisito come un unico enunciato con shall verificabile e un valore misurabile
  • Aggiungere un requisito sotto una sezione di una specifica
  • Impostare priorità, metodo di verifica, motivazione ed etichetta di tipo di un requisito
  • Eseguire il controllo di qualità su un documento e correggere un requisito che segnala
  • Segnare Corretto e Fattibile dopo aver esaminato personalmente un requisito

Scrivere requisiti nella specifica della Bike-Share Dock: che cosa rende buono un requisito, aggiungere requisiti sotto le sezioni, compilare priorità, metodo di verifica e motivazione, assegnare etichette, eseguire il controllo di qualità dei requisiti, correggere un requisito debole e registrare il giudizio del revisore.

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 Esigenze e requisiti → Documenti → EO-1 System Requirements Specification. Selezionare la sezione 5 Communications, fare clic su + Figlio, chiamare il requisito Command Link Margin e scrivere un enunciato con shall e un valore (ad esempio, un margine di almeno 6 dB a 5 gradi di elevazione).
  3. Nell’ispettore, impostare Priorità su Alto, Metodo di verifica su Analisi e una Motivazione, poi fare clic su + Etichetta e scegliere Performance Requirement.
  4. Aprire Esigenze e requisiti → Qualità, scegliere Documento: EO-1 System Requirements Specification nella barra dell’ambito e fare clic su Controlla la qualità. Leggere i Suggerimenti per 2.5 Safe Mode Recovery.
  5. Riscrivere 2.5 come un unico enunciato misurabile (che cosa avvia il recupero, con quale rapidità e verso quale modalità), e fare di nuovo clic su Controlla la qualità.
  6. Esaminare la propria riscrittura, poi fare clic sulla ✘ sotto Corretto e Fattibile nella sua riga per segnarli come Sì.

L’esercizio è completato quando 2.5 Safe Mode Recovery ottiene un punteggio più alto di prima, i suoi suggerimenti non citano più parole vaghe e Corretto e Fattibile mostrano ✔.

Verifica

  1. Perché un requisito unito da and ottiene un punteggio più basso anche quando entrambe le metà sono buone?
  2. Perché il controllo automatico non può mai segnare Corretto e Fattibile?
  3. Che cosa rende un problema una parola come quickly in un requisito?
Mostra le risposte
  1. Perché un requisito unito da and ottiene un punteggio più basso anche quando entrambe le metà sono buone?

    Contiene due requisiti in uno. Non possono essere verificati, tracciati o modificati separatamente, quindi il controllo lo segnala come non singolare.

  2. Perché il controllo automatico non può mai segnare Corretto e Fattibile?

    Stabilire se un requisito esprime il bisogno giusto e se è realizzabile richiede un giudizio ingegneristico. Una persona lo esamina e segna quei due criteri.

  3. Che cosa rende un problema una parola come quickly in un requisito?

    Non si può misurare, quindi nessun test può dimostrare che il requisito è soddisfatto. Sostituirla con un valore e un’unità.

Per saperne di più

Trascrizione

Mostra la trascrizione (narrazione e contenuto dello schermo)

Introduction

Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.

This first chapter is about writing requirements well, and letting Holarch check them.

A good requirement

A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.

On screen: Card: a good requirement.

Write requirements

Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.

On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.

Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.

On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.

Attributes and labels

Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.

On screen: 5.1.1 → Priority, Verification Method, Rationale.

Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.

On screen: + Label → Performance Requirement.

Quality check

Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.

On screen: Quality → Document: the SRS → Check Quality.

Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.

On screen: Findings for Friendly Kiosk.

Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.

On screen: Back to the SRS → 8.3.1 → new description.

Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.

On screen: Quality → Check Quality again → mark Correct and Feasible.

Recap

Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.

Next, you trace the stakeholder needs to these requirements.