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

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

図面とデータの完全同期:BOM出力における「原子性(Atomicity)」の確保とメモリ管理の極致

設計業務の現場において、図面(DWG)と部品表(BOM)の不一致は、単なるミスではなく「システムの設計破綻」を意味する。

多くのエンジニアが、図面を保存した後に手動、あるいは不完全なマクロでCSVを出力している。しかし、図面を更新したにもかかわらず、CSVが古いまま、あるいはCSVの出力に失敗したのに図面だけが保存されるといった事態は、製造工程における致命的な誤発注へと直結する。

我々アーキテクトが目指すべきは、「図面の保存」と「BOMの更新」を一つの不可分なトランザクションとして扱うことである。本稿では、AutoCAD VBAを用い、メモリリークを徹底的に排除し、ファイルI/Oの不整合を防ぎながら、図面データと外部集計データを完全同期させるための、実戦的な実装手法を詳解する。

1. オブジェクト・ライフサイクルとメモリの制御

AutoCAD VBAにおける最大の罠は、大量のブロック参照(BlockReference)を走査する際のメモリ消費と、オブジェクトの解放漏れである。

数千個のブロックを含む大規模な図面において、単純な `For Each` ループを回し、オブジェクトを適切に解放せずに放置すれば、AutoCADのプロセスは肥大化し、最終的に `Out of Memory` でクラッシュする。

SelectionSetによる走査の最適化

全てのオブジェクトを走査するのは愚策である。`SelectionSet` を利用し、属性を持つブロックのみをフィルタリングしてメモリ空間にロードする。これにより、走査対象を最小限に絞り込み、計算量を $O(n)$ から必要な要素数 $O(k)$ へと削減する。

明示的な解放の原則

VBAのガベージコレクションに頼ってはならない。ループ内で生成したオブジェクト、特に `SelectionSet` や `Attribute` オブジェクトは、スコープを抜ける前に必ず `Set = Nothing` を行い、参照カウントをゼロに落とす。これはレガシーな環境ほど、システムの安定性に直結する。

2. 実装:完全同期セーブ・アーキテクチャ

以下に、図面の保存と同時に、属性情報を集計してCSVへ書き出す、堅牢な実装例を示す。ここでは、高速なデータ集計のために `Scripting.Dictionary` を採用し、ファイル操作には `FileSystemObject` を用いる。

' ======================================================================================
' Module: BOM_Sync_System
' Description: 図面保存と連動したBOM(CSV)の完全同期出力システム
' Author: Legendary Chief Architect
' ======================================================================================

Option Explicit

' Windows API: ファイルの存在確認やロック状態の監視が必要な場合に備える
' 今回は安定性を重視し、FileSystemObjectを主軸とする
Private fso As Object

Sub ExecuteSynchronizedSave()
    Dim acadDoc As AcadDocument
    Set acadDoc = ThisDrawing
    
    ' 1. 保存の試行 (図面が未保存の場合はまず名前を付けて保存)
    On Error GoTo ErrorHandler
    If Not acadDoc.Saved Then
        acadDoc.Save
    End If
    
    ' 2. BOM抽出エンジンの起動
    ' 図面のパスからCSVの出力パスを決定
    Dim dwgPath As String
    Dim csvPath As String
    dwgPath = acadDoc.FullName
    csvPath = Replace(dwgPath, ".dwg", ".csv", , , vbTextCompare)
    
    Debug.Print "Starting BOM Synchronization: " & csvPath
    
    ' 3. BOM集計プロセスの実行
    ' 失敗した場合は図面の整合性を守るため、エラーとして処理
    Call GenerateBOM(acadDoc, csvPath)
    
    MsgBox "図面およびBOMの同期保存が完了しました。", vbInformation, "System Success"
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました。同期プロセスを中断します。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "System Failure"
    ' ここでロールバック処理(必要に応じて)を検討する
End Sub

Private Sub GenerateBOM(doc As AcadDocument, targetPath As String)
    Dim sSet As AcadSelectionSet
    Dim obj As AcadEntity
    Dim blkRef As AcadBlockReference
    Dim att As AcadAttribute
    
    ' 集計用ディクショナリ (Key: 部品番号, Value: 数量)
    ' ※参照設定: Microsoft Scripting Runtime
    Dim dict As Object
    Set dict = CreateObject("Scripting.Dictionary")
    
    ' SelectionSetの管理(既存の同名セットがあれば削除)
    On Error Resume Next
    doc.SelectionSets.Item("BOM_SET").Delete
    On Error GoTo 0
    Set sSet = doc.SelectionSets.Add("BOM_SET")
    
    ' フィルタリング条件: ブロック参照のみを抽出
    Dim filterType(0) As Integer
    Dim filterData(0) As Variant
    filterType(0) = 0: filterData(0) = "INSERT"
    
    sSet.Select OnPaper elocAll, , , filterType, filterData
    
    ' --- データ抽出フェーズ ---
    Dim i As Long
    For i = 0 To sSet.Count - 1
        Set obj = sSet.Item(i)
        
        If TypeOf obj Is AcadBlockReference Then
            Set blkRef = obj
            
            ' ブロックが属性を持っているか確認
            If blkRef.HasAttributes Then
                ' 属性の走査(ここがパフォーマンスの要)
                Dim j As Integer
                For j = 0 To blkRef.NumberAttributes - 1
                    Set att = blkRef.GetAttribute(j)
                    
                    ' 特定のタグ名(例: "PART_NO")をキーとして集計
                    ' 実務ではタグ名を定数化して管理すべき
                    If UCase(att.TagString) = "PART_NO" Then
                        Dim partNo As String
                        partNo = att.TextString
                        
                        If dict.Exists(partNo) Then
                            dict(partNo) = dict(partNo) + 1
                        Else
                            dict.Add partNo, 1
                        End If
                    End If
                Next j
            End If
        End If
        ' オブジェクトの参照を明示的にクリア(メモリ最適化)
        Set obj = Nothing
    Next i
    
    ' --- ファイル出力フェーズ ---
    Call WriteCSV(dict, targetPath)
    
    ' --- クリーンアップ ---
    sSet.Delete
    Set sSet = Nothing
    Set dict = Nothing
End Sub

Private Sub WriteCSV(dataDict As Object, filePath As String)
    Dim fso As Object
    Dim ts As Object
    Dim key As Variant
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' ファイルがExcel等で開かれている場合の排他制御
    On Error Resume Next
    ' 既存ファイルを削除して新規作成(上書き)
    If fso.FileExists(filePath) Then
        fso.DeleteFile filePath, True
    End If
    
    ' 書き込み用ストリームのオープン (ForWriting)
    Set ts = fso.CreateTextFile(filePath, True, True) ' Unicode出力
    If Err.Number <> 0 Then
        Err.Clear
        Err.Raise vbObjectError + 513, "WriteCSV", "CSVファイルが他のプロセスで使用中のため、書き込みに失敗しました。"
    End If
    On Error GoTo 0
    
    ' ヘッダーの書き込み
    ts.WriteLine "Part Number,Quantity"
    
    ' データの書き込み
    For Each key In dataDict.Keys
        ts.WriteLine key & "," & dataDict(key)
    Next key
    
    ts.Close
    Set ts = Nothing
    Set fso = Nothing
End Sub

3. 運用における極限の知見

このコードを実務システムへ組み込む際、単に「動く」こと以上の、以下の3点に留意しなければならない。

ファイルロックの競合回避

BOMのCSVファイルがExcelで開かれている場合、`fso.CreateTextFile` は実行時エラーを吐く。これは設計ミスではなく、Windowsのファイルロック仕様による不可抗力である。
シニアエンジニアとして、このエラーを単なる「エラー」として終わらせてはならない。ユーザーに対し、「CSVがExcelで開かれています。閉じてから再度実行してください」という文脈を持ったエラーハンドリングを提供することが、システムとしての品格を決める。

Unicode (UTF-16) の選択

図面内の属性情報には、日本語(マルチバイト文字)が含まれることが常である。`FileSystemObject` の `CreateTextFile` メソッドにおいて、第3引数を `True` に設定し、Unicodeとして出力することを推奨する。これにより、後続のERPシステムや集計ツールへの受け渡しにおける文字化けリスクを根源から断つことができる。

スケーラビリティへの配慮

本実装では `Scripting.Dictionary` を使用している。これは、数万件の属性データに対しても、ハッシュテーブルによる $O(1)$ に近い検索速度を維持するためである。`Collection` オブジェクトを使用する手法もあるが、重複チェックと更新速度の観点から、エンタープライズレベルの自動化においては `Dictionary` が圧倒的に優位である。

結論

図面とBOMの同期は、単なる便利機能ではない。それは、設計データが持つ「真実性」を担保するための、極めて重要なアーキテクチャの一部である。
メモリ管理、ファイルI/Oの整合性、そして例外処理。これら一つひとつの積み重ねが、レガシーな環境においても揺るがない、強靭な自動化システムを作り上げるのである。

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