Capítulos del curso
Formación · Curso 6. Migrar a Holarch · Capítulo 6.3 de 5
6.3 Requisitos desde Word y ReqIF 2:22
Importar una especificación de Word como documento, y el archivo ReqIF de un proveedor con su jerarquía y sus vínculos.
Muestra Holarch 2.21.
Lo que aprenderá
- Explicar qué partes de un archivo Word se convierten en secciones y cuáles en requisitos
- Importar una especificación de Word como documento de requisitos numerado
- Importar un archivo ReqIF con su jerarquía, sus atributos y sus relaciones
- Comprobar una relación importada en la sección Trazabilidad
Importe desde Word la especificación de la carga útil del Plant Inspection Drone, donde los títulos se convierten en secciones y las frases con «shall» en requisitos, y desde ReqIF los requisitos del proveedor de baterías, con su jerarquía, sus atributos y una relación refines.
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.
- 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.
Compruebe lo aprendido
- ¿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?
Mostrar las respuestas
¿Qué lee la importación de Word como sección y qué como requisito?
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.
Un proveedor puede enviar Word o ReqIF. ¿Por qué pedir ReqIF?
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.
Una relación de ReqIF tiene un nombre que Holarch no conoce. ¿Qué ocurre?
Entra como traced to. Si el esquema no permite traced to entre las dos clases, la relación se omite con un aviso.
Más información
Transcripción
Mostrar la transcripción (narración y lo que aparece en pantalla)
Introduction
Chapter three: requirements from Word and ReqIF. Many specifications live in Word, and many suppliers exchange requirements as ReqIF files. Both come in through the same Import and Export page.
We import the payload specification and the battery supplier's requirements into the Plant Inspection Drone project.
Word
The Word file uses heading styles for its sections, and plain sentences with shall for its requirements. That is what the Word import reads. Heading styles or Word's list numbering matter: headings typed as ordinary bold text are read as ordinary text.
On screen: Card: what Holarch reads in Word.
Open Import and Export, and drop the file. Holarch detects Word from the file and analyzes it.
On screen: Import and Export → drop the .docx → Word detected.
Click Continue. The numbering pattern stays automatic, which uses numbered headings and shall sentences. Click Continue for the review: Holarch creates a requirements document with the name of the file, and lists the sections and the requirements under them.
On screen: Continue → Map: numbering → Continue → Review.
Click Import. The document opens, numbered from the Word headings, with each shall sentence as a requirement you can now trace and check.
On screen: Import → the document.
ReqIF
Now the supplier's file. ReqIF is the standard exchange format between requirements tools. Open Import and Export again, and drop the file.
On screen: Import and Export → drop the .reqif → ReqIF detected.
Click Continue. Each requirement in the file is a row. Its ReqIF identifier and its parent rebuild the hierarchy, its type becomes the class, and its attributes map by name: the chapter name to the number, the name, and the text to the description.
On screen: Continue → Map.
Click Continue, check the review, and click Import.
On screen: Continue → Review → Import.
Check the result
The supplier's relations come in as relationships. Select Charge Time, and open Trace: it refines Pack Capacity, just as the file says.
On screen: Select B.4 Charge Time → Trace.
Recap
Let's recap. You imported a Word specification, where headings became sections and shall sentences requirements, and a supplier's ReqIF file, with its hierarchy, attributes and relations.
Next, a whole model from another tool.