【実務・中級編】【初心者向け】図面を開く前に「ファイルサイズ」をチェックし、巨大な図面の場合は警告を出して処理を中断する安全策 – AutoCAD VBA解析バイブル

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

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、ネットワーク、そしてユーザーの作業時間という、膨大なリソースが関わっている。それらを制御下に置くために、今回紹介したような「プレフライト・チェック」をルーチンに組み込んでほしい。

「ガードを固めることは、コードを複雑にすることではない。設計を洗練させることである。」

この言葉を胸に、次なる自動化プロジェクトに挑んでいただきたい。

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