Chapitres du cours
Formation · Parcours 4. Documents et livrables · Chapitre 4.4 sur 5
4.4 Dossiers de revue et références 2:35
Figer ce qui est revu, voir ce qui a changé depuis, et remettre aux relecteurs un seul dossier.
Montre Holarch 2.41.
Ce que vous allez apprendre
- Enregistrer une référence de document avec des enregistrements d'approbation
- Comparer une référence avec la version actuelle et exporter les modifications
- Demander la revue d'un document avec Demander une revue
- Constituer un dossier de revue à partir de plusieurs documents et l'exporter en un seul fichier Word
Préparez le Bike-Share Dock pour sa revue des exigences système : placez la spécification dans une référence avec son approbation, modifiez une exigence et lisez le rapport de modifications par rapport à la référence, puis constituez un dossier de revue qui réunit la spécification et le plan de management de l'ingénierie système.
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). Cette tâche utilise aussi l'EO-1 Interface Control Document du chapitre Modèles de documents ; créez-le d'abord si vous avez sauté ce chapitre.
- Ouvrez EO-1 System Requirements Specification, cliquez sur Demander une revue à côté du type de document, ne cochez personne et cliquez sur Demander une revue. Le bandeau sous le titre affiche la revue.
- Cliquez sur Version ▾ → Enregistrer la référence…, nommez-la
PDR Baseline, indiquez votre rôle, cliquez sur + Ajouter un approbateur pour un second approbateur, et cliquez sur Créer. - Changez 2.4 Target Slew en 45 secondes. Choisissez ensuite Version ▾ → Comparer les versions… avec De PDR Baseline et À Version actuelle, et cliquez sur Modifications (Excel).
- Ouvrez Contrôle et revues → Revues, cliquez sur + Nouveau dossier de revue et nommez-le
PDR review package. Choisissez deux fois Rédiger ▾ → Insérer ▸ Document… pour ajouter la SRS et l'ICD. - Choisissez Livrer ▾ → Configuration du livrable… et réglez Exporter chaque partie depuis sur PDR Baseline pour la partie SRS, puis choisissez Livrer ▾ → Spécification (Word).
C'est terminé quand le rapport de modifications liste la modification de 2.4 et que le fichier Word du dossier contient la partie A et la partie B, avec la partie SRS issue de PDR Baseline.
Vérifiez vos connaissances
- Que contient une référence de document, et peut-elle changer ensuite ?
- En quoi une référence de document diffère-t-elle d'une référence de projet ?
- Votre dossier doit exporter la SRS figée dans la référence, et non les modifications du jour. Comment ?
- Que devient une revue après un clic sur Demander une revue ?
Afficher les réponses
Que contient une référence de document, et peut-elle changer ensuite ?
Un instantané en lecture seule du document : ses éléments, leurs attributs et relations, et les éléments situés à une relation de distance. Vous pouvez la renommer et ajouter des approbations, mais les enregistrements d'approbation existants ne peuvent pas être modifiés.
En quoi une référence de document diffère-t-elle d'une référence de projet ?
Une référence de document contient un seul document et s'enregistre depuis son menu Version ▾. Une référence de projet contient tous les éléments du projet et s'enregistre avec + Enregistrer une référence… dans Contrôle et revues → Références et versions.
Votre dossier doit exporter la SRS figée dans la référence, et non les modifications du jour. Comment ?
Dans le dossier, réglez Exporter chaque partie depuis sur cette référence dans Configuration du livrable…. Une partie épinglée affiche 📌 et le nom de la référence, et exporte le contenu de la référence.
Que devient une revue après un clic sur Demander une revue ?
Le document est In Review. Les relecteurs du projet, ou les personnes que vous avez désignées, le reçoivent sous Documents à revoir dans Mon travail et l'approuvent ou le rejettent là ou dans le bandeau sous le titre.
Pour aller plus loin
Transcription
Afficher la transcription (narration et contenu de l'écran)
Introduction
Chapter four: review packages and baselines. Before a review, you freeze what is being reviewed, and you hand the reviewers one package.
You will baseline a document with its approval, see what changed since the baseline, and build a review package from several documents.
Baseline a document
Open the system requirements. In the version menu at the top of the document, choose Save Baseline.
On screen: Documents → the SRS → Version ▾ → Save Baseline….
Name it SRR Baseline, for the system requirements review. The approval is filled in with your name. Add the role, Lead Systems Engineer. Approval records are dated now and cannot be edited later. Click Create.
On screen: Name, approval role → Create.
The version menu now lists it. A baseline is a read-only snapshot of the document: its items, their attributes and their relationships.
On screen: Version ▾: the baseline.
What changed since
Now a change arrives: the footprint grows shorter. In the outline, open section 10, and change requirement 10.1 to two by eleven meters.
On screen: Outline → 10.1 → edit its description.
Open the version menu, and choose SRR Baseline. Holarch shows the document as it was, read-only, with its approval. Click Compare to Current.
On screen: Version ▾ → SRR Baseline → Compare to Current.
The change report lists every item that changed since the baseline, with the field and the change marked. Reviewers can see exactly what moved, and the report exports to Excel.
On screen: Baseline Change Report.
Build a review package
Now the review package. Open Plan and Deliver, then Review Packages, and click New Review Package. Name it SRR Review Package, and click Create.
On screen: Plan & Deliver → Review Packages → + New Review Package.
A review package is a document that holds other documents. In Write, choose Insert, then Document, and pick the system requirements.
On screen: Write ▾ → Insert → Document… → the SRS.
Insert the systems engineering management plan the same way. Each document keeps its own sections, below it.
On screen: Write ▾ → Insert → Document… → the SEMP.
The package has its own page setup, so it can carry a cover page of its own. From Deliver, choose a Word template, and the whole package becomes one file for the review board.
On screen: Deliver ▾ → Specification (Word).
Recap
Let's recap. You baselined a document with its approval, read what changed since the baseline, and built a review package from two documents.
Next, you present the model to the review board with slides that stay up to date.