Chapitres du cours
Formation · Parcours 2. Exigences et vérification · Chapitre 2.4 sur 6
2.4 Références et liens à revoir 2:40
Figer la spécification dans une référence, modifier une exigence, et examiner ce que touche la modification.
Montre Holarch 2.13.
Ce que vous allez apprendre
- Enregistrer une référence de document avec un enregistrement d'approbation
- Expliquer ce que fait une modification d'une exigence approuvée à son état et à ses liens
- Examiner un lien signalé avec Diff et le marquer comme revu avec une note
- Comparer une référence avec la version actuelle et exporter les modifications
Figez la spécification du Bike-Share Dock dans une référence avec une approbation, modifiez une exigence approuvée, voyez-la repasser en revue et ses liens marqués à revoir, examinez le lien et marquez-le comme revu avec une note, et listez toutes les modifications depuis la référence.
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 EO-1 System Requirements Specification, cliquez sur Version ▾ dans le bloc de titre et choisissez Enregistrer la référence…. Nommez-la
PDR Baseline, remplissez une ligne d'approbateur avec votre nom et votre rôle, et cliquez sur Créer. - Changez 3.3 Depth of Discharge de 30 % à 25 % dans sa description, et lisez la notification : l'exigence est de nouveau In Review et ses liens sont à revoir.
- Ouvrez Besoins et exigences → Liens à revoir. Sur une ligne de 3.3, cliquez sur Diff, puis sur Marquer comme revu…, écrivez ce que vous avez vérifié et cliquez sur Marquer comme revu.
- Dans le document, choisissez Version ▾ → Comparer les versions… avec De PDR Baseline et À Version actuelle, et cliquez sur Modifications (Excel).
- Ouvrez Contrôle et revues → Références et versions et trouvez PDR Baseline à côté de SRR Baseline. Pour figer tout le modèle plutôt qu'un seul document, vous utiliseriez + Enregistrer une référence… dans l'en-tête de cette page.
C'est terminé quand le rapport de modifications depuis PDR Baseline liste la modification de 3.3 et que le lien que vous avez examiné n'apparaît plus dans Liens à revoir.
Vérifiez vos connaissances
- Pourquoi modifier une exigence marque-t-il les liens qui en dépendent, et pas seulement l'exigence ?
- Quelle est la différence entre une référence de document et une référence de projet ?
- Quand vous marquez un lien comme revu, pourquoi écrire une note ?
Afficher les réponses
Pourquoi modifier une exigence marque-t-il les liens qui en dépendent, et pas seulement l'exigence ?
Les éléments à l'autre extrémité, comme la fonction qui la satisfait ou le test qui la vérifie, ont été contrôlés par rapport à l'ancien texte. Chaque lien doit être recontrôlé pour savoir s'il tient toujours.
Quelle est la différence entre une référence de document et une référence de projet ?
Une référence de document fige un document et ses approbations (Version ▾ → Enregistrer la référence…). Une référence de projet fige chaque élément et chaque relation (Références et versions → + Enregistrer une référence…).
Quand vous marquez un lien comme revu, pourquoi écrire une note ?
La note consigne ce qui a été vérifié et pourquoi le lien tient toujours. Elle est ajoutée aux commentaires de l'élément lié, pour qu'un relecteur puisse suivre la décision plus tard.
Pour aller plus loin
Transcription
Afficher la transcription (narration et contenu de l'écran)
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.