【実務・中級編】【実務中級者向け】図面保存と同時に「BOM(部品表)」をCSV出力:図面データと外部集計データの完全同期セーブ – AutoCAD VBA解析バイブル

スポンサーリンク
スポンサーリンク

同期する設計思想:図面保存と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)をいかにエレガントに制御するかという戦いなのだ。

タイトルとURLをコピーしました