【中級者への登竜門】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ソフトから、あなたの指示に従う強力な「自動化プラットフォーム」へと変貌します。
「もっと効率化したい」「このデータも連携させたい」
そう思った瞬間が、あなたのエンジニアとしての成長のチャンスです。
一歩ずつ、確実に。コードの向こう側にある自動化の未来を楽しんでください。応援していますよ!
