[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)」を見極め、モデル層のデータ構造を操作することで、図面層の結果を間接的に、かつ完璧に制御する。
この「プロパティ・インジェクション」によるアプローチこそが、バグが起きにくく、仕様変更にも強い、真のプロダクション・グレードの設計である。
