AutoCAD自動化の掟:致命的なフリーズを回避する「プレフライト・チェック」の実装設計
自動化ツールを開発していると、避けては通れない「悪夢」がある。
それは、数GBに及ぶ巨大なDWGファイルを、プログラムが不用意に `Documents.Open` した瞬間に、AutoCADが応答なし(フリーズ)に陥り、作業中のすべてのデータが消失することだ。
多くの初学者は、エラーハンドリング(`On Error Resume Next`)さえ書いておけば、プログラムは安全に動くと誤解している。だが、それは致命的な間違いだ。フリーズは「エラー」ではない。「リソースの枯渇によるシステムの停止」なのだ。エラーハンドリングは、発生した事象に対処するためのものであり、発生を防ぐためのものではない。
プロフェッショナルなエンジニアに求められるのは、「危険な操作を未然に防ぐガード機能(Guard Clause)」の設計である。
今回は、AutoCADのエンジンにファイルを渡す前に、ファイルシステム層で「物理的なサイズ」を検知し、リスクを回避する堅牢な設計手法を伝授する。
1. なぜ `Documents.Open` の前にチェックが必要なのか?
AutoCADの `Documents.Open` メソッドを呼び出した瞬間、AutoCADのコアエンジンはファイルのパース(解析)を開始する。このプロセスはCPUとメモリを猛烈に消費し、ネットワーク経由のファイルの場合、I/O待ちによってアプリケーション全体がロックされる。
一度このプロセスが始まってしまうと、VBA側から「あ、デカすぎたからキャンセル!」と制御することは不可能だ。
したがって、設計の鉄則はこうだ。
「AutoCADのオブジェクトモデル(図面操作)に触れる前に、OSのファイルシステム層(FSO)でメタデータを評価せよ」
2. 設計思想:関心の分離 (Separation of Concerns)
単一のプロシージャに「ファイルサイズの確認」「ユーザーへの警告」「図面のオープン」をすべて詰め込むのは、保守性の観点から最悪の設計だ。
我々が目指すべきは、以下の3つのレイヤーに分離された設計である。
1. Inspection Layer (検査層): ファイルの物理的な属性(サイズ等)を調査する。
2. Decision Layer (判断層): 調査結果に基づき、続行するか中断するかを決定する。
3. Execution Layer (実行層): 安全が確認された場合のみ、AutoCADのAPIを叩く。
3. プロダクション・コード:堅牢なファイルサイズ・ガード
以下に、実務でそのまま使えるレベルのモジュール構造を示す。ここでは `Scripting.FileSystemObject` (FSO) を使用する。`Dir` 関数よりも詳細なメタデータ取得が可能であり、オブジェクト指向的なアプローチとして信頼性が高い。
事前準備
VBAエディタの [ツール] -> [参照設定] から、「Microsoft Scripting Runtime」にチェックを入れておいてください。これにより、FSOを高速かつ型安全に扱えます。
Option Explicit
' ==============================================================================
' Module: modFileGuard
' Description: 図面オープン前の安全性チェックを行うガードモジュール
' ==============================================================================
' 閾値の設定(定数として管理することで、将来的な仕様変更に容易に対応する)
Private Const MAX_FILE_SIZE_MB As Double = 500# ' 500MBを閾値とする
Private Const WARNING_TITLE As String = "巨大な図面への警告"
''' <summary>
''' 指定されたファイルのサイズをチェックし、安全かどうかを判定する
''' </summary>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <returns>安全ならTrue、危険またはエラーならFalse</returns>
Public Function IsFileSafeToOpen(ByVal filePath As String) As Boolean
Dim fso As New FileSystemObject
Dim fileObj As File
Dim fileSizeMB As Double
On Error GoTo ErrorHandler
' 1. ファイルの存在確認
If Not fso.FileExists(filePath) Then
MsgBox "指定されたファイルが見つかりません:" & vbCrLf & filePath, vbCritical, "Error"
IsFileSafeToOpen = False
Exit Function
End If
' 2. ファイルサイズの取得 (Bytes -> MB 変換)
Set fileObj = fso.GetFile(filePath)
fileSizeMB = fileObj.Size / 1024 / 1024
' 3. 閾値判定
If fileSizeMB > MAX_FILE_SIZE_MB Then
' ユーザーに判断を委ねる(ここがプロの設計:強制中断ではなく、リスクを提示して選択させる)
Dim response As VbMsgBoxResult
response = MsgBox( _
"警告: このファイルは非常に巨大です。" & vbCrLf & vbCrLf & _
"推定サイズ: " & Format(fileSizeMB, "0.00") & " MB" & vbCrLf & _
"閾値: " & MAX_FILE_SIZE_MB & " MB" & vbCrLf & vbCrLf & _
"開くとAutoCADがフリーズする可能性があります。続行しますか?", _
vbExclamation + vbYesNo + vbDefaultButton2, _
WARNING_TITLE)
If response = vbYes Then
IsFileSafeToOpen = True
Else
IsFileSafeToOpen = False
End If
Else
' 安全圏内
IsFileSafeToOpen = True
End If
Exit Function
ErrorHandler:
MsgBox "ファイル情報の取得中にエラーが発生しました:" & vbCrLf & Err.Description, vbCritical, "System Error"
IsFileSafeToOpen = False
End Function
''' <summary>
''' 安全が確認された場合のみ図面を開くメインエントリポイント
''' </summary>
''' <param name="filePath">開きたい図面のパス</param>
Public Sub SafeOpenDocument(ByVal filePath As String)
Dim acadApp As Object ' AcadApplication
' 1. プレフライト・チェック(ガード)
If Not IsFileSafeToOpen(filePath) Then
Debug.Print "Operation cancelled by user or size limit: " & filePath
Exit Sub
End If
' 2. 実行フェーズ
On Error GoTo ExecutionError
Set acadApp = ThisDrawing.Application ' 現在のAutoCADインスタンスを取得
Debug.Print "Attempting to open: " & filePath
acadApp.Documents.Open filePath
Exit Sub
ExecutionError:
MsgBox "図面のオープンに失敗しました。ファイルが他のプロセスで使用されている可能性があります。" & vbCrLf & Err.Description, vbCritical, "Execution Error"
End Sub
4. アーキテクトの視点:なぜこのコードは「強い」のか
このコードが単なる「コピペ用スクリプト」と一線を画している理由を解説する。
① 失敗のコストを最小化している
`IsFileSafeToOpen` 関数は、AutoCADの `Documents` コレクションに一切触れていない。これは、ファイルが巨大であろうが、ネットワークが切断されていようが、AutoCAD本体のメモリ領域を汚染することなく、判定を終えられることを意味する。
② ユーザーへの「情報の提示」と「選択権」
単に「大きすぎるので拒否します」と突き放すのは、親切な設計ではない。実務では「巨大だが、どうしても今すぐ見なければならない」というケースが必ず存在する。
`vbYesNo + vbDefaultButton2` を指定することで、「安易なYes(デフォルト)」を排除し、ユーザーにリスクを再認識させた上で意思決定を促している。 これが、現場でのトラブルを減らすための心理的設計だ。
③ 拡張性(Scalability)
`MAX_FILE_SIZE_MB` を定数として独立させている。もし将来的に「ネットワーク越しの場合は100MB、ローカルなら1GB」という動的な閾値が必要になった場合、この関数のロジックを修正するだけで、呼び出し元(`SafeOpenDocument`)を一切汚さずに対応できる。
5. まとめ:現場で生き残るエンジニアへ
業務自動化ツールを作る際、最も避けるべきは「動くものを作る」ことだ。目指すべきは「壊れないものを作る」ことだ。
「ファイルを開く」という単純なアクションの裏側には、メモリ、I/O、ネットワーク、そしてユーザーの作業時間という、膨大なリソースが関わっている。それらを制御下に置くために、今回紹介したような「プレフライト・チェック」をルーチンに組み込んでほしい。
「ガードを固めることは、コードを複雑にすることではない。設計を洗練させることである。」
この言葉を胸に、次なる自動化プロジェクトに挑んでいただきたい。
