Capitoli del corso
Formazione · Percorso 6. Migrare a Holarch · Capitolo 6.3 di 5
6.3 Requisiti da Word e ReqIF 2:22
Importare una specifica Word come documento, e il file ReqIF di un fornitore con la sua gerarchia e i suoi collegamenti.
Mostra Holarch 2.21.
Che cosa si impara
- Spiegare quali parti di un file Word diventano sezioni e quali diventano requisiti
- Importare una specifica Word come documento di requisiti numerato
- Importare un file ReqIF con la sua gerarchia, i suoi attributi e le sue relazioni
- Controllare una relazione importata nella sezione Traccia
Importare da Word la specifica del payload del Plant Inspection Drone, dove i titoli diventano sezioni e le frasi con shall diventano requisiti, e da ReqIF i requisiti del fornitore della batteria, con la loro gerarchia, i loro attributi e una relazione refines.
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.
- Aprire il proprio progetto demo EO-1 (se non lo si ha, crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)). Aprire Documenti → EO-1 System Requirements Specification e fare clic su Consegna ▾ → Specifica (Word).
- Nello stesso documento, fare clic su Consegna ▾ → Requisiti (ReqIF)… e fare clic su Esporta.
- In Gestisci progetti, fare clic su + Nuovo progetto, chiamarlo
EO-1 Import Practicee fare clic su Crea progetto. Aprire Esigenze e requisiti → Importazione ed esportazione, rilasciare il .docx, fare clic due volte su Continua e importarlo. - Confrontare il nuovo documento con l’SRS: notare quali titoli sono diventati Statement e quali frasi con shall sono diventate Requirement, e come sono stati denominati.
- Importare il file .reqif nello stesso progetto, poi aprire il documento che crea e selezionare 1.6 Revisit Time per controllarne i figli e le etichette.
L’esercizio è completato quando il progetto contiene due documenti, uno da Word e uno da ReqIF, e si sa dire quale ha conservato i nomi e i numeri originali.
Verifica
- Che cosa legge l’importazione Word come sezione, e che cosa come requisito?
- Un fornitore può inviare Word o ReqIF. Perché chiedere ReqIF?
- Una relazione ReqIF ha un nome che Holarch non conosce. Che cosa succede?
Mostra le risposte
Che cosa legge l’importazione Word come sezione, e che cosa come requisito?
I paragrafi con stili di titolo di Word diventano Statement (sezioni). Un paragrafo con shall, must, will o should diventa un Requirement, denominato con le prime parole dopo il verbo. I titoli scritti come semplice testo in grassetto vengono letti come testo normale.
Un fornitore può inviare Word o ReqIF. Perché chiedere ReqIF?
ReqIF trasporta l’identificativo, la gerarchia, gli attributi e le relazioni di ogni requisito. Quando il fornitore invia un file più recente, importarlo aggiorna gli stessi elementi invece di aggiungere copie.
Una relazione ReqIF ha un nome che Holarch non conosce. Che cosa succede?
Arriva come traced to. Se lo schema non consente traced to tra le due classi, la relazione viene saltata con un avviso.
Per saperne di più
Trascrizione
Mostra la trascrizione (narrazione e contenuto dello schermo)
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.