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

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

「うっかりミス」を設計のプロセスから排除する。SolidWorks VBAによる入力バリデーションの極意

設計業務において、最も恐ろしいのは「計算ミス」ではありません。「必要な情報が抜けたまま、図面が次工程へ流れてしまうこと」です。

「材質が未入力のまま図面が出た」「承認印欄が空欄のままPDF化した」……。こうしたヒューマンエラーは、どれだけベテランの設計者であっても防ぎきれないことがあります。だからこそ、私たちは「システム(マクロ)にチェックさせる」という考え方を持つ必要があります。

今日は、マクロの記録(レコーディング)から一歩踏み出し、設計の品質を守るための「門番(バリデーター)」を作る方法を伝授しましょう。

1. 「マクロの記録」から「設計の自動化」への脱却

多くの初心者は、SolidWorksの「マクロの記録」機能を使ってコードを書き始めます。しかし、記録されたコードは「マウスをどこに動かしたか」という、いわば「動作のログ」に過ぎません。

私たちが作りたいのは、動作のログではなく「論理的な判断」を行うプログラムです。

  • 記録マクロ: 「Aというボタンを押して、Bという項目を書き込む」
  • プロのVBA: 「もしAという項目が空欄なら、警告を出して処理を中断し、そうでなければ保存する」

この「もし〜ならば(If文)」という条件分岐こそが、自動化エンジニアへの第一歩です。

2. 構造を理解する:カスタムプロパティの階層

コードを書く前に、SolidWorksのデータ構造を頭の中に描き出してください。カスタムプロパティを操作するには、以下の「オブジェクトの階段」を登る必要があります。

1. SldWorks (SolidWorksアプリケーションそのもの)
2. ModelDoc2 (開いている図面ファイル)
3. CustomPropertyManager (プロパティを管理する専門の窓口)

この「窓口(Manager)」を呼び出さない限り、プロパティの値を確認することはできません。ここを飛ばして操作しようとするのが、初心者が陥る最初の罠です。

3. 実践:必須項目チェック・バリデーションコード

では、実際に「材質(Material)」と「承認者(Approver)」が入力されているかを確認し、漏れていれば保存を阻止するコードを書いてみましょう。

このコードは、単体で動かすだけでなく、「保存やPDF書き出しを行う一連の自動化フローの冒頭」に組み込むことを想定しています。

Option Explicit

''' <summary>
''' 図面の必須カスタムプロパティをチェックするバリデーション・ルーチン
''' </summary>
''' <returns>全て入力されていればTrue、漏れがあればFalse</returns>
Public Function ValidateDrawingProperties() As Boolean
    
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swCustPropMgr As SldWorks.CustomPropertyManager
    
    Dim requiredProperties As Variant
    Dim propName As Variant
    Dim propValue As String
    Dim missingProps As String
    Dim isError As Boolean
    
    ' --- 設定エリア ---
    ' チェックしたい必須項目名を配列で定義します
    requiredProperties = Array("材質", "承認者", "設計者")
    ' ------------------

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    ' 1. ファイルが開かれているかチェック
    If swModel Is Nothing Then
        MsgBox "ドキュメントが開かれていません。", vbCritical
        ValidateDrawingProperties = False
        Exit Function
    End If
    
    ' 2. 図面ファイル(Drawing)であるかチェック
    If swModel.GetType <> swDocDRAWING Then
        MsgBox "このマクロは図面ファイル専用です。", vbExclamation
        ValidateDrawingProperties = False
        Exit Function
    End If
    
    ' 3. カスタムプロパティ管理オブジェクトを取得
    ' ※図面全体(General)のプロパティを取得します
    Set swCustPropMgr = swModel.Extension.CustomPropertyManager("")
    
    isError = False
    missingProps = ""
    
    ' 4. 必須項目のループチェック
    For Each propName In requiredProperties
        ' プロパティの値を取得 (Get6メソッドを使用)
        ' 第1引数: プロパティ名, 第2引数: 取得先, 第3引数: 値(出力), 第4引数: リンク状態, 第5引数: 評価済み値(出力), 第6引数: 評価済みリンク状態
        swCustPropMgr.Get6 propName, False, propValue, False, propValue, False
        
        ' 値が空、またはスペースのみの場合を「未入力」と判定
        If Trim(propValue) = "" Then
            isError = True
            missingProps = missingProps & " ・ " & propName & vbCrLf
        End If
    Next propName
    
    ' 5. 結果の判定
    If isError Then
        ' 警告を表示して中断
        MsgBox "【警告】以下の必須項目が入力されていません。" & vbCrLf & _
               vbCrLf & missingProps & vbCrLf & _
               "入力を完了してから再度実行してください。", vbCritical, "バリデーションエラー"
        ValidateDrawingProperties = False
    Else
        ' 全てOK
        ValidateDrawingProperties = True
    End If

End Function

''' <summary>
''' メイン実行ルーチン(ここからマクロを開始します)
''' </summary>
Sub Main()
    ' まずはバリデーションを実行
    If ValidateDrawingProperties() = True Then
        ' --- ここに「保存」や「PDF出力」の処理を書く ---
        MsgBox "バリデーション合格。保存プロセスを開始します。", vbInformation
        
        ' 例: 保存処理
        ' ActiveDoc.Save3 swSaveAsOptions_e.swSaveAsOptions_Silent, 0, 0
        
    Else
        ' バリデーションに失敗した場合は、何もしない(保存させない)
        ' プログラムをここで終了させることで、不正な保存を防ぐ
    End If
End Sub

4. コードの深掘り:プロの視点

このコードには、単なる初心者レベルを超えた「設計思想」がいくつか含まれています。

① `Get6` メソッドの選択

SolidWorks APIには、プロパティを取得するメソッドが複数存在します(`Get`, `Get5`, `Get6`など)。古いリファレンスには `Get` と書かれていますが、現代のエンジニアは最新の `Get6` を使うべきです。なぜなら、「リンクされたプロパティ(外部ファイルから参照している値)」を正確に、評価済みの状態で取得できるからです。

② `Trim` 関数の重要性

ユーザーは、誤って「スペース(空白)」だけを入力してしまうことがあります。単純に `If propValue = “”` と比較すると、スペースが入っている場合に「入力済み」と誤判定してしまいます。`Trim(propValue)` を使うことで、前後の余計な空白を除去し、実質的な中身があるかどうかを厳密に判定しています。

③ 拡張性を考慮した「配列」管理

必須項目を `If` 文の羅列で書くのは素人です。`Array(“材質”, “承認者”, …)` という配列にまとめておくことで、将来「図面番号」や「プロジェクト名」もチェック対象にしたいと思った時、たった一行追加するだけで対応できるようになっています。これが「メンテナンス性の高いコード」です。

5. 陥りやすいエラーと対策

このマクロを運用する上で、以下の点に注意してください。

  • 「カスタムプロパティ」と「注釈」の混同:

表題欄に直接テキストを書いている場合、それは「カスタムプロパティ」ではありません。このマクロは、あくまで「ファイル情報としてのカスタムプロパティ」をチェックします。表題欄とプロパティを連動(リンク)させておく運用をセットで覚えましょう。

  • 権限の問題:

読み取り専用(Read-Only)で開いているファイルに対して、プロパティを書き換える処理を組み込む場合は、エラーハンドリング(`On Error GoTo`)を適切に行わないと、マクロが突然クラッシュします。

最後に:ここをクリアすれば、SolidWorks VBAの基本はバッチリです

「入力漏れを検知する」という小さな仕組みですが、これは「設計のルールをプログラムに教え込む」という、エンジニアリングの本質的な行為です。

マクロの記録ボタンを押すのを一度やめて、今回のように「何を確認し、どう判断するか」というロジックを組み立てる練習をしてみてください。それができれば、あなたはもう「マクロを使う人」ではなく、「業務を自動化するエンジニア」です。

一歩ずつ、共に進んでいきましょう。応援していますよ。

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