E01. Excel Export
概要
BuildingDataをExcel形式（.xlsx）にエクスポートするコンポーネントです。 テンプレートベースで新規ファイルを作成し、すべてのデータをExcelシートに書き出します。
機能
- BuildingDataをExcel形式で保存
- ファイル保存ダイアログ
- トリガー式のエクスポート（Exportパラメータ）
- ファイルサイズと単位系の表示
入力パラメータ
| パラメータ名 | 型 | デフォルト | 説明 |
|---|---|---|---|
| Data | Generic | - | エクスポートするBuildingDataオブジェクト |
| Export | Boolean | false | Trueに設定すると保存ダイアログを表示 |
出力パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
| Success | Boolean | エクスポート成功フラグ |
| Message | Text | 結果メッセージ |
| FilePath | Text | 保存されたファイルのパス |
使用方法
基本的な使い方
- Dataパラメータに BuildingDataオブジェクトを接続
- Exportパラメータをtrueに設定
- 保存ダイアログが表示される
- 保存場所とファイル名を指定
- ファイルが作成される
立ち上がりエッジ検出
このコンポーネントは立ち上がりエッジ検出を使用しています：
false → trueの遷移時のみダイアログを表示true → true（保持）では再度ダイアログを表示しない- ボタンを使用する場合に最適
エクスポートされるシート
すべてのデータが以下のシートに書き出されます：
- Global - グローバル設定
- Grids - グリッド線データ
- Levels - レベル（階高）データ
- Catalog - 部材カタログ
- Layout_Column - 柱の配置
- Layout_MainBeam - 大梁の配置
- Layout_SecondaryBeam - 小梁の配置
- Layout_Wall - 壁の配置
- Layout_Slab - 床スラブの配置
- Layout_CantileverBeam - 片持ち梁
- Layout_CantileverSlab - 片持ちスラブ
- Layout_Brace - ブレース
- PlanSettings - 平面図設定（あれば）
パフォーマンス
書き込み速度
- 小規模（50要素以下）: < 1秒
- 中規模（500要素）: 1-3秒
- 大規模（5000要素）: 3-15秒
Excel形式は書き込みに時間がかかります。
関連コンポーネント
- I01. Excel Import - Excelファイルからのインポート
- E02. CSV Export - CSVファイルへのエクスポート
- E03. JSON Export - JSONファイルへのエクスポート
- D01. UI Data Editor - データの編集
注意事項
- Excel 2007以降の形式（.xlsx）で保存
- エクスポート中はGrasshopperをブロックしない
- 大量データの場合、JSON/CSV形式を推奨
- ファイルは必ず閉じてからエクスポート
トラブルシューティング
Q: ダイアログが表示されない
A: Exportパラメータがfalse → trueに変化したか確認してください。ボタンコンポーネントを使用すると便利です。
Q: "File is locked" エラーが出る
A: Excelでファイルを開いている場合は閉じてください。また、他のプログラムがファイルを使用していないか確認してください。
Q: 大きなファイルの保存が遅い
A: 5000要素を超える場合、JSON形式やCSV形式の方が高速です。E03. JSON Exportを検討してください。
Q: 保存したファイルが開けない
A: ファイルが破損している可能性があります。BuildingDataが正しいか、メモリが十分にあるかを確認してください。
v5.5.0 アップデート
| 反映項目 | 説明 |
|---|---|
| v5.5.0 schema 全面対応 | Justification / Revit_Family_Type / Design_Phase / Slab_On_Beam / Restraint_Code / End_Release_*_Code を read / write 両対応 |
| 後方互換 | v5.0.x / v5.2.x / v5.3.x データを自動マイグレーション (欠落フィールドは default 補完) |
| テンプレート | Excel テンプレ MakeBuildingPro_Template_Metric_v5.5.0.xlsx (同梱、Embedded リソース) を Excel Import 時に参照 |
| ラウンドトリップ | .mbp.json ↔ .xlsx ↔ CSV フォルダ形式 で無損失ラウンドトリップ可。Notes / CustomProperties も保持 |