同期する設計思想:図面保存とBOM(部品表)CSV出力の完全自動化戦略
「図面を保存したのに、CSVの部品表が古いままだった」
「CSVを更新しようとしたら、誰かがExcelで開いていてエラーでマクロが止まった」
もし君が、現場でこのような報告を受けて平然としていられるなら、君はまだ「スクリプト職人」の域を出ていない。我々が目指すべきは、図面データ(DWG)と集計データ(CSV)が、あたかも一つのオブジェクトであるかのように不可分に結合された「同期型データアーキテクチャ」の構築だ。
本記事では、AutoCAD VBAを用いて、図面保存と同時にBOMを書き出す「プロダクション・クオリティ」の実装手法を伝授する。単なるコードの書き方ではない。エラーに強く、パフォーマンスを考慮した、プロの設計思想を叩き込む。
1. なぜ「単純なループ」では実務に耐えられないのか
多くの開発者が陥る罠がある。それは、`For Each obj In ThisDrawing.ModelSpace` で全オブジェクトを舐めるだけの、あまりにナイーブな実装だ。
パフォーマンスの壁
数千、数万のブロックが配置された大規模プロジェクトにおいて、保存のたびに全オブジェクトを走査するのは、ユーザーの作業リズムを破壊する致命的な遅延を招く。
ファイルロックの地獄
CSV出力の最大の敵は、「Excelによるファイルロック」だ。集計担当者がCSVを開いている状態でマクロが走れば、I/Oエラーが発生し、最悪の場合、本来の目的である「図面の保存」まで巻き添えにして停止する。
エラー伝播の設計ミス
「CSVの書き出しに失敗したから、図面の保存もキャンセルする」という設計は、一見堅牢に見えて、実は極めて脆弱だ。図面の保存は「主業務」、CSV出力は「副業務(付随業務)」である。副業務の失敗が主業務を阻害してはならない。
2. プロダクション・レベルの設計指針
堅牢なツールを作るために、以下の3原則を実装に組み込む。
1. Atomic-like Responsibility (役割の分離): 図面保存の成否と、CSV出力の成否を切り離して管理する。
2. Graceful Failure (優雅な失敗): ファイルがロックされている場合は、エラーで落とすのではなく、ユーザーに警告を発して図面保存を優先させる。
3. Resource Management (リソース管理): ファイルハンドルを確実に解放し、メモリリークやゾンビプロセスを防ぐ。
3. 実装コード:Smart BOM Sync Engine
以下に、実務でそのまま利用可能な、堅牢性を極限まで高めたコード例を示す。このコードは、ブロック属性(Attribute)を抽出し、図面と同じパスにCSVを生成する。
Option Explicit
' ==============================================================================
' Module: BOM_Sync_Manager
' Description: 図面保存時にBOM(CSV)を自動同期するプロフェッショナル・モジュール
' Author: Chief Architect
' ==============================================================================
''' <summary>
''' 図面保存とBOM出力を一括制御するメインルーチン
''' </summary>
Public Sub SmartSaveWithBOM()
Dim dwgPath As String
Dim csvPath As String
Dim saveSuccess As Boolean
On Error GoTo ErrorHandler
' 1. 現在の図面のパスを取得
dwgPath = ThisDrawing.Path
If dwgPath = "" Then
MsgBox "図面が一度も保存されていません。先に図面を保存してください。", vbCritical
Exit Sub
End If
' CSVのファイル名を決定 (DWGと同じ場所に .csv で保存)
csvPath = Replace(ThisDrawing.FullName, ".dwg", ".csv")
csvPath = Replace(csvPath, ".DXF", ".csv") ' DXF対策
' 2. 図面の保存を実行 (主業務)
' ここでエラーが起きれば、BOM処理には進まない
ThisDrawing.Save
saveSuccess = True
' 3. BOMの書き出しを実行 (副業務)
' 図面保存が成功した後にのみ実行。ただし、ここで失敗しても図面は守る。
If saveSuccess Then
Call ExportBOMToCSV(csvPath)
End If
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical, "System Error"
End Sub
''' <summary>
''' ブロック属性を走査し、CSVへ書き出す
''' </summary>
Private Sub ExportBOMToCSV(ByVal targetPath As String)
Dim objEnt As AcadEntity
Dim objBlock As AcadBlockReference
Dim varAttributes As Variant
Dim i As Integer
Dim fileNum As Integer
Dim csvContent As String
Dim errorOccurred As Boolean
' CSVヘッダーの定義
csvContent = "PartNumber,Description,Quantity" & vbCrLf
' --- Step 1: データ集計 ---
' 効率化のため、モデル空間内のブロックのみを対象とする
On Error Resume Next
For Each objEnt In ThisDrawing.ModelSpace
If TypeOf objEnt Is AcadBlockReference Then
Set objBlock = objEnt
' 属性情報を持っているか確認
If objBlock.HasAttributes Then
varAttributes = objBlock.GetAttributes
' ここでは例として、1番目の属性をPartNumber、2番目をDescriptionとする
' 実務に合わせてインデックスやタグ名による判定ロジックをカスタマイズせよ
Dim partNo As String: partNo = ""
Dim desc As String: desc = ""
For i = LBound(varAttributes) To UBound(varAttributes)
Select Case varAttributes(i).TagString
Case "PART_NO": partNo = varAttributes(i).TextString
Case "DESC": desc = varAttributes(i).TextString
End Select
Next i
' 集計データの構築 (カンマ区切り)
If partNo <> "" Then
csvContent = csvContent & partNo & "," & desc & "," & vbCrLf
End If
End If
End If
Next objEnt
On Error GoTo 0
' --- Step 2: ファイル書き出し (I/Oセクション) ---
fileNum = FreeFile
On Error Resume Next
' ファイルを開く際、Excel等で開かれているとここでエラーになる
Open targetPath For Output As #fileNum
If Err.Number <> 0 Then
' 【重要】副業務の失敗を主業務に伝播させない設計
MsgBox "【警告】BOMの更新に失敗しました。" & vbCrLf & _
"原因: CSVファイルが他のアプリケーション(Excel等)で開かれている可能性があります。" & vbCrLf & _
"図面本体は正常に保存されています。", vbExclamation, "BOM Sync Warning"
Close #fileNum
Exit Sub
End If
Print #fileNum, csvContent
Close #fileNum
If Err.Number <> 0 Then
MsgBox "CSV書き出し中に予期せぬエラーが発生しました: " & Err.Description, vbCritical
Else
' 成功時はステータスバー等に控えめに通知するのがプロの作法
ThisDrawing.Application.StatusBar = "BOM successfully synchronized: " & targetPath
End If
On Error GoTo 0
End Sub
4. アーキテクトの視点:コードの深層解説
なぜ `On Error Resume Next` を戦略的に使うのか
このコードでは、`ExportBOMToCSV` 内のファイルオープン処理において、意図的に `On Error Resume Next` を使用している。これは「エラーを無視するため」ではなく、「エラーを検知し、それをコントロール下において、ユーザーに適切なフィードバックを与えるため」だ。
ファイルがロックされていることを検知した瞬間、我々は「図面は保存できたが、CSVは失敗した」という二極化した状態を正確にユーザーに伝えなければならない。
属性抽出の計算量(Complexity)について
`For Each objEnt In ThisDrawing.ModelSpace` は、図面内の全エンティティを走査する $O(N)$ の計算量を持つ。大規模図面でこれを高速化するには、以下の高度なアプローチを検討せよ:
- レイヤーフィルタリング: 特定の「BOM_DATA」レイヤーにあるブロックのみを走査対象とする。
- Selection Setの利用: `SelectByPolygon` や `Select` メソッドを用いて、あらかじめ属性を持つオブジェクトだけをメモリ上に抽出してからループを回す。
保守性のための「タグ名指定」
サンプルコードでは `Select Case varAttributes(i).TagString` を用いている。実務では、ブロックごとに属性の並び順が異なることは珍しくない。タグ名(`PART_NO` 等)で判定するロジックは、ブロックの定義変更に対して極めて高い耐性を持つ。
5. 結論
業務自動化における真の価値は、「動くコード」を書くことではなく、「止まらない、そしてユーザーを混乱させないシステム」を設計することにある。
図面とBOMの同期は、設計データと製造データの整合性を担保する生命線だ。今回示した、「主業務(Save)と副業務(CSV)の分離」および「I/Oエラーのハンドリング」という設計パターンを、君の次なるプロジェクトの標準に据えてほしい。
エンジニアリングとは、例外(Exception)をいかにエレガントに制御するかという戦いなのだ。
