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

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

図面とデータは「一蓮托生」である。Saveと同時にBOMを自動出力する、究極の同期制御術

こんにちは。今日も図面作成、お疲れ様です。

「マクロの記録」を使って、少しずつAutoCADの自動化に触れ始めたあなた。素晴らしい一歩を踏み出しましたね。でも、ふとこんな壁にぶつかっていませんか?

*「マクロの記録では、単純な操作の再生はできるけれど、『図面内の情報を集計して、外部ファイルに書き出す』といった、頭を使った処理が書けない……」*

もしあなたがそう感じているなら、それはあなたが「プログラミングの入り口」に立っている証拠です。ここを乗り越えれば、あなたは単なる「操作の自動化」ではなく、「業務プロセスの設計者」へと進化できます。

今日は、実務における「情報の不一致」という最大の恐怖を、VBAの力で根絶するテクニックを伝授しましょう。テーマは「図面保存と同時に、最新のBOM(部品表)をCSVとして自動出力する」です。

なぜ「図面保存」と「BOM出力」を分けることが罪なのか

設計現場でよく起こる悲劇があります。
「図面は最新版なのに、Excelの部品表が古いままだった」という事態です。

図面内のブロック属性(部品番号や数量)を書き換えたのに、Excelへの転記を忘れてしまう。あるいは、転記作業中にミスをしてしまう。この「情報のズレ」は、製造現場での誤発注や、致命的な手戻りを引き起こします。

理想的なのは、「図面を保存した瞬間に、その図面の中に含まれる部品情報が、自動的にCSVとして書き出されている」状態です。図面とデータが「一蓮托生(いちれんたくしょう)」、つまり運命を共にする。これこそが、エンジニアが目指すべき自動化の極致です。

核心となるロジック:3つのステップ

この機能を実装するために、私たちは以下の3つのフェーズをコードに落とし込みます。

1. 情報の収集(Scan): 図面内の全オブジェクトを走査し、「属性情報を持つブロック」だけを抜き出す。
2. 情報の集計(Aggregate): 抜き出した情報を、重複なく「部品番号」ごとにカウントする。
3. 情報の出力(Export & Save): 集計結果をCSVファイルとして書き出し、最後に図面本体を保存する。

ここで、プロのエンジニアとして一つアドバイス。情報の集計には、VBAの`Dictionary`オブジェクトを使いましょう。これを使うことで、「部品Aが何個あるか」という計算が劇的に高速かつスマートになります。

実装コード:BOM自動同期マクロ

さあ、準備はいいですか? 以下のコードは、そのままコピーして利用できるレベルまで磨き上げてあります。

【事前準備】
VBAエディタのメニューから `ツール` -> `参照設定` を開き、`Microsoft Scripting Runtime` にチェックを入れてください。これによって、強力な集計機能(Dictionary)が使えるようになります。

Option Explicit

''' <summary>
''' 図面を保存すると同時に、ブロック属性からBOM(CSV)を生成する
''' </summary>
Sub SaveDrawingWithBOM()
    Dim acadDoc As AcadDocument
    Set acadDoc = ThisDrawing
    
    ' 1. 保存先パスの取得(図面と同じフォルダ)
    Dim dwgPath As String
    Dim csvPath As String
    Dim folderPath As String
    
    If acadDoc.Path = "" Then
        MsgBox "図面がまだ保存されていません。先に図面を一度保存してください。", vbCritical
        Exit Sub
    End If
    
    dwgPath = acadDoc.FullName
    folderPath = acadDoc.Path & "\"
    ' 図面ファイル名から拡張子を除いて .csv を付与
    csvPath = Left(dwgPath, InStrRev(dwgPath, ".") - 1) & "_BOM.csv"
    
    ' 2. 集計用Dictionaryの準備 (部品番号をKey、数量をValueにする)
    ' ※参照設定: Microsoft Scripting Runtime が必要
    Dim bomDict As New Scripting.Dictionary
    Dim ent As AcadEntity
    Dim blockRef As AcadBlockReference
    Dim attrColl As Variant
    Dim i As Integer
    
    On Error Resume Next ' エラーハンドリングの準備
    
    ' 3. 図面内を走査して情報を収集
    For Each ent In acadDoc.ModelSpace
        ' ブロック参照(BlockReference)かどうかを判定
        If TypeOf ent Is AcadBlockReference Then
            Set blockRef = ent
            
            ' 属性情報(Attributes)を持っているか確認
            If blockRef.HasAttributes Then
                attrColl = blockRef.GetAttributes
                
                ' 属性をループ。ここでは「PART_NO」というタグを部品番号として扱う例
                For i = LBound(attrColl) To UBound(attrColl)
                    If attrColl(i).TagString = "PART_NO" Then
                        Dim partNo As String
                        partNo = attrColl(i).TextString
                        
                        ' Dictionaryに加算していく
                        If bomDict.Exists(partNo) Then
                            bomDict(partNo) = bomDict(partNo) + 1
                        Else
                            bomDict.Add partNo, 1
                        End If
                    End If
                Next i
            End If
        End If
    Next ent
    
    ' 4. CSVファイルへの書き出し
    Dim fileNum As Integer
    fileNum = FreeFile
    
    ' ファイルを開く(エラーハンドリング:Excel等で開いている場合を考慮)
    Err.Clear
    Open csvPath For Output As #fileNum
    
    If Err.Number <> 0 Then
        MsgBox "CSVファイルが開かれている可能性があります。閉じてから再実行してください。", vbExclamation
        Exit Sub
    End If
    
    ' ヘッダーの書き込み
    Print #fileNum, "Part Number,Quantity"
    
    ' データの書き込み
    Dim key As Variant
    For Each key In bomDict.Keys
        Print #fileNum, key & "," & bomDict(key)
    Next key
    
    Close #fileNum
    
    ' 5. 図面本体の保存
    acadDoc.Save
    
    MsgBox "図面を保存し、BOMを更新しました:" & vbCrLf & csvPath, vbInformation
    
End Sub

伝説のアーキテクトが教える「陥りやすい罠」と「回避術」

コードを動かすだけなら簡単です。しかし、実務で「使える」コードにするためには、以下の3つのポイントを理解しておく必要があります。

1. 「ファイルが開いています」エラーの恐怖

CSV出力時に最も多いエラーは、「出力先のCSVをExcelで開いたままにしている」ことです。
ファイルが他のプロセスにロックされていると、VBAは書き込み権限を得られず、マクロがクラッシュします。上記のコードでは、`On Error Resume Next` と `Err.Number` を使って、このエラーをスマートに検知し、ユーザーに優しく通知するように設計しています。

2. オブジェクトのライフサイクルとメモリ

図面が巨大な場合、すべてのエンティティ(`ent`)をループで回すのは負荷がかかります。
もし動作が重いと感じたら、`ModelSpace` だけでなく、特定のレイヤーだけに絞り込んで走査するなどの最適化を検討してください。また、`Set blockRef = ent` のようにオブジェクトを代入する際は、使い終わった後にメモリを意識することが重要ですが、VBAのガベージコレクションに任せるのが一般的です。ただし、大規模なループ内では変数のスコープを最小限に留めるのが鉄則です。

3. 「タグ名」への依存

上記のコードでは、属性のタグ名を `”PART_NO”` と決め打ちしています。
実務では、設計者によって「PART_NO」「P_NO」「品番」など、バラバラな名前が付けられることがあります。これを防ぐには、「属性の命名規則(ルール)」をチーム内で徹底するか、あるいはマクロ側で複数のキーワードを受け入れられるように拡張する必要があります。

まとめ:ここをクリアすれば、AutoCAD VBAの基本はバッチリです

今回のコードで学んだことは、単なる「CSV出力」ではありません。

  • 図面オブジェクトを走査する技術
  • Dictionaryを用いた高度なデータ集計
  • ファイルシステムとの連携とエラー制御

これらは、どのような業務自動化ツールを作るにしても共通する「核」となる技術です。

「マクロの記録」は、いわば「辞書」を引く作業です。しかし、今回のようなコードを書くことは、「文章を組み立てる」作業です。一度この感覚を掴めば、あなたの作るマクロは、単なる便利ツールを超えて、「信頼できるデジタル・アシスタント」へと進化していくはずです。

さあ、次はどんな業務を自動化しましょうか? 挑戦を続けてください。応援していますよ!

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