SysML v1 zu SysML v2
Bringen Sie Ihr SysML-v1-Modell nach SysML v2, ohne es neu zu zeichnen.
Legen Sie ein SysML-v1-Modell, gespeichert als XMI (.xmi, .xml, .uml) oder als .mdzip-Projektarchiv, in einem SysML-v2-Projekt ab. Holarch wandelt es in SysML-v2-Text um, prüft den Text und meldet jedes Element als umgewandelt, angenähert oder ausgelassen, mit dem Grund, bevor etwas importiert wird.
Der Konverter ist in jedem Plan enthalten, auch in Free. Neue Konten starten bei ihrer ersten Anmeldung eine 30-tägige Testphase von Individual: 10.000 Elemente pro Projekt, ohne Karte, danach zurück zu Free. Sie haben schon ein Konto? Testphase starten.
Nachweis: das CubeSat-Modell EO-1
| Ergebnis | Elemente |
|---|---|
| Umgewandelt | 1,007 |
| Angenähert | 32 |
| Ausgelassen | 3 |
| Gelesene Elemente | 1,042 |
| Probleme im SysML-v2-Text | 0 |
Der umgewandelte Text wird ohne Fehler und ohne Warnungen geprüft, und dasselbe Modell wird jedes Mal in denselben Text umgewandelt. Was angenähert und ausgelassen wurde
Ein SysML-v1-Modell importieren
Die XMI-Datei oder das .mdzip-Projekt eines SysML-v1-Modells in ein SysML-v2-Projekt importieren. Bevor etwas erstellt wird, listet ein Umwandlungsbericht jedes Element als umgewandelt, angenähert oder ausgelassen auf, mit dem Grund, und wird als CSV-Datei gespeichert. Das Beispiel ist das CubeSat-Modell EO-1: 1.042 Elemente, ohne Probleme importiert.
Was Sie vom Konverter erhalten
Ein SysML-v2-Modell, in dem Sie arbeiten können, und eine klare Liste dessen, was zu prüfen ist.
Kein Neuzeichnen
Blöcke werden zu part defs, Ports, Konnektoren und Item Flows werden übernommen, Anforderungen behalten ihre IDs und ihren Text, und satisfy-, verify- und allocate-Beziehungen bleiben nachverfolgt.
Ein Bericht zu jedem Element
Jedes Element des v1-Modells wird mit seiner v1-Art, seinem Ergebnis, dem SysML-v2-Namen, zu dem es wurde, und bei allem Angenäherten oder Ausgelassenen mit dem Grund in Worten aufgeführt. Filtern Sie ihn am Bildschirm oder laden Sie ihn als CSV herunter.
Geprüft, bevor Sie importieren
Dieselbe Engine, die im SysML-v2-Editor beim Tippen prüft, prüft den umgewandelten Text. Sie sehen zuerst das Ergebnis, den Text und den Bericht; der Import ist ein einziger Rückgängig-Schritt.
Erneut importieren, wenn sich das v1-Modell ändert
Elemente übernehmen ihre IDs aus den XMI-IDs des v1-Modells. Importieren Sie einen neueren Export in dasselbe Projekt, und die Elemente werden an Ort und Stelle aktualisiert, auch wenn sie umbenannt oder verschoben wurden, mit ihren Diagramm-Layouts, Kommentaren, Links und ihrem Verlauf.
Ein Modell, in dem Sie arbeiten können
Der Editor, die Ansichten, Anforderungen, Verifikation und die anderen Seiten eines SysML-v2-Projekts lesen das umgewandelte Modell wie jedes andere.
Ihr v1-Modell bleibt, wie es ist
Holarch liest einen Export davon und schreibt nie zurück, sodass das v1-Modell die Referenz bleibt, während das Team die SysML-v2-Version prüft.
So funktioniert es
- Datei ablegen. Klicken Sie in einem SysML-v2-Projekt auf Modell → Import und Export, wählen Sie In dieses Projekt oder In ein neues SysML-v2-Projekt und legen Sie die Datei
.mdzip,.xmi,.umloder.xmlab. Eine Fortschrittskarte zeigt Lesen, Umwandeln und Prüfen. - Bericht prüfen. Konvertierung aus SysML v1 nennt die Zahlen, sagt, ob der Text ohne Probleme geprüft wird, und listet die angenäherten und ausgelassenen Elemente mit dem Grund für jedes auf. SysML-v2-Text anzeigen öffnet das Ergebnis; laden Sie den Bericht oder die
.sysml-Datei herunter, um sie zu behalten. - Importieren. Deaktivieren Sie Pakete, die Sie nicht wollen, und importieren Sie. Ein Rückgängig entfernt den ganzen Import wieder.
Schritt für Schritt, mit den Exporteinstellungen jedes Werkzeugs: SysML-v1-Modelle importieren in den Docs, und der Migrationsleitfaden für die Planung des Umstiegs eines ganzen Programms.
Ein umgewandelter Block
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';
}Ausgabe des Konverters für einen gekapselten Block mit zwei Parts, einer Value Property in Watt, einem Konnektor zwischen Proxy Ports mit einem Item Flow und einer satisfy-Beziehung. Der Migrationsleitfaden zeigt das ganze kleine Modell vorher und nachher.
Was sie liest
- SysML v1 als XMI 2.x: UML 2.5 mit dem SysML-1.x-Profil.
.xmi: eine XMI-Datei..xml: XMI, gespeichert mit der Endung.xml..uml: eine XMI-Modelldatei..mdzip: ein gezipptes Projektarchiv, das das Modell als XMI enthält; Holarch liest das enthaltene XMI.- Andere Projektformate: Ein Werkzeug, das Modelle in einem eigenen Projektformat speichert, exportiert das Modell zuerst als XMI.
Eine Datei pro Import, bis zu 64 MB, 250.000 Elemente und 512 Verschachtelungsebenen.
Was herauskommt
- SysML-v2-Text im geöffneten Projekt oder in einem neuen SysML-v2-Projekt, als ein Rückgängig-Schritt importiert.
- Eine Prüfung des Texts, angezeigt vor dem Import.
- Ein Umwandlungsbericht zu jedem Element, am Bildschirm filterbar und als CSV herunterladbar.
- Die
.sysml-Datei zum Herunterladen, für die Prüfung oder für ein anderes SysML-v2-Werkzeug.
Die Umwandlung basiert auf der Transformation von SysML v1 zu SysML v2 in der OMG-Spezifikation SysML 2.0.
Umgewandelt, angenähert oder ausgelassen
Jedes Element des v1-Modells erhält eines von drei Ergebnissen, sodass Sie genau wissen, wo Sie hinsehen müssen.
Umgewandelt
Das Element hat eine direkte Entsprechung in SysML v2. Ein Block wird zu einer part def, ein Interface Block zu einer port def, eine Anforderung behält ihre ID und ihren Text.
Angenähert
Das Element wird in veränderter Form beibehalten. Ein Full Port, typisiert durch einen Interface Block, wird zu einem Port; eine Transition über eine Choice wird zu einer Transition pro Pfad; eine Einheit, die keine zugeordnete SI-Einheit ist, wird zu einer reellen Zahl mit der Einheit in ihrer Dokumentation.
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 Beziehungen zu unbenannten Elementen.
SysML-v1-Eigenschaften ohne SysML-v2-Schlüsselwort, etwa ein gekapselter Block, ein Full Port oder eine refine-Beziehung, werden als Metadaten aus dem Paket SysMLv1Library beibehalten, das Holarch in jedem SysML-v2-Projekt lädt. Ihre eigenen Stereotypen werden zu Metadatendefinitionen mit ihren Tagged Values, und Opaque Behaviors, Guards und Constraints behalten ihre Rümpfe als textuelle Repräsentationen, etwa language "OCL" /* … */.
Was wozu wird
Die wichtigsten Zuordnungen. Die Docs listen alle auf.
| SysML v1 | SysML v2 |
|---|---|
| Package | package, verschachtelt wie in v1 |
| Block, Actor | part def |
| Value Type, Enumeration | attribute def, enum def; ein Value Type mit bekannter SI-Einheit spezialisiert die ISQ-Größe |
| Part, Reference und Value Properties | part, ref part, attribute, mit Multiplizitäten und Standardwerten |
| Interface Block, Proxy Port, Flow Property | port def, port, gerichtetes item oder attribute |
| Connector, Binding Connector, Item Flow | connect, bind, flow |
| Activity, Actions, Control und Object Flows | action def, Actions, Successions mit Guards, Flows zwischen Parametern |
| State Machine, States, Transitions | state def, States, Transitions mit accept, Guards und Effekten |
| Requirement, satisfy, verify, derive | requirement mit ID und Text, satisfy, verify, Ableitungsverbindungen |
| Allocate, refine, trace | allocate; dependency mit SysMLv1Library-Metadaten |
| Use Case, Interaction, Constraint Block | use case def, occurrence def mit Messages, constraint def |
| Stereotypen und Tagged Values | metadata def pro Stereotyp, mit seinen Tags angewendet |
Ein durchgearbeitetes Beispiel: das CubeSat-Modell EO-1
Die CubeSat-Demo EO-1, als SysML-1.6-XMI exportiert und in ein neues SysML-v2-Projekt importiert: 1.042 Elemente gelesen, 1.007 umgewandelt, 32 angenähert, 3 ausgelassen. Der SysML-v2-Text wird ohne Fehler und ohne Warnungen geprüft, und das neue Projekt öffnet sich mit Struktur, Funktionen, Anforderungen und Traces des Satelliten. Jedes angenäherte und ausgelassene Element, nach Grund:
| Elemente | Ergebnis | Grund |
|---|---|---|
| 10 Konnektoren | Angenähert | Ein Konnektorende liegt innerhalb eines Parts; der Pfad dorthin wurde aus den Part-Typen ermittelt. |
| 8 Transitionen | Angenähert | 4 Change- und Time-Trigger, etwa when Undervoltage, werden als Dokumentation beibehalten; 4 Events ohne Signal, etwa Contact Start, erhielten eine Item-Definition mit diesem Namen. |
| 6 Item Flows | Angenähert | Der Name wird an derselben Stelle zweimal verwendet; der Flow wurde mit einem Suffix umbenannt. |
| 5 Value Types | Angenähert | Die Einheit (%, GB, Mbps, mNms, W/m^2) ist keine SI-Einheit, die Holarch zuordnet; der Value Type ist eine reelle Zahl mit der Einheit in seiner Dokumentation. |
| 2 Control Flows | Angenähert | Ein Zweig ohne Guard neben Zweigen mit Guard; er erhielt den Guard true. |
| 1 Endzustand | Angenähert | Ein Endzustand wurde zu einem einfachen Zustand. |
| 1 Use-Case-Extension | Ausgelassen | SysML v2 hat keine Use-Case-Extensions. |
| 2 trace-Beziehungen | Ausgelassen | Sie verweisen auf Elemente ohne Namen, auf die SysML-v2-Text nicht verweisen kann. |
Die EO-1-Datei ist der eigene SysML-1.6-Export von Holarch und verwendet daher den Teil von SysML v1, den Holarch schreibt. Ein Modell aus einem anderen Werkzeug nutzt meist mehr von der Sprache, und seine Zahlen werden abweichen: Maßgeblich ist der Bericht Ihres eigenen Modells, und Sie sehen ihn, bevor etwas importiert wird. Die Testmodelle von Holarch, geschrieben in den XMI-Formen mehrerer SysML-v1-Werkzeuge, werden ebenfalls in Text umgewandelt, der ohne Probleme geprüft wird, und dasselbe Modell wird jedes Mal in denselben Text umgewandelt.
Fragen
Was geht bei der Umwandlung verloren?
Diagramme und ihr Layout werden nicht umgewandelt: Erstellen Sie im SysML-v2-Projekt Ansichten für die Diagramme, auf die es ankommt. Elemente, für die SysML v2 keine Entsprechung hat, werden ausgelassen, etwa Use-Case-Extensions, Flow Final Nodes und Activity Partitions, ebenso Beziehungen zu unbenannten Elementen, weil SysML-v2-Text Elemente über ihren Namen anspricht (benennen Sie die Elemente, zu denen Sie nachverfolgen, vor dem Export). Angenäherte Elemente werden in veränderter Form beibehalten; an ihnen kann die Bedeutung vom v1-Modell abweichen, prüfen Sie sie also zuerst. Der Bericht nennt jedes einzelne davon, mit dem Grund.
Ist das umgewandelte Modell einsatzbereit?
Es wird ohne Probleme geprüft, und jede Seite eines SysML-v2-Projekts funktioniert damit, aber betrachten Sie es als Ausgangspunkt. Einige Unterschiede zwischen den Sprachen verdienen eine Modellierungsentscheidung, nicht nur eine Übersetzung. Was SysML-v2-Projekte unterstützen und die bekannten Lücken: Abdeckung der SysML-v2-Sprache.
Wie groß darf ein Modell für die Umwandlung sein?
Eine Datei von höchstens 64 MB, mit höchstens 250.000 Elementen in höchstens 512 Verschachtelungsebenen und höchstens 8 MB umgewandeltem Text. Exportieren Sie ein größeres Modell Paket für Paket. Die Elemente pro Projekt Ihres Plans gelten für das umgewandelte Modell: 1.000 in Free, 10.000 in Individual und 50.000 in Team. Siehe was als Element zählt. Für ein Modell mit mehr als 10.000 Elementen fragen Sie eine Team-Evaluierung an.
Kann ich in meinem SysML-v1-Werkzeug weiterarbeiten?
Ja. Holarch liest einen Export und ändert das v1-Modell nie. Wenn sich das v1-Modell ändert, exportieren Sie es erneut und importieren die neue Datei in dasselbe Projekt: Elemente übernehmen ihre IDs aus der XMI-Datei und werden daher an Ort und Stelle aktualisiert, auch nach einer Umbenennung oder Verschiebung. Gleichnamige Elemente an derselben Stelle werden mit einem Suffix wie _2 umbenannt, und der Bericht listet jede Umbenennung auf.
Wohin geht meine Datei?
Holarch liest und wandelt die XMI- oder .mdzip-Datei in Ihrem Browser um; die Datei selbst wird nicht hochgeladen. Auf app.holarch.app wird der umgewandelte SysML-v2-Text an Holarch gesendet, um die Vorschau vorzubereiten, und erst beim Import in Ihrem Projekt gespeichert. Der gehostete Dienst nimmt keine CUI und kein exportkontrolliertes Material an; dafür läuft Holarch in Ihrer eigenen Umgebung (Enterprise). Mehr unter Sicherheit.
Was ist mit Anforderungen, die in einem Anforderungsmanagement-Werkzeug liegen?
Sie kommen als ReqIF (.reqif, .reqifz), das Standard-Austauschformat für Anforderungen. Holarch importiert und exportiert ReqIF in LML- und SysML-v2-Projekten. In einem SysML-v2-Projekt wird eine ReqIF-Datei zu Anforderungen, Anforderungsdefinitionen und Paketen, mit einem Bericht über das Umgewandelte, und die Anforderungen werden mit ihren ursprünglichen Kennungen zurück exportiert. In unserem Rundlauf der CubeSat-Demo EO-1 von Holarch nach ReqIF und zurück kamen alle 407 Elemente und 979 Attributwerte unverändert zurück. ReqIF in LML-Projekten · ReqIF in SysML-v2-Projekten
Was kostet der Konverter?
Nichts zusätzlich: Er ist in jedem Plan enthalten, auch in Free. Die Pläne unterscheiden sich in den Elementen pro Projekt und darin, was sie über die Modellierung hinaus enthalten; siehe Preise.
Bauen Sie eine Migration in Ihr eigenes Werkzeug ein?
Der Konverter ist Teil der Holarch Language Engine, der Engine hinter den SysML-v2-Projekten von Holarch, und wird an Werkzeughersteller und Integratoren als Migrations-Add-on lizenziert. Es ist derselbe Konverter, der in Holarch läuft.
- Ihr Produkt liest die XMI-Datei, die Engine wandelt um: Senden Sie das v1-Modell als JSON in der dokumentierten neutralen Form und erhalten Sie als JSON den SysML-v2-Text, die Prüfung durch die Engine und den Bericht zu jedem Element mit einem stabilen Grundcode und dem SysML-v2-Namen, zu dem es wurde.
- Läuft dort, wo Ihr Produkt läuft: im Browser als WebAssembly in einem Web Worker oder auf Ihrem Server über Node.js oder die Python-Erweiterung mit Servernutzung.
- Wiederholbar und begrenzt: Dasselbe Modell wird jedes Mal in denselben Text umgewandelt; Modelle mit bis zu 250.000 Elementen, und ein größeres erhält eine Fehlerantwort, nie ein Hängenbleiben.
- Freigeschaltet über Ihr Lizenz-Token, ohne Neubau und ohne Codeänderung. Die kostenlose 60-tägige Evaluierung läuft auf Ihrem eigenen Computer, mit der Dokumentation und den Beispielen.
Eine Anfrage und ihre Antwort
// 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" }, … ] } }
Die v1_convert-Anfrage in der API-Referenz der Engine. Die Engine bietet außerdem Simulation und Servernutzung als Add-ons an.
Sehen Sie Ihr eigenes Modell in SysML v2.
Wandeln Sie es um, lesen Sie den Bericht und importieren Sie erst, wenn Sie zufrieden sind.
Neue Konten starten bei ihrer ersten Anmeldung eine 30-tägige Testphase von Individual: 10.000 Elemente pro Projekt, ohne Karte, danach zurück zu Free. Sie haben schon ein Konto? Starten Sie die Testphase unter Kontoeinstellungen → Plan & Abrechnung.