【実務・中級編】【初心者向け】図面内の特定文字列(担当者名や図面ステータス)を正規表現レスで高速に部分一致置換するVBA – SolidWorks VBA解析バイブル

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

【実戦編】SolidWorks図面自動化の急所:Noteオブジェクトを制御する「堅牢な文字列置換」の設計思想

図面作成の自動化を志す者は、必ずと言っていいほど「表題欄のテキストを書き換えたい」という壁にぶつかる。
「担当者名をExcelから読み取って流し込む」「図面のステータスを『設計中』から『検図済』へ一括置換する」――これらは一見、単純な作業に見えるだろう。

しかし、現場で動く「プロダクション・レベル」のツールを作ろうとしたとき、多くの開発者が初歩的なミスで自滅する。
全オブジェクトを無差別にループして速度を著しく低下させる、あるいは、ビュー内のノート(Note)を見落とし、一部のデータが書き換わらないといった「不完全な自動化」だ。

本記事では、正規表現(Regex)という強力すぎる武器に頼らず、あえて標準的な文字列操作を用いて、高速かつ確実に図面内のテキストを制御する設計思想を伝授する。

1. なぜ「適当なループ」ではいけないのか

多くの初心者は、以下のような思考プロセスでコードを書き始める。
*「図面の中にある全ての要素をスキャンして、テキストだったら置換する」*

これは、大規模なアセンブリや複雑な図面においては致命的なパフォーマンス低下を招く。SolidWorksのAPIにおいて、オブジェクトの列挙(Enumeration)はコストが高い操作だ。線、円、寸法、投影ビュー……それら全てを一つずつチェックするのは、砂漠の中から特定の砂粒を探すような無駄な作業である。

我々が目指すべきは、「ターゲット(Note)への最短経路」を辿る設計だ。

攻略すべきオブジェクト階層

図面におけるテキスト(Note)は、主に以下の2つのコンテキストに存在する。
1. シート直下のノート: 表題欄(Title Block)や注記など。
2. ビュー内のノート: 投影図の中に配置された寸法注記や部品番号など。

この階層構造を正しく理解し、「Sheet → View → Note」の順に、ピンポイントでアクセスを絞り込むことが、堅牢な設計の第一歩である。

2. 正規表現を使わない「部分一致置換」の合理性

「高度な検索には正規表現が必要だ」という意見がある。確かに複雑なパターンマッチングには有効だ。しかし、実務における「特定のキーワードを書き換える」という用途において、正規表現はオーバーエンジニアリング(過剰設計)になりかねない。

正規表現は学習コストが高く、後任の担当者がコードを見た際に「何をしているか不明」という保守性の低下を招く。
実務で求められるのは、「誰が見ても意図が明確で、かつ高速に動作するコード」だ。

我々は、VBA標準の `InStr` 関数を利用する。これは極めて高速であり、`InStr` が 0 より大きいかどうかを判定するだけで、直感的な部分一致検索が可能になる。

3. プロダクション・コードの実装例

以下に、実務でそのまま利用可能なレベルの設計思想を組み込んだコードを示す。
このコードは、単なる置換プログラムではない。「エラーハンドリング」「階層構造の走査」「保守性の高い関数分離」を組み込んだ、プロフェッショナル仕様の雛形である。

'==============================================================================
' Module: DrawingAutomationModule
' Description: 図面内の特定文字列を高速に置換する堅牢な実装例
'==============================================================================

Option Explicit

''' <summary>
''' 図面内のすべてのNoteを走査し、特定のキーワードを置換するメインルーチン
''' </summary>
Public Sub ReplaceDrawingNotes()
    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
    
    ' 置換設定(本来はExcelや外部DBから取得すべき値)
    Const TARGET_KEYWORD As String = "【ステータス】"
    Const NEW_VALUE As String = "【承認済】"

    On Error GoTo ErrorHandler

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc

    ' 1. モデルの型チェック(堅牢性の確保)
    If swModel Is Nothing Then
        MsgBox "ドキュメントが開かれていません。", vbCritical
        Exit Sub
    End If

    If swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを開いて実行してください。", vbCritical
        Exit Sub
    End If

    Set swDraw = swModel
    
    ' 高速化のため、画面更新を抑制(APIの挙動によるが、再描画コストを意識する)
    ' ※SolidWorks VBAでは直接的なScreenUpdating制御は限定的だが、
    '   処理の最後に再描画を明示的に行うのが作法である。

    ' 2. シートの走査
    Set swSheet = swDraw.GetCurrentSheet
    
    ' --- A. シート直下のNoteを処理 ---
    ProcessSheetNotes swSheet, TARGET_KEYWORD, NEW_VALUE

    ' --- B. 各ビュー内のNoteを処理 ---
    ' GetFirstViewは、シート自体(First View)を指す。
    ' その後のGetNextViewで投影ビューへと遷移していく。
    Set swView = swDraw.GetFirstView
    Do While Not swView Is Nothing
        ProcessViewNotes swView, TARGET_KEYWORD, NEW_VALUE
        Set swView = swView.GetNextView
    Loop

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

    Exit Sub

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

''' <summary>
''' シート直下のNoteを処理する内部関数
''' </summary>
Private Sub ProcessSheetNotes(ByRef swSheet As SldWorks.Sheet, ByVal target As String, ByVal replacement As String)
    Dim swNote As SldWorks.Note
    Dim swAnn As SldWorks.Annotation
    Dim noteText As String
    
    ' シート上の注釈(Annotation)を走査
    Set swAnn = swSheet.GetFirstAnnotation2
    Do While Not swAnn Is Nothing
        ' AnnotationがNoteであるかを確認
        If swAnn.GetType = swAnnotationType_e.swNote Then
            Set swNote = swAnn.GetSpecificAnnotation
            PerformReplacement swNote, target, replacement
        End If
        Set swAnn = swAnn.GetNextAnnotation
    Loop
End Sub

''' <summary>
''' ビュー内のNoteを処理する内部関数
''' </summary>
Private Sub ProcessViewNotes(ByRef swView As SldWorks.View, ByVal target As String, ByVal replacement As String)
    Dim swNote As SldWorks.Note
    Dim swAnn As SldWorks.Annotation
    
    ' ビュー内の注釈を走査
    Set swAnn = swView.GetFirstAnnotation2
    Do While Not swAnn Is Nothing
        If swAnn.GetType = swAnnotationType_e.swNote Then
            Set swNote = swAnn.GetSpecificAnnotation
            PerformReplacement swNote, target, replacement
        End If
        Set swAnn = swAnn.GetNextAnnotation
    Loop
End Sub

''' <summary>
''' 文字列置換のロジックをカプセル化した関数
''' </summary>
Private Sub PerformReplacement(ByRef swNote As SldWorks.Note, ByVal target As String, ByVal replacement As String)
    Dim currentText As String
    Dim newText As String
    
    currentText = swNote.GetText
    
    ' InStrによる高速な部分一致判定
    If InStr(1, currentText, target, vbTextCompare) > 0 Then
        ' VBA標準のReplace関数を使用
        newText = Replace(currentText, target, replacement, , , vbTextCompare)
        swNote.SetText newText
    End If
End Sub

4. 運用における「チーフアーキテクトの助言」

このコードをプロダクション環境に投入する前に、以下の3点を必ず検討せよ。

① データソースの分離(Hard-codingの禁止)

上記の例では `TARGET_KEYWORD` を定数で定義しているが、実務ではこれをExcelのセルやCSVファイルから取得する設計にせよ。プログラム(ロジック)とデータ(置換対象)を分離することで、コードを書き換えることなく、非エンジニアでも運用が可能になる。

② ログ出力の重要性

「何が書き換わったか」を記録に残さないツールは、トラブル時に原因究明を不可能にする。置換に成功した際、`Debug.Print` やテキストファイルへの書き出しを行い、「どのシートの、どのビューの、どのテキストを、何から何へ変えたか」の履歴を残すように拡張せよ。

③ 破壊的変更への備え

このスクリプトは図面を直接書き換える。実行前に必ず「ファイルを保存(SaveAs)してから実行する」、あるいは「バックアップを作成する」というワークフローを組み込むか、ユーザーに強く促す設計にすることだ。

結論

SolidWorks VBAにおける自動化の本質は、単に「動くものを作る」ことではない。「想定外のデータに対しても、壊れずに、速く、正確に動作し続けること」にある。

階層構造を意識したオブジェクト走査、標準関数による高速な文字列操作、そしてエラーを前提とした堅牢な設計。これらを意識するだけで、君の書くコードは「ただのスクリプト」から「信頼される業務ツール」へと昇華するだろう。

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