SysML v2
SysML v2 モデルの交換
.sysml ファイル、zip アーカイブ、SysML v2 JSON をプレビュー付きで SysML v2 プロジェクトにインポートし、モデルまたはパッケージを .sysml テキストまたは SysML v2 JSON としてエクスポートします。
概要
SysML v2 プロジェクトは、他の SysML v2 ツールとファイルでモデルを交換します。インポートとエクスポートページ(モデル → インポートとエクスポート)で両方を行います。
- インポートは、
.sysmlファイル、.sysmlファイルの.zip、または SysML v2 JSON ファイルを読み取ります。変更内容のプレビューを表示してから、このプロジェクトに適用するか(1 回の元に戻すですべて取り消せます)、新しい SysML v2 プロジェクトを作成します。 - エクスポートは、モデル全体または 1 つのパッケージを SysML v2 テキスト(
.sysml)または SysML v2 JSON(.json)として書き出します。 - 要求管理ツールの ReqIF ファイル(
.reqif、.reqifz)は SysML v2 の要求としてインポートされ、要求は ReqIF としてエクスポートされます:ReqIF の要求をインポート・エクスポートするを参照してください。
ファイルから直接プロジェクトを作成することもできます:プロジェクトを管理で、プロジェクトファイル ▾ → Import SysML v2 Files…をクリックします。
ヒント:Systems Modeling API を提供する SysML v2 モデルリポジトリとモデルを同期させるには、同じページのリポジトリセクションを使います:リポジトリからプル・リポジトリにプッシュするを参照してください。
概念
ファイル形式
| 形式 | 内容 | インポート | エクスポート |
|---|---|---|---|
SysML v2 テキスト(.sysml) | テキスト表記。最上位のパッケージごとに 1 ファイル。 | はい | はい |
Zip アーカイブ(.zip) | 複数の .sysml ファイル。フォルダーはパッケージになります。 | はい | はい、複数のファイルをエクスポートする場合 |
SysML v2 JSON(.json) | Systems Modeling API が使うような、それぞれ @id と @type を持つ要素のフラットなリスト。 | はい | はい |
ReqIF(.reqif、.reqifz) | DOORS、Polarion、Jama、codebeamer などの要求管理ツールからの、属性、階層、関係を含む要求。 | はい、要求に変換されます | はい、要求が対象です |
KerML ファイル(.kerml)はまだインポートできません。
ID と照合
SysML v2 プロジェクトのすべての要素には ID があります。2 つの形式では ID の保持方法が異なります。
- JSON は ID を保持します。JSON から再度インポートした要素は、同じ ID を持つ要素と照合されます。
- 標準ライブラリの参照は解釈されます。Systems Modeling API、SysML v2 Pilot Implementation、またはその他のリポジトリからの JSON は、標準ライブラリの要素(
ISQ::mass、ScalarValues::Real、Parts::Partなどの単位)を標準の ID で指定します。インポートはそれらを同じライブラリ要素として読み取るため、単位と型は解決されたままです。 - テキストは、求めた場合に ID を保持します。
.sysmlテキストをエクスポートするときに要素 ID を含めるにチェックを入れます。すると、名前付きの定義、使用、パッケージはすべて、本体の最初の行に ID を持ちます:@HolarchMetadata::ElementId { id = "…"; }。そのテキストを再度インポートすると、ID を持つ各要素は、名前の変更、別のオーナーや別の最上位パッケージへの移動、並べ替えが行われていても、同じ ID を持つ要素と照合されます。ダイアグラム上の位置、コメント、トレース、リンクは残ります。 - ID のないテキストは名前で照合されます。Holarch は最上位のパッケージを名前で、その中の要素を名前と位置で照合します。照合された要素では ID が保持されます。名前を変更した要素も、同じ位置にあれば照合されます。名前の変更と移動を同時に行った要素は、新しい要素になります。
エクスポートのコントロールの下に、次の注記があります:「Element ids are kept in JSON. In .sysml text, tick Include element ids to keep them: elements then keep their diagram positions, comments and traces when the edited text is imported again, even after a rename or a move. Without ids, elements are matched by name.」
テキスト内の要素 ID
@HolarchMetadata::ElementId { id = "…"; } は通常の SysML v2 メタデータです:ElementId は、TBD や TBR と並んで、Holarch 独自のライブラリパッケージ HolarchMetadata(標準ライブラリの Holarch の下)にあるメタデータ定義です。他の SysML v2 ツールはこの行をメタデータ注釈として読み取ります。その名前を解決するには、そのライブラリの HolarchMetadata.sysml が必要です。
- ID は、その行を本体に持つ要素に属します。名前のない要素(接続、サクセッション、コメント)は ID を持たず、従来どおり内容で照合されます。
- Holarch はこの行を要素として保持しません。エディターはこれらの行を除いたモデルを表示し、本体にこの行しかなかった要素は
part engine : Engine;と表示されます。 - ID は一意である必要があります。同じ ID が 2 回現れた場合(例えば、テキストでブロックをコピーした後)、最初の要素がその ID を保持し、コピーは新しい要素になります。
- UUID でない ID(例:
"R-17")は固定の UUID に変換されるため、JSON のインポートと同様に、同じ文字列は常に同じ要素になります。 - プロジェクトにない ID は、新しい要素のために保持されます。Holarch で要素を削除してからテキストを再度インポートすると、その要素が元の ID で戻ります。
- エディターでは、貼り付けた行は編集中のパッケージ内で機能します:別のパッケージの要素に属する ID はそこでは無視され、要素は名前で照合されます。ID を保持したままパッケージ間で要素を移動するには、ID 付きでエクスポートし、編集したファイルをインポートします。
Hybrid Car デモのパート定義 Car は、そのソースファイルにこの行を持っているため、デモのどのコピーでも ID が同じです。
フォルダーはパッケージになります
zip アーカイブでは、各フォルダーが、そのファイルとサブフォルダーを含むパッケージになります。アーカイブ内のファイル powertrain/engine.sysml は、package powertrain { … } の中に書かれているかのように読み取られます。アーカイブの最上位にあるファイルはそのまま読み取られます。フォルダーとファイルは名前順に読み取られます。
プレビューで比較される内容
プレビューには、最上位のパッケージごとに(新しいプロジェクトの場合は最上位の要素ごとに)1 行があります。各行には結果があります。
| 結果 | 意味 | 既定でインポート |
|---|---|---|
| 新規 | プロジェクトにその名前(または ID)のパッケージがありません。追加されます。 | はい |
| 変更 | プロジェクトにそのパッケージがあり、インポートによってその中の要素が追加、変更、除去されます。詳細にその数が示されます(例:「3 added, 1 changed (ids kept where elements match)」)。 | はい |
| 変更なし | パッケージはこのプロジェクトのものと同じです。 | いいえ(何もしません) |
| 競合 | パッケージをマージできません。詳細に理由と対処方法が示されます。 | いいえ |
使い方
使う場面と理由
モデルを Holarch と別の SysML v2 ツールの間、または Holarch のプロジェクト間で移動するときは、インポートとエクスポートを使います。
- 他の場所で書かれたモデルから Holarch プロジェクトを始める。
- コンポーネントライブラリなど、他のチームが保守するパッケージを取り込み、新しいバージョンが届いたら更新する。
- パッケージを、サプライヤーや SysML v2 テキストまたは JSON を読み取るツールに渡す。
- Holarch プロジェクトと並べて、自分のバージョン管理で
.sysmlファイルを管理する。
このプロジェクトにファイルをインポートする
- モデル → インポートとエクスポートを開きます。
- インポートで、このプロジェクトへを選択します。
- ファイルをドロップゾーンにドロップするか、ドロップゾーンをクリックしてファイルを選択します。
「Reading the files…」と表示された後、プレビューが表示されます:最上位のパッケージとファイルの数、問題があればその内容、およびインポート、パッケージ、要素、結果を含む表です。
- 問題リストがある場合は、それを確認します。解析できない各ファイルと行、およびスキップされた各ファイルが示されます。
- インポートしたくないパッケージのチェックを外します。名前が競合するパッケージを置き換えるには、そのパッケージにチェックを入れます。
項目数の上限があるプランでは、プレビューはインポート後にプロジェクトが持つ項目の数を数えます(関係は数えません)。それが上限を超える場合は、たとえば「This import would bring the project to 1,804 items; the Free plan allows 1,000.」のように表示され、十分な数のパッケージのチェックを外すまでImport N Packagesはオフのままです。何も適用されず、サーバーにも送信されません。新しいプロジェクトへのインポートも、同じようにプランのプロジェクトごとの上限と照合されます。
- Import N Packagesをクリックします。
トーストには「Imported N packages.」と表示されます。ページには「Imported N packages (M elements). Undo reverts the import in one step.」と表示されます。Open Textをクリックすると、それらが表示されます。
新しいプロジェクトにファイルをインポートする
- モデル → インポートとエクスポートを開き、新しい SysML v2 プロジェクトへを選択します。
- ファイルをドロップするか、選択します。
プレビューには最上位の要素が、すべてチェックされた状態で一覧表示されます。
- 不要なもののチェックを外し、プロジェクト名を編集します。既定値は、単一のファイルの名前、または最初のパッケージの名前です。
- プロジェクトを作成をクリックします。
新しいプロジェクトがエディターで開きます。
プロジェクトを管理から、プロジェクトファイル ▾ → SysML v2 ファイルをインポート…を使うと、同じ操作を 1 ステップで行えます。ファイルの一部を読み取れない場合は、先に確認があります:「N problems found: parts of the files are left out. Create the project with the rest? To see the problems first, open a SysML v2 project and use Import and Export.」続行するにはプロジェクトを作成をクリックします。
新しいバージョンからパッケージを更新する
- 新しいバージョンを
.sysmlファイルまたは JSON としてエクスポートするか、受け取ります。 - それをこのプロジェクトへインポートします。
パッケージにChangedと表示され、追加、変更、削除された要素の数が示されます。
- Import 1 Packageをクリックします。
一致する要素は ID を保持するため、それらへのリンク(要求リンク、リスク、ビューのレイアウト、コメント)は維持されます。ファイルにもう含まれていない要素はゴミ箱に移動します。
テキストで要素の名前変更と移動を行い、ID を保持する
- 要素 ID を含めるにチェックを入れて、パッケージをSysML v2 テキストとしてエクスポートします。
- ファイルを編集します。要素の名前を変更する、別の所有者や別のパッケージファイルに移動する、並べ替えるなどの操作を行います。各
@HolarchMetadata::ElementId行は、その要素の本体の中に残しておきます。 - 編集したファイルをこのプロジェクトへインポートします。
パッケージにChangedと表示されます。名前を変更した要素や移動した要素は、追加と削除ではなく、変更として数えられます。
- Import N Packagesをクリックします。
要素は ID を保持します。ダイアグラム上の位置、コメント、トレース、リンクは維持されます。別のパッケージに移動した要素は、元のパッケージから外れます。
ホスト型サービスでの大規模なインポート
ホスト型サービスでは、5,000 個以上の要素のインポートは、ブラウザーではなくサーバーによって適用されます。チェックしたパッケージがすべて新規であるか、競合を置き換えるものである場合は、サーバーがファイルを自分で読み取ります(以下の手順)。チェックしたパッケージがChangedの場合は、ブラウザーが通常どおりマージを計算して変更を一度だけアップロードし、その後サーバーがそれを 1 ステップで書き込みます。同じ進行状況カード、Cancel Import、Undo Import が使えます。
- 通常のインポートと同じように、ファイルを選択してプレビューを確認します。
- Import N Packages(またはプロジェクトを作成)をクリックします。
ファイルは一度だけアップロードされます。サーバーは、プレビューと同じチェックと同じ要素 ID でそれを読み取り、結果を 1 ステップで書き込みます。
- ウィンドウ下部の進行状況カードで経過を確認します。段階(アップロード、読み取り、チェック、適用、プロジェクトインデックスの更新)と残り時間が表示されます。
ページを離れたり、タブを閉じたりしてもかまいません。インポートはサーバーで続行され、プロジェクトを再び開くと結果が反映されています。インポートが適用されると、開いているプロジェクトのすべてのコピーが再読み込みされます。送信されていない編集は、再読み込みの後に再送信されます。
- 他のメンバーには、同じカードとインポートとエクスポートのページに「Name is importing file…」と表示されます。
- インポートは一度に 1 つ:同じプロジェクトへの 2 つ目の大きなインポートは、最初のものが終わるまで待機します。
- インポートをキャンセル(開始した人またはオーナー)は、インポートが適用される前に停止します。何も変更されません。
- インポートを元に戻す:ブラウザーでの ⌘Z / Ctrl+Z では、サーバーでのインポートは取り消せません。インポートとエクスポートのページでインポートを元に戻すをクリックすると、プロジェクトが最新のインポートの前の状態に戻ります。元に戻す前の状態は履歴に保持されるため、インポートの後に行った編集はそこから復元できます。
- Project Activityと履歴には、インポートが開始した人による 1 件のエントリとして一覧表示されます。
モデルまたはパッケージをエクスポートする
- モデル → インポートとエクスポートを開きます。
- エクスポートで、エクスポートする対象を選択します:モデル全体、または修飾名で指定したパッケージ。
- 形式を選択します:SysML v2 テキスト(.sysml。複数のパッケージは .zip)またはSysML v2 JSON(.json)。
- 編集して再びインポートするテキストの場合は、要素 ID を含めるにチェックを入れます。
- エクスポートをクリックします。
ファイルが 1 つダウンロードされます。エクスポートに複数のファイルが含まれる場合は zip になります。トーストには「Exported <file>.」または「Exported N files as a zip.」と表示されます。
1 つのパッケージをすばやくエクスポートするには、ブラウザーを使います。パッケージの行メニューに.sysml としてエクスポートとJSON としてエクスポートがあります。
ReqIF の要求をインポート・エクスポートする
ReqIF は要求管理ツールの交換形式です。ReqIF ファイルは SysML v2 の要求からなる 1 つのパッケージとしてインポートされ、要求は ReqIF として書き戻されるため、要求管理ツールと SysML v2 プロジェクトは同じ要求を双方向でやり取りできます。
ReqIF ファイルをインポートするには:
- モデル → インポートとエクスポートを開きます(または要求ページでインポート…をクリックするか、⌘K / Ctrl+K でReqIF をインポート…を選択します)。
.reqifまたは.reqifzファイルをボックスにドロップするか、ボックスをクリックして選択します。1 回のインポートにつき ReqIF ファイルは 1 つです。- ReqIF パネルには、要求、章、関係の数、そのうち変換、近似、除外された数、および SysML v2 テキストのチェックで問題がないかどうかが表示されます。
- 短縮名の取得元で、外部 ID(ソースツールで表示される番号。
SRS-12など)またはReqIF 識別子(ツールの内部 ID)を選択します。外部 ID のない要求は識別子を使います。 - 関係の種類で、各関係の種類を何にするかを選択します:派生、詳細化、依存関係、または除外。プレビューが再計算され、選択内容は同じファイルの次回のインポートのために保持されます。
- Import 1 Packageをクリックします。1 回の元に戻すでインポート全体を取り消せます。トーストには「Imported N requirements from <title>.」と表示されます。
インポートで作成されるもの:
| ReqIF | SysML v2 |
|---|---|
| 要求(スペックオブジェクト) | requirement。外部 ID または識別子をショートネームとし、名前、テキストを doc として持ちます |
| 要求の型 | requirement def。ReqIF 属性ごとに 1 つの属性を持ちます |
| 列挙データ型 | enum def |
| ステータス属性(Draft、Proposed、Approved など) | Holarch での要求のステータス |
| 章の見出し | 章番号をショートネームとする package |
| 入れ子の要求 | 入れ子の requirement |
| derived from 関係 | 派生の接続 |
| refines 関係 | Refinement アノテーション付きの依存関係 |
| satisfies、verified by、その他の関係 | 依存関係(理由はレポートに記載されます) |
| 仕様 | ファイルのパッケージ内の package |
表はセル間を | で区切ったテキスト行になり、リストはダッシュで始まる行になります。書式とリンクはテキストだけが残ります。これらの要求は近似となります。画像と埋め込みオブジェクトはインポートされません。それを含んでいた要求は理由とともに一覧表示されるため、そのファイルを要求に添付できます。レポートをダウンロードは、すべての要求と関係を結果とともに CSV として保存します。SysML v2 テキストをダウンロードはテキストを保存します。
ファイルの新しいコピーをインポートする:同じプロジェクトにインポートします。Holarch は前回のインポートのパッケージを見つけ、要求ごとに比較します:
- 要求は要素 ID を保持するため、ダイアグラム、satisfy と verify のリンク、レビュー、履歴は関連付けられたまま残ります。名前を変更した要求や移動した要求は、その場で更新されます。
- 新しいファイルにない要求は保持されます。それらをゴミ箱に移動するには、Remove the N requirements missing from this fileにチェックを入れます。
- Holarch で追加したパート、検証ケース、リンクは保持されます。
- Holarch でのみ変更された要求は、その変更を保持します。Holarch とファイルの両方で変更された要求は、ファイルのテキストを採用します。以前のテキストは履歴に残ります。プレビューでは、これらがChanged here and in the fileの下に一覧表示されます。
ReqIF としてエクスポートするには:
- エクスポートで、パッケージまたはモデル全体を選択し、ReqIF(.reqif)またはReqIF アーカイブ(.reqifz)を選択します。
- エクスポートをクリックします。トーストには「Exported N requirements as <file>.」と表示されます。
データベースまたは要求ページのExport… → Requirements (ReqIF)は、一覧表示されている(または選択した)要求を同じ方法でエクスポートします。
ファイルには、各要求のショートネーム(ReqIF.ForeignID として)、名前、doc(XHTML として)、ステータス、属性値、仕様としてのパッケージ階層、および派生、詳細化、依存関係の関係が含まれます。ReqIF からインポートした要求は元の識別子、型、関係の種類を保持するため、ソースツールはコピーを追加せずに要求を更新します。ファイルをエクスポートして再びインポートすると、すべてのパッケージがUnchangedと表示されます。計算された属性値はテキストとして書き込まれます。satisfy と verify のリンクは Holarch に残ります。ReqIF にはパートや検証ケースがないためです。
リポジトリからプル・リポジトリにプッシュする
プロジェクトを SysML v2 モデルリポジトリの 1 つのブランチに接続すると、その最新のコミットを読み取り、変更を送り返すことができます。
- モデル → インポートとエクスポートを開き、リポジトリセクションを見つけます。
- リポジトリのアドレス(その Systems Modeling API の https アドレス)と、リポジトリで必要な場合はアクセストークンを入力します。
- プロジェクトを読み込むをクリックし、プロジェクトと分岐を選択します。このモデルから新しいリポジトリプロジェクトを始めるには、代わりに新しいリポジトリのプロジェクトをクリックします。
- プル…をクリックします。Holarch はブランチの最新のコミットを読み取り、各差分を新規、Changed、Removed、競合として一覧表示します。プルするものがない場合は「Up to date: no changes in the repository.」と表示されます。
- 不要な差分のチェックを外し、プルを適用をクリックします。1 回の元に戻すでプル全体を取り消せます。
- モデルを変更したら、プッシュをクリックします。最後に同期したコミット以降の変更が、1 つの新しいコミットとしてブランチに送られます。たとえば「Pushed 3 changed as commit 1a2b3c4d.」と表示されます。
競合とは、最後の同期以降に、このプロジェクトとリポジトリの両方で変更された要素です。チェックを外した競合は、このプロジェクトのバージョンを保持します。
注:このプロジェクトがプルしていないコミットがブランチにある場合、プッシュは拒否されます:「The repository branch has commits that this project has not pulled. Pull first, then push again.」
作業例:Hybrid Car デモ
まずデモを作成します:プロジェクトを管理で、プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2)をクリックします。
- モデル → インポートとエクスポートを開きます。エクスポートでモデル全体とSysML v2 テキストを選択し、エクスポートをクリックします。
最上位パッケージごとに 1 つのファイル(
Vehicles.sysml、VehicleRequirements.sysml、VehicleBehavior.sysml、VehicleViews.sysmlなど)を含む zip がダウンロードされます。 VehicleRequirements.sysmlをテキストエディターで開きます。attribute maxCurbMass : MassValue = 1650 [kg];を1600 [kg]に変更して保存します。- インポートとエクスポートに戻り、このプロジェクトへを選択して
VehicleRequirements.sysmlをドロップします。プレビューでは、VehicleRequirementsがChangedと表示され、変更された要素の数が示されます。他のパッケージはファイルに含まれていないため、一覧表示されません。
- Import 1 Packageをクリックします。
モデルの値が変わります。要求Sedan Mass(VR-1.1)は
maxCurbMassを参照しているため、そのリンクがレビュー対象としてマークされます(SysML v2 プロジェクトの要求と検証を参照)。インポートを元に戻すには ⌘Z / Ctrl+Z を押します。 - 同じファイルから 2 つ目のプロジェクトを始めるには、新しい SysML v2 プロジェクトへを選択し、zip をドロップしてプロジェクトを作成をクリックします。
ヒントとよい進め方
- ID が重要な場合(たとえば、相手のツールが ID でリンクを保持する場合)は、SysML v2 ツール間でモデルを移すのに JSON を使います。人がファイルを読んだりレビューしたりする場合はテキストを使います。編集後にテキストを Holarch に戻す場合は、要素 ID を含めるにチェックを入れます。
- 読むだけの人に渡すテキストには ID を含めないでください。要素ごとに 1 行が追加されるためです。
- 1 つのファイルには最上位パッケージを 1 つだけ入れます。エクスポートはそのようにファイルを書き出し、その後のインポートはパッケージ単位で照合します。
- 他のチームから受け取ったパッケージは、それ専用の最上位パッケージにインポートします。そうすれば、更新はそのパッケージだけに影響します。
- インポートする前に問題リストを確認します。解析できないメンバーは除外されます。
よくある間違い
- パッケージに 競合 と表示される:「A package named X with other ids exists.」プロジェクトに、この JSON からインポートされたものではない同名のパッケージがあります。行にチェックを入れて置き換える(古いパッケージはゴミ箱に移動します)か、新しいプロジェクトにインポートします。
- 「The import holds two top-level packages named X; only the first is imported.」2 つのファイルが同じ最上位パッケージを宣言しています。それらを 1 つのファイルにまとめるか、一方の名前を変更します。
- 名前を変更した要素が新規としてインポートされた。テキストに要素 ID がなく、要素の名前変更と移動が同時に行われました(または種類と名前の両方が変わりました)。要素 ID を含めるでエクスポートし、変更を加えて、再びインポートします。
- インポート後に要素が見つからない。解析できないメンバーは除外されます:「This member does not parse and is left out.」問題リストに示された行を修正してから、再びインポートします。
- JSON のインポートが拒否される。SysML v2 JSON ファイルは、
.sysmlファイルを含めずに、一度に 1 つずつインポートします。
他の機能との関係
- エディター:インポートしたパッケージはそこで開きます。エクスポートしたファイルは、そこに表示されるテキストです。
- 元に戻すとゴミ箱:このプロジェクトへのインポート全体を 1 回の元に戻すで取り消せます。インポートで削除または置き換えられた要素はゴミ箱に移動します。
- 変更管理:インポートによって変更された値やドキュメンテーションは、他の編集と同様に、要求リンクをレビュー対象としてマークします。
- Holarch プロジェクトファイル:プロジェクトを管理のこのプロジェクトをエクスポート…は、リスク、ドキュメント、その他の Holarch データを含め、Holarch プロジェクト全体を保存します。
.sysmlと JSON にはモデルだけが含まれます。 - 変換:LML と SysML v2 の間でモデルを移すには、変換したコピーを作成します(LML と SysML v2 の間の変換を参照)。
インポートとエクスポートページ
インポート
| コントロール | 用途 |
|---|---|
| このプロジェクトへ | ファイルを開いているプロジェクトにマージします。プロジェクトを閲覧しかできない人は使用できません。その人の場合、インポートは新しいプロジェクトを作成します。 |
| 新しい SysML v2 プロジェクトへ | ファイルから新しいプロジェクトを作成します。 |
| ドロップゾーン | 「Drop files here or click to choose them」。.sysml ファイル、.sysml ファイルの .zip、または 1 つの SysML v2 JSON ファイルを受け付けます。 |
| プレビュー表 | インポート(チェックボックス)、パッケージ(名前と種類)、要素(数)、結果(New、Changed、Unchanged、Conflict と詳細)。 |
| プロジェクト名 | (新しいプロジェクトのみ)新しいプロジェクトの名前。最大 200 文字。 |
| Import N Packages / プロジェクトを作成 | インポートを適用します。 |
| キャンセル | インポートせずにプレビューを閉じます。 |
.sysml テキストでどのパッケージにも属さない要素は、まとめて 1 行のパッケージ外に一覧表示されます。
プレビューを開いている間にモデルが変わると(別のタブ、共同作業者、または元に戻す操作により)、プレビューは再計算されます。
エクスポート
| コントロール | 用途 |
|---|---|
| エクスポート(範囲) | モデル全体、または修飾名で指定した任意のパッケージ。 |
| として(形式) | SysML v2 テキスト(.sysml。複数のパッケージは .zip)またはSysML v2 JSON(.json)。 |
| 要素 ID を含める | (テキストのみ。既定はオフ)名前付きの各要素の ID を @HolarchMetadata::ElementId { id = "…"; } としてテキストに書き込みます。これにより、編集したコピーを再びインポートしても、名前変更や移動を経て ID が保持されます。 |
| エクスポート | ファイルをダウンロードします。 |
テキストのエクスポートは、最上位パッケージごとにその名前を付けた 1 つのファイル(Vehicles.sysml)を書き出します。パッケージ外の要素は Outside packages.sysml に入ります。JSON のエクスポートは、プロジェクトまたはパッケージの名前を付けた 1 つのファイルを書き出します。
リポジトリ
リポジトリセクションは、Systems Modeling API を提供するリポジトリの 1 つのブランチにプロジェクトをリンクします。
- リポジトリのアドレス:リポジトリの API の https アドレス。Holarch は、公開ホスト上の https アドレスにのみ接続します。サイト管理者はホストとポートを制限できます。
- アクセストークン:アカウントとこのプロジェクトのために暗号化して保存され、そのアドレスにのみ送信されます。再び表示されることはありません。保存済みのトークンを使い続けるには、フィールドを空のままにします。
- プロジェクトを読み込む、プロジェクト、分岐:同期する場所を選択します。新しいリポジトリのプロジェクトは、このモデル用のプロジェクトをリポジトリに作成します。
- プル…、プルを適用:最新のコミットを読み取り、差分を確認して適用します。1 回の元に戻すですべて取り消せます。Holarch は最後に同期したコミットと比較するため、自分の変更とリポジトリの変更を区別できます。
- プッシュ:最後に同期したコミット以降の変更を 1 つのコミットとして送信します。「Nothing to push: the model matches the last synced commit.」は、新しいものがないことを意味します。
- 設定…は接続を変更します。Disconnectは保存済みのトークンと同期の状態を除去します。モデルはそのまま残ります。
- リポジトリの操作には編集者のロールが必要です。閲覧者はプルもプッシュもできません。
- 規制対象データの区分表示があるプロジェクトでは、プッシュは拒否されます。
ファイルの読み取り方
- ファイルは何かを読み取る前にチェックされます:サイズ、数、入れ子の深さ、テキストの長さ。
- zip 内の隠しファイルと
__MACOSXフォルダーは無視されます。リンク、.sysml以外のファイル、同じパスの 2 つ目のコピーはスキップされ、問題リストにその理由が示されます。 - テキストは UTF-8 である必要があります。バイトオーダーマークは使用できます。
- インポートされる各要素は、書き込まれる前にチェックされます。拒否された要素は、それが所有するメンバーとともに除外されます。問題リストにはその数が示されます。
- JSON では、Holarch が解釈しない種類の要素は、インポートされたままの状態で保持されます。Holarch が解釈しない要素を参照してください。
Holarch が解釈しない要素
SysML v2 JSON には、KerML の behavior、step、interaction など、Holarch がモデル化しない種類の要素が含まれることがあります。Holarch はそれらを除外せずに保持します:
- それぞれが ID、名前、所有者、および元の JSON とともにモデルに残ります。元の JSON には、その関係(型付け、特化など)とそれらが所有するものも含まれます。そのメンバーは、引き続きそれを所有者とします。
- ブラウザーには、元の種類が解釈されませんタグとともに表示されます。タグをポイントすると説明が表示されます。インスペクターには、その種類、ファイル内での ID、その関係が指すものが表示されます。
- Holarch で名前を変更したり編集したりすることはできません。元のツールで変更して、再びインポートします。移動や削除はできます。
- SysML テキストはありません。エディターはそれと、それが所有するすべてのものをテキストから除外し、テキストの上の注記に表示されていない要素の数が示されます。テキストを編集しても、それらが除去されることはありません。
.sysmlのエクスポートでもそれらは除外されます。 - JSON のエクスポートは、それを変更せずに書き戻します。モデルで変更された部分だけが調整されます:削除または追加したメンバー、名前を変更したメンバー、新しい所有者。
- インポートのプレビューでは、保持される各種類が注記として 1 回ずつ一覧表示されます(例:2 Behavior elements are kept as imported)。注記は問題ではありません。
保持されないもの:一部のツールがエクスポート全体を包む名前のないルート名前空間(そのメンバーは最上位要素になります)と、値の中のサポートされていない要素(問題として一覧表示されます)。JSON が 256 KB を超える要素は、種類と ID だけが保持されます。
メッセージ
| メッセージ | 意味と対処法 |
|---|---|
| .sysml ファイル、.sysml ファイルの .zip、または SysML v2 JSON ファイルを選択してください。 | ファイルが選択されていません。 |
| .sysml ファイルが見つかりません。.sysml ファイル、.sysml ファイルの .zip、または SysML v2 JSON ファイルを選択してください。 | アーカイブまたは選択内容に .sysml ファイルが含まれていません。 |
| SysML v2 JSON ファイルは、.sysml ファイルを含めずに、一度に 1 つずつインポートしてください。 | 複数の JSON ファイル、またはテキストと混在した JSON が選択されました。 |
| <file> は ReqIF ファイルではありません(…)。ソースツールから ReqIF 1.0 以降としてエクスポートし、再びインポートしてください。 | ファイルが ReqIF XML ではないか、Holarch が読み取らない DOCTYPE を含んでいます。 |
| <file> には要求がありません(SPEC-OBJECT 要素がありません)。仕様をそのオブジェクトとともにエクスポートし、ファイルを再びインポートしてください。 | ReqIF ファイルに型はありますが、要求がありません。 |
| <title> には N 件の要求があり、1 回のインポートで扱える数(約 M 件)を超えています。仕様を別々の ReqIF ファイルとしてエクスポートしてください。 | SysML v2 テキストが 8 MB の上限を超えます。仕様を 1 ファイルずつインポートしてください。 |
| <file> は UTF-8 テキストではありません。UTF-8 で保存し、再びインポートしてください。 | ファイルのエンコーディングを変換します。 |
| <file> は有効な ZIP アーカイブではありません。アーカイブを作成し直してください。 | アーカイブが破損しています。 |
| <file> に暗号化されたファイルが含まれています。パスワードなしでアーカイブを作成してください。 | パスワードで保護されたアーカイブは読み取られません。 |
| <path> は 200:1 を超えて圧縮されています。これは zip 爆弾に典型的なものです。アーカイブを作成し直してください。 | 安全のため、アーカイブは拒否されました。 |
| アーカイブはサポートされていない圧縮方式を使用しています。標準の ZIP 圧縮で作成してください。 | 標準(deflate)圧縮を使用します。 |
| KerML ファイルはまだインポートできません。 | .kerml ファイルはスキップされます。 |
| アーカイブからインポートされるのは .sysml ファイルだけです。 | zip 内のその他のファイルはスキップされます。 |
| リンクはインポートされません。 | zip 内のシンボリックリンクはスキップされます。 |
| アーカイブにこのファイルが 2 つ含まれています。最初のコピーがインポートされます。 | 2 つのエントリが同じパスを持っています。 |
| <file> は有効な JSON ではありません。モデルを再度エクスポートしてください。 | JSON ファイルが破損しています。 |
| <file> は SysML v2 JSON(@id と @type を持つ要素のリスト)ではありません。SysML v2 JSON のエクスポートを選択してください。 | JSON が別の形式です。 |
| <file> の N 行目が 64 KB を超えています。行を分割してから、ファイルを再びインポートしてください。 | 非常に長い行は拒否されます。 |
| このメンバーは解析できないため、除外されます。 | 問題リストに示された行を修正します。 |
| この ID を持つ要素が、このプロジェクトの <element> の中にあります。先にそれを最上位に移動するか、新しいプロジェクトにインポートしてください。 | (Conflict)JSON の最上位パッケージが、モデルのより深い位置にすでに存在します。 |
| その要素 ID のうち N 個が、このプロジェクトの別の場所で使われています。代わりに新しいプロジェクトにインポートしてください。 | (Conflict)JSON が他の要素の ID を再利用しています。 |
| 出力後にパッケージのテキストを解析できません。新しいプロジェクトにインポートしてください。 | (Conflict)パッケージをマージできませんでした。 |
| N 個の <kind> 要素は、インポートされたまま保持されます(解釈されません):… | (注記)Holarch が解釈しない種類の要素は、変更されずに保持されます。Holarch が解釈しない要素を参照してください。 |
| 値の中にある種類 <kind> の要素はサポートされていないため、除外されます。 | 値(式)に、Holarch が読み取れない要素が含まれています。値の残りの部分はテキストとして保持されます。 |
| 種類 <kind> の要素は大きすぎて完全には保持できません。種類と ID だけが保持されます。 | その JSON が 256 KB を超えています。 |
| インポートは適用されませんでした:… 何も変更されていません。 | インポートが失敗しました。プロジェクトは変更されていません。 |
| モデルが空です。パッケージを追加してから、再度エクスポートしてください。 | エクスポートするものがありません。 |
| エクスポートするパッケージはもう存在しません。別のパッケージを選択してください。 | ページを開いている間にパッケージが削除されました。 |
制限事項
| 制限 | 値 |
|---|---|
| 1 回のインポートあたりのファイル数 | 2,000 |
1 回のインポートあたりの .sysml テキスト(展開後) | 8 MB |
| Zip アーカイブ | 16 MB、10,000 エントリ |
| zip 内のフォルダーの入れ子 | 32 フォルダー |
| 1 回のインポートあたりの要素数(テキストまたは JSON) | 100,000 |
| JSON ファイル | 24 MB、入れ子 64 レベル |
| Holarch が解釈しない 1 つの要素の JSON | 256 KB、入れ子 12 レベル |
| 行の長さ | 64 KB |
ReqIF ファイル(.reqif、または .reqifz 内の .reqif) | 64 MB。作成される SysML v2 テキストが 8 MB のテキスト上限に収まる必要があります(約 8,000~20,000 件の要求) |
- リポジトリからの応答は、1 回のプル全体で 64 MB が上限です。各リポジトリ操作は 120 秒で停止します。
- 各アカウントは、1 時間あたり最大 300 回のリポジトリ操作を実行できます。
- KerML(
.kerml)ファイルはまだインポートできません。 - ホスト型アプリでは、最大 1.5 MB の
.sysmlテキストのインポートをサーバーが読み取ります。それより大きいインポートはブラウザーで読み取られ、結果は同じです。 - モデルに付随する Holarch のデータ(要求のステータス、リスク、バジェット、シミュレーターの設定、ビューのレイアウト)は、
.sysmlや JSON ファイルには含まれません。それを残すには、プロジェクトを管理のこのプロジェクトをエクスポート…を使います。
関連ページ
- テキストエディターとブラウザー
- LML と SysML v2 の間の変換
- SysML v2 プロジェクトを始める
- SysML v1 モデルのインポート:SysML 1.x ツールの XMI を SysML v2 に変換します。
- LML プロジェクト(LML への ReqIF を含む)と Holarch プロジェクトファイルについては、インポートとエクスポートを参照してください。
SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。