SysML v2
SysML v1 モデルのインポート
Cameo、MagicDraw、Enterprise Architect、Rhapsody、Papyrus の SysML 1.x モデルを SysML v2 テキストに変換し、形が変わった部分を確認して、SysML v2 プロジェクトにインポートします。
このページの内容
概要
SysML 1.x のモデルを SysML v2 プロジェクトに取り込むことができます。Holarch はモデルの XMI ファイルを読み取り、SysML v2 テキストに変換してテキストをチェックし、何かを変更する前に変換レポートを表示します。
- 入力:XMI(
.xmi、.uml、.xml)形式の SysML 1.x モデル、または Cameo か MagicDraw のプロジェクト(.mdzip)。 - 出力:プロジェクトに追加される SysML v2 テキスト(1 回の元に戻すですべて取り消せます)、または新しい SysML v2 プロジェクト。
- レポート:v1 のすべての要素とその結果(変換済み、近似、除外)および理由。
変換は、OMG SysML 2.0 仕様の SysML v1 から SysML v2 への変換に従います。ただし、XMI として交換されたモデルがそれに十分な詳細を持つ場合に限ります。
概念
変換、近似、除外
v1 モデルの各要素には、1 つの結果が付きます:
- 変換:要素に直接対応する SysML v2 の要素があります。たとえば、
part defになるブロックです。 - 近似:要素は形を変えて保持されます。たとえば、インターフェースブロックで型付けされたフルポートはポートになり、選択疑似状態を通る遷移はパスごとに 1 つの遷移になります。
- 除外:SysML v2 に対応するものがないか、要素がファイルにないものを指しています。例として、フロー終了ノード、アクティビティパーティション、ユースケースの拡張、インスタンス仕様があります。
レポートには、近似および除外されたすべての要素について、その理由が文章で示されます。
SysMLv1Library パッケージ
SysML v1 のプロパティの中には、ブロックの isEncapsulated や refine 関係など、SysML v2 のキーワードがないものがあります。変換ツールは、それらを SysMLv1Library パッケージのメタデータとして保持します(例:@SysMLv1Library::RefineData { isRefine = true; })。このパッケージは Holarch のライブラリの一部なので、これらの名前はすべての SysML v2 プロジェクトで解決されます。
不透明な本体はテキスト表現になる
不透明振る舞い、不透明アクション、ガード、制約仕様は、OCL や英語などの言語のテキストを持ちます。変換ツールは、各本体をテキスト表現 language "OCL" /* … */ として保持します。SysML または KerML の本体は、テキストの他の部分と同様にチェックされます。テキスト表現を参照してください。
使い方
使う場面と理由
チームが既存の SysML 1.x モデルを SysML v2 に移行するとき、またはその一部を再利用したいときにインポートを使います。変換されたテキストは出発点です。手作業で確認すべき箇所はレポートに示されます。
SysML v1 モデルをプロジェクトにインポートする
- SysML v2 プロジェクトを開き、モデル → インポートとエクスポートをクリックします。
- インポートで、このプロジェクトへまたは新しい SysML v2 プロジェクトへを選択します。
.xmi、.uml、.xml、または.mdzipファイルをボックスにドロップするか、ボックスをクリックして選択します。Reading the XMI file…、Converting to SysML v2…、Checking the result… の段階を示す進行状況カードが表示されます。- プレビュー上部のSysML v1 からの変換を読みます。変換、近似、除外された要素の数と、SysML v2 テキストのチェックで問題がないかどうかが示されます。
- 表示を使って、近似および除外された要素、そのどちらか一方、またはすべての要素を一覧表示します。各行には、要素、その SysML v1 の種類、SysML v2 のキーワードと修飾名を含む結果、および理由が示されます。
- インポートする前に結果を読むには、SysML v2 テキストを表示を開きます。
- 下の表で不要なパッケージのチェックを外し、Import N Packages(またはプロジェクトを作成)をクリックします。モデルがインポートされます。1 回の元に戻すですべて取り消せます。元に戻すで再び除去されます。
同じモデルの新しいバージョンをインポートする
SysML v1 モデルが変わったら、再度エクスポートし、新しいファイルを同じプロジェクトにインポートします(このプロジェクトへ)。変換された各要素は、XMI ファイル内の要素の ID(xmi:id)から ID を得るため、インポートは要素をその場で更新します。SysML v1 ツールで名前を変更した要素や別のパッケージに移動した要素は、ダイアグラムのレイアウト、コメント、リンク、履歴とともに同じ要素のまま残ります。レポートには、SysML v1 モデルから ID を得た要素の数が示されます。名前のない要素(コネクター、サクセッション)は、モデル内の位置で照合されます。
Holarch が XMI ファイルから ID を導出するようになる前に SysML v1 モデルからインポートしたプロジェクトは、その ID を保持します。新しいエクスポートは要素を名前で更新し、SysML v1 モデルで新しく追加された要素はそこから ID を得ます。
レポートとテキストを保存する
- すべての要素、その結果、SysML v2 のパス、理由を含む CSV ファイルを得るには、レポートをダウンロードをクリックします。
- 変換された
.sysmlファイルを得るには、SysML v2 テキストをダウンロードをクリックします。
SysML v1 ツールからモデルをエクスポートする
- Cameo Systems Modeler と MagicDraw:
.mdzipプロジェクトを直接インポートするか、File → Export To → Eclipse UML2 (v5.x) XMI Fileを使って.xmiファイルをインポートします。 - Enterprise Architect:パッケージを選択し、Publish → Export XMLを選んで XMI 2.1 を選択し、
.xmlファイルをインポートします。Enterprise Architect のプロジェクトファイル(.eap、.qea)は直接読み取れません。 - IBM Rhapsody:XMI ツールキット(XMI 2.x)でモデルをエクスポートし、ファイルをインポートします。
- Eclipse Papyrus:モデルの
.umlファイルをインポートします。
作業例:CubeSat EO-1 モデル
CubeSat EO-1 デモは LML プロジェクトです。その SysML v1 エクスポートは、現実的なテストモデルになります。
- CubeSat EO-1 デモを開き、OMG XMI 2.5.1 形式の UML/SysML XMI としてエクスポートします(UML/SysML モデルのエクスポート(XMI)を参照)。
- SysML v2 プロジェクトを開き、モデル → インポートとエクスポートをクリックして新しい SysML v2 プロジェクトへを選択し、
.xmiファイルをドロップします。レポートには、1,042 個の要素、1,007 個が変換、32 個が近似、3 個が除外と表示されます。SysML v2 テキストのチェックで問題はありません。 - 表示を除外に設定します。3 行は、SysML v2 にないユースケースの拡張と、SysML v2 テキストでは参照できない名前のない要素への 2 つのトレース関係です。
- プロジェクトを作成をクリックします。衛星の構造、機能、要求、トレースを含む新しい SysML v2 プロジェクトがエディターで開きます。
ヒントとよくある間違い
- XMI ファイルは、他のファイルを含めずに一度に 1 つずつインポートします。Import one SysML v1 XMI file at a time, without other files.
- トレース先の要素には名前を付けます。SysML v2 テキストは要素を名前で参照するため、名前のない要素への関係は除外されます。
- 作り直さずに再インポートします。新しいエクスポートは、新しいプロジェクトではなく同じプロジェクトにインポートします。要素が ID を保持するのは、その要素を持つプロジェクト内に限られます。
- まず近似を確認します。ブロックで型付けされたポートや、パート内のコネクター端など、意味が v1 モデルと異なる可能性がある箇所です。
- 同じ場所にある同名の要素は、
_2などの接尾辞を付けて名前が変更されます。レポートには、名前の変更がそれぞれ一覧表示されます。 - 要求管理ツールで管理されている要求(DOORS、Polarion、Jama、codebeamer)は、XMI ではなく ReqIF として受け渡されます。同じページで
.reqifファイルをインポートすると、同じ種類のレポートとともに SysML v2 の要求になります(ReqIF 要求のインポートとエクスポート)。
変換されるもの
| SysML v1 | SysML v2 |
|---|---|
| モデル、パッケージ | package |
| ブロック、アクター | part def |
| 値型、データ型、列挙 | attribute def、enum def(既知の SI 単位を持つ値型は ISQ の量を特化します) |
| シグナル | item def |
| インターフェースブロック | port def |
| パートプロパティ、参照プロパティ、値プロパティ | part、ref part、attribute(多重度と既定値付き) |
| プロキシポート、フロープロパティ | port、in/out の item または attribute |
| フルポート | @SysMLv1Library::PortData 付きの part |
| コネクター、バインディングコネクター、アイテムフロー | connect, bind, flow |
| 汎化 | :> |
| アクティビティ、呼び出し振る舞いアクション、ピン | action def、action、パラメーター |
| 制御フローとオブジェクトフロー、ガード | if ガードと else を持つサクセッション、パラメーター間のフロー |
| 開始、終了、デシジョン、マージ、フォーク、ジョイン | start, done, decide, merge, fork, join |
| ステートマシン、状態、領域 | state def、state、並行状態 |
| 遷移、シグナルトリガーとタイムトリガー | accept、accept after、ガード、エフェクトを持つ transition |
| インタラクション | ライフラインとメッセージを持つ occurrence def |
| ユースケース、主体、包含 | use case def, subject, include |
| 要求(ID とテキスト) | requirement <'id'> Name { doc /* text */ } |
| 満足、検証、要求の派生 | satisfy、検証目的内の verify、派生の接続 |
| 詳細化、トレース | SysMLv1Library メタデータ付きの dependency |
| 割り当て、依存関係 | allocate, dependency |
| 制約ブロック、制約 | constraint def, assert constraint |
| ステレオタイプとタグ付き値 | ステレオタイプごとの metadata def(タグとともに適用) |
| コメント、ドキュメンテーション | doc, comment |
制限事項
- 最大 64 MB のファイル 1 つ。
- 最大 250,000 個の要素、入れ子は最大 512 レベル。それより深く入れ子になったモデルや、所有関係が循環しているモデルはインポートされません。
- 変換されたモデルでは、128 レベルを超えて入れ子になった要素は、理由 nesting とともに除外されます。
- 変換されたテキストは最大 8 MB です。
- ダイアグラムとそのレイアウトは変換されません。SysML v2 プロジェクトでビューを作成してください。
メッセージ
| メッセージ | すること |
|---|---|
| SysML v1 XMI ファイルは、他のファイルを含めずに一度に 1 つずつインポートしてください。 | XMI ファイルを単独でインポートします。 |
| <file> には UML または SysML の要素が含まれていません。モデルを XMI 2.x としてエクスポートし、再びインポートしてください。 | モデルを XMI 2.x として再度エクスポートします。 |
| <file> に UML モデルが見つかりません。Cameo または MagicDraw で、モデルを Eclipse UML2 XMI としてエクスポートし、.xmi ファイルをインポートしてください。 | プロジェクトを XMI としてエクスポートします。 |
| SysML v1 モデルの要素が 250,000 個を超えています。モデルのより小さな部分をエクスポートしてください。 | パッケージを 1 つずつエクスポートします。 |
| 変換された SysML v2 テキストが 8 MB を超えます。モデルのより小さな部分をエクスポートしてください。 | パッケージを 1 つずつエクスポートします。 |
関連ページ
- SysML v2 モデルの交換
- ReqIF 要求のインポートとエクスポート:DOORS、Polarion、その他の要求管理ツールの要求。
- SysML v2 テキスト表記
- LML と SysML v2 の間の変換
SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。