Chapitres du cours
Formation · Parcours 2. Exigences et vérification · Chapitre 2.1 sur 6
2.1 Rédiger des exigences et le contrôle qualité 3:37
Rédiger des exigences avec leurs attributs, et laisser le contrôle qualité trouver les formulations faibles.
Montre Holarch 1.27.
Ce que vous allez apprendre
- Rédiger une exigence sous la forme d'un seul énoncé « shall » testable avec une valeur mesurable
- Ajouter une exigence sous une section d'une spécification
- Définir la priorité, la méthode de vérification, la justification et l'étiquette de type d'une exigence
- Lancer le contrôle qualité sur un document et corriger une exigence qu'il signale
- Marquer Correct et Feasible après avoir examiné vous-même une exigence
Rédigez des exigences dans la spécification du Bike-Share Dock : ce qui fait une bonne exigence, l'ajout d'exigences sous des sections, la saisie de la priorité, de la méthode de vérification et de la justification, l'ajout d'étiquettes, le contrôle qualité des exigences, la correction d'une exigence faible, et la consignation du jugement du relecteur.
Fichiers de projet
- Projet de départ (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)
- Projet terminé (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)
La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.
Pratique
Faites-le vous-même dans Holarch, sur le projet de démonstration CubeSat EO-1.
- Ouvrez votre projet de démonstration EO-1 (ou créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)).
- Ouvrez Besoins et exigences → Documents → EO-1 System Requirements Specification. Sélectionnez la section 5 Communications, cliquez sur + Enfant, nommez l'exigence
Command Link Marginet rédigez un énoncé « shall » avec une valeur (par exemple, une marge d'au moins 6 dB à 5 degrés d'élévation). - Dans l'inspecteur, réglez Priority sur High, Verification Method sur Analysis et saisissez une Justification, puis cliquez sur + Étiquette et choisissez Performance Requirement.
- Ouvrez Besoins et exigences → Qualité, choisissez Document: EO-1 System Requirements Specification dans la barre de portée et cliquez sur Contrôler la qualité. Lisez les Suggestions pour 2.5 Safe Mode Recovery.
- Réécrivez 2.5 en un seul énoncé mesurable (ce qui déclenche la récupération, en combien de temps, et vers quel mode), et cliquez de nouveau sur Contrôler la qualité.
- Relisez votre réécriture, puis cliquez sur le ✘ sous Correct et Feasible sur sa ligne pour les passer à Yes.
C'est terminé quand 2.5 Safe Mode Recovery obtient un meilleur score qu'avant, que ses suggestions ne citent plus de mots vagues, et que Correct et Feasible affichent ✔.
Vérifiez vos connaissances
- Pourquoi une exigence reliée par and obtient-elle un score plus faible même quand ses deux moitiés sont bonnes ?
- Pourquoi le contrôle automatique ne peut-il jamais marquer Correct et Feasible ?
- Qu'est-ce qui fait d'un mot comme quickly un problème dans une exigence ?
Afficher les réponses
Pourquoi une exigence reliée par and obtient-elle un score plus faible même quand ses deux moitiés sont bonnes ?
Elle contient deux exigences en une. Elles ne peuvent pas être vérifiées, tracées ou modifiées séparément : le contrôle la signale donc comme non singulière.
Pourquoi le contrôle automatique ne peut-il jamais marquer Correct et Feasible ?
Savoir si une exigence exprime le bon besoin et si elle est réalisable demande un jugement d'ingénieur. Une personne l'examine et marque ces deux critères.
Qu'est-ce qui fait d'un mot comme quickly un problème dans une exigence ?
Il ne se mesure pas : aucun test ne peut montrer que l'exigence est satisfaite. Remplacez-le par une valeur et une unité.
Pour aller plus loin
Transcription
Afficher la transcription (narration et contenu de l'écran)
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.