Holarch
Capitoli del corso

Formazione · Percorso 4. Documenti e deliverable · Capitolo 4.4 di 5

4.4 Pacchetti di revisione e baseline 2:35

Congelare ciò che viene revisionato, vedere che cosa è cambiato da allora e consegnare ai revisori un unico pacchetto.

Mostra Holarch 2.41.

← 4.3 Output in Word ed Excel · Tutti i capitoli · 4.5 Presentazioni dal modello →

Che cosa si impara

  • Salvare una baseline di documento con i record di approvazione
  • Confrontare una baseline con la versione corrente ed esportare le modifiche
  • Chiedere la revisione di un documento con Richiedi revisione
  • Costruire un pacchetto di revisione da più documenti ed esportarlo come un unico file Word

Preparare la Bike-Share Dock per la revisione dei requisiti di sistema: mettere in baseline la specifica con la sua approvazione, modificare un requisito e leggere il report delle modifiche rispetto alla baseline, poi costruire un pacchetto di revisione che unisce la specifica e il piano di gestione dell’ingegneria dei sistemi.

File di progetto

  • Progetto iniziale (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)
  • Progetto completato (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)

Il video viene riprodotto da holarch.app; vedere l’Informativa sulla privacy.

Esercitazione

Provare in prima persona in Holarch, sul progetto demo CubeSat EO-1.

  1. Aprire il proprio progetto demo EO-1, oppure crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata). Questa esercitazione usa anche l’EO-1 Interface Control Document del capitolo Modelli di documento; crearlo prima se si è saltato quel capitolo.
  2. Aprire EO-1 System Requirements Specification, fare clic su Richiedi revisione accanto al tipo di documento, lasciare tutti senza spunta e fare clic su Richiedi revisione. La barra sotto il titolo mostra la revisione.
  3. Fare clic su Versione ▾ → Salva baseline…, chiamarla PDR Baseline, inserire il proprio ruolo, fare clic su + Aggiungi approvatore per un secondo approvatore e fare clic su Crea.
  4. Cambiare 2.4 Target Slew in 45 secondi. Poi scegliere Versione ▾ → Confronta versioni… con Da PDR Baseline e A Versione corrente, e fare clic su Modifiche (Excel).
  5. Aprire Controllo e revisioni → Revisioni, fare clic su + Nuovo pacchetto di revisione e chiamarlo PDR review package. Scegliere due volte Scrivi ▾ → Inserisci ▸ Documento… per aggiungere l’SRS e l’ICD.
  6. Scegliere Consegna ▾ → Impostazione del deliverable… e impostare Esporta ogni parte da su PDR Baseline per la parte SRS, poi scegliere Consegna ▾ → Specifica (Word).

L’esercizio è completato quando il report delle modifiche elenca la modifica a 2.4 e il file Word del pacchetto ha la Parte A e la Parte B, con la parte SRS dalla PDR Baseline.

Verifica

  1. Che cosa contiene una baseline di documento, e può cambiare in seguito?
  2. In che cosa una baseline di documento differisce da una baseline di progetto?
  3. Il pacchetto deve esportare l’SRS in baseline, non le modifiche di oggi. Come?
  4. Che cosa succede a una revisione dopo aver fatto clic su Richiedi revisione?
Mostra le risposte
  1. Che cosa contiene una baseline di documento, e può cambiare in seguito?

    Un’istantanea di sola lettura del documento: i suoi elementi, i loro attributi e relazioni, e gli elementi a una relazione di distanza. È possibile rinominarla e aggiungere approvazioni, ma i record di approvazione esistenti non possono essere modificati.

  2. In che cosa una baseline di documento differisce da una baseline di progetto?

    Una baseline di documento contiene un documento e si salva dal suo Versione ▾. Una baseline di progetto contiene ogni elemento del progetto e si salva con + Salva baseline… in Controllo e revisioni → Baseline e versioni.

  3. Il pacchetto deve esportare l’SRS in baseline, non le modifiche di oggi. Come?

    Nel pacchetto, impostare Esporta ogni parte da su quella baseline in Impostazione del deliverable…. Una parte fissata mostra 📌 e il nome della baseline, ed esporta il contenuto della baseline.

  4. Che cosa succede a una revisione dopo aver fatto clic su Richiedi revisione?

    Il documento è In revisione. I revisori del progetto, o le persone indicate, lo ricevono in Documenti da rivedere in Il mio lavoro e lo approvano o lo rifiutano lì o nella barra sotto il titolo.

Per saperne di più

Trascrizione

Mostra la trascrizione (narrazione e contenuto dello schermo)

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.