図面自動化の「死」を回避せよ:イベント駆動型バックアップシステムという究極の防壁
こんにちは。現場の設計自動化を支えるエンジニアの皆さん。
これまで「マクロの記録」を使い、コードを少しずつ書き換えて、なんとか業務を楽にしようと奮闘してきたことでしょう。その努力は素晴らしいものです。
しかし、あなたが「図面の自動生成」という、より高度で複雑な領域に足を踏み入れようとしたとき、一つの大きな壁にぶつかるはずです。それは「プログラムの暴走、あるいは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の枠を超え、プロフェッショナルなソフトウェア開発における共通言語です。
図面自動化は、やり遂げた時の達成感が凄まじい分野です。しかし、その達成感を味わうためには、まず「失敗してもやり直せる環境」を自分で作っておくこと。それが、一流のエンジニアへの第一歩です。
さあ、恐れずに、堅牢な自動化の世界へ踏み出しましょう!応援していますよ。
