Rozdziały kursu
Szkolenia · Ścieżka 2. Wymagania i weryfikacja · Rozdział 2.1 z 6
2.1 Pisanie wymagań i kontrola jakości 3:37
Pisanie wymagań z ich atrybutami i wykrywanie słabych sformułowań kontrolą jakości.
Pokazuje Holarch 1.27.
Czego się nauczysz
- Zapisywanie wymagania jako jednego testowalnego zdania z „shall” z mierzalną wartością
- Dodawanie wymagania pod sekcją specyfikacji
- Ustawianie priorytetu, metody weryfikacji, uzasadnienia i etykiety typu wymagania
- Uruchamianie kontroli jakości dokumentu i poprawianie oznaczonego wymagania
- Oznaczanie Correct i Feasible po samodzielnym przeglądzie wymagania
Pisz wymagania w specyfikacji stacji Bike-Share Dock: co czyni wymaganie dobrym, dodawanie wymagań pod sekcjami, uzupełnianie priorytetu, metody weryfikacji i uzasadnienia, nadawanie etykiet, uruchamianie kontroli jakości wymagań, poprawianie słabego wymagania i zapisywanie oceny recenzenta.
Pliki projektu
- Projekt początkowy (.holarch.json; Zarządzaj projektami → Pliki projektu ▾ → Importuj projekt (.json)…)
- Projekt ukończony (.holarch.json; Zarządzaj projektami → Pliki projektu ▾ → Importuj projekt (.json)…)
Film jest odtwarzany z holarch.app; zobacz Politykę prywatności.
Ćwiczenie
Wykonaj to samodzielnie w Holarch, w projekcie demonstracyjnym CubeSat EO-1.
- Otwórz swój projekt demonstracyjny EO-1 (lub go utwórz: Zarządzaj projektami → Pliki projektu ▾ → Nowy projekt demonstracyjny → CubeSat (inżynieria systemów z przewodnikiem)).
- Otwórz Potrzeby i wymagania → Dokumenty → EO-1 System Requirements Specification. Zaznacz sekcję 5 Communications, kliknij + Podrzędny, nazwij wymaganie
Command Link Margini napisz zdanie z „shall” z wartością (np. co najmniej 6 dB zapasu przy elewacji 5 stopni). - W inspektorze ustaw Priorytet na Wysoki, Verification Method na Analysis i wpisz Uzasadnienie, a następnie kliknij + Etykieta i wybierz Performance Requirement.
- Otwórz Potrzeby i wymagania → Jakość, wybierz Document: EO-1 System Requirements Specification na pasku zakresu i kliknij Sprawdź jakość. Przeczytaj Sugestie dla 2.5 Safe Mode Recovery.
- Przeredaguj 2.5 jako jedno mierzalne zdanie (co wyzwala odtwarzanie, jak szybko i do jakiego trybu) i ponownie kliknij Sprawdź jakość.
- Przejrzyj swoją wersję, a następnie kliknij ✘ pod Correct i Feasible w jej wierszu, aby oznaczyć je jako Tak.
Gotowe, gdy 2.5 Safe Mode Recovery ma wyższy wynik niż wcześniej, jego sugestie nie wymieniają już niejasnych słów, a Correct i Feasible pokazują ✔.
Sprawdź się
- Dlaczego wymaganie połączone spójnikiem „and” ma niższy wynik, nawet gdy obie połowy są dobre?
- Dlaczego automatyczna kontrola nigdy nie może oznaczyć Correct i Feasible?
- Dlaczego słowo takie jak „quickly” jest problemem w wymaganiu?
Pokaż odpowiedzi
Dlaczego wymaganie połączone spójnikiem „and” ma niższy wynik, nawet gdy obie połowy są dobre?
Zawiera dwa wymagania w jednym. Nie można ich zweryfikować, powiązać ani zmienić oddzielnie, więc kontrola oznacza je jako niepojedyncze.
Dlaczego automatyczna kontrola nigdy nie może oznaczyć Correct i Feasible?
To, czy wymaganie wyraża właściwą potrzebę i czy da się je zrealizować, wymaga oceny inżynierskiej. Człowiek przegląda wymaganie i oznacza te dwa kryteria.
Dlaczego słowo takie jak „quickly” jest problemem w wymaganiu?
Nie da się go zmierzyć, więc żaden test nie wykaże, że wymaganie jest spełnione. Zastąp je wartością z jednostką.
Więcej informacji
Transkrypcja
Pokaż transkrypcję (narracja i to, co widać na ekranie)
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.