Holarch

SysML v2

SysML v1-Modelle importieren

Konvertieren Sie ein SysML 1.x-Modell aus Cameo, MagicDraw, Enterprise Architect, Rhapsody oder Papyrus in SysML v2-Text, prüfen Sie, was seine Form geändert hat, und importieren Sie es in ein SysML v2-Projekt.

So gehen Sie vor →

Auf dieser Seite
  1. Überblick
  2. Konzepte
    1. Konvertiert, angenähert und ausgelassen
    2. Das Package SysMLv1Library
    3. Opaque Bodies werden zu textuellen Repräsentationen
  3. So setzen Sie es ein
    1. Wann und warum
    2. Ein SysML v1-Modell in ein Projekt importieren
    3. Eine neuere Version desselben Modells importieren
    4. Den Bericht und den Text behalten
    5. Das Modell aus Ihrem SysML v1-Werkzeug exportieren
  4. Durchgearbeitetes Beispiel: das Modell CubeSat EO-1
  5. Tipps und häufige Fehler
  6. Was konvertiert wird
  7. Grenzen
  8. Meldungen
  9. Verwandte Seiten

Überblick

Sie können ein SysML-1.x-Modell in ein SysML v2-Projekt übernehmen. Holarch liest die XMI-Datei des Modells, konvertiert sie in SysML v2-Text, prüft den Text und zeigt einen Konvertierungsbericht, bevor sich etwas ändert.

  • Input: ein SysML-1.x-Modell als XMI (.xmi, .uml, .xml) oder ein Cameo- oder MagicDraw-Projekt (.mdzip).
  • Ausgabe: SysML v2-Text in Ihrem Projekt (ein einziges Rückgängigmachen nimmt alles zurück) oder ein neues SysML v2-Projekt.
  • Bericht: jedes v1-Element mit seinem Ergebnis: Konvertiert, Angenähert oder Ausgelassen, und warum.

Die Konvertierung folgt der Transformation von SysML v1 nach SysML v2 in der Spezifikation OMG SysML 2.0, soweit ein als XMI ausgetauschtes Modell genug Details dafür enthält.

Konzepte

Konvertiert, angenähert und ausgelassen

Jedes Element des v1-Modells erhält ein Ergebnis:

  • Konvertiert: Das Element hat eine direkte Entsprechung in SysML v2, etwa ein Block, der zu einer part def wird.
  • Angenähert: Das Element wird in veränderter Form behalten. Zum Beispiel wird ein durch einen Interface Block typisierter Full Port zu einem Port, und eine Transition durch einen Choice-Pseudozustand wird zu einer Transition pro Pfad.
  • Ausgelassen: SysML v2 hat keine Entsprechung, oder das Element verweist auf etwas, das nicht in der Datei ist. Beispiele sind Flow Final Nodes, Activity Partitions, Use-Case-Extensions und Instance Specifications.

Der Bericht nennt für jedes angenäherte und ausgelassene Element den Grund in Worten.

Das Package SysMLv1Library

Einige SysML v1-Eigenschaften haben kein SysML v2-Schlüsselwort, etwa isEncapsulated eines Blocks oder eine Refine-Beziehung. Der Konverter behält sie als Metadaten aus dem Package SysMLv1Library, zum Beispiel @SysMLv1Library::RefineData { isRefine = true; }. Das Package ist Teil der Bibliothek von Holarch, sodass diese Namen in jedem SysML v2-Projekt aufgelöst werden.

Opaque Bodies werden zu textuellen Repräsentationen

Opaque Behaviors, Opaque Actions, Guards und Constraint Specifications tragen Text in einer Sprache wie OCL oder Englisch. Der Konverter behält jeden Body als textuelle Repräsentation: language "OCL" /* … */. Bodies in SysML oder KerML werden wie der übrige Text geprüft. Siehe Textuelle Repräsentationen.

So setzen Sie es ein

Wann und warum

Verwenden Sie den Import, wenn ein Team ein bestehendes SysML-1.x-Modell nach SysML v2 überführt oder Teile davon wiederverwenden möchte. Der konvertierte Text ist ein Ausgangspunkt: Der Bericht sagt Ihnen, was Sie von Hand prüfen sollten.

Ein SysML v1-Modell in ein Projekt importieren

  1. Öffnen Sie ein SysML v2-Projekt und klicken Sie auf Modell → Import und Export.
  2. Wählen Sie unter Importieren In dieses Projekt oder In ein neues SysML-v2-Projekt.
  3. Legen Sie die Datei .xmi, .uml, .xml oder .mdzip auf dem Feld ab, oder klicken Sie auf das Feld, um sie auszuwählen. Sie sehen eine Fortschrittskarte mit den Phasen XMI-Datei wird gelesen…, Konvertierung nach SysML v2… und Ergebnis wird geprüft….
  4. Lesen Sie Konvertierung aus SysML v1 oben in der Vorschau. Es nennt die Anzahl der konvertierten, angenäherten und ausgelassenen Elemente und ob der SysML v2-Text ohne Probleme geprüft wird.
  5. Verwenden Sie Anzeigen, um die angenäherten und ausgelassenen Elemente, nur eine dieser Gruppen oder alle Elemente aufzulisten. Jede Zeile nennt das Element, seine SysML v1-Art, das Ergebnis mit dem SysML v2-Schlüsselwort und dem qualifizierten Namen sowie Warum.
  6. Öffnen Sie SysML-v2-Text anzeigen, um das Ergebnis vor dem Import zu lesen.
  7. Entfernen Sie in der Tabelle unten die Häkchen bei allen Packages, die Sie nicht möchten, und klicken Sie dann auf N Packages importieren (oder Projekt erstellen). Das Modell wird importiert, und ein einziges Rückgängigmachen nimmt alles zurück. Rückgängig entfernt es wieder.

Eine neuere Version desselben Modells importieren

Wenn sich das SysML v1-Modell ändert, exportieren Sie es erneut und importieren Sie die neue Datei in dasselbe Projekt (In dieses Projekt). Jedes konvertierte Element übernimmt seine ID aus der ID des Elements in der XMI-Datei (xmi:id), sodass der Import die Elemente an Ort und Stelle aktualisiert: Ein im SysML v1-Werkzeug umbenanntes oder in ein anderes Package verschobenes Element bleibt dasselbe Element, mit seinen Diagrammlayouts, Kommentaren, Verknüpfungen und seinem Verlauf. Der Bericht sagt, wie viele Elemente ihre IDs aus dem SysML v1-Modell übernehmen. Elemente ohne Namen (Connectors, Successions) werden über ihre Stelle im Modell abgeglichen.

Ein Projekt, das aus einem SysML v1-Modell importiert wurde, bevor Holarch IDs aus der XMI-Datei ableitete, behält seine IDs: Ein neuerer Export aktualisiert seine Elemente über den Namen, und im SysML v1-Modell neue Elemente übernehmen ihre IDs daraus.

Den Bericht und den Text behalten

  • Klicken Sie auf Bericht herunterladen, um eine CSV-Datei mit jedem Element, seinem Ergebnis, seinem SysML v2-Pfad und dem Grund zu erhalten.
  • Klicken Sie auf SysML-v2-Text herunterladen, um die konvertierte .sysml-Datei zu erhalten.

Das Modell aus Ihrem SysML v1-Werkzeug exportieren

  • Cameo Systems Modeler und MagicDraw: Importieren Sie das Projekt .mdzip direkt, oder verwenden Sie File → Export To → Eclipse UML2 (v5.x) XMI File und importieren Sie die Datei .xmi.
  • Enterprise Architect: Wählen Sie das Package aus, wählen Sie Publish → Export XML, wählen Sie XMI 2.1 und importieren Sie die Datei .xml. Enterprise-Architect-Projektdateien (.eap, .qea) können nicht direkt gelesen werden.
  • IBM Rhapsody: Exportieren Sie das Modell mit dem XMI-Toolkit (XMI 2.x) und importieren Sie die Datei.
  • Eclipse Papyrus: Importieren Sie die Datei .uml des Modells.

Durchgearbeitetes Beispiel: das Modell CubeSat EO-1

Die Demo CubeSat EO-1 ist ein LML-Projekt. Ihr SysML v1-Export ergibt ein realistisches Testmodell.

  1. Öffnen Sie die Demo CubeSat EO-1 und exportieren Sie sie als UML/SysML-XMI im Format OMG XMI 2.5.1 (siehe Ein UML/SysML-Modell exportieren (XMI)).
  2. Öffnen Sie ein SysML v2-Projekt, klicken Sie auf Modell → Import und Export, wählen Sie In ein neues SysML-v2-Projekt und legen Sie die Datei .xmi ab. Der Bericht lautet: 1.042 Elemente, 1.007 konvertiert, 32 angenähert, 3 ausgelassen. Der SysML v2-Text wird ohne Probleme geprüft.
  3. Stellen Sie Anzeigen auf Ausgelassen. Die drei Zeilen sind eine Use-Case-Extension, die SysML v2 nicht hat, und zwei Trace-Beziehungen zu Elementen ohne Namen, auf die SysML v2-Text nicht verweisen kann.
  4. Klicken Sie auf Projekt erstellen. Das neue SysML v2-Projekt öffnet sich im Editor mit der Struktur, den Funktionen, Anforderungen und Traces des Satelliten.

Tipps und häufige Fehler

  • Importieren Sie jeweils eine XMI-Datei, ohne andere Dateien. Importieren Sie jeweils nur eine SysML-v1-XMI-Datei, ohne andere Dateien.
  • Benennen Sie die Elemente, zu denen Sie tracen. Beziehungen zu unbenannten Elementen werden ausgelassen, weil SysML v2-Text über Namen auf Elemente verweist.
  • Neu importieren, nicht neu erstellen. Importieren Sie einen neueren Export in dasselbe Projekt statt in ein neues: Elemente behalten ihre IDs nur innerhalb des Projekts, das sie hat.
  • Prüfen Sie zuerst die Annäherungen. Das sind die Stellen, an denen die Bedeutung vom v1-Modell abweichen kann, etwa durch Blöcke typisierte Ports oder Connector-Enden innerhalb von Parts.
  • Elemente mit demselben Namen an einer Stelle werden mit einem Suffix wie _2 umbenannt. Der Bericht führt jede Umbenennung auf.
  • Anforderungen, die in einem Anforderungswerkzeug gepflegt werden (DOORS, Polarion, Jama, codebeamer), kommen als ReqIF, nicht als XMI. Importieren Sie die Datei .reqif auf derselben Seite: Sie wird zu SysML v2-Anforderungen mit derselben Art von Bericht (ReqIF-Anforderungen importieren und exportieren).

Was konvertiert wird

SysML v1SysML v2
Modell, Packagepackage
Block, Actorpart def
Value Type, Data Type, Enumerationattribute def, enum def (Value Types mit einer bekannten SI-Einheit spezialisieren die ISQ-Größe)
Signalitem def
Interface Blockport def
Part, Reference und Value Propertiespart, ref part, attribute, mit Multiplizitäten und Standardwerten
Proxy Port, Flow Propertyport, in/out item oder attribute
Full Portpart mit @SysMLv1Library::PortData
Connector, Binding Connector, Item Flowconnect, bind, flow
Generalisierung:>
Activity, Call Behavior Action, Pinsaction def, action, Parameter
Control Flows und Object Flows, GuardsSuccessions mit if-Guards und else, Flows zwischen Parametern
Initial, Final, Decision, Merge, Fork, Joinstart, done, decide, merge, fork, join
State Machine, States, Regionsstate def, state, parallele States
Transitions, Signal- und Time-Triggertransition mit accept, accept after, Guards und Effects
Interactionoccurrence def mit Lifelines und Messages
Use Case, Subject, Includeuse case def, subject, include
Requirement (ID und Text)requirement <'id'> Name { doc /* text */ }
Satisfy, Verify, Derive Requirementsatisfy, verify in einem Verification Objective, Derivation-Connection
Refine, Tracedependency mit SysMLv1Library-Metadaten
Allocate, Dependencyallocate, dependency
Constraint Block, Constraintconstraint def, assert constraint
Stereotypen und Tagged Valuesmetadata def pro Stereotyp, mit seinen Tags angewendet
Comment, Documentationdoc, comment

Grenzen

  • Eine Datei von höchstens 64 MB.
  • Höchstens 250.000 Elemente, höchstens 512 Ebenen tief verschachtelt. Ein tiefer verschachteltes Modell oder eines mit einem Ownership-Zyklus wird nicht importiert.
  • Im konvertierten Modell werden Elemente, die mehr als 128 Ebenen tief verschachtelt sind, mit dem Grund nesting ausgelassen.
  • Der konvertierte Text ist höchstens 8 MB groß.
  • Diagramme und ihr Layout werden nicht konvertiert. Erstellen Sie Ansichten im SysML v2-Projekt.

Meldungen

NachrichtWas zu tun ist
Importieren Sie jeweils eine SysML v1-XMI-Datei, ohne andere Dateien.Importieren Sie die XMI-Datei allein.
<file> enthält keine UML- oder SysML-Elemente. Exportieren Sie das Modell als XMI 2.x und importieren Sie es erneut.Exportieren Sie das Modell erneut als XMI 2.x.
In <file> wurde kein UML-Modell gefunden. Exportieren Sie das Modell in Cameo oder MagicDraw als Eclipse UML2 XMI und importieren Sie die .xmi-Datei.Exportieren Sie das Projekt als XMI.
Das SysML v1-Modell hat mehr als 250.000 Elemente. Exportieren Sie einen kleineren Teil des Modells.Exportieren Sie jeweils ein Package.
Der konvertierte SysML v2-Text wäre größer als 8 MB. Exportieren Sie einen kleineren Teil des Modells.Exportieren Sie jeweils ein Package.

SysML® und OMG® sind eingetragene Marken der Object Management Group, Inc. in den Vereinigten Staaten und anderen Ländern.