SysML v2
Konwersja między LML a SysML v2
Utwórz kopię SysML v2 projektu LML lub kopię LML projektu SysML v2 wraz z raportem tego, co zostaje przekonwertowane, a co nie.
Przegląd
Typ projektu, LML lub SysML v2, jest ustalany przy jego tworzeniu. Aby pracować nad modelem LML w SysML v2 lub nad modelem SysML v2 przy użyciu stron LML, utwórz przekonwertowaną kopię:
- Utwórz kopię SysML v2… w projekcie LML zapisuje jego model jako tekst SysML v2 w nowym projekcie SysML v2.
- Utwórz kopię LML… w projekcie SysML v2 zamienia jego model na encje i relacje LML w nowym projekcie LML.
Oryginalny projekt nigdy nie jest zmieniany. Przed utworzeniem kopii raport wymienia, co się konwertuje (z liczbami), a co nie (z przyczyną). Ten sam raport jest zapisywany w nowym projekcie.
Pojęcia
Kopia, a nie zmiana typu
Konwersja zawsze tworzy nowy projekt. Można dalej pracować w oryginale i przekonwertować go ponownie później; każda konwersja tworzy kolejny nowy projekt. Nic nie łączy kopii z oryginałem.
Jak odwzorowują się oba języki
LML i SysML v2 opisują wiele tych samych rzeczy na różne sposoby. Konwersja używa tego odwzorowania w obu kierunkach:
| LML | SysML v2 |
|---|---|
| Asset | Definicja części z użyciem części wszędzie tam, gdzie jest używana |
| Dekompozycja Asset (decomposed by) | Użycie części w definicji elementu nadrzędnego |
| Port | Użycie portu |
| Characteristic elementu Asset | Użycie atrybutu |
| Conduit | Użycie połączenia lub użycie interfejsu, gdy oba końce są portami |
| Input/Output | Definicja elementu przepływu z parametrami in i out oraz przepływami |
| Requirement (Number, Name, Description) | Użycie wymagania (nazwa skrócona, nazwa, doc) |
| satisfied by | satisfy |
| Test Case | Użycie weryfikacji z celem verify |
| Test Suite | Pakiet przypadków weryfikacji |
| Action z przepływem | Użycie akcji z następstwami |
| Bloki SYNC i równoległe | Rozwidlenie i złączenie |
| OR | Decyzja i scalenie |
| LOOP | Akcja pętli |
| performed by | perform |
| Charakterystyki stanów i przejścia | Definicja stanu z przejściami, którą część przejawia |
| Equation i jej zmienne | Definicja ograniczenia z parametrami |
Dane Holarch są przenoszone
Niektóre dane nie mają miejsca w żadnym z języków. Są to dane Holarch i są kopiowane wraz z powiązaniami:
- Ryzyka, decyzje, zadania, koszty, harmonogramy, problemy, dokumenty i tablice są kopiowane i pozostają powiązane z przekonwertowanymi elementami.
- Status wymagań i metody weryfikacji pozostają przy każdym wymaganiu; wyniki testów pozostają przy każdym przypadku testowym. Zachowywane są też niestandardowe stany przepływów pracy klas.
- Zmiany schematu są przenoszone w obu kierunkach, łącznie z przepływami pracy klas z ich stanami, wycofanymi stanami, przejściami i zatwierdzającymi.
- Komentarze dyskusji podążają za swoim elementem.
- Prawdopodobieństwa gałęzi decyzji pozostają przy swoich gałęziach, na potrzeby Symulatora.
- Kopia LML utworzona z kopii SysML v2 odzyskuje atrybuty i etykiety LML zachowane przy pierwszej konwersji.
Czego się nie konwertuje
- Układy diagramów. Widoki i diagramy są w kopii rysowane od nowa.
- Historia, linie bazowe i wnioski o zmianę. Kopia zaczyna bez nich.
- Elementy, dla których jeden z języków nie ma miejsca, np. Measures i Resources w LML lub wyliczenia, obliczenia i przypadki analizy w SysML v2.
Raport wymienia każdy taki element i podaje przyczynę. Zobacz Opis raportu.
Jak z niego korzystać
Kiedy i dlaczego
Konwertuj, gdy język projektu przestaje pasować do pracy:
- Z LML do SysML v2: zespół lub klient pracuje teraz w SysML v2 albo model trzeba wymieniać z narzędziami SysML v2. Przekonwertuj, a następnie wyeksportuj
.sysmllub JSON (zobacz Wymiana modeli SysML v2). - Z SysML v2 do LML: potrzebujesz strony lub diagramu LML, których projekty SysML v2 nie mają, albo chcesz mieć model w formie cyklu życia Holarch na potrzeby przeglądu.
Konwertuj, gdy model jest stabilny, i przeczytaj raport, zanim zaczniesz polegać na kopii.
Tworzenie przekonwertowanej kopii
- Na stronie Zarządzaj projektami kliknij ⋯ w wierszu projektu.
- Wybierz Utwórz kopię SysML v2… (dla projektu LML) lub Utwórz kopię LML… (dla projektu SysML v2).
Holarch sprawdza konwersję; w dużym projekcie pasek postępu u dołu okna pokazuje “Sprawdzanie konwersji…”. Następnie otwiera się okno dialogowe z raportem.
- Przeczytaj raport:
- Przekonwertowano wymienia każdy rodzaj elementu, ich liczbę i to, czym się staje, na przykład “Wymagania 24 użycia wymagań”.
- Nie przekonwertowano wymienia każdy rodzaj elementu, który się nie konwertuje, ich liczbę i przyczynę.
- Kliknij Pobierz raport (CSV), aby zapisać raport z jednym wierszem na element, jeśli potrzebujesz go poza Holarch.
- Wpisz Nazwa nowego projektu. Domyślnie jest to nazwa oryginału z dopiskiem “(SysML v2)” lub “(LML)”.
- Kliknij Utwórz kopię.
Komunikat brzmi “Utworzono: <name>”. Kopia otwiera się na swojej stronie głównej.
- Otwórz w kopii dokument Raport konwersji. Wymienia on każdy element, który nie został przekonwertowany, według numeru i nazwy.
Sprawdzenie kopii
- W kopii SysML v2 otwórz Model → Edytor.
Model to jeden pakiet najwyższego poziomu nazwany tak jak projekt. Zawiera pakiety Architecture, System, Items, Requirements, Verification, Behavior, Constraints i Views (tylko te, które mają zawartość).
- Poszukaj znaczników problemów na marginesie. Jeśli przekonwertowany tekst ma problemy, okno dialogowe informowało o tym przed utworzeniem kopii: “Przekonwertowany tekst ma N problemów. Kopia pokazuje je w swoim Edytorze.”
- Otwórz widoki w Widoki (Architecture Overview, System Connections), aby zobaczyć strukturę narysowaną od nowa.
- W kopii LML otwórz Bazę danych i diagramy, aby sprawdzić elementy Asset, Requirement i przepływy akcji.
Przykład: demo Hybrid Car jako kopia LML
Najpierw utwórz projekt demonstracyjny: na stronie Zarządzaj projektami kliknij Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car (SysML v2).
- Na stronie Zarządzaj projektami kliknij ⋯ przy Hybrid Car (SysML v2 demo) i wybierz Utwórz kopię LML…. Kopia otrzyma nazwę “Hybrid Car (SysML v2 demo) (LML)”.
- Przeczytaj raport.
W sekcji Przekonwertowano: użycia części stają się elementami Asset, użycia portów elementami Port, atrybuty elementami Characteristic, użycia połączeń i interfejsów elementami Conduit, użycia i definicje wymagań elementami Requirement, użycia weryfikacji elementami Test Case, akcje elementami Action, a stany i przejścia ich odpowiednikami w LML.
W sekcji Nie przekonwertowano znajdują się między innymi:
- Specjalizacje: LML nie ma specjalizacji; do części kopiowane są cechy ich ogólnych definicji. Jedną z nich jest
SportCar :> Car. - Redefinicje: cecha redefiniująca zastępuje odziedziczoną w każdej skopiowanej części. Akumulator sedana jest kopiowany z wartością 48 kg.
- Wyliczenia (
DriveMode,FuelKind): wartości atrybutów są zachowywane jako tekst. - Obliczenia (
PowerToWeight,ElectricRange) i przypadki analizy (PowerToWeightAnalysis). - Łączniki wiążące (
bind output = transmission.output;): LML nie ma wiązania między cechami. - Wartości atrybutów: zachowywane jako tekst w polu Value każdego elementu Characteristic; jednostki i wyrażenia nie są obliczane.
- Widoki: diagramy są w kopii LML rysowane od nowa.
- Specjalizacje: LML nie ma specjalizacji; do części kopiowane są cechy ich ogólnych definicji. Jedną z nich jest
- Kliknij Utwórz kopię.
Otwiera się kopia LML.
fleet.sedani jego części są elementami Asset; wymaganie Sedan Mass (VR-1.1) jest elementem Requirement spełnianym przez Asset sedana. Ryzyka, decyzje i zadania z demo również są kopiowane i powiązane z przekonwertowanymi elementami.
Aby wypróbować drugi kierunek, utwórz demo CubeSat EO-1 (projekt LML) i wybierz dla niego Utwórz kopię SysML v2….
Wskazówki i dobre praktyki
- Przed konwersją uporządkuj projekt LML: połącz każdy Conduit z dokładnie dwoma elementami Asset lub Port, dołącz każdy Characteristic do elementu Asset lub Equation i usuń puste elementy Test Suite. W przeciwnym razie zostaną zgłoszone jako nieprzekonwertowane.
- W LML zapisuj etykiety gałęzi OR jako wyrażenia logiczne na wartościach modelu (np.
speed > 3), jeśli mają stać się warunkami dozoru. Inne etykiety stają się komentarzami doc przy następstwach. - W SysML v2 nadaj aktorom typ definicji części, a parametrom elementów przepływu typ definicji elementu. Nietypowane nie są konwertowane.
- Zachowaj oryginał. Po większych zmianach konwertuj ponownie z oryginału zamiast edytować oba projekty równolegle.
Typowe błędy
- Oczekiwanie, że oryginał się zmieni. Nie zmienia się. Kopia jest osobnym projektem.
- Oczekiwanie, że diagramy zachowają układ. Układy nie są konwertowane; ułóż nowe widoki lub diagramy ponownie.
- Brakujące części w kopii LML. Definicja części, której nie używa żadna część, nie ma elementu Asset w LML, ponieważ LML ma tylko instancje. Użyj definicji w części, a następnie przekonwertuj ponownie.
- Element “does not resolve” w raporcie. Nazwa w tekście SysML v2 nigdzie nie wskazuje. Popraw nazwę w Edytorze, a następnie przekonwertuj ponownie.
Opis raportu
Z LML do SysML v2
Przekonwertowane elementy obejmują Assets (definicje części z ich użyciami), Characteristics (atrybuty), Ports, Conduits (połączenia lub interfejsy), Input/Outputs (definicje elementów przepływu), Requirements, Actions i przypadki użycia, przepływy elementów między akcjami, States, Transitions, Equations (definicje ograniczeń), Performs, zestawy testów, Test Cases, Verifies, Satisfies oraz elementy Holarch (kopiowane z powiązaniami): artefakty, stwierdzenia, zadania, ryzyka, pozycje harmonogramu, koszty, problemy, decyzje, zagrożenia i rodzaje uszkodzeń. Przepływy pracy klas (zmiany schematu projektu) są przenoszone z niestandardowymi stanami, przejściami i zatwierdzającymi, więc wymagania i przypadki testowe zachowują niestandardowe wartości Status. Kopia zachowuje przełączniki projektu Program formalny oraz Bezpieczeństwo i niezawodność.
| Nie przekonwertowano | Powód |
|---|---|
| Elementy Asset w pętli dekompozycji | Asset, który zawiera sam siebie, nie ma miejsca w drzewie części. Jego definicja części jest konwertowana; nie jest używany jako część. |
| Elementy Conduit bez dokładnie dwóch końców | Połączenie SysML łączy dwa końce. Połącz conduit z dwoma elementami Asset lub Port, a następnie przekonwertuj ponownie. |
| Elementy przenoszone przez conduit | Połączenia w tej konwersji nie przenoszą elementów. Elementy są konwertowane jako definicje elementów przepływu i przepływy między akcjami. |
| Elementy Conduit dekomponowane na inne elementy Conduit | Połączenia SysML nie są tu zagnieżdżane; każdy conduit staje się osobnym połączeniem. |
| Liczby powtórzeń i skrypty pętli | Pętla SysML powtarza się tu do spełnienia warunku; liczba powtórzeń jest zachowywana jako dane Holarch i przywracana przez Utwórz kopię LML. |
| Etykiety i prawdopodobieństwa gałęzi decyzji | Gdy każda etykieta decyzji jest wyrażeniem logicznym na wartościach modelu, etykiety stają się jej warunkami dozoru; w przeciwnym razie stają się komentarzami doc przy następstwach. Prawdopodobieństwa są zachowywane jako dane Holarch dla Symulatora, a jedno i drugie przywraca Utwórz kopię LML. |
| Elementy OR, SYNC i LOOP | Konstrukcje są konwertowane jako węzły decyzji/scalenia, rozwidlenia/złączenia i pętli; elementy, które je nazywały, nie są zachowywane. |
| Akcje entry, do i exit stanów | Akcje są konwertowane jako akcje; ta konwersja nie wypełnia treści stanów SysML. |
| Przejścia bez dwóch stanów jednej maszyny | Przejście SysML łączy dwa stany tej samej definicji stanu. |
| Warunki dozoru i wyzwalacze przejść | W LML są zapisywane jako dowolny tekst; są zachowywane jako dane Holarch, a nie jako wyrażenia SysML, i przywracane przez Utwórz kopię LML. |
| Stany nieokreślone przez żaden Asset | Stan wymaga elementu Asset, którego zachowanie opisuje. |
| Wyrażenia Equation | Wyrażenia używają nazw, które nie są cechami SysML; każde jest zachowywane jako komentarz w swojej definicji ograniczenia. |
| Zestawy testów bez przypadków testowych | Zestaw staje się pakietem swoich przypadków weryfikacji; pusty zestaw nie ma czego zawierać. |
| Przypadki testowe weryfikujące coś innego niż wymaganie | Przypadek weryfikacji SysML weryfikuje tylko wymagania. |
| Cykle testów | Przebiegi testów zarejestrowane w zestawie nie są częścią modelu; zachowywany jest najnowszy wynik każdego przypadku. |
| Wymagania spełniane przez elementy innych rodzajów | Na przykład w SysML wymaganie nie spełnia innego wymagania; użyj wyprowadzenia w tekście. |
| Inne relacje | Ta konwersja nie ma dla nich relacji SysML; raport wymienia każdą z nich. |
| Measures | Miary skuteczności nie mają w tej konwersji elementu SysML. |
| Resources | Ilości zasobów (consumes, produces) należą do symulatora LML i nie mają tu elementu SysML. |
| Elementy Characteristic niedołączone do elementu Asset ani Equation | Atrybut wymaga właściciela: określ go przez Asset albo uczyń go zmienną Equation. |
| Elementy innych klas | Ta klasa nie ma elementu SysML ani miejsca w Holarch w projekcie SysML v2. |
| Cechy i konfiguracje | Jeszcze nie: cechy i konfiguracje linii produktów nie stają się punktami zmienności, wariantami i konfiguracjami SysML v2. Raport wymienia je jako elementy Feature i elementy Configuration; zamodeluj warianty ponownie w kopii (zobacz Warianty i konfiguracje SysML v2). |
| Linie bazowe | Linie bazowe projektu LML nie dotyczą nowego modelu; kopia zaczyna bez linii bazowych. |
| Historia | Historia zmian zaczyna się w kopii od nowa. |
| Wnioski o zmianę | Wnioski o zmianę w LML proponują zmiany elementów LML, których kopia nie ma. |
| Układy diagramów | Diagramy są rysowane od nowa jako widoki SysML v2; położenia nie są przenoszone. |
| Przekonwertowane elementy w konspektach dokumentów | Dokumenty są kopiowane; wymagania i inne elementy modelu w ich konspektach są teraz elementami SysML i pojawiają się w modelu, a nie w konspekcie. |
Z SysML v2 do LML
Każde użycie części staje się elementem Asset, do którego kopiowane są części, porty i atrybuty jego definicji (oraz definicji, które ona specjalizuje). Redefinicje zastępują to, co redefiniują. Połączenia i interfejsy stają się elementami Conduit między tymi elementami Asset. Wymagania, przypadki weryfikacji, satisfy, verify, perform, parametry elementów przepływu, stany i przejścia są odwzorowywane z powrotem jak w tabeli powyżej. Następstwa stają się przepływami akcji; warunki dozoru decyzji (lub komentarze doc jej następstw) stają się etykietami gałęzi OR wraz z prawdopodobieństwami. Zmiany schematu projektu są przenoszone, łącznie z przepływami pracy klas z niestandardowymi stanami, przejściami i zatwierdzającymi, więc wymagania i przypadki testowe zachowują niestandardowe wartości Status.
| Nie przekonwertowano | Powód |
|---|---|
| Połączenia z końcami, które się nie rozwiązują | Popraw nazwy końców w tekście, a następnie przekonwertuj ponownie. |
| Połączenia wewnątrz definicji, których nie używa żadna część | Każde połączenie staje się elementem conduit między częściami każdej części, która je ma; nic nie używa tej definicji. |
| Łączniki wiążące | LML nie ma wiązania (równości) między cechami. |
| Relacje verify, które się nie rozwiązują | Popraw nazwę wymagania w celu weryfikacji, a następnie przekonwertuj ponownie. |
| Parametry elementów przepływu bez definicji elementu | Nadaj parametrowi typ item def, aby go przekonwertować. |
| Aktorzy bez definicji części w modelu | Nadaj aktorowi typ part def, aby go przekonwertować. |
| Użycia perform, które nie rozwiązują się do akcji i części | Wykonuj akcję (perform) z definicji części lub użycia części, a następnie przekonwertuj ponownie. |
| Relacje satisfy, które się nie rozwiązują | Popraw nazwy w instrukcji satisfy, a następnie przekonwertuj ponownie. |
| Następstwa, które nie tworzą przepływu strukturalnego | Przepływy akcji LML to sekwencje z blokami równoległymi, decyzyjnymi i pętli; inne grafy następstw są linearyzowane. |
| Definicje stanów, których nie przejawia żadna część | Stany są konwertowane bez elementu Asset, którego zachowanie opisują. |
| Przejścia, które nie rozwiązują się do dwóch stanów | Popraw nazwy stanów, a następnie przekonwertuj ponownie. |
| Wyzwalacze przejść (accept) | Przejścia LML zachowują wyzwalacz tylko jako dowolny tekst; przyjmowany sygnał nie jest powiązywany. |
| Definicje portów, interfejsów i połączeń | Są konwertowane jako Ports i Conduits tam, gdzie używają ich części; LML nie ma typów portów, interfejsów ani połączeń. |
| Definicje atrybutów (typy wartości) | Charakterystyki LML nie mają typów. |
| Wyliczenia i wartości wyliczeń | LML nie ma wyliczeń; wartości atrybutów są zachowywane jako tekst. |
| Obliczenia, przypadki analizy, obawy | LML nie ma obliczeń, przypadków analizy ani obaw interesariuszy. |
| Widoki i punkty widzenia | Diagramy są w kopii LML rysowane od nowa. |
| Akcje przypisania, if, send i accept | Akcje LML nie mają instrukcji. |
| Zależności | LML nie ma ogólnej zależności. |
| Alokacje | Dla akcji wykonywanych przez części użyj perform w tekście. |
| Metadane | LML nie ma metadanych. |
| Wystąpienia | LML nie ma wystąpień. |
| Dołączane przypadki użycia | Relacje include między przypadkami użycia nie są konwertowane. |
| Aliasy | Encje LML mają po jednej nazwie. |
| Użycia referencji (parametry obliczeń i przypadków) | LML nie ma parametrów poza zmiennymi równań. |
| Specjalizacje | LML nie ma specjalizacji; do części kopiowane są cechy ich ogólnych definicji. |
| Redefinicje | Cecha redefiniująca zastępuje odziedziczoną w każdej skopiowanej części. |
| Podzbiory (subsetting) | LML nie ma podzbiorów. |
| Importy | LML nie ma przestrzeni nazw; każda encja jest widoczna w projekcie. |
| Definicje jako odrębne od użyć | LML ma tylko instancje: definicja części staje się elementami Asset części, które jej używają, a jej tekst trafia do ich opisów. |
| Liczności inne niż liczności części | Miejsce w LML mają tylko liczności części (Multiplicity relacji decomposed by). |
| Wartości atrybutów | Wartości są zachowywane jako tekst w polu Value każdej charakterystyki; jednostki i wyrażenia nie są obliczane. |
| Linie bazowe | Linie bazowe projektu SysML v2 nie dotyczą kopii LML; zaczyna ona bez linii bazowych. |
| Historia | Historia zmian zaczyna się w kopii od nowa. |
| Wnioski o zmianę | Wnioski o zmianę w SysML proponują zmiany tekstu, które nie dotyczą encji LML. |
Plik CSV raportu
Pobierz raport (CSV) zapisuje jeden wiersz na każdy rodzaj przekonwertowanego elementu i jeden wiersz na każdy element, który nie został przekonwertowany. Kolumny to Wynik (Przekonwertowano lub Nie przekonwertowano), Co, Liczba, Staje się lub przyczyna, Numer i Nazwa.
Komunikaty
| Wiadomość | Znaczenie i rozwiązanie |
|---|---|
| Sprawdzanie konwersji… (pasek postępu) | Raport jest przygotowywany. |
| To jest już projekt SysML v2. Zamiast tego wybierz Utwórz kopię LML…. | Wybrano niewłaściwy kierunek. |
| To jest już projekt LML. Zamiast tego wybierz Utwórz kopię SysML v2…. | Wybrano niewłaściwy kierunek. |
| Przekonwertowany tekst ma N problemów. Kopia pokazuje je w swoim Edytorze. | Kopię można utworzyć; popraw problemy w jej Edytorze. |
| Przekonwertowanego tekstu nie da się przeanalizować (…). Projekt nie został skopiowany; zgłoś to wraz z plikiem projektu. | Konwersja się nie powiodła. Skontaktuj się z pomocą techniczną i dołącz plik projektu. |
| Moduł sprawdzania SysML nie uruchomił się. Wczytaj stronę ponownie i spróbuj jeszcze raz. | Wczytaj ponownie i spróbuj jeszcze raz. |
| Nie udało się odczytać projektu. Wczytaj stronę ponownie i spróbuj jeszcze raz. | Wczytaj ponownie i spróbuj jeszcze raz. |
| Kopia nie została utworzona: … Wczytaj stronę ponownie i spróbuj jeszcze raz. | Wczytaj ponownie i spróbuj jeszcze raz. |
| Utworzono: <name> | Kopia została utworzona i otwarta. |
Limity
- Układy diagramów, historia, linie bazowe i wnioski o zmianę nie są konwertowane.
- Jeszcze nie: konwersja linii produktów LML (cech i konfiguracji) na warianty SysML v2.
- Dokument raportu wymienia do 500 elementów na rodzaj.
Powiązane strony
- Pierwsze kroki z projektami SysML v2
- Wymiana modeli SysML v2
- Funkcje Holarch w projektach SysML v2
- Notacja tekstowa SysML v2
SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.