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

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

【極限の設計自動化】アセンブリ・ツリーの階層構造を「図面バルーン」に同期させる:論理順序の完全制御

設計自動化の現場において、多くのエンジニアが「自動バルーン配置」という甘い言葉の罠に落ちる。

SolidWorksの標準機能による自動バルーン配置は、極めて「空間的」なアルゴリズムに基づいている。つまり、図面上の座標(XY平面上の距離)に基づいて、数学的に「近い」ものから順に番号を振っていくのだ。しかし、製造現場や組立工程の人間が求めているのは、空間的な近さではない。「アセンブリの構成ツリー(FeatureManager)の論理的な並び順」である。

ツリーの順序とバルーンの番号が一致しない図面は、部品表(BOM)との整合性に疑義を生じさせ、大規模プロジェクトにおける誤組立のリスクを増大させる。

本稿では、単なる「配置の自動化」を超え、アセンブリの階層構造を完全に掌握し、その論理的順序を図面上のバルーンに強制的に同期させるための、プロフェッショナルな実装アプローチを解説する。

1. アーキテクチャの設計思想:空間から論理への転換

一般的な自動化スクリプトは、`DrawingDoc` から `View` を取得し、その中の `Annotation` をループで回すだけで終わる。しかし、それでは「どのバルーンがどのコンポーネントに紐付いているか」という、階層構造の情報を欠落させてしまう。

我々が構築すべきアルゴリズムは、以下の3層構造でなければならない。

1. Hierarchy Traversal Layer(階層走査層):
アセンブリの `Component2` を再帰的に走査し、FeatureManager上の出現順序に基づいた「コンポーネント・インデックス・マップ」を構築する。
2. Mapping Layer(紐付け層):
図面ビュー内の各バルーン(`Note` または `Annotation`)が、どのコンポーネントを指し示しているかを API を通じて特定する。
3. Re-ordering/Relabeling Layer(再配置・再番号層):
構築したマップに基づき、バルーンの属性(テキストまたは連番)を、ツリーの順序に従って再定義する。

2. 実装:再帰的コンポーネント走査とバルーン同期

以下に、シニアエンジニアが実装すべき堅牢なコードの骨格を示す。ここでは、メモリリークを防ぐための明示的なオブジェクト解放と、再帰呼び出しによるツリー探索を実装している。

'**
' Module: BalloonOrderMaster
' Description: Synchronizes Drawing Balloon sequence with Assembly Tree order.
' Author: Legendary Chief Architect
'**

Option Explicit

' Windows API: プロセス制御や高度なUI操作が必要な場合に使用するが、
' 本実装ではメモリ管理の重要性を説くため、ここでは標準的なCOM操作に集中する。

Sub Main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swAssy As SldWorks.AssemblyDoc
    Dim swView As SldWorks.View
    
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 1. 実行環境のバリデーション
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY And swModel.GetType <> swDocDRAWING Then
        MsgBox "アセンブリ、または図面を開いてください。"
        Exit Sub
    End If
    
    ' 2. コンポーネント・マップの構築 (Dictionaryを使用)
    ' ※ Microsoft Scripting Runtime の参照設定が必要
    Dim compMap As Object
    Set compMap = CreateObject("Scripting.Dictionary")
    
    If swModel.GetType = swDocASSEMBLY Then
        Set swAssy = swModel
        ' アセンブリのルートから再帰的に走査
        Dim rootComp As SldWorks.Component2
        Set rootComp = swAssy.GetRootComponent3(True)
        TraverseComponentTree rootComp, compMap, 1
    ElseIf swModel.GetType = swDocDRAWING Then
        ' 図面からアセンブリを参照している場合、そのモデルを解析
        Dim refModel As SldWorks.ModelDoc2
        Set refModel = swModel.GetReferenceModel()
        If Not refModel Is Nothing Then
            If refModel.GetType = swDocASSEMBLY Then
                Set swAssy = refModel
                Set rootComp = swAssy.GetRootComponent3(True)
                TraverseComponentTree rootComp, compMap, 1
            End If
        End If
    End If

    ' 3. 図面ビューへの適用
    If swModel.GetType = swDocDRAWING Then
        Set swDraw = swModel
        Set swView = swDraw.GetFirstView ' Sheet view
        Set swView = swView.GetNextView  ' First actual drawing view
        
        Do While Not swView Is Nothing
            ProcessViewBalloons swView, compMap
            Set swView = swView.GetNextView
        Loop
    End If

    ' 4. メモリの明示的解放 (Object Lifecycle Management)
    Set compMap = Nothing
    Set swAssy = Nothing
    Set swDraw = Nothing
    Set swModel = Nothing
    Set swApp = Nothing
    
    MsgBox "バルーンの論理順序同期が完了しました。"
End Sub

'------------------------------------------------------------------------------
' 関数: TraverseComponentTree (再帰的走査)
' 引数: swComp (現在のコンポーネント), dict (マップ), depth (階層深さ)
'------------------------------------------------------------------------------
Private Sub TraverseComponentTree(ByRef swComp As SldWorks.Component2, ByRef dict As Object, ByVal ByRef counter As Long)
    Dim vChildren As Variant
    Dim i As Long
    Dim childComp As SldWorks.Component2
    Dim compName As String
    
    ' コンポーネント名をキーとして登録 (同一名称の別パーツを考慮する場合はFullNameを使用)
    compName = swComp.Name2
    
    ' すでに登録されている場合はスキップ(重複回避ロジック)
    If Not dict.Exists(compName) Then
        dict.Add compName, counter
        counter = counter + 1
    End If
    
    ' 子コンポーネントの取得
    vChildren = swComp.GetChildren
    If Not IsEmpty(vChildren) Then
        For i = 0 To UBound(vChildren)
            Set childComp = vChildren(i)
            TraverseComponentTree childComp, dict, counter
        Next i
    End If
    
    ' 再帰呼び出し終了時にローカルオブジェクトを解放する習慣を
    Set childComp = Nothing
End Sub

'------------------------------------------------------------------------------
' 関数: ProcessViewBalloons (ビュー内のバルーン処理)
'------------------------------------------------------------------------------
Private Sub ProcessViewBalloons(ByRef swView As SldWorks.View, ByRef dict As Object)
    Dim swNote As SldWorks.Note
    Dim swAnn As SldWorks.Annotation
    Dim swComp As SldWorks.Component2
    Dim compName As String
    Dim targetIndex As Long
    
    ' ビュー内の最初のノート(バルーン)を取得
    Set swNote = swView.GetFirstNote
    
    Do While Not swNote Is Nothing
        Set swAnn = swNote.GetAnnotation
        
        ' バルーンがコンポーネントに紐付いているか確認
        ' Noteの属性から紐付け先のコンポーネント情報を取得するロジックが必要
        ' ここでは簡略化のため、Noteのテキストまたは参照から取得するプロセスを想定
        
        ' ※ 実務上の重要ポイント: 
        ' BalloonはNoteの一種だが、特定のコンポーネントへのリンクを持つ。
        ' swNote.GetSelectedEntity を利用して、参照先のComponent2を特定する。
        
        ' [ロジック抜粋] 
        ' 1. Noteからコンポーネントを取得
        ' 2. compMap からそのコンポーネントの「ツリー順序」を引き出す
        ' 3. その順序に従って、Noteのテキストを書き換える、あるいは位置を調整する
        
        ' ※ 実際の高度な実装では、ここでバルーンの座標(swAnn.GetPosition)を
        ' ツリー順序に基づいて再計算し、重なりを防ぐロジックを組み込む。
        
        Set swNote = swNote.GetNext
    Loop
    
    Set swAnn = Nothing
    Set swNote = Nothing
    Set swView = Nothing
End Sub

3. 伝説的アーキテクトの知見:パフォーマンスと保守性

このコードを単なる「動くスクリプト」から「プロフェッショナルなシステム」へと昇華させるためには、以下の3点に留意せよ。

① オブジェクトのライフサイクル管理

VBAにおける最大の敵は、COMオブジェクトの「残存」である。特に再帰関数(`TraverseComponentTree`)内で `Set childComp = Nothing` を怠ると、大規模アセンブリの走査時にメモリ消費が指数関数的に増大し、SolidWorksのプロセスが不安定になる。「使い終わったオブジェクトは、スコープを抜ける前に必ず屠る」。これが鉄則である。

② Dictionaryの選択

`Scripting.Dictionary` は強力だが、大規模データではハッシュ衝突の可能性を考慮すべきだ。しかし、アセンブリのコンポーネント数(数千件程度まで)であれば、この実装が最もバランスが良い。もし数万件を超える超大規模アセンブリを扱うなら、VB.NETへの移行を検討し、`ConcurrentDictionary` を使用したマルチスレッド走査を検討せよ。

③ エラーハンドリングの深度

実務環境では、コンポーネントが「抑制(Suppressed)」されていたり、参照が壊れているケースが多々ある。`If Not swComp Is Nothing` だけでなく、`swComp.GetSuppression` をチェックし、抑制されたコンポーネントを走査対象から除外するロジックを組み込むことで、実行時エラーを未然に防ぐことが可能だ。

結びに代えて

図面自動化の本質は、単に「作業を減らすこと」ではない。「設計者が意図した論理構造を、いかに正確に、かつ美しく出力物に反映させるか」にある。

空間的な座標に依存した「動的な配置」に甘んじるのではなく、ツリー構造という「設計の背骨」を制御下に置くこと。それこそが、シニアエンジニアに求められる設計自動化の真髄である。

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