インポートとエクスポート
インポート形式とエクスポート形式
仕様書、スプレッドシート、要求交換ファイル、モデルを Holarch プロジェクトに取り込み、モデルをドキュメント、表、画像、交換ファイル、完全なプロジェクトファイルとして出力します。このページでは、すべての形式について、方向、扱う内容、既知の制限を一覧にしています。
インポートとエクスポートの仕組み
- エクスポートは、閲覧者を含むすべてのプロジェクトメンバーが利用できます。インポートはプロジェクトを変更するため、オーナーまたは編集者のロールが必要です。
- インポートとエクスポートのページからのインポートではプレビューが表示され、インポートした項目には新しい ID が付き、1 回の元に戻す単位になります。新しい項目を追加せずに既存の項目を更新するには、ID、名前、番号で照合します。
- インポートした内容はクリーンアップされます。リッチテキストからはスクリプトと安全でないリンクが、SVG 画像からはスクリプトと外部参照が取り除かれ、DOCTYPE や ENTITY 宣言を含む XML は拒否されます。
- CSV のエクスポートでは、スプレッドシートが数式として実行するテキストを無効化します。ファイル名はすべての OS 向けにクリーンアップされます。
- 各プロジェクトは LML プロジェクトか SysML v2 プロジェクトのいずれかです。Word、スプレッドシート、テキスト、ReqIF のインポートは LML プロジェクト向けです。SysML v2 プロジェクトは SysML v2 のテキストと JSON、および SysML v2 に変換される XMI または .mdzip の SysML 1.x モデルをインポートします。LML プロジェクトも XMI をインポートできます。プロジェクトファイルと、共通ページの Word、Excel、CSV エクスポートは両方で使えます。
移動先:要求と仕様書 · モデル · スプレッドシートと表 · ドキュメントとレポート · 画像 · プロジェクトファイル · API と MCP
要求と仕様書
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| Word (.docx) | インポート | 仕様書は番号付きのドキュメントになります。見出しはレベルに応じて入れ子になった Statement に、「shall」「must」「will」「should」を含む段落と番号付きリストの項目は Requirement になります。表は行ごとに 1 つの項目になるか、説明内の表としてそのまま残ります。太字、斜体、リスト、画像は保持され、挿入の変更履歴は読み込まれ、元のファイルが添付されます。 | PNG、JPEG、GIF、WebP、SVG 以外の EMF、WMF などの形式の画像はスキップされます。削除の変更履歴のテキストはインポートされません。 |
| プレーンテキスト(.txt または貼り付け) | インポート | 番号付きの行と「shall」を含む文は、Statement と Requirement からなる番号付きのドキュメントになります。アウトライン番号は自動検出または選択できます:10 進数、ローマ数字、英字、レベルの混在、DoD 形式、カスタムパターン。 | 構造は番号と文言からのみ判断されます。 |
| ReqIF (.reqif, .reqifz) | インポートとエクスポート | インポート:各 SPEC-OBJECT は項目になり、仕様の階層、クラスとしての型、文字列、XHTML、ブール値、日付、列挙、整数、実数の属性を持ちます。SPEC-RELATION は関係になり、satisfy、verify、deriveReqt は satisfies、verifies、traced from に、trace と refine は traced to になります。データベースまたはドキュメントからのエクスポート:クラスごとに 1 つの型(番号、名前、説明、すべての属性付き)、SPEC-RELATION としての関係、階層としての分解。 | 対応するものがない関係の型は traced to になります。スキーマで許可されないリンクは警告付きでスキップされます。 |
モデル
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| UML と SysML 1.x の XMI (.xmi, .uml, .xml, .mdzip) | インポートとエクスポート | インポート:UML 2.5 と SysML 1.3~1.7 プロファイルを使った XMI 2.x、および .mdzip プロジェクトアーカイブ。ID とテキスト付きの要求、ブロック、パーツ、ポート、値プロパティ、単位付きの値型、汎化、コネクターとアイテムフロー、制御フロー付きのアクティビティ、並行状態と choice、junction、fork、join の遷移を持つステートマシン、シーケンス図、テストケース、パッケージ、ステレオタイプ、タグ付き値。satisfy、verify、deriveReqt、refine、trace、copy、allocate は Holarch の関係になります。ブロック図、内部ブロック図、ステートマシン図、アクション図はインポートしたモデルから描かれます。エクスポート:Cameo/MagicDraw、Enterprise Architect、Rhapsody 向けの SysML 1.6 XMI(XMI 2.5.1)、または Papyrus 向けの Papyrus(Eclipse UML、.uml)。要求、ブロック、パーツ、ポート、単位付きの値型、制約ブロック、アイテムフロー付きのコネクター、アクティビティ、ユースケース、テストケース、ステートマシン、トレース関係を含みます。インポートした項目は XMI ID を保持し、エクスポートはそれを書き戻すため、同じモデルの新しいバージョンをインポートすると、コピーが追加されずに項目が更新されます。Holarch の属性とラベルをオンにすれば、ファイルは Holarch に損失なく再インポートできます。 | ダイアグラムのレイアウトと操作はインポートされません。除外される内容はレビューに一覧表示されます。アクティビティのフローは、適切に構造化されている場合にのみ描かれます。Artifact、Task、Risk、Issue、Decision、Time、Cost の項目はエクスポートされません。 |
| Java ソース (.java) | インポート | クラス図上で:クラス、インターフェース、列挙は Asset に、フィールドは Characteristic に、メソッドは Action になり、そのパラメーターと戻り値は Input/Output になります。 | 一度に 1 ファイルまたは貼り付けた 1 つのソース。 |
| SysML v2 テキスト(.sysml、または .sysml ファイルの .zip) | インポートとエクスポート | SysML v2 プロジェクトまたは新しいプロジェクトにインポートし、パッケージごとに新規、変更、変更なし、競合のプレビューを表示します。zip 内のフォルダーはパッケージになります。モデル全体または 1 つのパッケージをエクスポートでき、複数のパッケージは zip としてダウンロードされます。 | テキストには要素 ID がないため、再インポートでは名前で要素を照合します。KerML (.kerml) ファイルはインポートされません。1 回のインポートで最大 2,000 ファイル、テキスト 8 MB、zip 16 MB まで。テキストは UTF-8 である必要があります。 |
| SysML v2 JSON (.json) | インポートとエクスポート | Systems Modeling API が使う、@id と @type を持つフラットな要素リスト。要素 ID は保持されるため、再インポートでは ID で照合されます。 | 最大 24 MB、100,000 要素まで。Holarch が解釈しない要素の種類はインポートしたまま保持され、「解釈されません」と表示され、変更されずに書き戻されます。 |
| SysML v2 モデルリポジトリ | プルとプッシュ | SysML v2 プロジェクトを、Systems Modeling API を提供するリポジトリの 1 つのブランチに接続します。最新のコミットをプルし、各差分を確認してから適用します。変更は 1 つのコミットとしてプッシュします。 | 公開ホストの https アドレスのみ。プルしていないコミットがブランチにある間は、プッシュは拒否されます。プル 1 回あたり 64 MB、操作 1 回あたり 120 秒、アカウントあたり 1 時間に 300 操作まで。編集者のロールが必要です。 |
| Holarch の Systems Modeling API | 他のツールによる読み取りとコミット | 他の SysML v2 ツールは、個人用アクセストークンを使い、REST 経由で SysML v2 プロジェクトの要素を SysML v2 JSON として読み取り、変更要求のブランチに変更をコミットします。 | main は読み取り専用です。コミットは、承認者が Holarch で適用する変更要求に入ります。ブランチの先頭のみで、タグ、マージ、保存済みクエリーには対応していません。 |
| SysML v1 から SysML v2 へ (.xmi, .uml, .xml, .mdzip) | インポート | Cameo または MagicDraw、Enterprise Architect、Rhapsody、Papyrus の SysML 1.x モデルを SysML v2 テキストに変換し、チェックして、SysML v2 プロジェクトまたは新しいプロジェクトに 1 回の元に戻す単位でインポートします。変換レポートはすべての要素を変換、近似、除外に分けて理由とともに一覧表示し、CSV としてダウンロードできます。 | ダイアグラムとそのレイアウトは変換されません。名前のない要素への関係は除外されます。 |
| LML から SysML v2 へ、そしてその逆 | 双方向の変換コピー | もう一方の言語の新しいプロジェクト:Asset、ポート、Conduit、Input/Output、要求、satisfy リンク、テストケース、フロー付きの Action、状態、方程式。リスク、意思決定、タスク、ドキュメント、ホワイトボード、要求のステータス、テスト結果も引き継がれます。レポートには変換されたものとされなかったものが一覧表示され、CSV としてダウンロードできます。 | ダイアグラムのレイアウト、履歴、ベースライン、変更要求は変換されません。LML の Measure と Resource、SysML v2 の計算や分析ケースなど、一方の言語に置き場所のない要素はレポートに一覧表示されます。 |
要求のステータス、リスク、予算、ビューのレイアウトなど、SysML v2 モデルと並べて保持される Holarch のデータは、.sysml や SysML v2 JSON ファイルには含まれません。プロジェクトのエクスポートでは保持されます。
スプレッドシートと表
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| Excel(.xlsx、.xlsm)と CSV | インポート | 任意のクラスの新規または更新された項目。列のマッピングはヘッダーから提案されます。属性、ラベル、関係、親列または番号からの階層、データから作成される新しい属性。既存の項目を ID、名前、番号で照合して更新します。 | Excel 97-2003 (.xls) とセミコロン区切りの CSV は読み込めません。名前と番号は 255 文字で切り詰められます。 |
| データベースからの Excel と CSV | エクスポート | 任意の項目の集合を、選択した属性と関係、階層とロールアップ付きの表、定義、関係マトリクス、変更履歴、コメントとして出力します。 | Excel のセルには 32,000 文字まで入ります。それより長いテキストは切り詰められます。 |
| 他のページからの Excel と CSV | エクスポート | RVTM、VCRM、RVM、RTM、RSM、TVM、要求の品質結果、TBD/TBR 登録簿、インターフェース登録簿、N² と I² のマトリクス、予算と TPM、リスク登録簿、トレードスタディ、機能分析の表、ベースラインの比較、グラフのデータ、シミュレーターのタイムライン、イベントログ、実行結果。 | 各ページは独自の列をエクスポートします。 |
| トレーサビリティマトリクス (.xlsx, .csv) | インポートとエクスポート | 任意の関係をマトリクスとしてエクスポートします。ワークブックをスプレッドシートで編集して再インポートすると、プレビューに追加するリンク、削除するリンク、スキップされたセルが一覧表示されます。 | インポートでは既存の項目間のリンクの追加と削除のみを行います。スキーマで許可されないセルはスキップされ、一覧表示されます。 |
ドキュメントとレポート
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| Word (.docx) | エクスポート | Word の見出しスタイル、区分表示、表紙、ページ番号付きのドキュメントとアウトライン、ベースライン間の変更履歴付きの赤線版、エンティティの分解、ダイアグラムのレポート、ICD、テストケース、RVTM とトレーサビリティマトリクス、トレードスタディの概要、機能分析のレポート、DoDAF アーキテクチャパッケージ。 | ページサイズは US Letter です。 |
| PowerPoint (.pptx) | エクスポート | 1 ページにつき 1 スライドのプレゼンテーション。テキストボックス、図形、発表者ノート付き。プレゼンテーションは HTML と Word にもエクスポートできます。 | 記載なし。 |
| Markdown (.md) | エクスポート | Markdown の見出しとテキストとしてのドキュメント。 | 記載なし。 |
| HTML | エクスポート | ダイアグラム、ダイアグラムのレポート、グラフ、プレゼンテーション、トレーサビリティマトリクスの Web ページ。 | 記載なし。 |
| 印刷と PDF | エクスポート | ドキュメント、表、ダイアグラムはブラウザーの印刷ダイアログから PDF として保存できます。ホワイトボードは PDF を直接エクスポートします。 | ホワイトボードの PDF ページは画像です。 |
画像
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| PNG と SVG | エクスポート | ダイアグラム、グラフ、スライド、シミュレーターのパネル、ギャラリーのカード。PNG は倍率を選択でき、背景の有無も選べます。SVG は拡大縮小可能なベクター画像です。 | 記載なし。 |
| ホワイトボード:PNG、JPG、SVG、PDF | エクスポート | ボード、選択範囲、現在の表示、フレーム、またはすべてのボード。SVG ではベクターツールで図形とテキストを編集できます。 | PDF ページは画像です。 |
| 画像と添付ファイル | インポート | リッチテキスト内の画像、エンティティの画像、ファイル属性、ホワイトボード、スライド。ホットスポット付きの OV-1 など、DoDAF のプロダクト用の PNG、JPEG、SVG グラフィック。 | 長辺が 4,000 px を超える画像は縮小されます。ファイルの上限は Free プランで 10 MB、Individual で 25 MB、Team で 100 MB、プロジェクトの上限は Free プランで 100 MB です。 |
プロジェクトファイル
| 形式 | 方向 | 扱う内容 | 既知の制限 |
|---|---|---|---|
| Holarch バックアップ (.holarch) とプロジェクトファイル (.json) | インポートとエクスポート | バックアップや別の Holarch サーバーへの移動のためのプロジェクト全体:項目、関係、ダイアグラム、ベースライン、コメント、履歴、ホームの設定と、添付ファイルと画像。.holarch バックアップには各部分のチェックサムが含まれ、インポート前に検査されます。あなたがオーナーの新しいプロジェクトとしてインポートされます。バックアップ形式と JSON 形式は文書化されています。 | 常に新しいプロジェクトになります。開いているプロジェクトにマージするには、下のマージインポートを使います。 |
| プロジェクトへのマージ (.holarch, .json) | インポート | 添付ファイル付きの Holarch バックアップとパッケージ、および Holarch のプロジェクト、データベース、ドキュメントのエクスポートを、開いているプロジェクトにマージします。クラス、属性、ラベル、関係は名前で照合され、不足しているスキーマ項目は先に追加できます。コメント、履歴、ダイアグラムのレイアウトは、選択した場合に引き継がれます。 | ファイルから読み込んだシミュレーションスクリプトにはインポート済みの印が付き、シミュレーターは実行前に確認します。 |
| プロジェクトパッケージ (.holarch) | エクスポート | 選択した項目とその関係、ダイアグラム、コメント、スキーマ、すべての添付ファイル。インポート時に破損がないかチェックされます。 | 選択した項目を保持します。ベースラインと履歴は含まれません。 |
| スキーマ (.json) | インポートとエクスポート | プロジェクトのクラス、関係、属性、ラベル。インポートでは、プロジェクトにないものをマージするか、スキーマを置き換えます。 | 記載なし。 |
| ベースラインとドキュメントデータ (.json) | エクスポート。ドキュメントデータはインポートも可能 | 日付、ドキュメント、承認、スナップショットを含むベースライン。ドキュメントの項目、関係、状態は、別のプロジェクトにマージできます。 | 記載なし。 |
| DoDAF プロダクト (JSON) と DM2 PES サブセット (XML) | エクスポート | アーキテクチャ記述、データ付きのすべてのプロダクト、辞書。XML は辞書を DoDAF Meta Model の用語で書き出します。 | XML は Holarch 独自の名前空間を使い、DM2 PES スキーマに対する検証は行われていません。 |
| MS Project スケジュール (.xml) | エクスポート | シミュレーション実行のガント行を MS Project XML のスケジュールとして出力します。 | シミュレーターの実行からのみ。 |
API と MCP
スクリプトは、個人用アクセストークンと OpenAPI の記述を使い、REST API を通じてプロジェクトを読み取り・変更します。Claude などの AI ツールは Model Context Protocol(MCP)で接続し、その変更は適用前にあなたが確認する提案として届きます。API と MCPをご覧ください。