Curso 6. Migrar a Holarch: hoja de ejercicios
Para equipos que vienen de otras herramientas. 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
- Curso 1. Primeros pasos, capítulos 1.1 a 1.3.
- Plan
- Free
- Proyecto
- Sus propios archivos de requisitos, o archivos que exporte de la demostración EO-1 para practicar.
6.1 Planificar una migración
Ver el capítulo 6.1 (3:00)
Práctica
En el proyecto de demostración CubeSat EO-1:
- Abra su proyecto de demostración EO-1 (si no tiene ninguno, créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada)).
- Abra Ajustes → Esquema en la barra lateral, haga clic en Requirement en Clases y anote los atributos que podría rellenar una hoja de cálculo de requisitos (por ejemplo Priority, Owner, Verification Method).
- Abra la página Etiquetas del esquema y busque dónde se guardan tipos como Performance Requirement.
- Suponga que el registro de un proveedor tiene una columna
Supplier Refsin destino: en Requirement, haga clic en + Atributo, llámeloSupplier Ref, elija un tipo de texto y haga clic en Añadir atributo. - Abra Necesidades y requisitos → Importar y exportar y lea qué formatos acepta la zona de soltar y qué ofrece la tarjeta Exportar.
Habrá terminado cuando Supplier Ref sea el último de la lista de atributos de Requirement y pueda decir adónde iría cada columna de un registro típico.
Preguntas
- ¿Por qué decidir adónde va cada tipo de datos antes de importar?
- Una columna no tiene ningún atributo correspondiente. ¿Qué opciones hay?
- Una importación salió mal. ¿Cómo se deshace?
- ¿Cuándo se usa Gestionar proyectos → Importar proyecto (.json)… en lugar de la página Importar?
6.2 Requisitos desde Excel y CSV
Ver el capítulo 6.2 (2:32)
Práctica
En el proyecto de demostración CubeSat EO-1:
- Abra su proyecto de demostración EO-1 (si no tiene ninguno, créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada)). En la Base de datos, busque
class:Requirement, haga clic en Exportar…, elija Tabla (CSV), marque Status y Priority (deje marcado Etiquetas) y haga clic en Exportar. - Abra el archivo en una aplicación de hojas de cálculo. Conserve el encabezado y las filas de las secciones 1 y 2, y añada dos filas arriba:
1,Mission Imaging, ClassStatement, y2,Attitude Determination and Control, ClassStatement. Guárdelo como .xlsx o .csv. - En Gestionar proyectos, haga clic en + Nuevo proyecto, llámelo
EO-1 Import Practicey haga clic en Crear proyecto. - Abra Necesidades y requisitos → Importar y exportar, suelte el archivo, haga clic en Continuar y compruebe el Campo de Holarch de cada columna (fije en Omitir las columnas que no quiera).
- Haga clic en Continuar, deje marcado Crear un documento con estos N elementos y haga clic en Importar N elementos.
- En el nuevo documento, compruebe que 1.6.1 y 1.6.2 están bajo 1.6, y seleccione 1.5 para ver sus etiquetas y su estado.
Habrá terminado cuando el nuevo documento muestre las secciones 1 y 2 con sus requisitos anidados por número, con las etiquetas y los estados intactos.
Preguntas
- ¿Cómo reconstruye Holarch la jerarquía de las filas de una hoja de cálculo?
- Algunas filas llegaron con la clase equivocada. ¿Por qué?
- Quiere actualizar los responsables de 50 requisitos existentes desde una hoja de cálculo, no crear copias. ¿Cómo?
6.3 Requisitos desde Word y ReqIF
Ver el capítulo 6.3 (2:22)
Práctica
En el proyecto de demostración CubeSat EO-1:
- Abra su proyecto de demostración EO-1 (si no tiene ninguno, créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada)). Abra Documentos → EO-1 System Requirements Specification y haga clic en Entregar ▾ → Especificación (Word).
- En el mismo documento, haga clic en Entregar ▾ → Requisitos (ReqIF)… y haga clic en Exportar.
- En Gestionar proyectos, haga clic en + Nuevo proyecto, llámelo
EO-1 Import Practicey haga clic en Crear proyecto. Abra Necesidades y requisitos → Importar y exportar, suelte el .docx, haga clic dos veces en Continuar e impórtelo. - Compare el nuevo documento con la SRS: observe qué títulos se convirtieron en Statements y qué frases con «shall» se convirtieron en Requirements, y cómo se nombraron.
- Importe el archivo .reqif en el mismo proyecto; después abra el documento que crea y seleccione 1.6 Revisit Time para comprobar sus hijos y sus etiquetas.
Habrá terminado cuando el proyecto contenga dos documentos, uno de Word y otro de ReqIF, y pueda decir cuál conservó los nombres y números originales.
Preguntas
- ¿Qué lee la importación de Word como sección y qué como requisito?
- Un proveedor puede enviar Word o ReqIF. ¿Por qué pedir ReqIF?
- Una relación de ReqIF tiene un nombre que Holarch no conoce. ¿Qué ocurre?
6.4 Modelos de otras herramientas
Ver el capítulo 6.4 (2:44)
Práctica
En el proyecto de demostración CubeSat EO-1:
- Abra su proyecto de demostración EO-1 (si no tiene ninguno, créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada)). Abra Necesidades y requisitos → Importar y exportar, haga clic en Exportar UML/SysML (XMI)… en la tarjeta Exportar, deje Formato en OMG XMI 2.5.1 (.xmi) y haga clic en Exportar. Este archivo equivale a una exportación de una herramienta SysML como Cameo o Enterprise Architect.
- En Gestionar proyectos, haga clic en + Nuevo proyecto, póngale el nombre
EO-1 Import Practicey haga clic en Crear proyecto. Abra Necesidades y requisitos → Importar y exportar, suelte el archivo .xmi, compruebe que Formato muestre UML/SysML (.xmi, .uml, .mdzip), haga clic dos veces en Continuar, lea Revisar y haga clic en Importar N elementos. - En la Base de datos, busque
class:Asset, seleccione Payload Camera y compruebe en Traza que forma parte de EO-1 Spacecraft y qué actions ejecuta. - Abra Diagramas, haga clic en + Nuevo diagrama, elija Diagrama de Asset, elija EO-1 Spacecraft en Diagrama de y haga clic en Crear.
- Active Actions ejecutadas para enumerar las funciones de cada subsistema.
Habrá terminado cuando el diagrama de Asset del proyecto nuevo muestre los subsistemas de la nave con las actions que ejecutan.
Preguntas
- ¿Qué archivos de una herramienta SysML v1 puede importar Holarch y cómo se obtienen?
- ¿Por qué se pueden reconstruir los diagramas rápidamente después de una importación?
- Importa una exportación posterior del mismo modelo. ¿Por qué no se obtienen copias?
6.5 Limpieza después de importar
Ver el capítulo 6.5 (2:40)
Práctica
En el proyecto de demostración CubeSat EO-1:
- Abra su proyecto
EO-1 Import Practicede los capítulos anteriores (o importe un CSV con los requisitos de EO-1 como en el capítulo 2). - Abra Necesidades y requisitos → Calidad, elija uno de los documentos importados en la barra de ámbito y haga clic en Comprobar calidad.
- Si importó los mismos requisitos dos veces (Word y ReqIF), marque la fila de un duplicado en la Base de datos y elimínelo con Eliminar elemento… en la barra de acciones en bloque. Reescriba 2.5 Safe Mode Recovery para que sea medible y vuelva a comprobar la calidad.
- Abra Verificación → Comprobaciones del modelo y abra la regla Requirement.8, Requisitos hoja que ningún elemento de diseño cumple.
- Si también importó los activos (capítulo 4), seleccione 2.1 Pointing Accuracy y, en Trazabilidad, añada satisfied by con + → Vincular existente… a ADCS. Vuelva a ejecutar las comprobaciones del modelo.
Habrá terminado cuando 2.5 obtenga una puntuación más alta que antes y Requirement.8 ya no liste 2.1.
Preguntas
- ¿Qué examina la comprobación de calidad y qué examinan las comprobaciones del modelo?
- ¿Por qué la puntuación de calidad automática nunca supera el 78 %?
- ¿Por qué conectar requisitos y partes justo después de una migración?
Soluciones
6.1 Planificar una migración
- Los datos que llegan a las clases, etiquetas, atributos y relaciones correctas funcionan de inmediato en la trazabilidad, las comprobaciones de calidad y los informes. Corregirlos después de la importación supone editar muchos elementos a mano.
- Añadir el atributo en Ajustes → Esquema antes de la importación, o asignar la columna a Nuevo atributo (añadido al esquema) en el paso Asignar.
- Pulse ⌘Z / Ctrl+Z una vez: una importación desde la página Importar es un único paso de deshacer.
- Para restaurar un proyecto completo como proyecto nuevo e independiente. La página Importar fusiona los elementos de un archivo en el proyecto que está abierto.
6.2 Requisitos desde Excel y CSV
- A partir de una columna ID de la fila padre o Número del padre, si está asignada; si no, a partir del número de esquema: 1.2 va bajo 1. Si falta el padre, se usa el ancestro existente más cercano.
- Una columna Clase con nombres que el esquema no conoce recurre a la Clase para filas sin clase, con un aviso. Use los nombres de clase del editor de esquema.
- Expórtelos con la columna ID, edite el archivo e impórtelo con la columna ID asignada a ID global y Emparejar elementos existentes por fijado en ID global. Revisar los lista entonces en Elementos actualizados.
6.3 Requisitos desde Word y ReqIF
- Los párrafos con estilos de título de Word se convierten en Statements (secciones). Un párrafo con shall, must, will o should se convierte en un Requirement, nombrado según las primeras palabras que siguen al verbo. Los títulos escritos como texto normal en negrita se leen como texto ordinario.
- ReqIF transporta el identificador, la jerarquía, los atributos y las relaciones de cada requisito. Cuando el proveedor envía un archivo más reciente, importarlo actualiza los mismos elementos en lugar de añadir copias.
- Entra como traced to. Si el esquema no permite traced to entre las dos clases, la relación se omite con un aviso.
6.4 Modelos de otras herramientas
- XMI 2.x con el perfil SysML 1.x de Cameo/MagicDraw, Enterprise Architect, Rhapsody o Papyrus (se exporta desde la herramienta), directamente un proyecto .mdzip de Cameo o MagicDraw, y un archivo .uml de Papyrus. Los requisitos solos también pueden llegar como ReqIF, y las tablas como Excel o CSV.
- Los diseños de diagramas de otra herramienta no se importan, pero las relaciones sí. Holarch dibuja los diagramas de Asset, de jerarquía y otros a partir de esas relaciones.
- Cada elemento importado conserva su id de XMI, y Emparejar elementos existentes por usa de forma predeterminada ID de XMI en los archivos XMI, de modo que la importación posterior actualiza esos elementos. Las relaciones ya presentes no se añaden dos veces.
6.5 Limpieza después de importar
- La comprobación de calidad puntúa la redacción de cada requisito frente a las cualidades de un buen requisito. Las comprobaciones del modelo examinan todo el modelo en busca de huecos, como requisitos que nada satisface, elementos aislados o acciones que nadie realiza.
- Correct y Feasible requieren el juicio de una persona, de modo que la comprobación nunca los marca como cumplidos. Se marcan después de revisar el requisito.
- Llegan de archivos distintos sin vínculos entre ellos. Cada vínculo satisfied by alimenta desde ese momento la trazabilidad, la cobertura y las comprobaciones del modelo.
Publicado por Holarch