I03. JSON Import

概要

JSON形式から建物データをインポートするコンポーネントです。 単一のJSONファイルから建物データを読み込み、BuildingDataオブジェクトとして出力します。

機能

• 単一JSONファイルからのデータ読み込み
• JSON検証とエラー報告
• トリガー式の読み込み（Importパラメータ）
• ファイルサイズ情報の表示

入力パラメータ

パラメータ名	型	デフォルト	説明
File	Text	-	JSONファイルのパス (.json)
Import	Boolean	false	Trueに設定すると読み込み実行

出力パラメータ

パラメータ名	型	説明
Data	Generic	BuildingDataオブジェクト
Origin	Point	原点座標（Global設定から生成）
Success	Boolean	読み込み成功フラグ
Message	Text	結果メッセージ

使用方法

基本的な使い方

1. Fileパラメータに.jsonファイルのパスを接続
2. Importパラメータをtrueに設定
3. 読み込みが実行され、結果がMessageに表示される

JSON形式の例

{
  "Global": {
    "Origin_X": 0.0,
    "Origin_Y": 0.0,
    "UnitSystem": "mm"
  },
  "Grids": [
    {
      "Grid_ID": "X1",
      "Axis": "X",
      "Position": 0.0
    },
    {
      "Grid_ID": "X2",
      "Axis": "X",
      "Position": 6000.0
    }
  ],
  "Levels": [
    {
      "Floor": "1F",
      "Level_Offset": 0.0,
      "Floor_Height": 4000.0
    }
  ],
  "Catalog": [
    {
      "Type_ID": "COL-400x400",
      "Category": "Column",
      "Width": 400.0,
      "Depth": 400.0
    }
  ],
  "Layout_Column": [
    {
      "Floor": "1F",
      "Grid_Intersection": "X1-Y1",
      "Type_ID": "COL-400x400",
      "Rotation": 0.0,
      "Offset_X": 0.0,
      "Offset_Y": 0.0,
      "Offset_Base": 0.0,
      "Offset_Top": 0.0,
      "Is_Void": false
    }
  ]
}

JSON vs CSV vs Excel

JSONのメリット

• ✅ 単一ファイルで管理が簡単
• ✅ 階層構造を表現しやすい
• ✅ Web APIとの連携が容易
• ✅ 軽量で高速

JSONのデメリット

• ❌ 手動編集が困難（構文エラーが起きやすい）
• ❌ Excelのような視覚的編集ができない

使い分け

• Excel: 手動でデータを編集する場合
• CSV: プログラムから生成、バージョン管理
• JSON: API連携、プログラム間のデータ交換

パフォーマンス

読み込み速度

• 小規模（50要素以下）: < 0.3秒
• 中規模（500要素）: 0.3-1秒
• 大規模（5000要素）: 1-5秒

JSON形式は最も高速です。

ファイルサイズ

• 小規模: 1-10 KB
• 中規模: 10-100 KB
• 大規模: 100KB-1MB

関連コンポーネント

• I01. Excel Import - Excelファイルからのインポート
• I02. CSV Import - CSVファイルからのインポート
• E03. JSON Export - JSONファイルへのエクスポート
• D01. UI Data Editor - データの編集

注意事項

• JSON形式はUTF-8エンコーディング
• 数値は小数点に.（ドット）を使用
• 文字列は"（ダブルクォート）で囲む
• 最後の要素の後に,（カンマ）は不要

JSONエディタのおすすめ

Visual Studio Code

• JSON検証機能
• シンタックスハイライト
• フォーマット機能

オンラインツール

• jsonlint.com - JSON検証
• jsonformatter.org - JSONフォーマッター

トラブルシューティング

Q: "JSON parse error" が出る

A: JSONの構文エラーです。オンラインのJSON検証ツールでチェックしてください。よくある間違い：

• カンマの付け忘れ/余分なカンマ
• 閉じ括弧の不足
• 文字列のクォート忘れ

Q: Importをtrueにしても何も起こらない

A: Fileパスが正しいか確認してください。Messageパラメータを接続してエラーを確認してください。

Q: データは読み込まれるが内容がおかしい

A: JSON内のフィールド名が正しいか確認してください。フィールド名は大文字小文字を区別します。

Q: 大きなファイルの読み込みが遅い

A: JSONは通常高速ですが、非常に大きなファイル（>10MB）の場合は時間がかかることがあります。データを分割することを検討してください。