SysML v1 から SysML v2 へ
SysML v1 モデルを描き直さずに SysML v2 へ移行できます。
XMI(.xmi、.xml、.uml)または .mdzip プロジェクトアーカイブとして保存した SysML v1 モデルを、SysML v2 プロジェクトにドロップします。Holarch はモデルを SysML v2 テキストに変換してチェックし、何かをインポートする前に、すべての要素を変換、近似、除外のいずれかとして理由とともに報告します。
変換器は Free を含むすべてのプランに含まれています。新しいアカウントは最初のサインイン時に 30 日間の Individual トライアルを開始します。プロジェクトあたり 10,000 項目、カードは不要で、終了すると Free に戻ります。アカウントをお持ちの場合は、トライアルを開始できます。
実証:CubeSat EO-1 モデル
| 結果 | 要素 |
|---|---|
| 変換 | 1,007 |
| 近似 | 32 |
| 除外 | 3 |
| 読み込んだ要素 | 1,042 |
| SysML v2 テキストの問題 | 0 |
変換後のテキストはエラーも警告もなくチェックを通過し、同じモデルは毎回同じテキストに変換されます。近似・除外された内容
SysML v1 モデルのインポート
SysML v1 モデルの XMI ファイルまたは .mdzip プロジェクトを SysML v2 プロジェクトにインポートします。何かを作成する前に、変換レポートがすべての要素を変換、近似、除外に分類して理由とともに一覧表示し、CSV ファイルとして保存できます。例は CubeSat EO-1 モデルで、1,042 要素を問題なくインポートしました。
変換器から得られるもの
作業に使える SysML v2 モデルと、レビューすべき内容の明確な一覧。
描き直し不要
ブロックは part def になり、ポート、コネクター、アイテムフローも移行されます。要求は ID とテキストを保持し、satisfy、verify、allocate の関係はトレースされたまま残ります。
すべての要素のレポート
v1 モデルの各要素が、v1 での種類、結果、変換後の SysML v2 名、そして近似または除外されたものについては理由を文章で示して一覧表示されます。画面上で絞り込むか、CSV としてダウンロードできます。
インポート前にチェック
入力中の SysML v2 エディターをチェックしているのと同じエンジンが、変換後のテキストをチェックします。結果、テキスト、レポートを先に確認でき、インポートは 1 回の元に戻す操作で取り消せる単位です。
v1 モデルの変更に合わせて再インポート
要素の ID は v1 モデルの XMI ID から取られます。新しいエクスポートを同じプロジェクトにインポートすると、名前の変更や移動があった要素も含めて、要素はダイアグラムのレイアウト、コメント、リンク、履歴を保ったままその場で更新されます。
作業に使えるモデル
エディター、ビュー、要求、検証など SysML v2 プロジェクトの各ページは、変換したモデルを他のモデルと同じように読み込みます。
v1 モデルはそのまま
Holarch はそのエクスポートを読み込むだけで書き戻すことはないため、チームが SysML v2 版をレビューする間、v1 モデルは参照用として残ります。
仕組み
- ファイルをドロップします。SysML v2 プロジェクトでモデル → インポートとエクスポートをクリックし、このプロジェクトへまたは新しい SysML v2 プロジェクトへを選んで、
.mdzip、.xmi、.uml、.xmlのいずれかのファイルをドロップします。進行状況カードに、読み込み、変換、チェックが表示されます。 - レポートを確認します。SysML v1 からの変換には、件数、テキストが問題なくチェックを通過したかどうか、近似・除外された要素とそれぞれの理由が表示されます。SysML v2 テキストを表示で結果を開き、残しておくにはレポートや
.sysmlファイルをダウンロードします。 - インポートします。不要なパッケージのチェックを外してインポートします。元に戻すを 1 回行えば、インポート全体が取り消されます。
各ツールのエクスポート設定を含む手順は、ドキュメントのSysML v1 モデルのインポートを、プログラム全体の移行計画については移行ガイドをご覧ください。
変換されたブロック
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';
}2 つのパート、ワット単位の値プロパティ、アイテムフロー付きのプロキシポート間コネクター、satisfy 関係を持つカプセル化ブロックの変換結果です。移行ガイドでは、小さなモデル全体の変換前と変換後を示しています。
読み込める形式
- XMI 2.x 形式の SysML v1:SysML 1.x プロファイルを適用した UML 2.5。
.xmi:XMI ファイル。.xml:.xml拡張子で保存した XMI。.uml:XMI モデルファイル。.mdzip:モデルを XMI として含む zip 形式のプロジェクトアーカイブ。Holarch は内部の XMI を読み込みます。- その他のプロジェクト形式:独自のプロジェクト形式でモデルを保持するツールでは、まずモデルを XMI としてエクスポートします。
1 回のインポートで 1 ファイル、最大 64 MB、250,000 要素、入れ子 512 階層まで。
出力されるもの
- 開いているプロジェクトまたは新しい SysML v2 プロジェクト内の SysML v2 テキスト。1 回の元に戻す操作で取り消せる単位でインポートされます。
- テキストのチェック。インポート前に表示されます。
- すべての要素の変換レポート。画面上で絞り込め、CSV としてダウンロードできます。
- レビュー用や他の SysML v2 ツール用にダウンロードできる
.sysmlファイル。
変換は、OMG SysML 2.0 仕様の SysML v1 から SysML v2 への変換に基づいています。
変換、近似、除外
v1 モデルのすべての要素は 3 つの結果のいずれかになるため、どこを確認すべきかが正確にわかります。
変換
要素に直接対応する SysML v2 の要素があります。ブロックは part def に、インターフェースブロックは port def になり、要求は ID とテキストを保持します。
近似
要素は形を変えて保持されます。インターフェースブロックで型付けされたフルポートはポートになり、選択を経由する遷移は経路ごとに 1 つの遷移になり、対応付けられた SI 単位ではない単位は、単位をドキュメントに記した実数になります。
除外
SysML v2 に対応するものがないか、要素がファイルにないものを参照しています。例としては、フロー終了ノード、アクティビティパーティション、ユースケースの拡張、名前のない要素への関係があります。
カプセル化されたブロック、フルポート、詳細化関係など、SysML v2 にキーワードのない SysML v1 のプロパティは、SysMLv1Library パッケージのメタデータとして保持されます。Holarch はこのパッケージをすべての SysML v2 プロジェクトで読み込みます。独自のステレオタイプはタグ付き値を持つメタデータ定義になり、不透明な振る舞い、ガード、制約は、language "OCL" /* … */ のようなテキスト表現として本体を保持します。
変換の対応表
主な対応です。すべての対応はドキュメントに掲載しています。
| SysML v1 | SysML v2 |
|---|---|
| パッケージ | package(v1 と同じ入れ子構造) |
| ブロック、アクター | part def |
| 値型、列挙型 | attribute def、enum def。既知の SI 単位を持つ値型は ISQ の量を特化します |
| パートプロパティ、参照プロパティ、値プロパティ | part、ref part、attribute(多重度と既定値付き) |
| インターフェースブロック、プロキシポート、フロープロパティ | port def、port、方向付きの item または attribute |
| コネクター、バインディングコネクター、アイテムフロー | connect, bind, flow |
| アクティビティ、アクション、制御フローとオブジェクトフロー | action def、アクション、ガード付きのサクセッション、パラメーター間のフロー |
| ステートマシン、状態、遷移 | state def、状態、accept・ガード・エフェクト付きの遷移 |
| 要求、satisfy、verify、derive | ID とテキストを持つ requirement、satisfy、verify、導出の接続 |
| allocate、refine、trace | allocate、SysMLv1Library メタデータ付きの dependency |
| ユースケース、インタラクション、制約ブロック | use case def、メッセージ付きの occurrence def、constraint def |
| ステレオタイプとタグ付き値 | ステレオタイプごとの metadata def(タグとともに適用) |
実例:CubeSat EO-1 モデル
CubeSat EO-1 デモを SysML 1.6 XMI としてエクスポートし、新しい SysML v2 プロジェクトにインポートしました。読み込んだ要素 1,042、変換 1,007、近似 32、除外 3 です。SysML v2 テキストはエラーも警告もなくチェックを通過し、新しいプロジェクトは衛星の構造、機能、要求、トレースを備えた状態で開きます。近似・除外されたすべての要素を理由別に示します。
| 要素 | 結果 | 理由 |
|---|---|---|
| コネクター 10 件 | 近似 | コネクターの端がパートの内部にあり、そこへのパスをパートの型から求めました。 |
| 遷移 8 件 | 近似 | when Undervoltage などの変化トリガーと時間トリガー 4 件はドキュメントとして保持しました。Contact Start などシグナルのないイベント 4 件には、同じ名前のアイテム定義を作成しました。 |
| アイテムフロー 6 件 | 近似 | 同じ場所で名前が 2 回使われていたため、フローの名前に接尾辞を付けました。 |
| 値型 5 件 | 近似 | 単位(%、GB、Mbps、mNms、W/m^2)が Holarch の対応付ける SI 単位ではないため、値型は単位をドキュメントに記した実数になりました。 |
| 制御フロー 2 件 | 近似 | ガード付きの分岐と並んでガードのない分岐があったため、ガード true を付けました。 |
| 最終状態 1 件 | 近似 | 最終状態は通常の状態になりました。 |
| ユースケースの拡張 1 件 | 除外 | SysML v2 にはユースケースの拡張がありません。 |
| トレース関係 2 件 | 除外 | 名前のない要素を参照しており、SysML v2 テキストではそれを参照できません。 |
EO-1 のファイルは Holarch 自身の SysML 1.6 エクスポートなので、Holarch が書き出す範囲の SysML v1 を使っています。他のツールのモデルは通常、言語のより多くの部分を使うため、数値は異なります。重要なのはお客様自身のモデルのレポートであり、何かをインポートする前に確認できます。複数の SysML v1 ツールの XMI 形式で書かれた Holarch のテストモデルも、問題なくチェックを通過するテキストに変換され、同じモデルは毎回同じテキストに変換されます。
よくある質問
変換で失われるものは何ですか。
ダイアグラムとそのレイアウトは変換されません。重要なダイアグラムについては、SysML v2 プロジェクトでビューを作成してください。ユースケースの拡張、フロー終了ノード、アクティビティパーティションなど、SysML v2 に対応するもののない要素は除外されます。名前のない要素への関係も、SysML v2 テキストは名前で要素を参照するため除外されます(エクスポートする前に、トレース先の要素に名前を付けてください)。近似された要素は形を変えて保持されます。v1 モデルと意味が異なる可能性がある箇所なので、最初にレビューしてください。レポートには、そのすべてが理由とともに記載されます。
変換したモデルはすぐに使えますか。
問題なくチェックを通過し、SysML v2 プロジェクトのすべてのページで動作しますが、出発点として扱ってください。言語間の違いの中には、単なる翻訳ではなくモデリング上の判断が必要なものがあります。SysML v2 プロジェクトの対応内容と既知の未対応箇所:SysML v2 言語の対応範囲。
どのくらいの大きさのモデルを変換できますか。
1 ファイル最大 64 MB、最大 250,000 要素、入れ子は最大 512 階層、変換後のテキストは最大 8 MB です。それより大きなモデルはパッケージごとにエクスポートしてください。変換後のモデルにはプランのプロジェクトあたりの項目数が適用されます。Free は 1,000、Individual は 10,000、Team は 50,000 です。項目として数えられるものをご覧ください。10,000 項目を超えるモデルについては、Team の評価をご依頼ください。
SysML v1 ツールでの作業を続けられますか。
はい。Holarch はエクスポートを読み込むだけで、v1 モデルを変更することはありません。v1 モデルが変わったら、再度エクスポートして新しいファイルを同じプロジェクトにインポートします。要素の ID は XMI ファイルから取られるため、名前の変更や移動の後でも、要素はその場で更新されます。同じ場所にある同名の要素には _2 などの接尾辞を付けて名前を変更し、レポートに各変更が記載されます。
ファイルはどこに送られますか。
Holarch は XMI または .mdzip ファイルをお客様のブラウザー内で読み込んで変換します。ファイル自体はアップロードされません。app.holarch.app では、プレビューを準備するために変換後の SysML v2 テキストが Holarch に送信され、インポートした場合にのみプロジェクトに保存されます。ホスト型サービスは CUI や輸出管理対象の情報を受け付けません。それらについては、Holarch をお客様自身の環境で実行できます(Enterprise)。詳しくはセキュリティをご覧ください。
要求管理ツールで管理している要求はどうなりますか。
要求は、標準の要求交換形式である ReqIF(.reqif、.reqifz)でやり取りできます。Holarch は LML プロジェクトと SysML v2 プロジェクトで ReqIF をインポート・エクスポートします。SysML v2 プロジェクトでは、ReqIF ファイルは要求、要求定義、パッケージになり、変換内容のレポートが出力されます。要求は元の識別子のままエクスポートされます。CubeSat EO-1 デモを Holarch から ReqIF に出して戻すラウンドトリップでは、407 項目すべてと 979 の属性値が変わらずに戻りました。LML プロジェクトでの ReqIF · SysML v2 プロジェクトでの ReqIF
変換器の料金はいくらですか。
追加料金はかかりません。Free を含むすべてのプランに含まれています。プランの違いは、プロジェクトあたりの項目数と、モデリング以外に含まれる機能です。料金をご覧ください。
自社ツールに移行機能を組み込みますか。
変換器は、Holarch の SysML v2 プロジェクトを支えるエンジンである Holarch Language Engine の一部で、ツールベンダーやインテグレーターに移行アドオンとしてライセンス提供しています。Holarch で動作しているものと同じ変換器です。
- お客様の製品が XMI ファイルを読み込み、エンジンが変換します。v1 モデルをドキュメント化された中立形式の JSON で送ると、SysML v2 テキスト、エンジンによるそのチェック結果、そして安定した理由コードと変換後の SysML v2 名を含むすべての要素のレポートが JSON で返されます。
- お客様の製品が動く場所で動作:ブラウザーでは Web Worker 内の WebAssembly として、サーバーではサーバー利用付きの Node.js または Python 拡張機能を通じて動作します。
- 再現性があり、上限が明確:同じモデルは毎回同じテキストに変換されます。対象は最大 250,000 要素のモデルで、それより大きいモデルにはエラーが返され、処理が止まることはありません。
- ライセンストークンで有効化:再ビルドもコードの変更も不要です。60 日間の無料評価版は、ドキュメントとサンプル付きでお客様のコンピューター上で動作します。
リクエストとその応答
// 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" }, … ] } }
エンジンの API リファレンスにある v1_convert リクエスト。エンジンはシミュレーションとサーバーでの利用もアドオンとして提供しています。
自分のモデルを SysML v2 で確認しましょう。
変換してレポートを読み、納得したらインポートします。
新しいアカウントは最初のサインイン時に 30 日間の Individual トライアルを開始します。プロジェクトあたり 10,000 項目、カードは不要で、終了すると Free に戻ります。アカウントをお持ちの場合は、アカウント設定 → プランと請求でトライアルを開始できます。