Holarch

SysML v2

SysML v2-Modelle austauschen

Importieren Sie .sysml-Dateien, ZIP-Archive und SysML v2-JSON mit einer Vorschau in ein SysML v2-Projekt und exportieren Sie das Modell oder ein Package als .sysml-Text oder SysML v2-JSON.

So gehen Sie vor →

Auf dieser Seite
  1. Überblick
  2. Konzepte
    1. Dateiformate
    2. IDs und Zuordnung
    3. Element-IDs im Text
    4. Ordner werden zu Packages
    5. Was die Vorschau vergleicht
  3. So setzen Sie es ein
    1. Wann und warum
    2. Dateien in dieses Projekt importieren
    3. Dateien in ein neues Projekt importieren
    4. Ein Package aus einer neuen Version aktualisieren
    5. Elemente im Text umbenennen und verschieben und ihre IDs behalten
    6. Große Importe im gehosteten Dienst
    7. Das Modell oder ein Package exportieren
    8. ReqIF-Anforderungen importieren und exportieren
    9. Aus einem Repository abrufen und in ein Repository übertragen
    10. Ausgeführtes Beispiel: die Hybrid-Car-Demo
    11. Tipps und bewährte Vorgehensweisen
    12. Häufige Fehler
    13. Zusammenhang mit anderen Funktionen
  4. Die Seite Import und Export
    1. Import
    2. Export
  5. Repository
  6. Wie Dateien gelesen werden
    1. Elemente, die Holarch nicht interpretiert
  7. Meldungen
  8. Grenzen
  9. Verwandte Seiten

Überblick

SysML v2-Projekte tauschen Modelle als Dateien mit anderen SysML v2-Werkzeugen aus. Die Seite Import und Export (Modell → Import und Export) erledigt beides:

  • Importieren liest .sysml-Dateien, eine .zip mit .sysml-Dateien oder eine SysML v2-JSON-Datei. Es zeigt eine Vorschau dessen, was sich ändert, und wendet es dann auf dieses Projekt an (ein einziges Rückgängigmachen nimmt alles zurück) oder erstellt ein neues SysML v2-Projekt.
  • Exportieren schreibt das ganze Modell oder ein Package als SysML v2-Text (.sysml) oder als SysML v2-JSON (.json).
  • ReqIF-Dateien (.reqif, .reqifz) aus Anforderungswerkzeugen werden als SysML v2-Anforderungen importiert, und Anforderungen werden als ReqIF exportiert: siehe ReqIF-Anforderungen importieren und exportieren.

Sie können ein Projekt auch direkt aus Dateien erstellen: Klicken Sie unter Projekte verwalten auf Projektdateien ▾ → SysML v2-Dateien importieren….

Tipp: Um das Modell mit einem SysML v2-Modell-Repository synchron zu halten, das die Systems Modeling API anbietet, verwenden Sie den Abschnitt Repository derselben Seite: siehe Aus einem Repository abrufen und in ein Repository übertragen.

Konzepte

Dateiformate

FormatInhaltImportExport
SysML v2-Text (.sysml)Die textuelle Notation, eine Datei pro Package der obersten Ebene.JaJa
Zip-Archiv (.zip)Mehrere .sysml-Dateien. Ordner werden zu Packages.JaJa, wenn mehrere Dateien exportiert werden
SysML v2-JSON (.json)Eine flache Liste von Elementen, jedes mit @id und @type, wie sie die Systems Modeling API verwendet.JaJa
ReqIF (.reqif, .reqifz)Anforderungen mit ihren Attributen, ihrer Hierarchie und ihren Beziehungen, aus DOORS, Polarion, Jama, codebeamer und anderen Anforderungswerkzeugen.Ja, in Anforderungen umgewandeltJa, die Anforderungen

KerML-Dateien (.kerml) werden noch nicht importiert.

IDs und Zuordnung

Jedes Element in einem SysML v2-Projekt hat eine ID. Die beiden Formate bewahren sie unterschiedlich:

  • JSON behält IDs. Ein erneut aus JSON importiertes Element wird dem Element mit derselben ID zugeordnet.
  • Verweise auf die Standardbibliothek werden verstanden. JSON aus der Systems Modeling API, der SysML v2 Pilot Implementation oder einem anderen Repository nennt Elemente der Standardbibliothek (Einheiten wie ISQ::mass, ScalarValues::Real, Parts::Part) über die Standard-IDs. Der Import liest sie als dieselben Bibliothekselemente, sodass Einheiten und Typen aufgelöst bleiben.
  • Text behält IDs, wenn Sie es verlangen. Aktivieren Sie Element-IDs einschließen, wenn Sie .sysml-Text exportieren. Jede benannte Definition, Verwendung und jedes Package trägt dann seine ID als erste Zeile seines Rumpfs, @HolarchMetadata::ElementId { id = "…"; }. Wird dieser Text erneut importiert, wird jedes Element mit einer ID dem Element mit derselben ID zugeordnet, auch wenn es umbenannt, zu einem anderen Eigentümer oder in ein anderes Package der obersten Ebene verschoben oder umsortiert wurde. Seine Diagrammpositionen, Kommentare, Nachverfolgungen und Verknüpfungen bleiben erhalten.
  • Text ohne IDs wird nach Namen zugeordnet. Holarch ordnet Packages der obersten Ebene nach Namen zu und die Elemente darin nach ihren Namen und Positionen. IDs bleiben erhalten, wo Elemente zugeordnet werden. Ein umbenanntes Element wird weiterhin zugeordnet, wenn es seinen Platz behält; ein Element, das gleichzeitig umbenannt und verschoben wurde, wird zu einem neuen Element.

Der Export vermerkt dies unter den Exportsteuerelementen: "Element-IDs bleiben in JSON erhalten. Aktivieren Sie in .sysml-Text „Element-IDs einschließen“, um sie zu behalten: Die Elemente behalten dann ihre Diagrammpositionen, Kommentare und Nachverfolgungen, wenn der bearbeitete Text erneut importiert wird, auch nach einer Umbenennung oder Verschiebung. Ohne IDs werden Elemente nach Namen zugeordnet."

Element-IDs im Text

@HolarchMetadata::ElementId { id = "…"; } sind gewöhnliche SysML v2-Metadaten: ElementId ist eine Metadatendefinition in Holarchs eigenem Bibliotheks-Package HolarchMetadata (in der Standardbibliothek unter Holarch), neben TBD und TBR. Andere SysML v2-Werkzeuge lesen die Zeile als Metadatenannotation; um ihren Namen aufzulösen, benötigen sie HolarchMetadata.sysml aus dieser Bibliothek.

  • Die ID gehört zu dem Element, dessen Rumpf die Zeile enthält. Unbenannte Elemente (Verbindungen, Successions, Kommentare) tragen keine ID und werden wie bisher nach ihrem Inhalt zugeordnet.
  • Holarch behält die Zeile nicht als Element. Der Editor zeigt das Modell ohne diese Zeilen, und ein Element, dessen Rumpf nur die Zeile enthielt, wird als part engine : Engine; angezeigt.
  • IDs müssen eindeutig sein. Erscheint dieselbe ID zweimal (zum Beispiel nach dem Kopieren eines Blocks im Text), behält das erste Element sie, und die Kopie wird zu einem neuen Element.
  • Eine ID, die keine UUID ist (zum Beispiel "R-17"), wird in eine feste UUID umgewandelt, sodass dieselbe Zeichenfolge immer dasselbe Element ergibt, wie bei einem JSON-Import.
  • Eine ID, die das Projekt nicht hat, wird für das neue Element beibehalten. Ein in Holarch gelöschtes Element kommt nach einem erneuten Import des Textes unter seiner alten ID zurück.
  • Im Editor wirkt eine eingefügte Zeile innerhalb des Packages, das Sie bearbeiten: Eine ID, die zu einem Element eines anderen Packages gehört, wird dort ignoriert, und das Element wird nach Namen zugeordnet. Um Elemente zwischen Packages zu verschieben und ihre IDs zu behalten, exportieren Sie mit IDs und importieren Sie die bearbeiteten Dateien.

Die Part-Definition Car der Hybrid-Car-Demo trägt eine solche Zeile in ihrer Quelldatei, daher ist ihre ID in jeder Kopie der Demo gleich.

Ordner werden zu Packages

In einem Zip-Archiv wird jeder Ordner zu einem Package, das seine Dateien und Unterordner enthält. Eine Datei powertrain/engine.sysml im Archiv wird gelesen, als stünde sie innerhalb von package powertrain { … }. Dateien auf der obersten Ebene des Archivs werden gelesen, wie sie sind. Ordner und Dateien werden in Namensreihenfolge gelesen.

Was die Vorschau vergleicht

Die Vorschau hat eine Zeile pro Package der obersten Ebene (oder bei einem neuen Projekt pro Element der obersten Ebene). Jede Zeile hat ein Ergebnis:

ErgebnisBedeutungStandardmäßig importiert
NeuDas Projekt hat kein Package dieses Namens (oder dieser ID). Es wird hinzugefügt.Ja
GeändertDas Projekt hat das Package; der Import fügt darin Elemente hinzu, ändert oder entfernt sie. Das Detail nennt, wie viele, zum Beispiel "3 added, 1 changed (ids kept where elements match)".Ja
UnverändertDas Package ist dasselbe wie in diesem Projekt.Nein (nichts zu tun)
KonfliktDas Package lässt sich nicht zusammenführen. Das Detail nennt den Grund und was zu tun ist.Nein

So setzen Sie es ein

Wann und warum

Verwenden Sie Import und Export, wenn ein Modell zwischen Holarch und einem anderen SysML v2-Werkzeug oder zwischen Holarch-Projekten wechselt:

  • Ein Holarch-Projekt aus einem anderswo geschriebenen Modell beginnen.
  • Ein Package übernehmen, das ein anderes Team pflegt, etwa eine Komponentenbibliothek, und es aktualisieren, wenn eine neue Version kommt.
  • Ein Package an einen Zulieferer oder an ein Werkzeug übergeben, das SysML v2-Text oder -JSON liest.
  • .sysml-Dateien in Ihrer eigenen Versionsverwaltung neben dem Holarch-Projekt halten.

Dateien in dieses Projekt importieren

  1. Öffnen Sie Modell → Import und Export.
  2. Wählen Sie unter Importieren In dieses Projekt.
  3. Legen Sie die Dateien auf der Ablagefläche ab, oder klicken Sie darauf und wählen Sie sie aus.

    Sie sehen "Dateien werden gelesen…" und dann die Vorschau: die Anzahl der Packages der obersten Ebene und der Dateien, etwaige Probleme und eine Tabelle mit Importieren, Package, Elemente und Ergebnis.

  4. Lesen Sie die Problemliste, falls es eine gibt. Sie nennt jede Datei und Zeile, die sich nicht parsen lässt, und jede übersprungene Datei.
  5. Entfernen Sie das Häkchen bei jedem Package, das Sie nicht importieren möchten. Um ein Package zu ersetzen, das wegen seines Namens in Konflikt steht, setzen Sie das Häkchen.

    In einem Tarif mit Elementlimit zählt die Vorschau die Elemente, die das Projekt nach dem Import hätte (Beziehungen zählen nicht). Liegt das über dem Limit, sagt sie es, zum Beispiel "Dieser Import würde das Projekt auf 1.804 Elemente bringen; der Free-Tarif erlaubt 1.000.", und N Packages importieren bleibt deaktiviert, bis Sie bei genügend Packages das Häkchen entfernt haben. Nichts wird angewendet oder an den Server gesendet. Importe in ein neues Projekt werden auf dieselbe Weise gegen das Limit pro Projekt Ihres Tarifs geprüft.

  6. Klicken Sie auf N Packages importieren.

    Die Meldung lautet "N Packages importiert." Die Seite zeigt "N Packages importiert (M Elemente). „Rückgängig“ macht den Import in einem Schritt rückgängig." Klicken Sie auf Text öffnen, um sie zu sehen.

Dateien in ein neues Projekt importieren

  1. Öffnen Sie Modell → Import und Export und wählen Sie In ein neues SysML-v2-Projekt.
  2. Legen Sie die Dateien ab oder wählen Sie sie aus.

    Die Vorschau listet die Elemente der obersten Ebene auf, alle mit Häkchen.

  3. Entfernen Sie das Häkchen bei allen, die Sie nicht möchten, und bearbeiten Sie den Projektname. Standardmäßig ist es der Name der einzelnen Datei oder des ersten Packages.
  4. Klicken Sie auf Projekt erstellen.

    Das neue Projekt öffnet sich im Editor.

Unter Projekte verwalten erledigt Projektdateien ▾ → SysML v2-Dateien importieren… dasselbe in einem Schritt. Wenn sich Teile der Dateien nicht lesen lassen, fragt es zuerst: "N Probleme gefunden: Teile der Dateien werden ausgelassen. Projekt mit dem Rest erstellen? Um die Probleme zuerst zu sehen, öffnen Sie ein SysML-v2-Projekt und nutzen Sie „Import und Export“." Klicken Sie auf Projekt erstellen, um fortzufahren.

Ein Package aus einer neuen Version aktualisieren

  1. Exportieren oder erhalten Sie die neue Version als .sysml-Dateien oder JSON.
  2. Importieren Sie sie In dieses Projekt.

    Das Package zeigt Geändert, mit der Anzahl der hinzugefügten, geänderten und entfernten Elemente.

  3. Klicken Sie auf 1 Package importieren.

    Übereinstimmende Elemente behalten ihre IDs, sodass die Verknüpfungen zu ihnen (Anforderungsverknüpfungen, Risiken, Ansichtslayouts, Kommentare) erhalten bleiben. Elemente, die nicht mehr in der Datei stehen, wandern in den Papierkorb.

Elemente im Text umbenennen und verschieben und ihre IDs behalten

  1. Exportieren Sie die Packages als SysML v2-Text mit aktiviertem Element-IDs einschließen.
  2. Bearbeiten Sie die Dateien: Benennen Sie Elemente um, verschieben Sie sie zu anderen Ownern oder in eine andere Package-Datei, ordnen Sie sie neu an. Lassen Sie jede Zeile @HolarchMetadata::ElementId im Rumpf ihres Elements.
  3. Importieren Sie die bearbeiteten Dateien In dieses Projekt.

    Die Packages zeigen Geändert. Umbenannte und verschobene Elemente zählen als geändert, nicht als hinzugefügt und entfernt.

  4. Klicken Sie auf N Packages importieren.

    Die Elemente behalten ihre IDs: Ihre Diagrammpositionen, Kommentare, Traces und Verknüpfungen bleiben erhalten. In ein anderes Package verschobene Elemente verlassen das Package, in dem sie waren.

Große Importe im gehosteten Dienst

Im gehosteten Dienst wird ein Import von 5.000 oder mehr Elementen vom Server angewendet, nicht von Ihrem Browser. Wenn jedes Package mit Häkchen Neu ist oder einen Konflikt ersetzt, liest der Server die Dateien selbst (die Schritte unten). Wenn ein Package mit Häkchen Geändert ist, berechnet Ihr Browser die Zusammenführung wie üblich und lädt die Änderungen einmal hoch; der Server schreibt sie dann in einem Schritt, mit derselben Fortschrittskarte, Import abbrechen und Import rückgängig machen.

  1. Wählen Sie die Dateien und prüfen Sie die Vorschau wie bei jedem Import.
  2. Klicken Sie auf N Packages importieren (oder Projekt erstellen).

    Die Dateien werden einmal hochgeladen. Der Server liest sie mit denselben Prüfungen und denselben Element-IDs wie die Vorschau und schreibt das Ergebnis in einem Schritt.

  3. Verfolgen Sie die Fortschrittskarte am unteren Fensterrand: Sie zeigt die Phase (Hochladen, Lesen, Prüfen, Anwenden, Aktualisieren des Projektindex) und die verbleibende Zeit.

    Sie können die Seite verlassen oder den Tab schließen. Der Import läuft auf dem Server weiter, und wenn Sie das Projekt wieder öffnen, ist sein Ergebnis da. Jede geöffnete Kopie des Projekts wird neu geladen, wenn der Import angewendet wird; nicht gesendete Bearbeitungen werden nach dem Neuladen erneut gesendet.

  • Andere Mitglieder sehen "Name importiert Datei…" in derselben Karte und auf der Seite Import und Export.
  • Ein Import nach dem anderen: Ein zweiter großer Import in dasselbe Projekt wartet, bis der erste abgeschlossen ist.
  • Import abbrechen (die Person, die ihn gestartet hat, oder ein Owner) stoppt den Import, bevor er angewendet wird. Nichts wird geändert.
  • Import rückgängig machen: ⌘Z / Ctrl+Z im Browser nimmt einen Server-Import nicht zurück. Klicken Sie auf der Seite Import und Export auf Import rückgängig machen, um das Projekt in seinen Zustand vor dem letzten Import zurückzuversetzen. Der Zustand vor dem Rückgängigmachen bleibt im Verlauf erhalten, sodass nach dem Import vorgenommene Bearbeitungen von dort wiederhergestellt werden können.
  • Projektaktivität und Verlauf führen den Import als einen Eintrag der Person auf, die ihn gestartet hat.

Das Modell oder ein Package exportieren

  1. Öffnen Sie Modell → Import und Export.
  2. Wählen Sie unter Exportieren, was exportiert werden soll: Das gesamte Modell oder ein Package über seinen qualifizierten Namen.
  3. Wählen Sie das Format: SysML-v2-Text (.sysml; ein .zip für mehrere Packages) oder SysML v2 JSON (.json).
  4. Für Text, den Sie bearbeiten und erneut importieren, setzen Sie das Häkchen bei Element-IDs einschließen.
  5. Klicken Sie auf Exportieren.

    Eine Datei wird heruntergeladen, oder ein Zip, wenn der Export mehrere Dateien enthält. Die Meldung lautet "<file> exportiert." oder "N Dateien als Zip exportiert."

Um schnell ein Package zu exportieren, verwenden Sie den Browser: Das Zeilenmenü eines Packages enthält Als .sysml exportieren und Als JSON exportieren.

ReqIF-Anforderungen importieren und exportieren

ReqIF ist das Austauschformat von Anforderungswerkzeugen. Eine ReqIF-Datei wird als ein Package von SysML v2-Anforderungen importiert, und Anforderungen werden wieder als ReqIF exportiert, sodass ein Anforderungswerkzeug und ein SysML v2-Projekt dieselben Anforderungen in beide Richtungen austauschen können.

Eine ReqIF-Datei importieren:

  1. Öffnen Sie Modell → Import und Export (oder klicken Sie auf der Seite Anforderungen auf Importieren…, oder wählen Sie ReqIF importieren… in ⌘K / Ctrl+K).
  2. Legen Sie die Datei .reqif oder .reqifz auf dem Feld ab, oder klicken Sie auf das Feld, um sie auszuwählen. Eine ReqIF-Datei pro Import.
  3. Der ReqIF-Bereich zeigt die Anzahl der Anforderungen, Kapitel und Relationen, wie viele konvertiert, angenähert oder ausgelassen wurden, und ob der SysML v2-Text ohne Probleme geprüft wird.
  4. Wählen Sie unter Kurznamen aus entweder Fremd-ID (die Nummer, die Personen im Quellwerkzeug sehen, etwa SRS-12) oder ReqIF-Bezeichner (die interne ID des Werkzeugs). Anforderungen ohne Fremd-ID erhalten den Bezeichner.
  5. Wählen Sie unter Beziehungstypen, was aus jedem Relationstyp wird: Ableiten, Verfeinern, Abhängigkeit oder Auslassen. Die Vorschau wird neu berechnet, und die Wahl bleibt für den nächsten Import derselben Datei erhalten.
  6. Klicken Sie auf 1 Package importieren. Ein einziges Rückgängigmachen nimmt den ganzen Import zurück. Die Meldung lautet "N Anforderungen aus <title> importiert."

Was der Import erzeugt:

ReqIFSysML v2
Anforderung (Spec-Objekt)requirement, mit der Fremd-ID oder dem Bezeichner als Kurzname, dem Namen und dem Text als doc
Anforderungstyprequirement def, mit einem Attribut pro ReqIF-Attribut
Aufzählungsdatentypenum def
Statusattribut (Draft, Proposed, Approved und so weiter)Der Status der Anforderung in Holarch
Kapitelüberschriftpackage mit der Kapitelnummer als Kurzname
Verschachtelte AnforderungVerschachteltes requirement
Relation derived fromDerivation-Connection
Relation refinesDependency mit der Annotation Refinement
satisfies, verified by und andere RelationenDependency (der Bericht sagt, warum)
Spezifikationpackage innerhalb des Packages der Datei

Tabellen werden zu Textzeilen mit | zwischen den Zellen, Listen werden zu Zeilen, die mit einem Bindestrich beginnen, und Formatierungen und Links behalten nur ihren Text; diese Anforderungen sind Angenähert. Bilder und eingebettete Objekte werden nicht importiert; die Anforderung, die eines enthielt, wird mit dem Grund aufgeführt, sodass Sie die Datei an sie anhängen können. Bericht herunterladen speichert jede Anforderung und Relation mit ihrem Ergebnis als CSV; SysML-v2-Text herunterladen speichert den Text.

Eine neuere Kopie der Datei importieren: Importieren Sie sie in dasselbe Projekt. Holarch findet das Package des früheren Imports und vergleicht Anforderung für Anforderung:

  • Anforderungen behalten ihre Element-IDs, sodass Diagramme, Satisfy- und Verify-Verknüpfungen, Reviews und Verlauf verbunden bleiben. Umbenannte und verschobene Anforderungen werden an Ort und Stelle aktualisiert.
  • Anforderungen, die in der neuen Datei fehlen, bleiben erhalten. Setzen Sie das Häkchen bei Die in dieser Datei fehlenden N Anforderungen entfernen, um sie in den Papierkorb zu verschieben.
  • Parts, Verifikationsfälle und Verknüpfungen, die Sie in Holarch hinzugefügt haben, bleiben erhalten.
  • Eine nur in Holarch geänderte Anforderung behält Ihre Änderung. Eine sowohl hier als auch in der Datei geänderte Anforderung übernimmt den Text der Datei; der frühere Text bleibt im Verlauf. Die Vorschau führt diese unter Hier und in der Datei geändert auf.

Als ReqIF exportieren:

  1. Wählen Sie unter Exportieren ein Package oder Das gesamte Modell und ReqIF (.reqif) oder ReqIF-Archiv (.reqifz).
  2. Klicken Sie auf Exportieren. Die Meldung lautet "N Anforderungen als <file> exportiert."

Exportieren… → Anforderungen (ReqIF) auf der Seite Datenbank oder Anforderungen exportiert die aufgeführten (oder ausgewählten) Anforderungen auf dieselbe Weise.

Die Datei enthält für jede Anforderung den Kurznamen (als ReqIF.ForeignID), den Namen, das Doc (als XHTML), den Status und die Attributwerte, die Package-Hierarchie als Spezifikation sowie Derive-, Refine- und Dependency-Beziehungen. Aus ReqIF importierte Anforderungen behalten ihre ursprünglichen Bezeichner, Typen und Relationstypen, sodass das Quellwerkzeug seine Anforderungen aktualisiert, statt Kopien hinzuzufügen; ein erneutes Exportieren und Importieren der Datei zeigt jedes Package als Unverändert. Berechnete Attributwerte werden als Text geschrieben. Satisfy- und Verify-Verknüpfungen bleiben in Holarch: ReqIF hat keine Parts oder Verifikationsfälle.

Aus einem Repository abrufen und in ein Repository übertragen

Verbinden Sie das Projekt mit einem Branch eines SysML v2-Modell-Repositorys, um dessen neuesten Commit zu lesen und Ihre Änderungen zurückzusenden.

  1. Öffnen Sie Modell → Import und Export und suchen Sie den Abschnitt Repository.
  2. Geben Sie die Repository-Adresse ein (die https-Adresse seiner Systems Modeling API) und, falls das Repository eines benötigt, das Zugriffstoken.
  3. Klicken Sie auf Projekte laden und wählen Sie dann das Projekt und den Branch. Um aus diesem Modell ein neues Repository-Projekt zu starten, klicken Sie stattdessen auf Neues Repository-Projekt.
  4. Klicken Sie auf Pull…. Holarch liest den neuesten Commit des Branches und listet jeden Unterschied auf: Neu, Geändert, Entfernt oder Konflikt. Sie sehen "Aktuell: keine Änderungen im Repository.", wenn es nichts zu pullen gibt.
  5. Entfernen Sie das Häkchen bei den Unterschieden, die Sie nicht möchten, und klicken Sie dann auf Pull anwenden. Ein einziges Rückgängigmachen nimmt den ganzen Pull zurück.
  6. Nachdem Sie das Modell geändert haben, klicken Sie auf Push. Ihre Änderungen seit dem zuletzt synchronisierten Commit gehen als ein neuer Commit an den Branch. Sie sehen zum Beispiel "3 geändert als Commit 1a2b3c4d gepusht."

Ein Konflikt ist ein Element, das seit der letzten Synchronisierung sowohl hier als auch im Repository geändert wurde. Ein Konflikt ohne Häkchen behält die Version dieses Projekts.

Notiz: Ein Push wird abgelehnt, wenn der Branch Commits hat, die dieses Projekt nicht gepullt hat: "Der Repository-Branch hat Commits, die dieses Projekt nicht gepullt hat. Zuerst pullen, dann erneut pushen."

Ausgeführtes Beispiel: die Hybrid-Car-Demo

Erstellen Sie zuerst die Demo: Klicken Sie unter Projekte verwalten auf Projektdateien ▾ → Neues Demoprojekt → Hybrid Car (SysML v2).

  1. Öffnen Sie Modell → Import und Export. Wählen Sie unter Exportieren Das gesamte Modell und SysML v2-Text, und klicken Sie dann auf Exportieren.

    Ein Zip wird heruntergeladen, mit einer Datei pro Package der obersten Ebene, etwa Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml und VehicleViews.sysml.

  2. Öffnen Sie VehicleRequirements.sysml in einem Texteditor. Ändern Sie attribute maxCurbMass : MassValue = 1650 [kg]; in 1600 [kg] und speichern Sie.
  3. Wählen Sie zurück auf Import und Export In dieses Projekt und legen Sie VehicleRequirements.sysml ab.

    Die Vorschau zeigt VehicleRequirements als Geändert, mit der Anzahl der geänderten Elemente. Die anderen Packages sind nicht in der Datei, daher werden sie nicht aufgeführt.

  4. Klicken Sie auf 1 Package importieren.

    Der Wert ändert sich im Modell. Die Anforderung Sedan Mass (VR-1.1) nennt maxCurbMass, daher werden ihre Verknüpfungen zur Überprüfung markiert (siehe Anforderungen und Verifikation in SysML v2-Projekten). Drücken Sie ⌘Z / Ctrl+Z, um den Import rückgängig zu machen.

  5. Um ein zweites Projekt aus denselben Dateien zu starten, wählen Sie In ein neues SysML-v2-Projekt, legen Sie das Zip ab und klicken Sie auf Projekt erstellen.

Tipps und bewährte Vorgehensweisen

  • Verwenden Sie JSON, um ein Modell zwischen SysML v2-Werkzeugen zu übertragen, wenn IDs wichtig sind, zum Beispiel wenn das andere Werkzeug Verknüpfungen über IDs hält. Verwenden Sie Text, wenn Personen die Dateien lesen oder prüfen; setzen Sie das Häkchen bei Element-IDs einschließen, wenn der Text nach dem Bearbeiten zu Holarch zurückkommt.
  • Lassen Sie die IDs aus Text weg, den Sie an Personen geben, die ihn nur lesen: Die Zeilen fügen pro Element eine hinzu.
  • Halten Sie ein Package der obersten Ebene pro Datei. Der Export schreibt Dateien auf diese Weise, und ein späterer Import gleicht dann Package für Package ab.
  • Importieren Sie ein Package eines anderen Teams in sein eigenes Package der obersten Ebene. Aktualisierungen betreffen dann nur dieses Package.
  • Prüfen Sie die Problemliste, bevor Sie importieren. Member, die sich nicht parsen lassen, werden ausgelassen.

Häufige Fehler

  • Ein Package zeigt Konflikt: "Ein Package namens X mit anderen IDs existiert." Das Projekt hat ein Package dieses Namens, das nicht aus diesem JSON importiert wurde. Setzen Sie das Häkchen in der Zeile, um es zu ersetzen (das alte Package wandert in den Papierkorb), oder importieren Sie in ein neues Projekt.
  • "Der Import enthält zwei Packages der obersten Ebene namens X; nur das erste wird importiert." Zwei Dateien deklarieren dasselbe Package der obersten Ebene. Führen Sie sie zu einer Datei zusammen oder benennen Sie eines um.
  • Ein umbenanntes Element wurde als neu importiert. Der Text hatte keine Element-IDs, und das Element wurde gleichzeitig umbenannt und verschoben (oder seine Art und sein Name haben sich beide geändert). Exportieren Sie mit Element-IDs einschließen, nehmen Sie die Änderung vor und importieren Sie erneut.
  • Nach dem Import fehlen Elemente. Ein Member, der sich nicht parsen lässt, wird ausgelassen: "Dieser Member lässt sich nicht parsen und wird ausgelassen." Beheben Sie die Zeile, die die Problemliste nennt, und importieren Sie dann erneut.
  • Ein JSON-Import wird abgelehnt. Importieren Sie jeweils eine SysML v2-JSON-Datei, ohne .sysml-Dateien.

Zusammenhang mit anderen Funktionen

  • Editor: Importierte Packages öffnen sich dort; exportierte Dateien sind der Text, den Sie dort sehen.
  • Rückgängig und Papierkorb: Ein einziges Rückgängigmachen nimmt einen ganzen Import in dieses Projekt zurück; Elemente, die er entfernt oder ersetzt, wandern in den Papierkorb.
  • Änderungskontrolle: Werte und Dokumentation, die sich durch einen Import ändern, markieren Anforderungsverknüpfungen zur Überprüfung, wie jede andere Bearbeitung.
  • Holarch-Projektdateien: Dieses Projekt exportieren… unter Projekte verwalten speichert das gesamte Holarch-Projekt, mit Risiken, Dokumenten und anderen Holarch-Daten. .sysml und JSON enthalten nur das Modell.
  • Konvertierung: Um ein Modell zwischen LML und SysML v2 zu übertragen, erstellen Sie eine konvertierte Kopie (siehe Konvertieren zwischen LML und SysML v2).

Die Seite Import und Export

Import

SteuerelementVerwendung
In dieses ProjektDie Dateien in das geöffnete Projekt zusammenführen. Nicht verfügbar für Personen, die das Projekt nur ansehen können; für sie erstellen Importe ein neues Projekt.
In ein neues SysML-v2-ProjektEin neues Projekt aus den Dateien erstellen.
Ablagefeld"Dateien hier ablegen oder klicken, um sie auszuwählen". Akzeptiert .sysml-Dateien, ein .zip mit .sysml-Dateien oder eine SysML v2-JSON-Datei.
VorschautabelleImportieren (Kontrollkästchen), Package (Name und Art), Elemente (Anzahl), Ergebnis (Neu, Geändert, Unverändert oder Konflikt, mit einem Detail).
Projektname(Nur neues Projekt) Der Name des neuen Projekts, bis zu 200 Zeichen.
N Packages importieren / Projekt erstellenDen Import anwenden.
AbbrechenDie Vorschau schließen, ohne zu importieren.

Elemente außerhalb eines Packages in .sysml-Text werden zusammen in einer Zeile aufgeführt, Außerhalb von Packages.

Wenn sich das Modell ändert, während eine Vorschau geöffnet ist (ein anderer Tab, ein Mitarbeiter oder Rückgängig), wird die Vorschau neu berechnet.

Export

SteuerelementVerwendung
Exportieren (Umfang)Das gesamte Modell oder ein beliebiges Package über den qualifizierten Namen.
als (Format)SysML-v2-Text (.sysml; ein .zip für mehrere Packages) oder SysML v2 JSON (.json).
Element-IDs einschließen(Nur Text; standardmäßig aus) Die ID jedes benannten Elements als @HolarchMetadata::ElementId { id = "…"; } in den Text schreiben, sodass eine bearbeitete, erneut importierte Kopie die IDs über Umbenennungen und Verschiebungen hinweg behält.
ExportDie Datei herunterladen.

Der Textexport schreibt eine Datei pro Package der obersten Ebene, benannt nach diesem (Vehicles.sysml). Elemente außerhalb von Packages kommen in Outside packages.sysml. Der JSON-Export schreibt eine Datei, benannt nach dem Projekt oder dem Package.

Repository

Der Abschnitt Repository verbindet das Projekt mit einem Branch eines Repositorys, das die Systems Modeling API anbietet.

  • Repository-Adresse: die https-Adresse der API des Repositorys. Holarch verbindet sich nur mit https-Adressen auf öffentlichen Hosts; Site-Administratoren können die Hosts und Ports einschränken.
  • Zugriffstoken: verschlüsselt für Ihr Konto und dieses Projekt gespeichert und nur an diese Adresse gesendet. Es wird nie wieder angezeigt; lassen Sie das Feld leer, um das gespeicherte Token zu behalten.
  • Projekte laden, Projekt und Branch: wählen, wohin synchronisiert wird. Neues Repository-Projekt erstellt im Repository ein Projekt für dieses Modell.
  • Pull…, Pull anwenden: den neuesten Commit lesen, die Unterschiede prüfen und sie anwenden; ein einziges Rückgängigmachen nimmt alles zurück. Holarch vergleicht mit dem zuletzt synchronisierten Commit und kann so Ihre Änderungen von denen des Repositorys unterscheiden.
  • Push: die Änderungen seit dem zuletzt synchronisierten Commit als einen Commit senden. "Nichts zu pushen: Das Modell entspricht dem zuletzt synchronisierten Commit." bedeutet, dass es nichts Neues gibt.
  • Einstellungen… ändert die Verbindung. Trennen entfernt das gespeicherte Token und den Synchronisierungsstatus; das Modell bleibt.
  • Repository-Vorgänge erfordern die Editor-Rolle. Betrachter können nicht pullen oder pushen.
  • Pushes werden für Projekte mit Kennzeichnungen für regulierte Daten abgelehnt.

Wie Dateien gelesen werden

  • Dateien werden geprüft, bevor etwas gelesen wird: ihre Größen, Anzahlen, Verschachtelung und Textlängen.
  • In einem Zip werden versteckte Dateien und __MACOSX-Ordner ignoriert. Links, Dateien außer .sysml und eine zweite Kopie desselben Pfads werden übersprungen, und die Problemliste sagt, warum.
  • Text muss UTF-8 sein. Eine Byte-Order-Mark ist erlaubt.
  • Jedes importierte Element wird geprüft, bevor es geschrieben wird. Ein abgelehntes Element nimmt seine eigenen Member mit; die Problemliste zählt sie.
  • In JSON werden Elemente von Arten, die Holarch nicht interpretiert, so behalten, wie sie importiert wurden: siehe Elemente, die Holarch nicht interpretiert.

Elemente, die Holarch nicht interpretiert

SysML v2-JSON kann Elementarten enthalten, die Holarch nicht modelliert, etwa KerML-Behaviors, Steps oder Interactions. Holarch behält sie, statt sie auszulassen:

  • Jedes bleibt im Modell mit seiner ID, seinem Namen, seinem Owner und seinem ursprünglichen JSON, einschließlich seiner Beziehungen (Typisierungen, Spezialisierungen und andere) und dessen, was sie besitzen. Seine Member behalten es als ihren Owner.
  • Der Browser zeigt seine ursprüngliche Art mit einem Tag Nicht interpretiert; zeigen Sie auf das Tag, um die Erklärung zu sehen. Der Inspektor zeigt seine Art, seine ID in der Datei und worauf seine Beziehungen zeigen.
  • Es kann in Holarch nicht umbenannt oder bearbeitet werden. Ändern Sie es in dem Werkzeug, aus dem es stammt, und importieren Sie es erneut. Sie können es verschieben oder löschen.
  • Es hat keinen SysML-Text. Der Editor lässt es und alles, was es besitzt, aus dem Text weg, und ein Hinweis über dem Text sagt, wie viele Elemente nicht angezeigt werden. Das Bearbeiten des Texts entfernt sie nie. Ein .sysml-Export lässt sie ebenfalls weg.
  • Ein JSON-Export schreibt es unverändert zurück. Nur was sich im Modell geändert hat, wird angepasst: ein Member, den Sie gelöscht oder hinzugefügt haben, ein Member, den Sie umbenannt haben, oder ein neuer Owner.
  • Die Importvorschau führt jede behaltene Art einmal als Hinweis auf, zum Beispiel 2 Behavior-Elemente werden wie importiert behalten. Hinweise sind keine Probleme.

Nicht behalten: der unbenannte Root-Namespace, in den manche Werkzeuge einen ganzen Export einpacken (seine Member werden zu Elementen der obersten Ebene), und nicht unterstützte Elemente innerhalb eines Werts, die als Probleme aufgeführt werden. Ein Element, dessen JSON größer als 256 KB ist, behält nur seine Art und ID.

Meldungen

NachrichtBedeutung und Lösung
Wählen Sie .sysml-Dateien, ein .zip mit .sysml-Dateien oder eine SysML v2-JSON-Datei.Es wurden keine Dateien ausgewählt.
Es wurden keine .sysml-Dateien gefunden. Wählen Sie .sysml-Dateien, ein .zip mit .sysml-Dateien oder eine SysML v2-JSON-Datei.Das Archiv oder die Auswahl enthält keine .sysml-Dateien.
Importieren Sie jeweils eine SysML v2-JSON-Datei, ohne .sysml-Dateien.Mehrere JSON-Dateien oder JSON gemischt mit Text wurden ausgewählt.
<file> ist keine ReqIF-Datei (…). Exportieren Sie sie aus dem Quellwerkzeug als ReqIF 1.0 oder neuer und importieren Sie sie erneut.Die Datei ist kein ReqIF-XML, oder sie enthält einen DOCTYPE, den Holarch nicht liest.
<file> enthält keine Anforderungen (keine SPEC-OBJECT-Elemente). Exportieren Sie die Spezifikationen mit ihren Objekten und importieren Sie die Datei erneut.Die ReqIF-Datei hat Typen, aber keine Anforderungen.
<title> hat N Anforderungen, mehr als ein Import aufnimmt (etwa M). Exportieren Sie die Spezifikationen als separate ReqIF-Dateien.Der SysML v2-Text würde das Limit von 8 MB überschreiten. Importieren Sie die Spezifikationen eine Datei nach der anderen.
<file> ist kein UTF-8-Text. Speichern Sie sie als UTF-8 und importieren Sie sie erneut.Konvertieren Sie die Kodierung der Datei.
<file> ist kein gültiges ZIP-Archiv. Erstellen Sie das Archiv neu.Das Archiv ist beschädigt.
<file> enthält verschlüsselte Dateien. Erstellen Sie das Archiv ohne Passwort.Passwortgeschützte Archive werden nicht gelesen.
<path> ist mehr als 200:1 komprimiert, was typisch für eine Zip-Bombe ist. Erstellen Sie das Archiv neu.Das Archiv wurde aus Sicherheitsgründen abgelehnt.
Das Archiv verwendet eine Komprimierungsmethode, die nicht unterstützt wird. Erstellen Sie es mit Standard-ZIP-Komprimierung.Verwenden Sie Standardkomprimierung (Deflate).
KerML-Dateien werden noch nicht importiert..kerml-Dateien werden übersprungen.
Aus einem Archiv werden nur .sysml-Dateien importiert.Andere Dateien in einem Zip werden übersprungen.
Links werden nicht importiert.Symbolische Links in einem Zip werden übersprungen.
Das Archiv enthält diese Datei zweimal; die erste Kopie wird importiert.Zwei Einträge haben denselben Pfad.
<file> ist kein gültiges JSON. Exportieren Sie das Modell erneut.Die JSON-Datei ist beschädigt.
<file> ist kein SysML v2-JSON (eine Liste von Elementen mit @id und @type). Wählen Sie einen SysML v2-JSON-Export.Das JSON hat ein anderes Format.
Zeile N von <file> ist länger als 64 KB. Brechen Sie die Zeile um und importieren Sie die Datei dann erneut.Sehr lange Zeilen werden abgelehnt.
Dieser Member lässt sich nicht parsen und wird ausgelassen.Beheben Sie die in der Problemliste genannte Zeile.
Ein Element mit dieser ID befindet sich in diesem Projekt innerhalb von <element>. Verschieben Sie es zuerst auf die oberste Ebene, oder importieren Sie in ein neues Projekt.(Konflikt) Das Package der obersten Ebene des JSON existiert bereits tiefer im Modell.
N Element-IDs davon werden an anderer Stelle in diesem Projekt verwendet. Importieren Sie stattdessen in ein neues Projekt.(Konflikt) Das JSON verwendet IDs anderer Elemente erneut.
Der Package-Text lässt sich nach dem Ausgeben nicht parsen. Importieren Sie ihn in ein neues Projekt.(Konflikt) Das Package konnte nicht zusammengeführt werden.
N <kind>-Elemente werden wie importiert behalten (nicht interpretiert): …(Hinweis) Elemente einer Art, die Holarch nicht interpretiert, werden unverändert behalten. Siehe Elemente, die Holarch nicht interpretiert.
Ein Element der Art <kind> innerhalb eines Werts wird nicht unterstützt und ausgelassen.Ein Wert (ein Ausdruck) enthält ein Element, das Holarch nicht lesen kann. Der Rest des Werts wird als Text behalten.
Ein Element der Art <kind> ist zu groß, um es vollständig zu behalten; nur seine Art und ID werden behalten.Sein JSON ist größer als 256 KB.
Der Import wurde nicht angewendet: … Nichts wurde geändert.Der Import ist fehlgeschlagen; das Projekt ist unverändert.
Das Modell ist leer. Fügen Sie ein Package hinzu und exportieren Sie dann erneut.Es gibt nichts zu exportieren.
Das zu exportierende Package existiert nicht mehr. Wählen Sie ein anderes.Das Package wurde gelöscht, während die Seite geöffnet war.

Grenzen

GrenzeWert
Dateien pro Import2,000
.sysml-Text pro Import (entpackt)8 MB
Zip-Archiv16 MB, 10.000 Einträge
Ordnerverschachtelung in einem Zip32 Ordner
Elemente pro Import (Text oder JSON)100,000
JSON-Datei24 MB, Verschachtelung 64 Ebenen
JSON eines Elements, das Holarch nicht interpretiert256 KB, Verschachtelung 12 Ebenen
Zeilenlänge64 KB
ReqIF-Datei (.reqif oder .reqif innerhalb einer .reqifz)64 MB; der daraus erzeugte SysML v2-Text muss in das Textlimit von 8 MB passen (etwa 8.000 bis 20.000 Anforderungen)
  • Antworten des Repositorys sind für einen ganzen Pull auf 64 MB begrenzt, und jeder Repository-Vorgang stoppt nach 120 Sekunden.
  • Jedes Konto kann höchstens 300 Repository-Vorgänge pro Stunde ausführen.
  • KerML-Dateien (.kerml) werden noch nicht importiert.
  • In der gehosteten App liest der Server Importe mit bis zu 1,5 MB .sysml-Text. Größere Importe werden in Ihrem Browser gelesen, mit demselben Ergebnis.
  • Holarch-Daten neben dem Modell (Anforderungsstatus, Risiken, Budgets, Simulatoreinstellungen, Ansichtslayouts) sind nicht Teil von .sysml- oder JSON-Dateien. Verwenden Sie Dieses Projekt exportieren… unter Projekte verwalten, um sie zu behalten.

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