【入門編】【上級プロ向け】図面自動生成プロセスにおける「イベント駆動型(Event-Driven)非同期バックアップシステム」 – SolidWorks VBA解析バイブル

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

図面自動化の「死」を回避せよ:イベント駆動型バックアップシステムという究極の防壁

こんにちは。現場の設計自動化を支えるエンジニアの皆さん。
これまで「マクロの記録」を使い、コードを少しずつ書き換えて、なんとか業務を楽にしようと奮闘してきたことでしょう。その努力は素晴らしいものです。

しかし、あなたが「図面の自動生成」という、より高度で複雑な領域に足を踏み入れようとしたとき、一つの大きな壁にぶつかるはずです。それは「プログラムの暴走、あるいはSolidWorksのクラッシュによる、数時間の作業の消失」という恐怖です。

大量の図面ビューを配置し、シートフォーマットを制御し、注記を流し込む……。こうした重い処理を実行している最中に、メモリ不足やAPIの予期せぬエラーでSolidWorksが落ちたとしたら? 戻ってくるのは、真っ白な画面と、失われた数時間の努力だけです。

今日は、そんなプロの現場で必須となる「イベント駆動型(Event-Driven)バックアップシステム」の構築方法を伝授します。これは単なる「保存マクロ」ではありません。SolidWorksの「振る舞い」を監視し、システムを守る「番人」を立てる技術です。

ここをクリアすれば、あなたは「ただ動くコード」を書く人から、「信頼されるシステム」を設計できるエンジニアへと進化できますよ。

1. なぜ「マクロの記録」では守れないのか?

一般的なマクロは、「命令型(Imperative)」です。
「Aをしろ」「次にBをしろ」「最後に保存しろ」という、一方通行の指示です。

しかし、図面自動化のプロセスは長丁場です。
1. 図面ファイルの生成
2. テンプレートの適用
3. 3Dモデルからのビュー配置(ここが非常に重い!)
4. 寸法・注記の自動生成
5. シートレイアウトの調整

もし、手順3の途中でエラーが起きたら? 命令型のマクロはそこで止まり、保存命令には到達しません。

そこで登場するのが「イベント駆動型(Event-Driven)」です。
これは、「何かが起きたら(イベント)、あらかじめ決めておいた動作(ハンドラ)を実行する」という考え方です。SolidWorksの中で「ファイルが変更された」「保存が試みられた」という瞬間を、バックグラウンドで常に待ち構えておく仕組みです。

2. システムの全体像:クラスモジュールという「番人」

このシステムを実現するためには、「クラスモジュール」という概念が不可欠です。

通常の標準モジュールは、マクロを実行すると動き出し、終わると消えてしまいます。しかし、クラスモジュールは、SolidWorksというアプリケーションの中に「監視役のオブジェクト(番人)」を常駐させることができます。

概念図

[ SolidWorks Application ]
      │
      │ (イベント発生: 「図面が更新された!」)
      ▼
[ クラスモジュール (番人: clsEventWatcher) ] <─── 常に待ち構えている
      │
      │ (命令: 「危ない!バックアップを取れ!」)
      ▼
[ バックアップ実行ロジック ] ───> [ 自動保存用フォルダへ出力 ]

3. 実装:堅牢なバックアップシステムの構築

それでは、実際にコードを書いていきましょう。
作業は2ステップです。「番人の定義(クラスモジュール)」と「番人の起動(標準モジュール)」です。

Step 1: クラスモジュールの作成

まず、VBAエディタのメニューから `[挿入] -> [クラスモジュール]` を選択し、プロパティウィンドウでオブジェクト名を `clsEventWatcher` に変更してください。

ここがシステムの心臓部です。

'-------------------------------------------------------------------------
' クラス名: clsEventWatcher
' 役割: SolidWorksのイベントを監視し、図面の変更を検知してバックアップする
'-------------------------------------------------------------------------
Option Explicit

' SolidWorksのイベントをキャッチするための変数
' WithEvents をつけることで、イベントを「フック」できるようになります
Private WithEvents swApp As SldWorks.SldWorks

' バックアップを防止するためのフラグ(無限ループ防止用)
Private isBackingUp As Boolean

' -------------------------------------------------------------------------
' 初期化メソッド: 番人を起動させるための準備
' -------------------------------------------------------------------------
Public Sub Initialize(ByRef App As SldWorks.SldWorks)
    Set swApp = App
    isBackingUp = False
    Debug.Print "【System】バックアップ監視システムが起動しました。"
End Sub

' -------------------------------------------------------------------------
' イベントハンドラ: ドキュメントが保存された時
' -------------------------------------------------------------------------
Private Sub swApp_OnDocumentSave(ByVal Doc As SldWorks.ModelDoc2)
    ' バックアップ中なら、このイベントによる再帰呼び出しを無視する
    If isBackingUp Then Exit Sub
    
    Call ExecuteBackup(Doc)
End Sub

' -------------------------------------------------------------------------
' バックアップ実行のコアロジック
' -------------------------------------------------------------------------
Private Sub ExecuteBackup(ByVal Doc As SldWorks.ModelDoc2)
    Dim backupPath As String
    Dim timestamp As String
    Dim fileName As String
    
    ' 万が一、ドキュメントがNothingなら終了
    If Doc Is Nothing Then Exit Sub
    
    ' バックアップ先の設定(例: ドキュメントと同じフォルダの "_Backup" フォルダ)
    ' ※実際には運用に合わせて適切なパスを設定してください
    On Error GoTo ErrorHandler
    isBackingUp = True ' フラグを立てる(重要!)

    timestamp = Format(Now, "yyyymmdd_hhmmss")
    fileName = Doc.GetTitle
    
    ' 保存先パスの生成(簡易版)
    ' 本来はDoc.GetPathName()から取得し、ディレクトリを加工します
    backupPath = Doc.GetPathName & "_bak_" & timestamp & ".drw"
    
    ' 【重要】非同期的に(に見えるように)保存を実行
    ' SaveAs3 を使用して、現在の作業ファイルとは別に保存する
    Debug.Print "【Backup】バックアップ作成中: " & backupPath
    
    ' 保存実行
    Doc.SaveAs3 backupPath, 0, 2 ' 2 = swSaveAsOptions_Silent
    
    Debug.Print "【Backup】完了。"

CleanUp:
    isBackingUp = False
    Exit Sub

ErrorHandler:
    Debug.Print "【Error】バックアップ失敗: " & Err.Description
    Resume CleanUp
End Sub

Step 2: 標準モジュールの作成

次に、通常のモジュール(`Module1` など)に、この番人を起動し、図面処理を行うメインコードを書きます。

ここが最大のポイントです。 クラスのインスタンス(番人)を、プロシージャの中で宣言してはいけません。プロシージャが終わると番人も消えてしまうからです。必ずモジュールの最上部(宣言セクション)で宣言してください。

'-------------------------------------------------------------------------
' 標準モジュール
' -------------------------------------------------------------------------
Option Explicit

' 【極めて重要】クラスのインスタンスをモジュールレベルで保持する
' これにより、マクロが動いている間、番人がメモリ上に残り続けます
Dim watcher As clsEventWatcher

'-------------------------------------------------------------------------
' メインプロセス: 図面自動生成の実行
'-------------------------------------------------------------------------
Sub Main_DrawingAutomation()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    
    Set swApp = Application.SldWorks
    
    ' 1. 番人を起動する
    Set watcher = New clsEventWatcher
    watcher.Initialize swApp
    
    ' 2. 図面生成の重い処理を開始
    On Error GoTo FatalError
    
    MsgBox "図面自動生成を開始します。バックアップシステムは稼働中です。"
    
    ' --- ここから重い処理のシミュレーション ---
    Set swModel = swApp.NewDocument("C:\Templates\Drawing_Template.drwdot", 0, 0, 0)
    
    If swModel Is Nothing Then
        MsgBox "テンプレートが見つかりません。"
        Exit Sub
    End If
    
    ' 重い処理の代わり(ループの中で保存を挟むとイベントが発火します)
    Dim i As Integer
    For i = 1 To 5
        Debug.Print "処理中... ステップ " & i
        
        ' 図面ビューの配置などの重い処理をここに記述
        ' ...
        
        ' 擬似的に保存を発生させてイベントをテスト
        swModel.Save3 swSaveAsOptions_Silent, 0, 0
        
        ' 処理待ち(負荷シミュレーション)
        Dim pauseTime As Single
        pauseTime = Timer
        Do While Timer < pauseTime + 2
            DoEvents ' OSに制御を戻し、イベントを処理させるために必須!
        Loop
    Next i
    ' --- ここまで ---

    MsgBox "すべての工程が正常に完了しました。"
    Exit Sub

FatalError:
    MsgBox "致命的なエラーが発生しました。バックアップを確認してください。" & vbCrLf & Err.Description
End Sub

' 番人を停止させるためのクリーンアップ用
Sub StopWatcher()
    Set watcher = Nothing
    MsgBox "監視システムを停止しました。"
End Sub

4. プロが教える「陥りやすい罠」と回避策

このシステムを運用する上で、絶対に避けて通れない「落とし穴」が3つあります。

① 無限ループの罠(Re-entrancy)

バックアップのために `SaveAs` を実行すると、その「保存」という行為自体が「保存イベント」を発生させます。すると、またバックアップが走り、また保存が走り……と、無限ループに陥り、SolidWorksがフリーズします。
回避策: コード内の `isBackingUp` フラグのように、処理中かどうかを判定する「ガード条件」を必ず入れてください。

② ガーベッジコレクション(メモリ解放)の罠

「クラスを作ったのに、イベントが全く反応しない!」という初心者が最も陥るミスです。
前述の通り、`Dim watcher As clsEventWatcher` を `Sub` の中で宣言してしまうと、その `Sub` が終わった瞬間に、番人はメモリから消去されます。
回避策: インスタンスは必ずモジュールレベル(宣言セクション)で保持してください。

③ `DoEvents` の重要性

VBAのコードが重いループ(`For…Next` など)に没頭している間、SolidWorksは「イベント」を受け取る余裕がなくなります。
回避策: ループの中に `DoEvents` を挟んでください。これにより、VBAが一時的に制御をOSに返し、待ち構えていたイベント(バックアップ命令)を実行できるようになります。

結びに:自動化の先にある「信頼」

「マクロが動けばいい」という段階から、「どんな状況でもデータが守られる仕組みを作る」という段階へ。
今回紹介したイベント駆動型の考え方は、VBAの枠を超え、プロフェッショナルなソフトウェア開発における共通言語です。

図面自動化は、やり遂げた時の達成感が凄まじい分野です。しかし、その達成感を味わうためには、まず「失敗してもやり直せる環境」を自分で作っておくこと。それが、一流のエンジニアへの第一歩です。

さあ、恐れずに、堅牢な自動化の世界へ踏み出しましょう!応援していますよ。

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