Holarch

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.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Przekonwertowane, przybliżone i pominięte
    2. Pakiet SysMLv1Library
    3. Treści nieprzezroczyste stają się reprezentacjami tekstowymi
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Import modelu SysML v1 do projektu
    3. Import nowszej wersji tego samego modelu
    4. Zachowanie raportu i tekstu
    5. Eksport modelu z narzędzia SysML v1
  4. Przykład: model CubeSat EO-1
  5. Wskazówki i typowe błędy
  6. Co jest konwertowane
  7. Limity
  8. Komunikaty
  9. Powiązane strony

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

  1. Otwórz projekt SysML v2 i kliknij Model → Import i eksport.
  2. W sekcji Importuj wybierz Do tego projektu lub Do nowego projektu SysML v2.
  3. Upuść plik .xmi, .uml, .xml lub .mdzip na pole albo kliknij pole, aby go wybrać. Pojawi się karta postępu z etapami Odczyt pliku XMI…, Konwersja na SysML v2… i Sprawdzanie wyniku….
  4. 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.
  5. 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.
  6. Otwórz Pokaż tekst SysML v2, aby przeczytać wynik przed importem.
  7. 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 .mdzip lub 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 .uml modelu.

Przykład: model CubeSat EO-1

Demo CubeSat EO-1 jest projektem LML. Jego eksport SysML v1 tworzy realistyczny model testowy.

  1. 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)).
  2. 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.
  3. 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ć.
  4. 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 .reqif na tej samej stronie: stanie się wymaganiami SysML v2 z raportem tego samego rodzaju (Import i eksport wymagań ReqIF).

Co jest konwertowane

SysML v1SysML v2
Model, pakietpackage
Blok, aktorpart def
Typ wartości, typ danych, wyliczenieattribute def, enum def (typy wartości ze znaną jednostką SI specjalizują wielkość ISQ)
Sygnałitem def
Blok interfejsuport def
Właściwości części, referencji i wartościpart, ref part, attribute, z krotnościami i wartościami domyślnymi
Port pośredniczący, właściwość przepływuport, in/out item lub attribute
Pełny portpart z @SysMLv1Library::PortData
Łącznik, łącznik wiążący, przepływ elementuconnect, bind, flow
Generalizacja:>
Aktywność, akcja wywołania zachowania, pinyaction def, action, parametry
Przepływy sterowania i obiektów, warunki dozorunastępstwa z warunkami if i else, przepływy między parametrami
Początkowy, końcowy, decyzja, scalenie, rozwidlenie, złączeniestart, done, decide, merge, fork, join
Maszyna stanów, stany, regionystate def, state, stany równoległe
Przejścia, wyzwalacze sygnałowe i czasowetransition z accept, accept after, warunkami dozoru i efektami
Interakcjaoccurrence def z liniami życia i komunikatami
Przypadek użycia, podmiot, includeuse case def, subject, include
Wymaganie (identyfikator i tekst)requirement <'id'> Name { doc /* text */ }
Satisfy, verify, derive requirementsatisfy, verify w celu weryfikacji, połączenie wyprowadzenia
Refine, tracedependency z metadanymi SysMLv1Library
Allocate, dependencyallocate, dependency
Blok ograniczeń, ograniczenieconstraint def, assert constraint
Stereotypy i wartości znacznikówmetadata def dla każdego stereotypu, zastosowana z jego znacznikami
Komentarz, dokumentacjadoc, 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.

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