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が正しいか、メモリが十分にあるかを確認してください。