【入門編】【中級者向け】図面内「部品表(BOM)」の特定列にカスタムプロパティ(質量や表面処理)を自動マッピングして値を補正するVBA – SolidWorks VBA解析バイブル

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

【中級者への登竜門】BOMの限界を超える:カスタムプロパティをテーブルへ強制マッピングする極意

こんにちは。設計現場の自動化に情熱を注ぐエンジニアの皆さん。
マクロの「記録」機能を使って、簡単な操作を自動化することには慣れてきましたか? もしあなたが今、「標準の部品表(BOM)では、どうしても表示できない社内独自の計算値や、特殊な表面処理の情報を書き込みたい……」という壁にぶつかっているなら、おめでとうございます。

あなたは今、「単なる自動化」から「システムの構築」へとステップアップする境界線に立っています。

今日は、SolidWorksの標準機能では手が届かない領域――図面内のBOM(部品表)に対して、VBAを用いて特定のカスタムプロパティを狙い撃ちで流し込み、値を補正する高度なテクニックを伝授します。

ここをクリアすれば、SolidWorks VBAの制御における「オブジェクトの概念」が、驚くほどクリアに見えてくるはずですよ。

1. なぜ「標準のBOM」では不十分なのか?

SolidWorksのBOMは非常に強力です。部品の構成を自動で読み取り、数量を計算してくれます。しかし、実務では以下のような要望が必ず発生します。

  • 「設計データベースから取得した『特殊な熱処理コード』を、BOMの特定の列に表示したい」
  • 「部品の質量(Mass)を、単なる数値ではなく、社内規定の単位変換を施した状態で表示したい」
  • 「図面上のBOMに、部品単体のプロパティにはない『設計上の注釈』を一括で書き込みたい」

標準のBOMは「モデル(部品・アセンブリ)の情報を反映する」というルールに縛られています。しかし、VBAを使えば、BOMを「単なるテーブル(表)オブジェクト」として扱い、セルの一つひとつに対して直接命令を下すことが可能になります。

これができると、図面作成のプロセスは「手入力による修正」から「データの同期」へと劇的に進化します。

2. 攻略の鍵:オブジェクト・階層構造の理解

コードを書く前に、SolidWorksが内部でどのように図面を捉えているか、その「家系図(階層構造)」を頭に叩き込みましょう。ここを間違えると、コードは必ずエラーで止まります。

図面を操作する際のルートは以下の通りです:

1. SldWorks (Application):すべての神。
2. ModelDoc2 (Drawing):今開いている図面ファイル。
3. DrawingDoc:図面特有の機能(シート操作など)を持つインターフェース。
4. Sheet:図面内の各シート。
5. View:図面上の投影図や、BOMが含まれる「ビュー」。
6. BomTableAnnotation:これこそが今回の主役。BOMの「表」そのもの。
7. TableAnnotation:セル操作を行うための最小単位。

私たちは、「ビュー」の中から「BOMテーブル」を見つけ出し、その中の「行」をループで回して、「特定の列」に値を書き込むという旅に出るのです。

3. 実践:BOMカスタムマッピング・マクロ

それでは、実際のコードを見てみましょう。
このコードは、「BOMの第3列(インデックスは2)に、各部品のカスタムプロパティ『Surface_Finish』の値を強制的に書き込む」という動きを想定しています。

Option Explicit

' ==============================================================================
' テーマ: BOMの特定列にカスタムプロパティを自動マッピングする
' 概要: 図面内の全てのBOMを走査し、指定した列に部品のカスタムプロパティを書き込む
' ==============================================================================

Sub Main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swSheet As SldWorks.Sheet
    Dim swView As SldWorks.View
    Dim swBomTable As SldWorks.BomTableAnnotation
    Dim swTableAnn As SldWorks.TableAnnotation
    
    Dim i As Long ' 行ループ用
    Dim targetColumn As Integer
    Dim propName As String
    Dim customValue As String
    Dim swComp As SldWorks.Component2
    Dim swPartModel As SldWorks.ModelDoc2
    
    ' --- 設定エリア ---
    targetColumn = 2      ' 書き込みたい列番号 (0から数えるので、3列目は「2」)
    propName = "Surface_Finish" ' 取得したいカスタムプロパティ名
    ' ------------------

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 図面が開かれているかチェック
    If swModel Is Nothing Or swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを開いた状態で実行してください。", vbCritical
        Exit Sub
    End If
    
    Set swDraw = swModel
    
    ' 画面更新を停止してパフォーマンスを向上させる(重要!)
    swApp.UserControl = False ' 処理中の制御奪取防止
    
    ' 1. 図面内の全てのビューを走査
    ' 最初のビュー(シート自体)から始まり、全てのビューを辿る
    Set swView = swDraw.GetFirstView 
    
    Do While Not swView Is Nothing
        
        ' 2. そのビューがBOMを持っているか確認
        Set swBomTable = swView.GetBomTableAnnotation
        
        If Not swBomTable Is Nothing Then
            ' BOMが見つかった場合、テーブル操作用のインターフェースを取得
            Set swTableAnn = swBomTable
            
            ' 3. BOMの行をループ(ヘッダーを除外するため 1 から開始)
            ' GetRowCount で総行数を取得
            For i = 1 To swTableAnn.RowCount - 1
                
                ' 4. その行に紐づくコンポーネント(部品)を取得
                ' BOMの行からモデル情報を辿るのは少しテクニカルです
                Set swComp = swBomTable.GetComponent(i)
                
                If Not swComp Is Nothing Then
                    Set swPartModel = swComp.GetModelDoc2
                    
                    If Not swPartModel Is Nothing Then
                        ' 5. 部品のカスタムプロパティから値を取得
                        customValue = swPartModel.GetCustomInfoValue("", propName)
                        
                        ' 6. もし値が存在すれば、BOMのセルに書き込む
                        If customValue <> "" Then
                            ' SetText(行, 列, 値)
                            swTableAnn.Text(i, targetColumn) = customValue
                        End If
                    End If
                End If
                
            Next i
            Debug.Print "BOMの更新完了: " & swView.Name
        End If
        
        ' 次のビューへ
        Set swView = swView.GetNextView
    Loop
    
    ' 再描画して結果を表示
    swModel.ForceRebuild3 True
    MsgBox "BOMのマッピングが完了しました!", vbInformation

End Sub

4. コードの深淵:エンジニアとしての解説

このコードには、単なる「動くマクロ」以上の、実戦的な知見が詰まっています。

① `swBomTable.GetComponent(i)` の重要性

BOMのセルに値を書き込む際、一番の難所は「その行がどの部品を指しているか」を特定することです。`swBomTable.GetComponent(i)` を使うことで、BOMの行番号から直接、アセンブリ内のコンポーネントオブジェクトへアクセスできます。ここが、マクロの記録では決して辿り着けない「オブジェクトの繋がり」です。

② パフォーマンスへの配慮

`swModel.ForceRebuild3 True` は、ループの中で毎回呼ぶのではなく、全ての処理が終わった最後に一度だけ呼びます。ループ内で再描画を繰り返すと、部品数が多い場合にSolidWorksがフリーズしたかのように重くなります。これは「計算コスト」を意識したプロの書き方です。

③ エラーハンドリングの思想

`If Not swPartModel Is Nothing Then` という一文。これは「部品が欠落(SuppressedやMissing)している場合に、プログラムがクラッシュするのを防ぐ」ための防波堤です。実務の現場では、必ず「想定外のデータ」が紛れ込みます。それを前提にコードを書くのが、強靭なエンジニアへの第一歩です。

5. 陥りやすい罠(Pitfalls)

もし動かないときは、以下の3点を疑ってください。

1. 列番号のカウントミス(0-based index)
VBAの配列や多くのAPIは、1番目の要素を `0` と数えます。BOMの「3列目」に書き込みたいなら、コード上では `2` を指定しなければなりません。
2. カスタムプロパティの「場所」
`swPartModel.GetCustomInfoValue(“”, propName)` の第一引数が `””` なのは、「ファイル全体(カスタムプロパティ)」を探していることを意味します。もし「構成タブ」ではなく「詳細設定」などに情報がある場合は、取得ロジックを見直す必要があります。
3. BOMのタイプ
アセンブリBOMなのか、パーツBOMなのかによって、取得できるオブジェクトの挙動が微妙に異なる場合があります。まずはシンプルなアセンブリ図面でテストしましょう。

最後に:次なるステップへ

いかがでしたか?
標準機能の「枠」を飛び出し、VBAという武器を使ってオブジェクトを直接操る感覚。これが掴めると、SolidWorksは単なるCADソフトから、あなたの指示に従う強力な「自動化プラットフォーム」へと変貌します。

「もっと効率化したい」「このデータも連携させたい」
そう思った瞬間が、あなたのエンジニアとしての成長のチャンスです。

一歩ずつ、確実に。コードの向こう側にある自動化の未来を楽しんでください。応援していますよ!

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