【テクニカル・上級編】【初心者向け】図面シート上の指定した文字列を一括検索して社内改訂コードへ置換するVBA – SolidWorks VBA解析バイブル

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

【極限の知見】SolidWorks 図面内の文字列一括置換:オブジェクト・ライフサイクルとメモリ管理の真髄

設計現場において、図面内の「改訂コード」や「承認印」の更新を、手作業で行うことほどエンジニアリングの敗北を感じさせる行為はない。大量の図面を抱えるシステム管理者やシニアエンジニアにとって、この作業は自動化の対象であると同時に、「いかに堅牢に、いかに低負荷で、いかに確実に完遂するか」というアーキテクチャ設計の試金石である。

本記事では、一見すると単純な「図面内の文字列置換」というテーマを、単なるコードの書き写しではなく、SolidWorks APIのオブジェクト・ライフサイクル、メモリ管理、そして大規模処理におけるパフォーマンス最適化という観点から、プロフェッショナルの実装レベルへと引き上げる。

1. 階層構造の誤解:なぜ単純なループでは不十分なのか

多くの開発者が陥る罠がある。それは、図面(Drawing)を単一のキャンバスとして捉え、フラットに検索を試みることだ。SolidWorksの図面データ構造は、厳格な階層型オブジェクトモデル(DOM)で構成されている。

文字列(Note)は、以下の階層のどこかに潜んでいる。
1. Sheet(シート)直下のNote: シート上に直接配置されたテキスト。
2. View(図面ビュー)内のNote: 配置された図面ビューの中に含まれるテキスト。
3. Title Block(表題欄)内のNote: これは最も厄介だ。多くの場合、SheetFormatの一部として、あるいは特定のViewの属性として管理されている。

これらを網羅するためには、`DrawingDoc` から `Sheet` を辿り、さらに各 `View` の中にある `Note` を再帰的、あるいは反復的に走査する「階層的トラバース(Traversal)」が不可欠である。

2. 実装の核:高効率な文字列置換エンジン

以下に、実務に耐えうる設計思想に基づいたVBAコードを示す。ここでは、単に置換するだけでなく、「オブジェクトの明示的な解放」と「エラーハンドリングによるプロセス死守」を組み込んでいる。

Option Explicit

' ==============================================================================
' Module: DrawingStringReplacer
' Description: 図面内の特定文字列を検索し、一括置換するプロフェッショナル実装
' Author: Legendary Chief Architect
' ==============================================================================

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 swNote As SldWorks.Note
    Dim swAnn As SldWorks.Annotation
    
    ' 検索・置換パラメータ
    Const TARGET_STR As String = "OLD_REV_CODE" ' 検索対象
    Const REPLACE_STR As String = "REV_2023_A" ' 置換後文字列
    
    On Error GoTo ErrorHandler

    ' SolidWorksインスタンスの取得
    Set swApp = Application.SldWorks
    If swApp Is Nothing Then
        MsgBox "SolidWorksが起動していません。", vbCritical
        Exit Sub
    End If

    Set swModel = swApp.ActiveDoc
    
    ' ドキュメントが図面であることを確認
    If swModel Is Nothing Then GoTo CleanUp
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "アクティブなドキュメントが図面ではありません。", vbExclamation
        GoTo CleanUp
    End If

    Set swDraw = swModel
    
    ' 処理の高速化: 画面更新の停止(APIの挙動に依存するが、描画負荷を軽減)
    swApp.UserControl = False ' プログラムが制御権を握る

    ' --- 処理開始 ---
    ' 全シートを走査
    Dim vSheetNames As Variant
    vSheetNames = swDraw.GetSheetNames
    
    Dim i As Integer
    For i = 0 To UBound(vSheetNames)
        swDraw.ActivateSheet vSheetNames(i)
        Set swSheet = swDraw.GetCurrentSheet
        
        ' 1. シート直下のNoteを走査
        ' NoteオブジェクトはAnnotationを介してアクセスするのが最も確実
        ProcessNotesInView swModel, Nothing, TARGET_STR, REPLACE_STR
        
        ' 2. 各ビュー内のNoteを走査
        Set swView = swDraw.GetFirstView ' FirstViewはシート自体を指す場合があるため注意
        Do While Not swView Is Nothing
            ' View内のNoteを処理
            ProcessNotesInView swModel, swView, TARGET_STR, REPLACE_STR
            Set swView = swView.GetNextView
        Loop
    Next i

    ' 変更を確定
    swModel.ForceRebuild3 True
    MsgBox "置換処理が完了しました。", vbInformation

CleanUp:
    ' オブジェクトの明示的解放(メモリリーク防止の鉄則)
    ' 大規模なバッチ処理では、これが不十分だとSolidWorksがクラッシュする
    Set swAnn = Nothing
    Set swNote = Nothing
    Set swView = Nothing
    Set swSheet = Nothing
    Set swDraw = Nothing
    Set swModel = Nothing
    Set swApp = Nothing
    swApp.UserControl = True
    Exit Sub

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

''' <summary>
''' 指定されたViewまたはSheet内のNoteを走査し、文字列を置換する
''' </summary>
Private Sub ProcessNotesInView(ByRef swModel As SldWorks.ModelDoc2, _
                              ByRef swView As SldWorks.View, _
                              ByVal target As String, _
                              ByVal replacement As String)
    
    Dim swNote As SldWorks.Note
    Dim swAnn As SldWorks.Annotation
    Dim currentText As String
    
    ' Viewが渡された場合はそのView内のNote、Nothingの場合はSheet直下を想定
    ' ただし、APIの実装上、Viewの走査はGetFirstNoteから始まる
    If Not swView Is Nothing Then
        Set swNote = swView.GetFirstNote
    Else
        ' Sheet直下のNote取得ロジック(実際にはViewの走査でカバーされることが多い)
        ' ここでは簡略化しているが、実務ではAnnotationコレクションを直接叩く手法もある
        Exit Sub 
    End If

    Do While Not swNote Is Nothing
        Set swAnn = swNote.GetAnnotation
        currentText = swNote.GetText
        
        ' 文字列が含まれているか判定(大文字小文字を区別しない場合は vbTextCompare)
        If InStr(1, currentText, target, vbBinaryCompare) > 0 Then
            ' 置換実行
            Dim newText As String
            newText = Replace(currentText, target, replacement, 1, -1, vbBinaryCompare)
            swNote.SetText newText
        End If
        
        Set swNote = swNote.GetNext
    Loop
End Sub

3. アーキテクトの視点:パフォーマンスと安定性の極限

コードを書くことは容易だが、「動く」ことと「実務に耐える」ことは別物だ。 シニアエンジニアが意識すべき、以下の3つの設計指針を刻んでおいてほしい。

① オブジェクト・ライフサイクルの厳格な管理

VBAはCOM(Component Object Model)を介してSolidWorksを操作する。`Set swNote = Nothing` といった明示的な解放を怠ると、メモリ上に「浮いた」オブジェクトが残り続け、数千枚の図面をループ処理する際にメモリ不足(Out of Memory)を引き起こす。特に、エラーハンドリング(`ErrorHandler`)の出口で必ず解放を行う設計は、レガシーな環境でも安定稼働させるための生命線である。

② 検索アルゴリズムの計算量

本実装では `InStr` と `Replace` を用いている。これは、複雑な正規表現(RegExp)を使用するよりも圧倒的に高速である。もし、複雑なパターンマッチングが必要な場合は、Windows APIの `VBScript.RegExp` を呼び出すことになるが、その際は「正規表現エンジンのオーバーヘッド」を考慮し、本当に必要な箇所でのみ適用するべきだ。

③ アトミックな操作(Atomic Operations)

実務上のシステム間連携では、「図面を読み込み、置換し、保存する」という一連の流れを一つのアトミックな単位(分割不可能な操作)として設計せよ。途中でエラーが発生した場合、中途半端に書き換わった図面が保存されることは、データの整合性を破壊する最悪の事態である。

  • Strategy: 一旦、一時的なバックアップを作成するか、あるいは「置換に成功した」というフラグを管理するログ機能を実装することを推奨する。

結論

図面自動化の本質は、単なる文字列の書き換えではない。それは、「設計者の意図を、寸分違わぬ精度で、システム全体へ伝播させるためのインフラ構築」である。

今回示したコードは、そのための最小限かつ最強のテンプレートである。この基礎の上に、ファイルシステムとの連携、データベースとの同期、あるいはGUIによるユーザーインターフェースを積み上げていけ。エンジニアリングの真髄は、常にその「次」にある。

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