【実務・中級編】【中級者向け】アセンブリ図面における「部品番号の連番(バルーン)」をパーツのツリー構造順に沿って完璧に並べ替えるVBA – SolidWorks VBA解析バイブル

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

[SolidWorks VBA] 整合された設計思想:FeatureManagerの順序を部品番号(バルーン)へ同期させる「BOMソート・エンジニアリング」

設計現場において、アセンブリ図面の「バルーン(部品番号)」の並び順が、設計者の意図(FeatureManagerのデザインツリーの構造)と乖離しているケースは枚挙にいとまがない。

SolidWorksの「自動バルーン配置」機能は、あくまで描画ビュー内の配置アルゴリズムに基づいた「見た目の整理」に過ぎない。一方で、エンジニアが真に求めているのは、「設計意図(ツリー構造)=部品番号(BOM順序)=図面表示(バルーン)」という情報の完全な同期である。

本稿では、単にバルーンを動かすという小手先のテクニックではなく、「ツリーの順序をカスタムプロパティに書き込み、BOMのソート順を制御することで、図面全体の整合性を自動的に担保する」という、極めて堅牢かつプロフェッショナルな設計アプローチを伝授する。

1. なぜ「バルーンの座標操作」では敗北するのか

中級者が陥りがちな罠がある。それは、「バルーンオブジェクトを取得し、その座標を一つずつ計算して並べ替える」というアプローチだ。

これは設計として「敗北」である。理由は3つある。

1. データの一貫性の欠如: バルーンの番号はBOM(部品表)に依存している。バルーンの見た目だけをいじっても、BOMの順序が変われば、番号は再びバラバラになる。
2. 計算コストの増大: 描画ビュー内の全アノテーションを走査し、座標計算を行うロジックは、大規模アセンブリにおいて極めて重い。
3. 保守性の欠如: 部品が追加・削除された際、再計算ロジックが破綻する。

提唱するアーキテクチャ:Single Source of Truth (SSOT)

我々が採用すべきは、「FeatureManagerの順序を、部品のカスタムプロパティ(例:`SortOrder`)に書き込む」という戦略である。

1. Model層: ツリーを走査し、出現順に `SortOrder` プロパティを各コンポーネントに注入する。
2. BOM層: BOMのソート基準を `SortOrder` に設定する。
3. Drawing層: バルーンはBOMに従い、自動的にツリー順の番号を纏う。

この設計であれば、図面側で複雑な座標計算を行う必要は一切なくなる。

2. 実装コード:Tree-to-Property Synchronization Engine

以下に、アセンブリのツリー構造を解析し、コンポーネントに連番を付与する堅牢なプロダクションコードを示す。

'**
' Module: ComponentSequenceManager
' Purpose: FeatureManagerの順序に基づき、コンポーネントにソート用プロパティを付与する
'**
Option Explicit

Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim counter As Long

Sub Main()
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 1. 実行環境のバリデーション
    If swModel Is Nothing Then
        MsgBox "モデルが開かれていません。", vbCritical
        Exit Sub
    End If
    
    If swModel.GetType <> swDocASSEMBLY Then
        MsgBox "アセンブリファイルを開いて実行してください。", vbCritical
        Exit Sub
    End If

    ' 2. 初期化
    counter = 1
    
    ' 3. 再帰的走査の開始
    Debug.Print "--- Sequence Injection Started ---"
    TraverseComponentTree swModel.FirstConfiguration.RootComponent
    Debug.Print "--- Injection Completed. Total: " & (counter - 1) & " ---"

    ' 4. 変更の確定
    swModel.ForceRebuild3
    MsgBox "全コンポーネントへの順序付与が完了しました。", vbInformation
End Sub

''' <summary>
''' コンポーネントツリーを再帰的に走査する関数
''' </summary>
''' <param name="swComp">現在のコンポーネント</param>
Private Sub TraverseComponentTree(swComp As SldWorks.Component2)
    If swComp Is Nothing Then Exit Sub

    Dim vChildren As Variant
    Dim i As Long
    Dim swChildComp As SldWorks.Component2
    Dim swPartModel As SldWorks.ModelDoc2
    
    ' --- コンポーネントへのプロパティ書き込みロジック ---
    ' 取得したコンポーネントの「実体モデル」に対してプロパティを書き込む
    Set swPartModel = swComp.GetModelDoc2
    
    If Not swPartModel Is Nothing Then
        ' カスタムプロパティ "SortOrder" を書き込み
        ' 注意: 実体モデルに書き込むため、全インスタンスに影響する
        WriteCustomProperty swPartModel, "SortOrder", CStr(counter)
        Debug.Print "Index: " & counter & " | Name: " & swComp.Name2
        counter = counter + 1
    End If
    ' --------------------------------------------------

    ' 子コンポーネントの取得
    vChildren = swComp.GetChildren
    If Not IsEmpty(vChildren) Then
        For i = 0 To UBound(vChildren)
            Set swChildComp = vChildren(i)
            ' 再帰呼び出し
            TraverseComponentTree swChildComp
        Next i
    End If
End Sub

''' <summary>
''' カスタムプロパティの書き込み(堅牢なエラーハンドリング付き)
''' </summary>
Private Sub WriteCustomProperty(targetModel As SldWorks.ModelDoc2, propName As String, propValue As String)
    Dim swCustPropMgr As SldWorks.CustomPropertyManager
    On Error GoTo ErrHandler
    
    ' コンポーネント固有のプロパティではなく、モデル自体のプロパティとして扱う
    ' (BOMで参照するためには、モデルレベルのプロパティが必要)
    Set swCustPropMgr = targetModel.Extension.CustomPropertyManager("")
    
    ' Add3を使用して、既存プロパティがあれば更新、なければ追加を行う
    ' swCustomPropertyAddOrReplace = 1
    swCustPropMgr.Add3 propName, swCustomPropertyText, propValue, swCustomPropertyReplaceValue
    
    Exit Sub
ErrHandler:
    Debug.Print "Error writing property to " & targetModel.GetTitle & ": " & Err.Description
End Sub

3. プロフェッショナルのための運用設計(Critical Insights)

コードを書くだけでは不十分だ。このツールを「業務フロー」に組み込むための、アーキテクトとしての視点を授ける。

① プロパティのスコープ(Scope)に注意せよ

上記のコードでは、`swComp.GetModelDoc2` を使用して、コンポーネントの「実体モデル」に対してプロパティを書き込んでいる。

  • 利点: BOM(部品表)はモデルのプロパティを参照するため、これで確実にソートが可能になる。
  • リスク: 同じパーツを複数箇所で使用している場合、それら全てに同じ `SortOrder` が入ってしまう。しかし、BOMのソートにおいては「同一パーツは同一番号」であるべきなので、これはむしろ正しい挙動である。

② BOMの設定変更(手動またはVBA)

このスクリプトを実行した後、図面のBOMに対して以下の設定を行う必要がある。
1. BOMテーブルの列に「カスタムプロパティ」→「`SortOrder`」を追加。
2. `SortOrder` 列を基準に昇順ソート。
3. `SortOrder` 列を非表示にする(必要に応じて)。

これを自動化したい場合は、Drawing APIを用いて `swBomTableAnnotation.SortColumn` を制御するコードを追加することになる。

③ パフォーマンスとライフサイクル

大規模アセンブリ(数千点規模)で実行する場合、`swModel.ForceRebuild3` は非常に重い。
実務では、「すべてのコンポーネントの書き込みが完了した後に、一括でリビルドをかける」という、本コードのような実装が鉄則である。ループ内でリビルドをかけるような初心者のコードは、即座にプロジェクトの納期を破壊する。

4. 結論

「バルーンを並べ替える」という問題に対し、図面(Drawing)レイヤーで戦うのは非効率の極みである。
真に堅牢な自動化エンジニアは、「データの出所(Source of Truth)」を見極め、モデル層のデータ構造を操作することで、図面層の結果を間接的に、かつ完璧に制御する。

この「プロパティ・インジェクション」によるアプローチこそが、バグが起きにくく、仕様変更にも強い、真のプロダクション・グレードの設計である。

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