【実務・中級編】【初心者向け】図面シート名(Sheet1, Sheet2…)をアセンブリ構成部品の名称に連動させて一括リネームするVBA – SolidWorks VBA解析バイブル

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

「ただ動くだけ」のコードを卒業せよ:図面シート名自動連動システムの設計思想

設計業務の自動化に足を踏み入れたエンジニアが、最初に直面する「小さな、しかし確実に時間を奪う作業」がある。それが図面シート名の書き換えだ。

アセンブリから大量の図面を生成する際、デフォルトの「Sheet1」「Sheet2」という名前を、構成部品名やコンフィギュレーション名へと手動でリネームしていく作業は、精神的にも時間的にも大きなコストとなる。

「簡単なループ処理で書けるだろう」と考える初心者は多い。しかし、そのままの実装では、特殊文字によるエラー、空のシートでの停止、あるいは意図しないビューの参照といった「現場で使い物にならないバグ」に直面することになる。

本記事では、単なるコピペ用のコードを提供するのではない。「業務で耐えうる堅牢な自動化ツール」を設計するための、プロフェッショナルなアプローチを伝授する。

1. 陥りがちな「設計の罠」:なぜ初心者のマクロは壊れるのか

多くの入門者が書くコードには、共通する「設計の欠陥」がある。

罠1:オブジェクト階層の無視

図面(Drawing)とモデル(Part/Assembly)は、直接的な親子関係ではない。図面は「シート」を持ち、シートは「ビュー」を持ち、ビューが初めて「モデル」を参照する。この階層構造(Hierarchy)を正しく辿らずに、いきなり名前を取得しようとするコードは、必ず実行時エラーで停止する。

罠2:不正文字への無防備さ

SolidWorksのシート名には、Windowsのファイル名規則と同様に、使用できない文字(`\ / : * ? ” < > |`)が存在する。モデル名にこれらが含まれている場合、あるいは設計者が意図せず含めてしまった場合、リネーム処理は即座にクラッシュする。

罠3:例外状態の未定義

「すべてのシートに必ずモデルビューが存在する」という前提は、実務では通用しない。タイトルブロックのみのシートや、注記のみのシートが存在する場合、モデルを参照しようとした瞬間にマクロは死ぬ。

2. プロフェッショナルな設計指針

堅牢なツールを作るためには、以下の3つの原則をコードに組み込む必要がある。

1. 階層的な検証 (Hierarchical Validation):
`Drawing` $\rightarrow$ `Sheet` $\rightarrow$ `View` $\rightarrow$ `Model` と、一歩ずつ存在を確認しながら進む。
2. サニタイズ (Sanitization):
取得した文字列から、禁止文字を排除するクレンジング処理を独立した関数として持つ。
3. エラーハンドリングの局所化:
一つのシートでエラーが起きても、図面全体の処理を止めない。

3. 実装例:プロダクションレベルのVBAコード

以下に、これらの原則をすべて適用した、そのまま業務に投入可能なレベルのコードを示す。

Option Explicit

''
' @description 図面内の各シートを、そのシート上の最初のビューが参照するモデル名(+コンフィギュレーション名)にリネームする
' @return True: 成功, False: 図面ドキュメントではない等の致命的エラー
''
Public Function RenameSheetsByModelName() As Boolean
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim vSheetNames As Variant
    Dim i As Integer
    
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' --- 1. 入力バリデーション ---
    If swModel Is Nothing Then
        MsgBox "ドキュメントが開かれていません。", vbCritical
        Exit Function
    End If
    
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "このマクロは図面ファイル専用です。", vbCritical
        Exit Function
    End If
    
    Set swDraw = swModel
    vSheetNames = swDraw.GetSheetNames
    
    ' --- 2. メインループ ---
    For i = 0 To UBound(vSheetNames)
        On Error Resume Next ' 個別のシート処理での致命的エラーを回避
        
        Dim currentSheetName As String
        Dim targetSheetName As String
        Dim swSheet As SldWorks.Sheet
        Dim swView As SldWorks.View
        Dim swModelView As SldWorks.ModelDoc2
        Dim configName As String
        Dim modelName As String
        
        currentSheetName = vSheetNames(i)
        Set swSheet = swDraw.GetSheet(currentSheetName)
        
        ' シート内の最初のビューを取得(Sheet自体ではなく、Viewを取得するのが肝)
        ' GetFirstViewは図面シート自体のビューを返すため、その次のViewがモデルを持つ
        Set swView = swSheet.GetFirstView
        
        ' 最初のビューがモデルを持たない(図面そのもののビュー)場合、次のビューへ
        If Not swView Is Nothing Then
            Set swView = swView.GetNextView
        End If
        
        ' --- 3. モデル情報の抽出と検証 ---
        If Not swView Is Nothing Then
            Set swModelView = swView.ReferencedDocument
            
            If Not swModelView Is Nothing Then
                ' モデル名(ファイル名)とコンフィギュレーション名を取得
                modelName = swModelView.GetTitle
                configName = swModelView.ConfigurationManager.ActiveConfiguration.Name
                
                ' 名前を構築(例: PartA - Config1)
                targetSheetName = modelName & " - " & configName
                
                ' 禁止文字の除去(サニタイズ)
                targetSheetName = SanitizeSheetName(targetSheetName)
                
                ' シート名の変更実行
                swDraw.ActivateSheet currentSheetName
                swDraw.RenameSheet targetSheetName
            End If
        End If
        
        ' 次のシートへ(エラーが発生しても継続)
        If Err.Number <> 0 Then
            Debug.Print "Error on sheet " & currentSheetName & ": " & Err.Description
            Err.Clear
        End If
        On Error GoTo 0
    Next i
    
    RenameSheetsByModelName = True
    MsgBox "シートのリネーム処理が完了しました。", vbInformation
End Function

''
' @description Windowsの禁止文字をアンダースコアに置換するサニタイズ関数
' @param rawName 置換前の文字列
' @return CleanedName 置換後の安全な文字列
''
Private Function SanitizeSheetName(ByVal rawName As String) As String
    Dim illegalChars As Variant
    Dim char As Variant
    
    ' Windowsで禁止されている文字のリスト
    illegalChars = Array("\", "/", ":", "*", "?", """", "<", ">", "|")
    
    For Each char In illegalChars
        rawName = Replace(rawName, char, "_")
    Next char
    
    ' 文字数制限(SolidWorksのシート名上限に配慮)
    If Len(rawName) > 31 Then
        rawName = Left(rawName, 31)
    End If
    
    SanitizeSheetName = rawName
End Function

' 実行用エントリーポイント
Sub Main()
    Call RenameSheetsByModelName
End Sub

4. コードの深層解説:なぜこう書いたのか

`GetFirstView` と `GetNextView` の使い分け

ここが最大の技術的ポイントだ。SolidWorks APIにおいて、`Sheet.GetFirstView` が返すのは「図面シートそのもののビュー(Sheet View)」である。このビューはモデルを参照していない。実質的なモデルビューを取得するには、必ず `GetNextView` を呼び出して、その次に続くビューにアクセスしなければならない。これを知らずに実装すると、「モデル名が取得できない」という壁にぶち当たることになる。

`SanitizeSheetName` の独立性

文字列操作をメインロジックから分離し、専用の関数(Private Function)として切り出した。これは単一責任の原則(Single Responsibility Principle)に基づいている。将来的に「禁止文字をスペースに変えたい」といった要件変更があっても、修正箇所はこの関数だけで済む。これが保守性の高いコードの条件だ。

`On Error Resume Next` の戦略的運用

マクロ全体をエラーハンドリングで覆うのは素人の仕事だ。プロは、「どこでエラーが起きても良いように、エラーが起きうる最小単位(ループ内)を局所的に保護する」。これにより、特定のシートに不備があっても、他の全てのシートの処理を完遂させることができる。

5. 結論:自動化エンジニアとしてのマインドセット

自動化ツールを作る際、我々が向き合うべきは「成功するケース」だけではない。「想定外のデータが来た時に、いかに優雅に、かつ確実に処理を継続するか」である。

「動けばいい」という思考は、現場では「使いにくいツール」として拒絶される。
「例外を考慮し、構造を整理し、保守性を担保する」。
この設計思想こそが、単なるプログラマと、エンジニアリングを支えるアーキテクトを分かつ境界線である。

次なるステップとして、このコードに「特定のコンフィギュレーションのみを対象にするフィルタリング機能」や「Excelリストとの照合機能」を組み込んでみること。それが、君の自動化スキルを次の次元へと引き上げるだろう。

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