Holarch

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.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Kopia, a nie zmiana typu
    2. Jak odwzorowują się oba języki
    3. Dane Holarch są przenoszone
    4. Czego się nie konwertuje
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Tworzenie przekonwertowanej kopii
    3. Sprawdzenie kopii
    4. Przykład: demo Hybrid Car jako kopia LML
    5. Wskazówki i dobre praktyki
    6. Typowe błędy
  4. Opis raportu
    1. Z LML do SysML v2
    2. Z SysML v2 do LML
    3. Plik CSV raportu
  5. Komunikaty
  6. Limity
  7. Powiązane strony

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:

LMLSysML v2
AssetDefinicja 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
PortUżycie portu
Characteristic elementu AssetUżycie atrybutu
ConduitUżycie połączenia lub użycie interfejsu, gdy oba końce są portami
Input/OutputDefinicja elementu przepływu z parametrami in i out oraz przepływami
Requirement (Number, Name, Description)Użycie wymagania (nazwa skrócona, nazwa, doc)
satisfied bysatisfy
Test CaseUżycie weryfikacji z celem verify
Test SuitePakiet przypadków weryfikacji
Action z przepływemUżycie akcji z następstwami
Bloki SYNC i równoległeRozwidlenie i złączenie
ORDecyzja i scalenie
LOOPAkcja pętli
performed byperform
Charakterystyki stanów i przejściaDefinicja stanu z przejściami, którą część przejawia
Equation i jej zmienneDefinicja 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 .sysml lub 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

  1. Na stronie Zarządzaj projektami kliknij ⋯ w wierszu projektu.
  2. 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.

  3. 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ę.
  4. Kliknij Pobierz raport (CSV), aby zapisać raport z jednym wierszem na element, jeśli potrzebujesz go poza Holarch.
  5. Wpisz Nazwa nowego projektu. Domyślnie jest to nazwa oryginału z dopiskiem “(SysML v2)” lub “(LML)”.
  6. Kliknij Utwórz kopię.

    Komunikat brzmi “Utworzono: <name>”. Kopia otwiera się na swojej stronie głównej.

  7. Otwórz w kopii dokument Raport konwersji. Wymienia on każdy element, który nie został przekonwertowany, według numeru i nazwy.

Sprawdzenie kopii

  1. 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ść).

  2. 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.”
  3. Otwórz widoki w Widoki (Architecture Overview, System Connections), aby zobaczyć strukturę narysowaną od nowa.
  4. 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).

  1. 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)”.
  2. 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.
  3. Kliknij Utwórz kopię.

    Otwiera się kopia LML. fleet.sedan i 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 przekonwertowanoPowód
Elementy Asset w pętli dekompozycjiAsset, 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ówPołączenie SysML łączy dwa końce. Połącz conduit z dwoma elementami Asset lub Port, a następnie przekonwertuj ponownie.
Elementy przenoszone przez conduitPołą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 ConduitPołączenia SysML nie są tu zagnieżdżane; każdy conduit staje się osobnym połączeniem.
Liczby powtórzeń i skrypty pętliPę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 decyzjiGdy 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 LOOPKonstrukcje 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ówAkcje są konwertowane jako akcje; ta konwersja nie wypełnia treści stanów SysML.
Przejścia bez dwóch stanów jednej maszynyPrzejś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 AssetStan wymaga elementu Asset, którego zachowanie opisuje.
Wyrażenia EquationWyraż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 testowychZestaw staje się pakietem swoich przypadków weryfikacji; pusty zestaw nie ma czego zawierać.
Przypadki testowe weryfikujące coś innego niż wymaganiePrzypadek weryfikacji SysML weryfikuje tylko wymagania.
Cykle testówPrzebiegi testów zarejestrowane w zestawie nie są częścią modelu; zachowywany jest najnowszy wynik każdego przypadku.
Wymagania spełniane przez elementy innych rodzajówNa przykład w SysML wymaganie nie spełnia innego wymagania; użyj wyprowadzenia w tekście.
Inne relacjeTa konwersja nie ma dla nich relacji SysML; raport wymienia każdą z nich.
MeasuresMiary skuteczności nie mają w tej konwersji elementu SysML.
ResourcesIlości zasobów (consumes, produces) należą do symulatora LML i nie mają tu elementu SysML.
Elementy Characteristic niedołączone do elementu Asset ani EquationAtrybut wymaga właściciela: określ go przez Asset albo uczyń go zmienną Equation.
Elementy innych klasTa klasa nie ma elementu SysML ani miejsca w Holarch w projekcie SysML v2.
Cechy i konfiguracjeJeszcze 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 bazoweLinie bazowe projektu LML nie dotyczą nowego modelu; kopia zaczyna bez linii bazowych.
HistoriaHistoria 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ówDiagramy są rysowane od nowa jako widoki SysML v2; położenia nie są przenoszone.
Przekonwertowane elementy w konspektach dokumentówDokumenty 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 przekonwertowanoPowó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ążąceLML 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 elementuNadaj parametrowi typ item def, aby go przekonwertować.
Aktorzy bez definicji części w modeluNadaj aktorowi typ part def, aby go przekonwertować.
Użycia perform, które nie rozwiązują się do akcji i częściWykonuj 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 strukturalnegoPrzepł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ówPopraw 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, obawyLML nie ma obliczeń, przypadków analizy ani obaw interesariuszy.
Widoki i punkty widzeniaDiagramy są w kopii LML rysowane od nowa.
Akcje przypisania, if, send i acceptAkcje LML nie mają instrukcji.
ZależnościLML nie ma ogólnej zależności.
AlokacjeDla akcji wykonywanych przez części użyj perform w tekście.
MetadaneLML nie ma metadanych.
WystąpieniaLML nie ma wystąpień.
Dołączane przypadki użyciaRelacje include między przypadkami użycia nie są konwertowane.
AliasyEncje LML mają po jednej nazwie.
Użycia referencji (parametry obliczeń i przypadków)LML nie ma parametrów poza zmiennymi równań.
SpecjalizacjeLML nie ma specjalizacji; do części kopiowane są cechy ich ogólnych definicji.
RedefinicjeCecha redefiniująca zastępuje odziedziczoną w każdej skopiowanej części.
Podzbiory (subsetting)LML nie ma podzbiorów.
ImportyLML 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ęściMiejsce w LML mają tylko liczności części (Multiplicity relacji decomposed by).
Wartości atrybutówWartości są zachowywane jako tekst w polu Value każdej charakterystyki; jednostki i wyrażenia nie są obliczane.
Linie bazoweLinie bazowe projektu SysML v2 nie dotyczą kopii LML; zaczyna ona bez linii bazowych.
HistoriaHistoria 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.

SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.