Holarch

Z SysML v1 do SysML v2

Przenieś model SysML v1 do SysML v2 bez ponownego rysowania.

Upuść model SysML v1 zapisany jako XMI (.xmi, .xml, .uml) lub jako archiwum projektu .mdzip w projekcie SysML v2. Holarch konwertuje go na tekst SysML v2, sprawdza tekst i przed jakimkolwiek importem raportuje każdy element jako przekonwertowany, przybliżony lub pominięty, z podaniem przyczyny.

Konwerter jest częścią każdego planu, także Free. Nowe konta przy pierwszym logowaniu rozpoczynają 30-dniowy okres próbny Individual: 10 000 elementów na projekt, bez karty, z powrotem na Free po jego zakończeniu. Masz już konto? Rozpocznij okres próbny.

Dowód: model CubeSat EO-1

WynikElementy
Przekonwertowane1,007
Przybliżone32
Pominięte3
Odczytane elementy1,042
Problemy w tekście SysML v20

Przekonwertowany tekst przechodzi kontrolę bez błędów i ostrzeżeń, a ten sam model za każdym razem daje ten sam tekst. Co zostało przybliżone i pominięte

Import modelu SysML v1

Zaimportuj plik XMI lub projekt .mdzip modelu SysML v1 do projektu SysML v2. Zanim cokolwiek zostanie utworzone, raport konwersji wymienia każdy element jako przekonwertowany, przybliżony lub pominięty, z podaniem przyczyny, i zapisuje się jako plik CSV. Przykładem jest model CubeSat EO-1: 1042 elementy, zaimportowane bez problemów.

Import modelu SysML v1 na stronie Filmy

Co daje konwerter

Model SysML v2, w którym można pracować, i jasna lista tego, co trzeba przejrzeć.

Bez ponownego rysowania

Bloki stają się definicjami part def, porty, łączniki i przepływy elementów są przenoszone, wymagania zachowują identyfikatory i tekst, a relacje satisfy, verify i allocate pozostają powiązane.

Raport dla każdego elementu

Każdy element modelu v1 jest wymieniony z rodzajem w v1, wynikiem, nazwą w SysML v2, którą otrzymał, oraz – dla wszystkiego, co przybliżono lub pominięto – przyczyną opisaną słowami. Filtruj raport na ekranie lub pobierz go jako CSV.

Sprawdzone przed importem

Przekonwertowany tekst sprawdza ten sam silnik, który sprawdza Edytor SysML v2 w trakcie pisania. Najpierw widzisz wynik, tekst i raport; import to jeden krok cofania.

Ponowny import po zmianie modelu v1

Elementy przejmują identyfikatory z identyfikatorów XMI modelu v1. Zaimportuj nowszy eksport do tego samego projektu, a elementy zaktualizują się na miejscu, także po zmianie nazwy lub przeniesieniu, wraz z układami diagramów, komentarzami, powiązaniami i historią.

Model, w którym można pracować

Edytor, widoki, wymagania, weryfikacja i pozostałe strony projektu SysML v2 odczytują przekonwertowany model jak każdy inny.

Model v1 pozostaje bez zmian

Holarch odczytuje jego eksport i nigdy nic do niego nie zapisuje, więc model v1 pozostaje punktem odniesienia, gdy zespół przegląda wersję SysML v2.

Jak to działa

  1. Upuść plik. W projekcie SysML v2 kliknij Model → Import i eksport, wybierz Do tego projektu lub Do nowego projektu SysML v2 i upuść plik .mdzip, .xmi, .uml lub .xml. Karta postępu pokazuje odczyt, konwersję i sprawdzanie.
  2. Przejrzyj raport. Konwersja z SysML v1 podaje liczby, informuje, czy tekst przechodzi kontrolę bez problemów, i wymienia przybliżone i pominięte elementy z przyczyną dla każdego. Pokaż tekst SysML v2 otwiera wynik; pobierz raport lub plik .sysml, aby je zachować.
  3. Zaimportuj. Odznacz pakiety, których nie chcesz, i zaimportuj. Jedno Cofnij usuwa cały import.

Krok po kroku, z ustawieniami eksportu każdego narzędzia: Importowanie modeli SysML v1 w Docs oraz przewodnik po migracji do planowania przeniesienia całego programu.

Przekonwertowany blok

part def Rover {
  @SysMLv1Library::BlockData { isEncapsulated = true; }
  part battery : Battery;
  part computer : Computer;
  attribute 'power budget' : Types::Power = 120 [SI::W];
  connection 'power bus' connect battery.'out' to computer.'in';
  satisfy Requirements::'Power Margin' by battery;
  flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}

Wynik konwertera dla bloku hermetyzowanego z dwiema częściami, właściwością wartości w watach, łącznikiem między portami proxy z przepływem elementu i relacją satisfy. Przewodnik po migracji pokazuje cały mały model przed konwersją i po niej.

Co odczytuje

  • SysML v1 jako XMI 2.x: UML 2.5 z profilem SysML 1.x.
  • .xmi: plik XMI.
  • .xml: XMI zapisany z rozszerzeniem .xml.
  • .uml: plik modelu XMI.
  • .mdzip: spakowane archiwum projektu zawierające model jako XMI; Holarch odczytuje XMI znajdujący się w środku.
  • Inne formaty projektów: narzędzie, które przechowuje modele we własnym formacie projektu, najpierw eksportuje model jako XMI.

Jeden plik na import, do 64 MB, 250 000 elementów i 512 poziomów zagnieżdżenia.

Co powstaje

  • Tekst SysML v2 w otwartym projekcie lub w nowym projekcie SysML v2, zaimportowany jako jeden krok cofania.
  • Kontrola tekstu, pokazywana przed importem.
  • Raport konwersji dla każdego elementu, z filtrowaniem na ekranie i do pobrania jako CSV.
  • Plik .sysml do pobrania, do przeglądu lub dla innego narzędzia SysML v2.

Konwersja opiera się na transformacji SysML v1 do SysML v2 opisanej w specyfikacji OMG SysML 2.0.

Przekonwertowane, przybliżone lub pominięte

Każdy element modelu v1 otrzymuje jeden z trzech wyników, więc wiadomo dokładnie, gdzie patrzeć.

Przekonwertowane

Element ma bezpośredni odpowiednik w SysML v2. Blok staje się part def, blok interfejsu – port def, a wymaganie zachowuje identyfikator i tekst.

Przybliżone

Element zostaje zachowany w zmienionej postaci. Port pełny typowany przez blok interfejsu staje się portem; przejście przez węzeł wyboru staje się osobnym przejściem dla każdej ścieżki; jednostka, która nie jest mapowaną jednostką SI, staje się liczbą rzeczywistą z jednostką w dokumentacji.

Pominięte

SysML v2 nie ma odpowiednika albo element wskazuje na coś, czego nie ma w pliku. Przykłady to węzły końcowe przepływu, partycje aktywności, rozszerzenia przypadków użycia i relacje do elementów bez nazwy.

Właściwości SysML v1 bez słowa kluczowego SysML v2, takie jak blok hermetyzowany, port pełny czy relacja refine, są zachowywane jako metadane z pakietu SysMLv1Library, który Holarch wczytuje w każdym projekcie SysML v2. Własne stereotypy stają się definicjami metadanych z wartościami znaczników, a zachowania nieprzezroczyste, warunki dozoru i ograniczenia zachowują treść jako reprezentacje tekstowe, np. language "OCL" /* … */.

Co na co jest konwertowane

Najważniejsze odwzorowania. Wszystkie wymienia Docs.

SysML v1SysML v2
Pakietpackage, zagnieżdżone jak w v1
Blok, aktorpart def
Typ wartości, wyliczenieattribute def, enum def; typ wartości ze znaną jednostką SI specjalizuje wielkość ISQ
Właściwości części, referencji i wartościpart, ref part, attribute, z krotnościami i wartościami domyślnymi
Blok interfejsu, port proxy, właściwość przepływuport def, port, skierowany item lub attribute
Łącznik, łącznik wiążący, przepływ elementuconnect, bind, flow
Aktywność, akcje, przepływy sterowania i obiektówaction def, akcje, następstwa z warunkami dozoru, przepływy między parametrami
Maszyna stanów, stany, przejściastate def, stany, przejścia z accept, warunkami dozoru i efektami
Wymaganie, satisfy, verify, deriverequirement z identyfikatorem i tekstem, satisfy, verify, połączenia wyprowadzenia
Allocate, refine, traceallocate; dependency z metadanymi SysMLv1Library
Przypadek użycia, interakcja, blok ograniczeńuse case def, occurrence def z komunikatami, constraint def
Stereotypy i wartości znacznikówmetadata def dla każdego stereotypu, zastosowana z jego znacznikami

Przykład: model CubeSat EO-1

Demo CubeSat EO-1 wyeksportowane jako SysML 1.6 XMI i zaimportowane do nowego projektu SysML v2: odczytano 1042 elementy, przekonwertowano 1007, przybliżono 32, pominięto 3. Tekst SysML v2 przechodzi kontrolę bez błędów i ostrzeżeń, a nowy projekt otwiera się ze strukturą, funkcjami, wymaganiami i powiązaniami satelity. Każdy przybliżony i pominięty element według przyczyny:

ElementyWynikPowód
10 łącznikówPrzybliżoneKoniec łącznika leży wewnątrz części; ścieżkę do niego wyznaczono na podstawie typów części.
8 przejśćPrzybliżone4 wyzwalacze zmiany i czasu, takie jak when Undervoltage, są zachowane jako dokumentacja; 4 zdarzenia bez sygnału, takie jak Contact Start, otrzymały definicję elementu o tej nazwie.
6 przepływów elementówPrzybliżoneNazwa występuje dwa razy w tym samym miejscu; przepływ otrzymał nową nazwę z przyrostkiem.
5 typów wartościPrzybliżoneJednostka (%, GB, Mbps, mNms, W/m^2) nie jest jednostką SI mapowaną przez Holarch; typ wartości jest liczbą rzeczywistą z jednostką w dokumentacji.
2 przepływy sterowaniaPrzybliżoneGałąź bez warunku dozoru obok gałęzi z warunkami; otrzymała warunek true.
1 stan końcowyPrzybliżoneStan końcowy stał się zwykłym stanem.
1 rozszerzenie przypadku użyciaPominięteSysML v2 nie ma rozszerzeń przypadków użycia.
2 relacje tracePominięteWskazują na elementy bez nazwy, do których tekst SysML v2 nie może się odwołać.

Plik EO-1 to własny eksport SysML 1.6 z Holarch, więc używa tej części SysML v1, którą zapisuje Holarch. Model z innego narzędzia zwykle używa większej części języka i jego liczby będą inne: miarodajny jest raport twojego własnego modelu, a widzisz go, zanim cokolwiek zostanie zaimportowane. Modele testowe Holarch, zapisane w formach XMI kilku narzędzi SysML v1, także konwertują się do tekstu, który przechodzi kontrolę bez problemów, a ten sam model za każdym razem daje ten sam tekst.

Pytania

Co traci się przy konwersji?

Diagramy i ich układ nie są konwertowane: utwórz w projekcie SysML v2 widoki dla ważnych diagramów. Elementy, dla których SysML v2 nie ma odpowiednika, są pomijane, np. rozszerzenia przypadków użycia, węzły końcowe przepływu i partycje aktywności, podobnie jak relacje do elementów bez nazwy, ponieważ tekst SysML v2 odwołuje się do elementów po nazwie (przed eksportem nadaj nazwy elementom, do których prowadzą powiązania). Elementy przybliżone są zachowane w zmienionej postaci; to w nich znaczenie może różnić się od modelu v1, więc przejrzyj je najpierw. Raport wymienia każdy z nich wraz z przyczyną.

Czy przekonwertowany model jest gotowy do użycia?

Przechodzi kontrolę bez problemów i działa z nim każda strona projektu SysML v2, ale traktuj go jako punkt wyjścia. Niektóre różnice między językami wymagają decyzji modelarskiej, a nie tylko tłumaczenia. Co obsługują projekty SysML v2 i jakie są znane luki: Pokrycie języka SysML v2.

Jak duży model mogę przekonwertować?

Jeden plik o rozmiarze najwyżej 64 MB, z najwyżej 250 000 elementów zagnieżdżonych najwyżej na 512 poziomach i najwyżej 8 MB przekonwertowanego tekstu. Większy model eksportuj po jednym pakiecie. Do przekonwertowanego modelu stosuje się limit elementów na projekt w twoim planie: 1000 w Free, 10 000 w Individual i 50 000 w Team. Zobacz, co liczy się jako element. Dla modelu powyżej 10 000 elementów poproś o ocenę planu Team.

Czy mogę dalej pracować w narzędziu SysML v1?

Tak. Holarch odczytuje eksport i nigdy nie zmienia modelu v1. Gdy model v1 się zmieni, wyeksportuj go ponownie i zaimportuj nowy plik do tego samego projektu: elementy przejmują identyfikatory z pliku XMI, więc aktualizują się na miejscu, także po zmianie nazwy lub przeniesieniu. Elementy o tej samej nazwie w jednym miejscu otrzymują nową nazwę z przyrostkiem, np. _2, a raport wymienia każdą taką zmianę.

Dokąd trafia mój plik?

Holarch odczytuje i konwertuje plik XMI lub .mdzip w przeglądarce; sam plik nie jest przesyłany. Na app.holarch.app przekonwertowany tekst SysML v2 jest wysyłany do Holarch w celu przygotowania podglądu i zapisywany w projekcie dopiero przy imporcie. Hostowana usługa nie przyjmuje materiałów CUI ani objętych kontrolą eksportu; do nich Holarch działa we własnym środowisku (Enterprise). Więcej w sekcji Bezpieczeństwo.

A co z wymaganiami przechowywanymi w narzędziu do zarządzania wymaganiami?

Przenosi się je jako ReqIF (.reqif, .reqifz), standardowy format wymiany wymagań. Holarch importuje i eksportuje ReqIF w projektach LML i SysML v2. W projekcie SysML v2 plik ReqIF staje się wymaganiami, definicjami wymagań i pakietami, z raportem tego, co przekonwertowano, a wymagania eksportują się z powrotem z oryginalnymi identyfikatorami. W naszej wymianie w obie strony demo CubeSat EO-1 z Holarch do ReqIF i z powrotem wszystkie 407 elementów i 979 wartości atrybutów wróciło bez zmian. ReqIF w projektach LML · ReqIF w projektach SysML v2

Ile kosztuje konwerter?

Nic dodatkowo: jest częścią każdego planu, także Free. Plany różnią się liczbą elementów na projekt i tym, co obejmują poza modelowaniem; zobacz Cennik.

Budujesz migrację we własnym narzędziu?

Konwerter jest częścią Holarch Language Engine, silnika projektów SysML v2 w Holarch, i jest licencjonowany dostawcom narzędzi i integratorom jako dodatek migracyjny. To ten sam konwerter, który działa w Holarch.

  • Twój produkt odczytuje plik XMI, a silnik konwertuje: wyślij model v1 jako JSON w udokumentowanej neutralnej postaci i otrzymaj tekst SysML v2, jego kontrolę wykonaną przez silnik oraz raport każdego elementu ze stabilnym kodem przyczyny i nazwą w SysML v2, którą otrzymał, jako JSON.
  • Działa tam, gdzie twój produkt: w przeglądarce jako WebAssembly w Web Workerze lub na twoim serwerze przez Node.js albo rozszerzenie Python z dodatkiem do użycia serwerowego.
  • Powtarzalny i ograniczony: ten sam model za każdym razem daje ten sam tekst; modele do 250 000 elementów, a większy otrzymuje odpowiedź z błędem, nigdy zawieszenie.
  • Włączany tokenem licencyjnym, bez ponownego budowania i bez zmian w kodzie. Bezpłatna 60-dniowa ocena działa na twoim własnym komputerze z dokumentacją i przykładami.

Żądanie i odpowiedź

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

Żądanie v1_convert w dokumentacji API silnika. Silnik oferuje też symulację i użycie serwerowe jako dodatki.

Zobacz swój model w SysML v2.

Przekonwertuj go, przeczytaj raport i zaimportuj dopiero wtedy, gdy wynik cię zadowala.

Nowe konta przy pierwszym logowaniu rozpoczynają 30-dniowy okres próbny Individual: 10 000 elementów na projekt, bez karty, z powrotem na Free po jego zakończeniu. Masz już konto? Rozpocznij okres próbny w Ustawienia konta → Plan i rozliczenia.