Holarch
Capítulos del curso

Formación · Curso 4. Documentos y entregables · Capítulo 4.4 de 5

4.4 Paquetes de revisión y líneas base 2:35

Congelar lo que se revisa, ver qué ha cambiado desde entonces y entregar a los revisores un único paquete.

Muestra Holarch 2.41.

Lo que aprenderá

  • Guardar una línea base de documento con registros de aprobación
  • Comparar una línea base con la versión actual y exportar los cambios
  • Pedir la revisión de un documento con Solicitar revisión
  • Preparar un paquete de revisión a partir de varios documentos y exportarlo como un único archivo Word

Prepare el Bike-Share Dock para su revisión de requisitos del sistema: cree una línea base de la especificación con su aprobación, cambie un requisito y lea el informe de cambios frente a la línea base; después prepare un paquete de revisión que combine la especificación y el plan de gestión de ingeniería de sistemas.

Archivos de proyecto

  • Proyecto inicial (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)
  • Proyecto terminado (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)

El vídeo se reproduce desde holarch.app; consulte la Política de privacidad.

Práctica

Hágalo usted mismo en Holarch, en el proyecto de demostración CubeSat EO-1.

  1. Abra su proyecto de demostración EO-1 o créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada). Esta tarea usa también el EO-1 Interface Control Document del capítulo Plantillas de documento; créelo primero si se saltó ese capítulo.
  2. Abra EO-1 System Requirements Specification, haga clic en Solicitar revisión junto al tipo de documento, deje a todos sin marcar y haga clic en Solicitar revisión. La franja bajo el título muestra la revisión.
  3. Haga clic en Versión ▾ → Guardar línea base…, llámela PDR Baseline, indique su rol, haga clic en + Añadir aprobador para un segundo aprobador y haga clic en Crear.
  4. Cambie 2.4 Target Slew a 45 segundos. Después elija Versión ▾ → Comparar versiones… con Desde PDR Baseline y Hasta Versión actual, y haga clic en Cambios (Excel).
  5. Abra Control y revisiones → Revisiones, haga clic en + Nuevo paquete de revisión y llámelo PDR review package. Elija dos veces Escribir ▾ → Insertar ▸ Documento… para añadir la SRS y el ICD.
  6. Elija Entregar ▾ → Configuración del entregable… y fije Exportar cada parte desde en PDR Baseline para la parte de la SRS; después elija Entregar ▾ → Especificación (Word).

Habrá terminado cuando el informe de cambios liste la edición de 2.4 y el archivo Word del paquete tenga la Parte A y la Parte B, con la parte de la SRS tomada de PDR Baseline.

Compruebe lo aprendido

  1. ¿Qué contiene una línea base de documento y puede cambiar después?
  2. ¿En qué se diferencia una línea base de documento de una línea base de proyecto?
  3. El paquete debe exportar la SRS de la línea base, no las ediciones de hoy. ¿Cómo?
  4. ¿Qué ocurre con una revisión después de hacer clic en Solicitar revisión?
Mostrar las respuestas
  1. ¿Qué contiene una línea base de documento y puede cambiar después?

    Una instantánea de solo lectura del documento: sus elementos, sus atributos y relaciones, y los elementos a una relación de distancia. Se puede cambiar su nombre y añadir aprobaciones, pero los registros de aprobación existentes no se pueden editar.

  2. ¿En qué se diferencia una línea base de documento de una línea base de proyecto?

    Una línea base de documento contiene un documento y se guarda desde su menú Versión ▾. Una línea base de proyecto contiene todos los elementos del proyecto y se guarda con + Guardar línea base… en Control y revisiones → Líneas base y versiones.

  3. El paquete debe exportar la SRS de la línea base, no las ediciones de hoy. ¿Cómo?

    En el paquete, fije Exportar cada parte desde en esa línea base en Configuración del entregable…. Una parte fijada muestra 📌 y el nombre de la línea base, y exporta el contenido de la línea base.

  4. ¿Qué ocurre con una revisión después de hacer clic en Solicitar revisión?

    El documento queda En revisión. Los revisores del proyecto, o las personas que haya indicado, lo reciben en Documentos por revisar en Mi trabajo y lo aprueban o rechazan allí o en la franja bajo el título.

Más información

Transcripción

Mostrar la transcripción (narración y lo que aparece en pantalla)

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.