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

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

BOM操作の深淵:標準機能の限界を突破する「データ同期型」自動化設計思想

SolidWorksの標準機能としての部品表(BOM)は、アセンブリの構成を可視化するには極めて優秀だ。しかし、設計現場の「真の要求」はそれだけでは満たされない。

「表面処理の仕様を、社内の基幹システムから取得した最新コードに書き換えたい」
「計算式でしか出せない、メッキ厚を考慮した総重量をBOMの特定列に反映させたい」
「部品番号の末尾に、特定の設計変更フラグを自動付与したい」

こうした「標準プロパティの枠を超えたデータ操作」が必要になったとき、多くの開発者は罠に陥る。セルを一つずつループで回し、マジックナンバー(列番号)を直接指定して書き込む――そんなコードは、設計変更一つで即座に崩壊する「脆弱なスクリプト」に過ぎない。

本記事では、単なるプログラミング解説ではない。「変化に強く、大規模データでも高速に動作し、保守性に優れた」プロダクションレベルのBOM制御エンジニアリングについて、その設計思想を伝授する。

1. 陥りがちな「アンチパターン」と設計のパラダイムシフト

中級者が最初に直面する壁は、「列番号への依存」だ。

脆弱な設計(アンチパターン)

' ❌ 非常に危険なコード
For i = 1 To rowCount
    ' 5列目が「表面処理」だと思い込んでいる
    bomTable.Text(i, 5) = "クロメート" 
Next i

図面のレイアウト変更で列が一つ挿入された瞬間、このコードは「部品番号」や「数量」を上書きし、図面データを破壊する。これは自動化ツールではなく、破壊ツールだ。

堅牢な設計(アーキテクチャ)

プロフェッショナルは、「列名(Header Name)による動的インデックス取得」を実装する。
1. テーブルのヘッダー行を走査し、目的の文字列(例:「表面処理」)を持つ列番号を特定する。
2. 特定したインデックスを用いてデータ操作を行う。

これにより、列の増減や並べ替えに対して、コードを書き換えることなく耐性を維持できる。

2. オブジェクトモデルの正しい理解:TableAnnotation vs BomTableAnnotation

SolidWorks APIにおいて、BOMは `TableAnnotation` オブジェクトの派生、あるいはそれに関連付けられた特殊なインターフェースとして振る舞う。

図面上のテーブルを操作する場合、単なる `TableAnnotation` として扱うのではなく、BOM特有のプロパティにアクセスするために、適切なキャスト(型判定)とオブジェクトの取得フローが必要だ。

設計の肝:

  • `DrawingDoc` から `Sheet` を取得。
  • `Sheet` から `View` を取得。
  • `View` から `BomTableAnnotation` を特定する。

この階層構造を正しく辿ることで、意図しないテーブル(注記テーブルなど)を操作してしまうミスを防ぐ。

3. 実践:堅牢なBOMマッピング・エンジンの実装

以下に、実務でそのまま転用可能な、高信頼性設計のコード例を示す。このコードは、「列名検索」「エラーハンドリング」「データ同期ロジックの分離」を具備している。

Option Explicit

''' <summary>
''' BOMの特定列にカスタムデータを流し込むメインルーチン
''' </summary>
Public Sub UpdateBomCustomColumns()
    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 swBomAnn As SldWorks.BomTableAnnotation
    
    On Error GoTo ErrorHandler

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 1. ドキュメント型のチェック(堅牢性の基本)
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを開いてください。", vbCritical
        Exit Sub
    End If
    
    Set swDraw = swModel
    Set swSheet = swDraw.GetCurrentSheet
    
    ' 2. 図面内の最初のビュー(または特定のビュー)からBOMを取得
    ' ここでは、シート上の最初のビューを走査する設計とする
    Set swView = swDraw.GetFirstView ' Sheet自体が最初のViewとして返る
    Set swView = swView.GetNextView  ' 実際の図面ビューへ
    
    Do While Not swView Is Nothing
        ' ビューがBOMを持っているか確認
        Set swBomAnn = GetBomAnnotationFromView(swView)
        
        If Not swBomAnn Is Nothing Then
            ' BOMが見つかった場合、更新処理を実行
            ProcessBomData swBomAnn
            Exit Do ' 最初のBOMを処理したら終了(複数BOM対応が必要なら継続)
        End If
        Set swView = swView.GetNextView
    Loop

    If swBomAnn Is Nothing Then
        MsgBox "更新対象のBOMが見つかりませんでした。", vbExclamation
    Else
        swModel.ForceRebuild3 True
        MsgBox "BOMの更新が完了しました。", vbInformation
    End If

    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 指定したビューからBomTableAnnotationオブジェクトを抽出する
''' </summary>
Private Function GetBomAnnotationFromView(swView As SldWorks.View) As SldWorks.BomTableAnnotation
    Dim swAnn As SldWorks.Annotation
    Dim swTableAnn As SldWorks.TableAnnotation
    
    Set swAnn = swView.GetFirstAnnotation2
    Do While Not swAnn Is Nothing
        If swAnn.GetType = swAnnotationType_e.swTableAnnotation Then
            Set swTableAnn = swAnn.GetSpecificAnnotation
            ' TableAnnotationがBOMであることを確認
            If swTableAnn.Type = swTableType_e.swTableType_Bom Then
                Set GetBomAnnotationFromView = swTableAnn
                Exit Function
            End If
        End If
        Set swAnn = swAnn.GetNextAnnotation
    Loop
    Set GetBomAnnotationFromView = Nothing
End Function

''' <summary>
''' BOMの列を動的に特定し、データを書き込むコアロジック
''' </summary>
Private Sub ProcessBomData(swBomAnn As SldWorks.BomTableAnnotation)
    Dim swTable As SldWorks.TableAnnotation
    Set swTable = swBomAnn
    
    Dim colSurface As Integer: colSurface = -1
    Dim colMass As Integer: colMass = -1
    Dim i As Long, j As Long
    Dim colCount As Long: colCount = swTable.ColumnCount
    Dim rowCount As Long: rowCount = swTable.RowCount
    
    ' --- STEP 1: 列インデックスの動的特定 ---
    ' ヘッダー行(通常は0行目)を走査して列番号を特定する
    For j = 0 To colCount - 1
        Dim headerText As String
        headerText = swTable.Text(0, j)
        
        Select Case headerText
            Case "表面処理" ' 探したいヘッダー名
                colSurface = j
            Case "質量(kg)"
                colMass = j
        End Select
    Next j
    
    ' 必須列が見つからない場合は処理を中断(設計の整合性チェック)
    If colSurface = -1 Or colMass = -1 Then
        MsgBox "必要な列(表面処理 または 質量(kg))がBOM内に見つかりません。", vbExclamation
        Exit Sub
    End If

    ' --- STEP 2: データ同期ロジック ---
    ' 2行目(データ開始行)から最終行までループ
    For i = 1 To rowCount - 1
        ' 部品番号(通常は0列目)を取得して、データベース連携のキーとする
        Dim partNumber As String
        partNumber = swTable.Text(i, 0) 
        
        If partNumber <> "" Then
            ' 外部DBや計算ロジックから値を取得する(ここではシミュレーション)
            Dim newValSurface As String
            Dim newValMass As String
            
            ' [実務へのアドバイス] ここにDB接続や複雑な計算ロジックを分離して呼び出す
            Call FetchExternalData(partNumber, newValSurface, newValMass)
            
            ' セルへの書き込み
            swTable.Text(i, colSurface) = newValSurface
            swTable.Text(i, colMass) = newValMass
        End If
    Next i
End Sub

''' <summary>
''' 外部データ取得のモックアップ(実務ではここをDB接続やExcel参照に置き換える)
''' </summary>
Private Sub FetchExternalData(ByVal pNum As String, ByRef outSurf As String, ByRef outMass As String)
    ' 本来はここで SQL Query や API Call を行う
    ' 今回はデモ用に、部品番号に基づいて値を生成
    If InStr(pNum, "BRKT") > 0 Then
        outSurf = "アルマイト"
        outMass = "0.45"
    Else
        outSurf = "未指定"
        outMass = "0.00"
    End If
End Sub

4. プロフェッショナルとしての「運用」の知見

コードを書いた後、真のエンジニアリングは「運用」において試される。

パフォーマンスの最適化

BOMの行数が数百、数千に及ぶ場合、`swTable.Text(i, j) = value` の呼び出しは無視できないオーバーヘッドを生む。

  • 描画停止: 大規模更新時は、更新処理の前に `swModel.ViewFreeze = True` を検討せよ(ただし、BOM操作においてはテーブルの再描画が伴うため、効果は限定的だ)。
  • 一括更新の検討: 可能であれば、計算結果をメモリ上の配列に一度格納し、最後に一気に書き込む設計にせよ。

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

「エラーが出たら止まる」のは初歩的だ。

  • データ整合性チェック: 「部品番号が空ではないか?」「取得した数値が数値型として妥当か?」を、書き込みの直前に検証するバリデーション層を設けるべきだ。
  • トランザクションの概念: 万が一、途中の行でエラーが起きた場合、図面が「半分だけ書き換わった中途半端な状態」になる。これを防ぐには、処理開始前に図面のバックアップ(一時保存)を取る、あるいはエラー発生時にユーザーに「ロールバック(やり直し)」を促す設計が求められる。

結びに代えて

SolidWorks VBAによる自動化は、単なる「手作業の代替」ではない。それは、「設計データと製造データの同期プロセスを、プログラムによって定義し直す行為」である。

列番号に依存せず、オブジェクトのライフサイクルを尊重し、エラーを予測して設計する。この視点を持った時、君が書くコードは「ツール」から「システム」へと昇華する。

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