Holarch

Formación · Curso 4. Documentos y entregables

Curso 4. Documentos y entregables: hoja de ejercicios

Para ingenieros y responsables. Una tarea práctica y algunas preguntas por capítulo, para trabajar después de cada vídeo. Imprima esta página desde el navegador o trabaje en pantalla. Las soluciones empiezan en una página nueva al final.

Antes de empezar

Requisito previo
Capítulo 1.5 Documentos; los cursos 2 y 3 hacen que las matrices sean más útiles.
Plan
Free
Proyecto
El Bike-Share Dock: cada capítulo tiene su archivo inicial.

4.1 Plantillas de documento

Ver el capítulo 4.1 (2:54)

Práctica

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).
  2. Abra Necesidades y requisitos → Documentos y haga clic en + Nuevo documento. Llámelo EO-1 Interface Control Document.
  3. En Plantillas para, elija Interface Control Document, marque Incluir pautas de redacción, elija la tarjeta Interface Control Document (ICD) y haga clic en Crear.
  4. Seleccione la sección 2.3 Interface Owners and Change Authority y lea sus pautas. Haga clic en su descripción, sustituya las pautas por los responsables de las interfaces de EO-1 (por ejemplo, el Payload Lead y el Comms Lead) y pulse ⌘ / Ctrl↵ para guardar.
  5. Seleccione la sección 3.2 Interface Matrix y lea la matriz de interfaces dinámica que la plantilla colocó allí.
  6. Para un recorrido guiado y comprobado, ejecute el tutorial 11 Produce the Deliverable (Ayuda → Tutoriales).

Habrá terminado cuando el nuevo ICD muestre su propio texto en 2.3 en lugar de las pautas, y 3.2 muestre una matriz de componentes de EO-1.

Preguntas

  1. ¿Qué determina las plantillas que Nuevo documento ofrece primero?
  2. ¿Qué diferencia hay entre una plantilla con pautas de redacción y una sin ellas?
  3. ¿Por qué importa que cada sección sea un elemento del modelo?

4.2 Matrices dinámicas en documentos

Ver el capítulo 4.2 (2:48)

Práctica

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).
  2. Abra Necesidades y requisitos → Documentos → EO-1 System Requirements Specification y haga clic en la descripción de la sección 2 Attitude Determination and Control para editarla.
  3. En la barra de herramientas de texto enriquecido, abra + y elija Matriz…. Elija Matriz de asignación de requisitos, mantenga el ámbito en este documento, haga clic en Insertar y pulse ⌘ / Ctrl↵ para guardar.
  4. Lea el pie y las filas sombreadas. 2.5 Safe Mode Recovery es un hueco: nada lo satisface.
  5. Seleccione 2.5 y, en su sección Trazabilidad, vincule F10 Enter Safe Mode en satisfied by. Vuelva a la sección 2 y lea de nuevo la matriz.

Habrá terminado cuando la fila 2.5 de la matriz de asignación liste F10 Enter Safe Mode y ya no esté sombreada.

Preguntas

  1. ¿En qué se diferencia una matriz dinámica de una tabla escrita a mano?
  2. ¿Por qué se cierra un hueco en el modelo y no en la matriz?
  3. ¿Qué ámbitos puede abarcar una matriz?

4.3 Salida a Word y Excel

Ver el capítulo 4.3 (2:10)

Práctica

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).
  2. Abra EO-1 System Requirements Specification y elija Entregar ▾ → Configurar página…. En Marcado, elija Marcado propio y defina un encabezado y un pie como EO-1 Program Internal.
  3. Marque Portada con Versión 2.0 y Elaborado por EO-1 Systems Team, marque Números de página y haga clic en Aplicar.
  4. Elija Entregar ▾ → Copia de revisión (Word) y abra el archivo: páginas apaisadas con las columnas de atributos bajo cada elemento y el marcado en todas las páginas.
  5. Elija Entregar ▾ → Matriz de trazabilidad…. Elija la RVTM, fije Modelo en SRR Baseline y Exportar como en Matriz (Excel), lea el recuento de filas y de huecos y haga clic en Exportar.

Habrá terminado cuando tenga un archivo Word con portada, marcado y números de página, y una RVTM en Excel de la SRR Baseline con sus huecos sombreados.

Preguntas

  1. ¿Qué marcado usa un documento?
  2. ¿Qué diferencia hay entre una plantilla de Word y una plantilla de documento?
  3. ¿De dónde proceden las tablas Historial de revisiones y Aprobaciones de una exportación a Word?
  4. ¿Por qué exportar una matriz desde una línea base en lugar del modelo actual?

4.4 Paquetes de revisión y líneas base

Ver el capítulo 4.4 (2:35)

Práctica

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.

Preguntas

  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?

4.5 Presentaciones a partir del modelo

Ver el capítulo 4.5 (1:59)

Práctica

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).
  2. Abra Plan → Presentaciones y haga clic en + Nueva presentación. Llámela EO-1 PDR Briefing, fije Empezar desde en Un esquema de documento con EO-1 System Requirements Specification y haga clic en Crear.
  3. Haga doble clic en el título de la primera diapositiva, escriba EO-1 Preliminary Design Review y pulse Esc.
  4. Haga clic en + Nueva diapositiva ▾, elija En blanco, después Imagen ▾ → Imagen de… y elija el FFBD de F0 Perform EO-1 Mission.
  5. Haga clic en ▶ Presentar ▾ → Presentar desde la diapositiva actual, avance con → y termine con Esc. Después haga clic en Exportar… y elija Presentación (PowerPoint).

Habrá terminado cuando la presentación tenga una diapositiva de título, una diapositiva por sección de la SRS y una imagen dinámica del FFBD, y tenga el archivo de PowerPoint.

Preguntas

  1. ¿Qué mantiene actualizada una imagen de una diapositiva?
  2. ¿Cuándo conviene empezar una presentación a partir de un esquema de documento?
  3. ¿A qué formatos se puede exportar una presentación?

Soluciones

4.1 Plantillas de documento

  1. El tipo de documento elegido en Plantillas para. Las plantillas de otros tipos siguen apareciendo en Otras plantillas; el documento recibe el tipo de la plantilla que elija.
  2. Ambas ofrecen las mismas secciones numeradas y tablas iniciales. Con pautas, cada sección empieza además con una breve guía de lo que debe contener, que se sustituye a medida que se redacta.
  3. Una sección es un Statement, de modo que se puede vincular, comentar e incluir en una línea base como un requisito, y el documento sigue siendo una vista del modelo.

4.2 Matrices dinámicas en documentos

  1. El bloque guarda solo qué matriz y qué ámbito mostrar. Holarch reconstruye las filas a partir del modelo cada vez que se muestra o exporta el documento, de modo que nunca queda desactualizado.
  2. Una matriz dinámica no se puede editar celda a celda. El hueco es un vínculo o un atributo que falta en el modelo, y corregirlo allí actualiza todas las matrices y vistas que lo muestran.
  3. Los elementos de un documento, todas las partes de una compilación o el proyecto entero. Las matrices de interfaces y N² también pueden abarcar los hijos de un Asset o de una Action.

4.3 Salida a Word y Excel

  1. El más cercano: el marcado propio del documento; si no, el del proyecto; si no, el de la organización. Sin ningún marcado, queda sin marcar.
  2. Una plantilla de documento aporta el contenido: secciones y tablas iniciales. Una plantilla de Word da forma al archivo Word: índice, numeración de leyendas, tamaño de página y tablas preliminares.
  3. De las líneas base del documento y sus registros de aprobación, cuando la plantilla de Word los incluye, como hace Especificación.
  4. Un comité de revisión anota lo que se acordó. Elegir una línea base en Modelo exporta la matriz tal como era en esa línea base, no tal como es hoy.

4.4 Paquetes de revisión y líneas base

  1. 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. 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. 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. 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.

4.5 Presentaciones a partir del modelo

  1. Una imagen creada con Imagen de… muestra una vista del modelo, no una copia. Cuando cambia el diagrama, el documento o el gráfico, la diapositiva muestra el cambio.
  2. Cuando la presentación sigue un documento: se obtiene una diapositiva de título más una diapositiva por sección de nivel superior con el texto de la sección, lista para recortar.
  3. PowerPoint, Word y una página web para toda la presentación, y PNG o SVG para la diapositiva actual.

Publicado por Holarch