【テクニカル・上級編】【初心者向け】図面保存時に指定カスタムプロパティの入力漏れを検知して保存をストップする入力バリデーションVBA – SolidWorks VBA解析バイブル

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

データ整合性の守護者:SolidWorksにおける「バリデーション・ゲートキーパー」の実装戦略

設計業務の自動化において、多くのエンジニアが「いかに速く作るか」に腐心する。しかし、真のアーキテクトが注力すべきは「いかに汚いデータをシステムに流さないか」である。

図面ファイルにおける「承認者」や「材質」といったカスタムプロパティの入力漏れは、単なる入力ミスではない。それは、後続のPDM(Product Data Management)への流し込み失敗、BOM(部品構成表)の不整合、ひいては製造現場での誤発注という、致命的なサプライチェーンの破壊を招く「毒」となる。

本稿では、単なる「空欄チェック」のレベルを超え、オブジェクトのライフサイクル管理と堅牢なエラーハンドリングを組み込んだ、プロフェッショナルなバリデーション・マクロの設計思想を解説する。

1. 設計思想:なぜ「保存直前」のバリデーションが必要なのか

通常のSolidWorks運用では、ユーザーは `Ctrl + S` を押して保存を行う。しかし、VBAで作成した標準的なマクロは、実行された瞬間に「現在の状態」を処理するだけであり、ユーザーの標準的な保存操作をフック(割り込み)して止めることは、アドイン(C++ / .NET)を用いない限り極めて困難である。

したがって、我々が構築すべきは「標準の保存ボタンを介さず、バリデーションを通過した時のみ実行されるSafe Save(安全な保存)プロシージャ」である。これを社内の標準ワークフローとして定義することが、システム管理者の責務となる。

2. 技術的深掘り:オブジェクトの生存期間とメモリの整合性

SolidWorks APIを操作する際、初心者が最も陥りやすい罠は、`CustomPropertyManager` や `ModelDoc2` といった重厚なオブジェクトを、適切に解放(Release)せずに放置することだ。

メモリ上にゾンビプロセスが蓄積すれば、SolidWorksの動作は次第に不安定になり、最終的には強制終了を招く。我々は、オブジェクトのスコープを最小限に抑え、処理の終端では必ず `Set obj = Nothing` を明示的に実行する「徹底したライフサイクル管理」を実装しなければならない。

また、カスタムプロパティの取得において、`Get5` メソッドをループ内で乱用するのはパフォーマンス上の悪手だ。プロパティマネージャーの参照を一度確立し、そこから値を引き出す、計算量の少ないアプローチを採用する。

3. 実装:バリデーション・ゲートキーパー・コード

以下に、シニアエンジニアが現場でそのまま使用できるレベルの、堅牢なコード例を示す。

'==============================================================================
' Module: modDrawingValidator
' Description: 図面保存前のカスタムプロパティバリデーション・ゲートキーパー
' Author: Legendary Chief Architect
'==============================================================================

Option Explicit

' 必須プロパティの定義(定数として管理することで保守性を高める)
Private Const REQ_PROPERTY_1 As String = "承認者"
Private Const REQ_PROPERTY_2 As String = "材質"
Private Const REQ_PROPERTY_3 As String = "設計番号"

''' <summary>
''' 図面の整合性を検証し、問題がなければ保存を実行するメインルーチン
''' </summary>
Public Sub SafeSaveDrawing()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swCustPropMgr As SldWorks.CustomPropertyManager
    Dim propNames As Variant
    Dim propName As Variant
    Dim propVal As String
    Dim isError As Boolean
    Dim errorMsg As String
    
    ' エラーハンドリングの初期化
    On Error GoTo ErrorHandler
    
    ' 1. SolidWorks インスタンスへの接続
    Set swApp = Application.SldWorks
    If swApp Is Nothing Then
        MsgBox "SolidWorksに接続できません。", vbCritical
        Exit Sub
    End If
    
    ' 2. アクティブドキュメントの取得と型チェック
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then
        MsgBox "アクティブなドキュメントが見つかりません。", vbExclamation
        Exit Sub
    End If
    
    ' 図面ファイル(Drawing)であるかを確認
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "このマクロは図面ファイル専用です。", vbExclamation
        Exit Sub
    End If
    
    Set swDraw = swModel
    
    ' 3. カスタムプロパティマネージャーの取得
    ' 図面全体のプロパティ(ファイルプロパティ)を対象とする
    Set swCustPropMgr = swModel.Extension.CustomPropertyManager("")
    
    ' 4. バリデーション・ロジック
    isError = False
    errorMsg = "以下の必須項目が未入力です:" & vbCrLf
    
    ' 必須プロパティの配列をループ処理
    propNames = Array(REQ_PROPERTY_1, REQ_PROPERTY_2, REQ_PROPERTY_3)
    
    For Each propName In propNames
        ' プロパティ値の取得 (Get5を使用)
        ' swCustomPropertyText : プロパティのテキスト値を取得
        swCustPropMgr.Get5 propName, False, propVal, False
        
        ' 空文字またはスペースのみの場合をエラーと判定
        If Trim(propVal) = "" Then
            isError = True
            errorMsg = errorMsg & " ・ " & propName & vbCrLf
        End If
    Next propName
    
    ' 5. 結果に基づく分岐処理
    If isError Then
        ' バリデーション失敗:警告を表示して中断
        MsgBox errorMsg, vbCritical, "バリデーションエラー: 保存を中断しました"
        GoTo CleanUp
    Else
        ' バリデーション成功:保存を実行
        ' 保存ダイアログを出さずに強制保存する場合は swSaveAsOptions_Silent を検討
        Dim saveStatus As Boolean
        saveStatus = swModel.Save3(swSaveAsOptions_Silent, 0, 0)
        
        If saveStatus Then
            MsgBox "バリデーションを通過し、安全に保存されました。", vbInformation, "Success"
        Else
            MsgBox "保存プロセス中にエラーが発生しました。", vbCritical, "Save Error"
        End If
    End If

CleanUp:
    ' 6. メモリ解放(オブジェクトのライフサイクルを確実に終了させる)
    ' これを怠ると、大規模な自動化プロセスにおいてメモリリークの原因となる
    Set swCustPropMgr = Nothing
    Set swDraw = Nothing
    Set swModel = Nothing
    Set swApp = Nothing
    Exit Sub

ErrorHandler:
    MsgBox "予期せぬ致命的なエラーが発生しました。" & vbCrLf & _
           "Error Number: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "System Error"
    Resume CleanUp
End Sub

4. アーキテクトの視点:実運用における3つのアドバイス

① 「空文字」と「未定義」の差異を理解せよ

SolidWorksのプロパティには、「プロパティ名自体が存在しないケース」と「プロパティ名は存在するが値が空(””)のケース」の2通りがある。上記のコードでは `Get5` を使用し、値が取得できなかった場合も `propVal` が空文字として扱われるため、一括して検知可能としている。

② UI/UXの設計:ユーザーを「拒絶」するのではなく「導け」

`vbCritical` でエラーを出すだけでは、ユーザーはストレスを感じる。理想的なシステムでは、エラーメッセージの中に「どのプロパティが、どこにあるか」を明示し、可能であればそのプロパティへフォーカスを当てるようなインターフェースが望ましい。

③ レガシー環境への配慮

社内システムでは、古いバージョンのSolidWorksや、異なるOS環境が混在していることが珍しくない。`Late Binding`(実行時バインディング)を利用して参照設定の依存性を減らす手法もあるが、開発時のインテリセンス(入力補完)とパフォーマンスを優先するならば、本稿のように `Early Binding`(事前バインディング)を用い、適切に型定義を行うべきである。

結びに代えて

自動化エンジニアの仕事は、コードを書くことではない。「正しいデータが、正しいプロセスで、正しい場所に流れるための仕組み」を設計することだ。

このバリデーション・ロジックは、その仕組みの最小単位に過ぎない。これを起点として、設計データの品質を担保する堅牢なアーキテクチャを構築してほしい。

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