Rozdziały kursu
Szkolenia · Ścieżka 6. Migracja do Holarch · Rozdział 6.3 z 5
6.3 Wymagania z Word i ReqIF 2:22
Import specyfikacji Word jako dokumentu i pliku ReqIF od dostawcy z hierarchią i powiązaniami.
Pokazuje Holarch 2.21.
Czego się nauczysz
- Które części pliku Word stają się sekcjami, a które wymaganiami
- Importowanie specyfikacji Word jako numerowanego dokumentu wymagań
- Importowanie pliku ReqIF z hierarchią, atrybutami i relacjami
- Sprawdzanie zaimportowanej relacji w sekcji Ślad
Zaimportuj specyfikację ładunku Plant Inspection Drone z Word, w której nagłówki stają się sekcjami, a zdania z „shall” wymaganiami, oraz wymagania dostawcy akumulatorów z ReqIF, z ich hierarchią, atrybutami i relacją refines.
Pliki projektu
- Projekt początkowy (.holarch.json; Zarządzaj projektami → Pliki projektu ▾ → Importuj projekt (.json)…)
- Projekt ukończony (.holarch.json; Zarządzaj projektami → Pliki projektu ▾ → Importuj projekt (.json)…)
Film jest odtwarzany z holarch.app; zobacz Politykę prywatności.
Ćwiczenie
Wykonaj to samodzielnie w Holarch, w projekcie demonstracyjnym CubeSat EO-1.
- Otwórz swój projekt demonstracyjny EO-1 (jeśli go nie masz, utwórz go: Zarządzaj projektami → Pliki projektu ▾ → Nowy projekt demonstracyjny → CubeSat (inżynieria systemów z przewodnikiem)). Otwórz Dokumenty → EO-1 System Requirements Specification i kliknij Dostarcz ▾ → Specyfikacja (Word).
- W tym samym dokumencie kliknij Dostarcz ▾ → Wymagania (ReqIF)… i kliknij Eksportuj.
- W Zarządzaj projektami kliknij + Nowy projekt, nazwij go
EO-1 Import Practicei kliknij Utwórz projekt. Otwórz Potrzeby i wymagania → Import i eksport, upuść plik .docx, dwukrotnie kliknij Dalej i zaimportuj go. - Porównaj nowy dokument z SRS: zwróć uwagę, które nagłówki stały się elementami Statement, a które zdania z „shall” elementami Requirement, i jak zostały nazwane.
- Zaimportuj plik .reqif do tego samego projektu, a następnie otwórz utworzony przez niego dokument i zaznacz 1.6 Revisit Time, aby sprawdzić jego elementy podrzędne i etykiety.
Gotowe, gdy projekt zawiera dwa dokumenty, jeden z Word i jeden z ReqIF, i umiesz powiedzieć, który zachował oryginalne nazwy i numery.
Sprawdź się
- Co import z Word odczytuje jako sekcję, a co jako wymaganie?
- Dostawca może przesłać Word lub ReqIF. Dlaczego prosić o ReqIF?
- Relacja ReqIF ma nazwę, której Holarch nie zna. Co się dzieje?
Pokaż odpowiedzi
Co import z Word odczytuje jako sekcję, a co jako wymaganie?
Akapity w stylach nagłówków Word stają się elementami Statement (sekcjami). Akapit z shall, must, will lub should staje się elementem Requirement, nazwanym od pierwszych słów po czasowniku. Nagłówki wpisane jako zwykły pogrubiony tekst są odczytywane jako zwykły tekst.
Dostawca może przesłać Word lub ReqIF. Dlaczego prosić o ReqIF?
ReqIF przenosi identyfikator, hierarchię, atrybuty i relacje każdego wymagania. Gdy dostawca prześle nowszy plik, jego import aktualizuje te same elementy zamiast dodawać kopie.
Relacja ReqIF ma nazwę, której Holarch nie zna. Co się dzieje?
Trafia jako traced to. Jeśli schemat nie dopuszcza traced to między tymi dwiema klasami, relacja jest pomijana z ostrzeżeniem.
Więcej informacji
Transkrypcja
Pokaż transkrypcję (narracja i to, co widać na ekranie)
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.