自動化の天敵「ダイアログ」を屠る:大量図面一括処理におけるサイレント・オープンの極意
エンジニア諸君、君たちの書いた自動化ツールが、実行開始から数時間後に「たった一つの参照切れ」によって停止し、深夜のオフィスで虚しくモニターを見つめる……そんな悲劇を経験したことはないか?
大量の図面ファイルをループ処理で回す際、モデルのパスが見つからない、あるいはコンポーネントが抑制されているといった些細な警告ダイアログが画面に現れた瞬間、君たちの「自動化」は「手動作業」へと成り下がる。ダイアログが出現した時点で、VBAの制御フローはユーザーのクリック待ち状態となり、プログラムの実行は実質的に死に至るのだ。
本稿では、単なる「エラー回避」のテクニックではない。プロダクション環境に投入できるレベルの、「例外を制御下に置き、堅牢な一括処理を実現するための設計思想」を伝授する。
1. なぜ「OpenDoc6」のフラグだけでは不十分なのか
SolidWorks APIにおいて、ファイルをオープンする際の定石は `OpenDoc6` メソッドであり、その引数に `swOpenDocOptions_Silent` を指定することだ。
多くの初学者は、これだけで全ての警告が消えると考えている。しかし、現実は甘くない。
`swOpenDocOptions_Silent` は「特定のダイアログ」を抑制する力はあるが、アプリケーション全体のユーザー設定(User Preference)に起因する深刻な警告や、特定の条件下で強制的に割り込むダイアログを完全に封じ込めるには、「アプリケーションの状態を事前に制御する」という設計思想が欠けている。
真のプロフェッショナルは、ファイルを開く前に、SolidWorksという「環境」そのものを、自動化に適した「無口な状態」へと作り変えるのだ。
2. 堅牢な実装のための3つの柱
失敗しない一括処理プログラムを構築するには、以下の3つのレイヤーでの制御が不可欠である。
① アプリケーション・レベルの制御 (Global Suppression)
`SetUserPreferenceToggle` を用い、モデル参照エラー時のダイアログ表示自体をシステムレベルでOFFにする。これにより、APIのフラグをすり抜けてくる警告を根こそぎシャットアウトする。
② メソッド・レベルの制御 (Local Suppression)
`OpenDoc6` の引数に `swOpenDocOptions_Silent` を指定し、当該のオープン処理におけるインタラクションを最小化する。
③ 例外ハンドリングとロギング (Error Handling & Logging)
「開けなかった」という事実を単に無視(`On Error Resume Next`)するのは、エンジニアとして失格だ。何が原因で失敗したのかを記録し、次のファイルへ確実に進むための「堅牢なループ構造」を設計しなければならない。
3. プロダクション・クオリティのコード例
以下に、実務でそのまま利用可能な、エラーハンドリングとサイレント処理を組み込んだ設計例を示す。このコードは、単に動くだけでなく、「後続の処理を止めないこと」と「失敗の証拠を残すこと」に特化している。
'**
' Module: DrawingBatchProcessor
' Description: 図面ファイルの一括サイレント処理用プロトタイプ
' Author: Chief Architect
'**
Option Explicit
' SolidWorks API Constants (参照設定がない場合のための定義)
Private Const swOpenDocOptions_Silent As Long = 1
Private Const swUserPreferenceToggle_e_swDisplayModelReferenceErrors As Long = 101 ' 参照エラー表示設定
Sub Main()
Dim swApp As SldWorks.SldWorks
Set swApp = Application.SldWorks
' --- [設計思想1] 環境の事前制御 ---
' 参照切れのダイアログが出ないよう、ユーザー設定を一時的に書き換える
' これにより、APIのフラグを越えてくる警告を封じ込める
swApp.SetUserPreferenceToggle swUserPreferenceToggle_e_swDisplayModelReferenceErrors, False
Dim targetFolder As String
targetFolder = "C:\Your\Drawing\Path\" ' 実際のパスに置き換えてください
Dim fileName As String
fileName = Dir(targetFolder & "*.drw")
Dim errorLog As String
errorLog = "--- Batch Process Log: " & Now & " ---" & vbCrLf
' --- [設計思想2] 堅牢なループ構造 ---
Do While fileName <> ""
Dim fullPath As String
fullPath = targetFolder & fileName
Debug.Print "Processing: " & fileName
' ファイルオープン試行
Dim swModel As SldWorks.ModelDoc2
Set swModel = SafeOpenDrawing(swApp, fullPath)
If Not swModel Is Nothing Then
' --- [成功時の処理] ---
' ここにビュー配置やシート制御のロジックを記述する
Debug.Print "Successfully opened: " & fileName
' 処理が終わったら必ず閉じる(メモリリーク防止の鉄則)
swApp.CloseDoc swModel.GetTitle
Else
' --- [失敗時の処理] ---
' 失敗しても停止せず、ログに記録して次のファイルへ進む
errorLog = errorLog & "[FAILED] " & fileName & vbCrLf
Debug.Print "Failed to open: " & fileName
End If
fileName = Dir()
Loop
' ログの出力(実務ではファイルへの書き出しを推奨)
Debug.Print errorLog
MsgBox "処理が完了しました。詳細はイミディエイトウィンドウを確認してください。"
End Sub
''' <summary>
''' サイレントモードを適用して図面を安全に開く関数
''' </summary>
''' <param name="swApp">SolidWorks Application Object</param>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <returns>成功時はModelDoc2、失敗時はNothing</returns>
Private Function SafeOpenDrawing(swApp As SldWorks.SldWorks, filePath As String) As SldWorks.ModelDoc2
Dim errors As Long
Dim warnings As Long
Dim swModel As SldWorks.ModelDoc2
On Error GoTo ErrorHandler
' OpenDoc6 を使用し、swOpenDocOptions_Silent を指定
' これにより、モデル参照エラー等のダイアログを抑制する
Set swModel = swApp.OpenDoc6(filePath, swDocDRAWING, swOpenDocOptions_Silent, "", errors, warnings)
If swModel Is Nothing Then
' エラーが発生した場合、errors 変数に原因が格納される
' ここで詳細なエラー解析を行うことも可能
Set SafeOpenDrawing = Nothing
Else
Set SafeOpenDrawing = swModel
End If
Exit Function
ErrorHandler:
' 予期せぬ実行時エラー(ファイルアクセス権限など)を捕捉
Debug.Print "Critical Error opening " & filePath & ": " & Err.Description
Set SafeOpenDrawing = Nothing
End Function
4. アーキテクトからの警告:運用上の注意点
この実装を導入するにあたり、以下の3点を肝に銘じておくこと。
1. メモリ管理の徹底(CloseDocの重要性)
ループ内で `OpenDoc6` を繰り返す際、処理が終わったファイルを `swApp.CloseDoc` で確実に閉じていないコードは、ただの「メモリ爆弾」だ。大量の図面を扱う場合、メモリ消費が指数関数的に増大し、最終的にSolidWorks自体がクラッシュする。「開いたら、必ず閉じる」。これは自動化エンジニアの聖書である。
2. 「サイレント」は「無視」ではない
ダイアログを抑制するということは、「問題があるファイルを見逃すリスク」を背負うことと同義だ。そのため、コード例に示したように、必ずログ(Error Log)を出力し、後から「どのファイルが、なぜ失敗したのか」を監査できるように設計しなければならない。
3. ユーザー設定の復元
本稿では `SetUserPreferenceToggle` を使用して設定を変更している。もし、より高度なツールを作るならば、処理の開始前に元の設定を保存しておき、処理終了後に必ず元の状態へ戻す(Rollback)処理を実装するのが、プロフェッショナルな作法である。
結論
自動化の本質は、人間が介在すべきでない作業から人間を解放することにある。
ダイアログに足を掬われるような脆弱なコードを書くのは今日で終わりにしよう。アプリケーションの状態を完全に掌握し、例外をコントロール下に置く。それこそが、真に価値のある業務自動化ツールを生み出す唯一の道である。
Go forth and automate with discipline.
