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
| Wynik | Elementy |
|---|---|
| Przekonwertowane | 1,007 |
| Przybliżone | 32 |
| Pominięte | 3 |
| Odczytane elementy | 1,042 |
| Problemy w tekście SysML v2 | 0 |
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.
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
- 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,.umllub.xml. Karta postępu pokazuje odczyt, konwersję i sprawdzanie. - 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ć. - 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
.sysmldo 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 v1 | SysML v2 |
|---|---|
| Pakiet | package, zagnieżdżone jak w v1 |
| Blok, aktor | part def |
| Typ wartości, wyliczenie | attribute def, enum def; typ wartości ze znaną jednostką SI specjalizuje wielkość ISQ |
| Właściwości części, referencji i wartości | part, ref part, attribute, z krotnościami i wartościami domyślnymi |
| Blok interfejsu, port proxy, właściwość przepływu | port def, port, skierowany item lub attribute |
| Łącznik, łącznik wiążący, przepływ elementu | connect, bind, flow |
| Aktywność, akcje, przepływy sterowania i obiektów | action def, akcje, następstwa z warunkami dozoru, przepływy między parametrami |
| Maszyna stanów, stany, przejścia | state def, stany, przejścia z accept, warunkami dozoru i efektami |
| Wymaganie, satisfy, verify, derive | requirement z identyfikatorem i tekstem, satisfy, verify, połączenia wyprowadzenia |
| Allocate, refine, trace | allocate; dependency z metadanymi SysMLv1Library |
| Przypadek użycia, interakcja, blok ograniczeń | use case def, occurrence def z komunikatami, constraint def |
| Stereotypy i wartości znaczników | metadata 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:
| Elementy | Wynik | Powód |
|---|---|---|
| 10 łączników | Przybliżone | Koniec łącznika leży wewnątrz części; ścieżkę do niego wyznaczono na podstawie typów części. |
| 8 przejść | Przybliżone | 4 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ów | Przybliżone | Nazwa występuje dwa razy w tym samym miejscu; przepływ otrzymał nową nazwę z przyrostkiem. |
| 5 typów wartości | Przybliżone | Jednostka (%, 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 sterowania | Przybliżone | Gałąź bez warunku dozoru obok gałęzi z warunkami; otrzymała warunek true. |
| 1 stan końcowy | Przybliżone | Stan końcowy stał się zwykłym stanem. |
| 1 rozszerzenie przypadku użycia | Pominięte | SysML v2 nie ma rozszerzeń przypadków użycia. |
| 2 relacje trace | Pominięte | Wskazują 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.