Ścieżka 6. Migracja do Holarch: arkusz ćwiczeń
Dla zespołów przechodzących z innych narzędzi. Jedno zadanie ćwiczeniowe i kilka pytań do każdego rozdziału, do przerobienia po każdym filmie. Wydrukuj tę stronę z przeglądarki lub pracuj na ekranie. Klucz odpowiedzi zaczyna się na nowej stronie na końcu.
Zanim zaczniesz
- Najpierw przejdź
- Ścieżka 1. Pierwsze kroki, rozdziały od 1.1 do 1.3.
- Plan
- Free
- Projekt
- Własne pliki z wymaganiami lub pliki wyeksportowane do ćwiczeń z demo EO-1.
6.1 Planowanie migracji
Obejrzyj rozdział 6.1 (3:00)
Ćwiczenie
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 Ustawienia → Schemat na pasku nawigacji, kliknij Wymaganie w sekcji Klasy i wypisz atrybuty, które mógłby wypełnić arkusz wymagań (np. Priority, Owner, Verification Method).
- Otwórz stronę Etykiety schematu i znajdź, gdzie przechowywane są rodzaje takie jak Performance Requirement.
- Załóżmy, że arkusz dostawcy ma kolumnę
Supplier Ref, która nie ma swojego miejsca: w klasie Wymaganie kliknij + Atrybut, nazwij goSupplier Ref, wybierz typ tekstowy i kliknij Dodaj atrybut. - Otwórz Potrzeby i wymagania → Import i eksport i sprawdź, jakie formaty przyjmuje strefa upuszczania i co oferuje karta Eksportuj.
Gotowe, gdy Supplier Ref jest ostatni na liście atrybutów klasy Requirement i umiesz powiedzieć, gdzie trafiłaby każda kolumna typowego arkusza.
Pytania
- Dlaczego przed importem trzeba zdecydować, gdzie trafi każdy rodzaj danych?
- Kolumna nie ma pasującego atrybutu. Jakie są możliwości?
- Import się nie udał. Jak go wycofać?
- Kiedy używać Zarządzaj projektami → Importuj projekt (.json)… zamiast strony Import?
6.2 Wymagania z Excel i CSV
Obejrzyj rozdział 6.2 (2:32)
Ćwiczenie
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)). W Bazie danych wyszukaj
class:Requirement, kliknij Eksportuj…, wybierz Tabela (CSV), zaznacz Status i Priorytet (pozostaw zaznaczone Etykiety) i kliknij Eksportuj. - Otwórz plik w arkuszu kalkulacyjnym. Zachowaj nagłówek i wiersze sekcji 1 i 2, a następnie dodaj na górze dwa wiersze:
1,Mission Imaging, klasaStatementoraz2,Attitude Determination and Control, klasaStatement. Zapisz plik jako .xlsx lub .csv. - 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, kliknij Dalej i sprawdź Pole Holarch każdej kolumny (każdą kolumnę, której nie chcesz, ustaw na Pomiń).
- Kliknij Dalej, pozostaw zaznaczone Utwórz dokument z tych N elementów i kliknij Importuj N elementów.
- W nowym dokumencie sprawdź, czy 1.6.1 i 1.6.2 znajdują się pod 1.6, i zaznacz 1.5, aby zobaczyć jego etykiety i status.
Gotowe, gdy nowy dokument pokazuje sekcje 1 i 2 z wymaganiami zagnieżdżonymi według numerów, z zachowanymi etykietami i statusami.
Pytania
- Jak Holarch odtwarza hierarchię wierszy arkusza?
- Niektóre wiersze trafiły do niewłaściwej klasy. Dlaczego?
- Chcesz zaktualizować właścicieli 50 istniejących wymagań z arkusza, a nie tworzyć kopie. Jak to zrobić?
6.3 Wymagania z Word i ReqIF
Obejrzyj rozdział 6.3 (2:22)
Ćwiczenie
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.
Pytania
- 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?
6.4 Modele z innych narzędzi
Obejrzyj rozdział 6.4 (2:44)
Ćwiczenie
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 Potrzeby i wymagania → Import i eksport, kliknij Eksportuj UML/SysML (XMI)… na karcie Eksport, pozostaw Format ustawiony na OMG XMI 2.5.1 (.xmi) i kliknij Eksportuj. Ten plik zastępuje eksport z narzędzia SysML, takiego jak Cameo lub Enterprise Architect.
- 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 .xmi, sprawdź, czy Format pokazuje UML/SysML (.xmi, .uml, .mdzip), dwukrotnie kliknij Dalej, przeczytaj krok Przegląd i kliknij Importuj N elementów. - W Bazie danych wyszukaj
class:Asset, zaznacz Payload Camera i sprawdź w sekcji Ślad, czy jest częścią EO-1 Spacecraft i jakie akcje wykonuje. - Otwórz Diagramy, kliknij + Nowy diagram, wybierz Diagram Asset, wybierz EO-1 Spacecraft w polu Diagram dla i kliknij Utwórz.
- Włącz Wykonywane elementy Action, aby wyświetlić funkcje każdego podsystemu.
Gotowe, gdy diagram Asset nowego projektu pokazuje podsystemy statku kosmicznego z wykonywanymi przez nie akcjami.
Pytania
- Jakie pliki z narzędzia SysML v1 Holarch może zaimportować i jak je uzyskać?
- Dlaczego po imporcie można szybko odtworzyć diagramy?
- Importujesz późniejszy eksport tego samego modelu. Dlaczego nie powstają kopie?
6.5 Porządkowanie po imporcie
Obejrzyj rozdział 6.5 (2:40)
Ćwiczenie
W projekcie demonstracyjnym CubeSat EO-1:
- Otwórz projekt
EO-1 Import Practicez wcześniejszych rozdziałów (lub zaimportuj plik CSV z wymaganiami EO-1 jak w rozdziale 2). - Otwórz Potrzeby i wymagania → Jakość, wybierz jeden z zaimportowanych dokumentów na pasku zakresu i kliknij Sprawdź jakość.
- Jeśli zaimportowano te same wymagania dwukrotnie (Word i ReqIF), zaznacz wiersz duplikatu w Bazie danych i usuń go poleceniem Usuń element… na pasku operacji zbiorczych. Przeredaguj 2.5 Safe Mode Recovery tak, aby było mierzalne, a następnie ponownie sprawdź jakość.
- Otwórz Weryfikacja → Kontrole modelu i otwórz regułę Requirement.8, Wymagania liściowe, których nie spełnia żadna encja projektowa.
- Jeśli zaimportowano także elementy Asset (rozdział 4), zaznacz 2.1 Pointing Accuracy i w sekcji Ślad dodaj satisfied by poleceniem + → Powiąż istniejący… do ADCS. Ponownie uruchom kontrole modelu.
Gotowe, gdy 2.5 ma wyższy wynik niż wcześniej, a Requirement.8 nie wymienia już 2.1.
Pytania
- Co sprawdza kontrola jakości, a co kontrole modelu?
- Dlaczego automatyczny wynik jakości nigdy nie przekracza 78%?
- Dlaczego łączyć wymagania i części zaraz po migracji?
Klucz odpowiedzi
6.1 Planowanie migracji
- Dane, które trafiają do właściwych klas, etykiet, atrybutów i relacji, od razu działają w śledzeniu powiązań, kontrolach jakości i raportach. Poprawianie ich po imporcie oznacza ręczną edycję wielu elementów.
- Dodaj atrybut w Ustawienia → Schemat przed importem lub w kroku Mapowanie przypisz kolumnę do opcji Nowy atrybut (dodany do schematu).
- Naciśnij raz ⌘Z / Ctrl+Z: import ze strony Import to jeden krok cofania.
- Aby przywrócić cały projekt jako nowy, osobny projekt. Strona Import scala elementy pliku z otwartym projektem.
6.2 Wymagania z Excel i CSV
- Z kolumny ID wiersza nadrzędnego lub Numer elementu nadrzędnego, jeśli jest zmapowana, w przeciwnym razie z numeru w konspekcie: 1.2 trafia pod 1. Jeśli brakuje elementu nadrzędnego, używany jest najbliższy istniejący przodek.
- Kolumna Class z nazwami, których schemat nie zna, przechodzi na Klasa dla wierszy bez klasy, z ostrzeżeniem. Używaj nazw klas z edytora schematu.
- Wyeksportuj je z kolumną ID, edytuj plik i zaimportuj go z kolumną ID zmapowaną na Globalny ID oraz opcją dopasowania istniejących encji ustawioną na Globalny ID. Krok Przegląd wymieni je wtedy w sekcji Zaktualizowane elementy.
6.3 Wymagania z Word i ReqIF
- 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.
- 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.
- Trafia jako traced to. Jeśli schemat nie dopuszcza traced to między tymi dwiema klasami, relacja jest pomijana z ostrzeżeniem.
6.4 Modele z innych narzędzi
- XMI 2.x z profilem SysML 1.x z Cameo/MagicDraw, Enterprise Architect, Rhapsody lub Papyrus (wyeksportuj go z narzędzia), bezpośrednio projekt .mdzip z Cameo lub MagicDraw oraz plik .uml z Papyrus. Same wymagania mogą też przyjść jako ReqIF, a tabele jako Excel lub CSV.
- Układy diagramów z innego narzędzia nie są importowane, ale relacje tak. Holarch rysuje z tych relacji diagramy Asset, hierarchii i inne.
- Każdy zaimportowany element zachowuje swój identyfikator XMI, a dopasowanie istniejących encji domyślnie używa XMI ID dla plików XMI, więc późniejszy import aktualizuje te elementy. Istniejące relacje nie są dodawane drugi raz.
6.5 Porządkowanie po imporcie
- Kontrola jakości ocenia sformułowanie każdego wymagania względem cech dobrego wymagania. Kontrole modelu przeglądają cały model w poszukiwaniu luk, takich jak wymagania, których nic nie spełnia, elementy niepowiązane z niczym czy akcje, których nikt nie wykonuje.
- Cechy Correct i Feasible wymagają oceny człowieka, więc kontrola nigdy nie oznacza ich jako spełnionych. Oznacza się je po przeglądzie wymagania.
- Pochodzą z różnych plików i nie mają między sobą powiązań. Od tej chwili każde powiązanie satisfied by zasila identyfikowalność, pokrycie i kontrole modelu.
Wydawca: Holarch