Kurskapitel
Schulung · Reihe 2. Anforderungen und Verifikation · Kapitel 2.1 von 6
2.1 Anforderungen schreiben und die Qualitätsprüfung 3:37
Anforderungen mit ihren Attributen schreiben und schwache Formulierungen von der Qualitätsprüfung finden lassen.
Zeigt Holarch 1.27.
Das lernen Sie
- Eine Anforderung als eine testbare Shall-Aussage mit messbarem Wert schreiben
- Eine Anforderung unter einem Abschnitt einer Spezifikation hinzufügen
- Priorität, Verifikationsmethode, Begründung und Typ-Label einer Anforderung festlegen
- Die Qualitätsprüfung auf ein Dokument anwenden und eine markierte Anforderung korrigieren
- Correct und Feasible markieren, nachdem Sie eine Anforderung selbst geprüft haben
Schreiben Sie Anforderungen in der Spezifikation des Bike-Share Dock: was eine gute Anforderung ausmacht, Anforderungen unter Abschnitten hinzufügen, Priorität, Verifikationsmethode und Begründung ausfüllen, ihnen Labels geben, die Qualitätsprüfung der Anforderungen ausführen, eine schwache Anforderung korrigieren und das Urteil des Reviewers erfassen.
Projektdateien
- Startprojekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)
- Fertiges Projekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)
Das Video wird von holarch.app abgespielt; siehe Datenschutzerklärung.
Übung
Führen Sie dies selbst in Holarch durch, am Demoprojekt CubeSat EO-1.
- Öffnen Sie Ihr EO-1-Demoprojekt (oder erstellen Sie es: Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt → CubeSat (Geführtes Systems Engineering)).
- Öffnen Sie Bedarfe & Anforderungen → Dokumente → EO-1 System Requirements Specification. Wählen Sie den Abschnitt 5 Communications aus, klicken Sie auf + Untergeordnet, nennen Sie die Anforderung
Command Link Marginund schreiben Sie eine Shall-Aussage mit einem Wert (zum Beispiel mindestens 6 dB Marge bei 5 Grad Elevation). - Setzen Sie im Inspektor Priorität auf High, Verification Method auf Analysis und eine Begründung, klicken Sie dann auf + Label und wählen Sie Performance Requirement.
- Öffnen Sie Bedarfe & Anforderungen → Qualität, wählen Sie in der Umfangsleiste Dokument: EO-1 System Requirements Specification und klicken Sie auf Qualität prüfen. Lesen Sie die Vorschläge für 2.5 Safe Mode Recovery.
- Formulieren Sie 2.5 als eine messbare Aussage um (was die Wiederherstellung auslöst, wie schnell und in welchen Modus) und klicken Sie erneut auf Qualität prüfen.
- Prüfen Sie Ihre Neuformulierung und klicken Sie dann in ihrer Zeile auf das ✘ unter Correct und Feasible, um sie mit Ja zu markieren.
Sie sind fertig, wenn 2.5 Safe Mode Recovery eine höhere Bewertung als vorher hat, ihre Vorschläge keine vagen Wörter mehr nennen und Correct und Feasible ✔ zeigen.
Selbsttest
- Warum wird eine mit and verbundene Anforderung niedriger bewertet, selbst wenn beide Hälften gut sind?
- Warum kann die automatische Prüfung Correct und Feasible nie markieren?
- Was macht ein Wort wie quickly in einer Anforderung zum Problem?
Antworten anzeigen
Warum wird eine mit and verbundene Anforderung niedriger bewertet, selbst wenn beide Hälften gut sind?
Sie enthält zwei Anforderungen in einer. Diese können nicht getrennt verifiziert, nachverfolgt oder geändert werden, daher markiert die Prüfung sie als nicht singulär.
Warum kann die automatische Prüfung Correct und Feasible nie markieren?
Ob eine Anforderung den richtigen Bedarf ausdrückt und umsetzbar ist, erfordert ingenieurtechnisches Urteil. Eine Person prüft sie und markiert diese beiden Kriterien.
Was macht ein Wort wie quickly in einer Anforderung zum Problem?
Es lässt sich nicht messen, daher kann kein Test zeigen, dass die Anforderung erfüllt ist. Ersetzen Sie es durch einen Wert und eine Einheit.
Weiterlesen
Transkript
Transkript anzeigen (Erzählung und Bildschirminhalt)
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.