SysML v2
Import modeli SysML v1
Przekonwertuj model SysML 1.x z Cameo, MagicDraw, Enterprise Architect, Rhapsody lub Papyrus na tekst SysML v2, sprawdź, co zmieniło postać, i zaimportuj go do projektu SysML v2.
Na tej stronie
Przegląd
Model SysML 1.x można przenieść do projektu SysML v2. Holarch odczytuje plik XMI modelu, konwertuje go na tekst SysML v2, sprawdza tekst i pokazuje raport konwersji, zanim cokolwiek się zmieni.
- Wejście: model SysML 1.x jako XMI (
.xmi,.uml,.xml) lub projekt Cameo albo MagicDraw (.mdzip). - Wyjście: tekst SysML v2 w projekcie (jedno polecenie Cofnij wycofuje całość) lub nowy projekt SysML v2.
- Raport: każdy element v1 z wynikiem: Przekonwertowano, Przybliżone lub Pominięte, wraz z przyczyną.
Konwersja odpowiada transformacji z SysML v1 do SysML v2 opisanej w specyfikacji OMG SysML 2.0, w zakresie, w jakim model wymieniany jako XMI zawiera wystarczająco szczegółów.
Pojęcia
Przekonwertowane, przybliżone i pominięte
Każdy element modelu v1 otrzymuje jeden wynik:
- Skonwertowany: element ma bezpośredni odpowiednik w SysML v2, na przykład blok, który staje się
part def. - Przybliżone: element jest zachowany w zmienionej postaci. Na przykład pełny port typowany przez blok interfejsu staje się portem, a przejście przez pseudostan wyboru staje się jednym przejściem na każdą ścieżkę.
- 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 specyfikacje instancji.
Raport podaje słowami przyczynę dla każdego przybliżonego i pominiętego elementu.
Pakiet SysMLv1Library
Niektóre właściwości SysML v1 nie mają słowa kluczowego SysML v2, np. isEncapsulated bloku lub relacja refine. Konwerter zachowuje je jako metadane z pakietu SysMLv1Library, na przykład @SysMLv1Library::RefineData { isRefine = true; }. Pakiet jest częścią biblioteki Holarch, więc te nazwy są rozwiązywane w każdym projekcie SysML v2.
Treści nieprzezroczyste stają się reprezentacjami tekstowymi
Nieprzezroczyste zachowania, nieprzezroczyste akcje, warunki dozoru i specyfikacje ograniczeń zawierają tekst w języku takim jak OCL lub angielski. Konwerter zachowuje każdą treść jako reprezentację tekstową: language "OCL" /* … */. Treści w SysML lub KerML są sprawdzane jak reszta tekstu. Zobacz Reprezentacje tekstowe.
Jak z niego korzystać
Kiedy i dlaczego
Używaj importu, gdy zespół przenosi istniejący model SysML 1.x do SysML v2 lub chce ponownie wykorzystać jego części. Przekonwertowany tekst jest punktem wyjścia: raport wskazuje, co trzeba przejrzeć ręcznie.
Import modelu SysML v1 do projektu
- Otwórz projekt SysML v2 i kliknij Model → Import i eksport.
- W sekcji Importuj wybierz Do tego projektu lub Do nowego projektu SysML v2.
- Upuść plik
.xmi,.uml,.xmllub.mdzipna pole albo kliknij pole, aby go wybrać. Pojawi się karta postępu z etapami Odczyt pliku XMI…, Konwersja na SysML v2… i Sprawdzanie wyniku…. - Przeczytaj Konwersja z SysML v1 na górze podglądu. Podaje liczbę elementów przekonwertowanych, przybliżonych i pominiętych oraz to, czy tekst SysML v2 przechodzi kontrole bez problemów.
- Użyj Pokaż, aby wyświetlić elementy przybliżone i pominięte, tylko jedną z tych grup lub wszystkie elementy. Każdy wiersz podaje element, jego rodzaj w SysML v1, wynik ze słowem kluczowym SysML v2 i nazwą kwalifikowaną oraz Dlaczego.
- Otwórz Pokaż tekst SysML v2, aby przeczytać wynik przed importem.
- Odznacz w tabeli poniżej pakiety, których nie chcesz, a następnie kliknij Importuj N pakietów (lub Utwórz projekt). Model zostaje zaimportowany, a jedno polecenie Cofnij wycofuje całość. Cofnij ponownie go usuwa.
Import nowszej wersji tego samego modelu
Gdy model SysML v1 się zmieni, wyeksportuj go ponownie i zaimportuj nowy plik do tego samego projektu (Do tego projektu). Każdy przekonwertowany element bierze identyfikator z identyfikatora elementu w pliku XMI (xmi:id), więc import aktualizuje elementy w miejscu: element, którego nazwę zmieniono lub który przeniesiono do innego pakietu w narzędziu SysML v1, pozostaje tym samym elementem, z układami diagramów, komentarzami, powiązaniami i historią. Raport podaje, ile elementów bierze identyfikatory z modelu SysML v1. Elementy bez nazwy (łączniki, następstwa) są dopasowywane według miejsca w modelu.
Projekt zaimportowany z modelu SysML v1, zanim Holarch zaczął wyprowadzać identyfikatory z pliku XMI, zachowuje swoje identyfikatory: nowszy eksport aktualizuje jego elementy według nazwy, a elementy nowe w modelu SysML v1 biorą identyfikatory z niego.
Zachowanie raportu i tekstu
- Kliknij Pobierz raport, aby otrzymać plik CSV z każdym elementem, jego wynikiem, ścieżką SysML v2 i przyczyną.
- Kliknij Pobierz tekst SysML v2, aby otrzymać przekonwertowany plik
.sysml.
Eksport modelu z narzędzia SysML v1
- Cameo Systems Modeler i MagicDraw: zaimportuj bezpośrednio projekt
.mdziplub użyj File → Export To → Eclipse UML2 (v5.x) XMI File i zaimportuj plik.xmi. - Enterprise Architect: zaznacz pakiet, wybierz Publish → Export XML, wybierz XMI 2.1 i zaimportuj plik
.xml. Plików projektów Enterprise Architect (.eap,.qea) nie można odczytać bezpośrednio. - IBM Rhapsody: wyeksportuj model przy użyciu zestawu narzędzi XMI (XMI 2.x) i zaimportuj plik.
- Eclipse Papyrus: zaimportuj plik
.umlmodelu.
Przykład: model CubeSat EO-1
Demo CubeSat EO-1 jest projektem LML. Jego eksport SysML v1 tworzy realistyczny model testowy.
- Otwórz demo CubeSat EO-1 i wyeksportuj je jako XMI UML/SysML w formacie OMG XMI 2.5.1 (zobacz Eksport modelu UML/SysML (XMI)).
- Otwórz projekt SysML v2, kliknij Model → Import i eksport, wybierz Do nowego projektu SysML v2 i upuść plik
.xmi. Raport podaje: 1042 elementy, 1007 przekonwertowanych, 32 przybliżone, 3 pominięte. Tekst SysML v2 przechodzi kontrole bez problemów. - Ustaw Pokaż na Pominięte. Trzy wiersze to rozszerzenie przypadku użycia, którego SysML v2 nie ma, oraz dwie relacje trace do elementów bez nazwy, do których tekst SysML v2 nie może się odwołać.
- Kliknij Utwórz projekt. Nowy projekt SysML v2 otwiera się w Edytorze ze strukturą, funkcjami, wymaganiami i śladami satelity.
Wskazówki i typowe błędy
- Importuj jeden plik XMI naraz, bez innych plików. Importuj jeden plik XMI SysML v1 naraz, bez innych plików.
- Nadaj nazwy elementom, do których prowadzą ślady. Relacje do nienazwanych elementów są pomijane, ponieważ tekst SysML v2 odwołuje się do elementów po nazwie.
- Importuj ponownie, nie twórz od nowa. Nowszy eksport importuj do tego samego projektu, a nie do nowego: elementy zachowują identyfikatory tylko w projekcie, który je zawiera.
- Najpierw sprawdź przybliżenia. To miejsca, w których znaczenie może różnić się od modelu v1, np. porty typowane przez bloki lub końce łączników wewnątrz części.
- Elementy o tej samej nazwie w jednym miejscu otrzymują nową nazwę z przyrostkiem takim jak
_2. Raport wymienia każdą zmianę nazwy. - Wymagania przechowywane w narzędziu do wymagań (DOORS, Polarion, Jama, codebeamer) przychodzą jako ReqIF, a nie XMI. Zaimportuj plik
.reqifna tej samej stronie: stanie się wymaganiami SysML v2 z raportem tego samego rodzaju (Import i eksport wymagań ReqIF).
Co jest konwertowane
| SysML v1 | SysML v2 |
|---|---|
| Model, pakiet | package |
| Blok, aktor | part def |
| Typ wartości, typ danych, wyliczenie | attribute def, enum def (typy wartości ze znaną jednostką SI specjalizują wielkość ISQ) |
| Sygnał | item def |
| Blok interfejsu | port def |
| Właściwości części, referencji i wartości | part, ref part, attribute, z krotnościami i wartościami domyślnymi |
| Port pośredniczący, właściwość przepływu | port, in/out item lub attribute |
| Pełny port | part z @SysMLv1Library::PortData |
| Łącznik, łącznik wiążący, przepływ elementu | connect, bind, flow |
| Generalizacja | :> |
| Aktywność, akcja wywołania zachowania, piny | action def, action, parametry |
| Przepływy sterowania i obiektów, warunki dozoru | następstwa z warunkami if i else, przepływy między parametrami |
| Początkowy, końcowy, decyzja, scalenie, rozwidlenie, złączenie | start, done, decide, merge, fork, join |
| Maszyna stanów, stany, regiony | state def, state, stany równoległe |
| Przejścia, wyzwalacze sygnałowe i czasowe | transition z accept, accept after, warunkami dozoru i efektami |
| Interakcja | occurrence def z liniami życia i komunikatami |
| Przypadek użycia, podmiot, include | use case def, subject, include |
| Wymaganie (identyfikator i tekst) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify w celu weryfikacji, połączenie wyprowadzenia |
| Refine, trace | dependency z metadanymi SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Blok ograniczeń, ograniczenie | constraint def, assert constraint |
| Stereotypy i wartości znaczników | metadata def dla każdego stereotypu, zastosowana z jego znacznikami |
| Komentarz, dokumentacja | doc, comment |
Limity
- Jeden plik o rozmiarze najwyżej 64 MB.
- Najwyżej 250 000 elementów, zagnieżdżonych najwyżej na 512 poziomach. Model zagnieżdżony głębiej lub z cyklem własności nie jest importowany.
- W przekonwertowanym modelu elementy zagnieżdżone głębiej niż na 128 poziomach są pomijane z przyczyną nesting.
- Przekonwertowany tekst ma najwyżej 8 MB.
- Diagramy i ich układ nie są konwertowane. Utwórz widoki w projekcie SysML v2.
Komunikaty
| Wiadomość | Co zrobić |
|---|---|
| Importuj jeden plik XMI SysML v1 naraz, bez innych plików. | Zaimportuj plik XMI osobno. |
| <file> nie zawiera elementów UML ani SysML. Wyeksportuj model jako XMI 2.x i zaimportuj go ponownie. | Wyeksportuj model ponownie jako XMI 2.x. |
| Nie znaleziono modelu UML w <file>. W Cameo lub MagicDraw wyeksportuj model jako Eclipse UML2 XMI i zaimportuj plik .xmi. | Wyeksportuj projekt jako XMI. |
| Model SysML v1 ma więcej niż 250 000 elementów. Wyeksportuj mniejszą część modelu. | Eksportuj po jednym pakiecie. |
| Przekonwertowany tekst SysML v2 byłby większy niż 8 MB. Wyeksportuj mniejszą część modelu. | Eksportuj po jednym pakiecie. |
Powiązane strony
- Wymiana modeli SysML v2
- Import i eksport wymagań ReqIF: wymagania z DOORS, Polarion i innych narzędzi do wymagań.
- Notacja tekstowa SysML v2
- Konwersja między LML a SysML v2
SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.