【テクニカル・上級編】【実務中級者向け】「SaveAs」メソッドの戻り値を判定し、ネットワーク切断時のリトライ処理を組み込む堅牢な保存マクロ – AutoCAD VBA解析バイブル

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

「SaveAs」の脆弱性を克服せよ:ネットワーク切断を前提とした堅牢な保存アーキテクチャ

実務における自動化エンジニアリングは、理想的な環境で動作するコードを書くことではない。「最悪の環境下で、いかにしてデータの整合性を守り抜くか」という極限の状況に対する回答を設計することだ。

AutoCADの自動化において、最も頻繁に、かつ致命的な失敗を招くのは「ファイルの保存」である。特に、大規模な設計プロジェクトが共有サーバー(SMB/CIFS)上のネットワークドライブに配置されている環境では、瞬時なネットワークの瞬断や、サーバー側のセッションタイムアウトが日常的に発生する。

多くのジュニアエンジニアは、単に `ThisDrawing.SaveAs` を呼び出し、エラーハンドリングを `On Error GoTo` で済ませる。しかし、それでは不十分だ。ネットワークの瞬断により保存に失敗した際、メモリ上のオブジェクトとファイルシステムの状態に不整合が生じ、図面ファイルが破損(Corrupt)したり、AutoCAD自体がハングアップしたりするリスクを孕んでいる。

本稿では、Windows APIを用いた精密な待機制御、リトライアルゴリズム、そして最終手段としてのローカル退避戦略を組み合わせた、プロフェッショナル仕様の「堅牢な保存マクロ」の設計思想を解説する。

1. 脆弱な実装と、アーキテクチャの欠落

一般的な実装は以下の通りだ。

' 典型的な、しかし極めて脆弱な実装
Sub BadSave()
    On Error Resume Next
    ThisDrawing.SaveAs "Z:\Projects\Design_v1.dwg"
    If Err.Number <> 0 Then
        MsgBox "保存に失敗しました。"
    End If
End Sub

このコードには、シニアエンジニアが直ちに指摘すべき3つの致命的な欠陥がある。

1. 非決定的なエラー処理: ネットワークエラーは一時的なもの(Transient Error)であることが多い。一度の失敗で諦めるのは、システムとしてのレジリエンス(回復力)が欠如している。
2. OSレベルの待機欠如: ネットワークの再接続には時間がかかる。VBAの `Wait` や `DoEvents` だけでは、OSのネットワークスタックが復旧するまでの精密な制御ができない。
3. データの消失リスク: ネットワークが完全にダウンしている場合、保存を諦めることは「ユーザーの数時間の作業を無に帰す」ことを意味する。

2. 堅牢な保存アーキテクチャの設計指針

我々が目指すべきは、以下の3段階のフェーズを持つ「防御的保存シーケンス」である。

1. Retry Phase (再試行フェーズ): Windows APIの `Sleep` を用い、指数バックオフ(あるいは一定間隔)でネットワークの復旧を待ちながら保存を試みる。
2. Detection Phase (検知フェーズ): 失敗の理由が「パスの不在」なのか「権限不足」なのかを、エラー番号に基づいて精査する。
3. Fallback Phase (退避フェーズ): ネットワークへの復旧が不可能と判断した場合、即座にローカルディレクトリ(`%TEMP%` 等)へ図面を強制退避させ、作業データの生存を最優先する。

3. 実装:RobustSaveアーキテクチャ

以下に、これら全ての要件を満たす、実戦投入レベルのコードを示す。

Option Explicit

' Windows APIの宣言: 精密な待機制御のために必要

If VBA7 Then

Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)

Else

Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

End If

' 定数の定義 Private Const MAX_RETRIES As Integer = 3 ' 最大リトライ回数 Private Const RETRY_INTERVAL_MS As Long = 3000 ' リトライ間隔 (3秒) ''' <summary> ''' ネットワーク環境を考慮した堅牢な保存メソッド ''' </summary> ''' <param name="targetPath">保存先のフルパス</param> Public Sub ExecuteRobustSave(ByVal targetPath As String) Dim retryCount As Integer Dim success As Boolean Dim localFallbackPath As String Dim errorMsg As String success = False retryCount = 0 ' ローカル退避用パスの生成 (Tempフォルダ) localFallbackPath = Environ("TEMP") & "\" & _ Replace(Dir(targetPath), ".dwg", "") & "_" & _ Format(Now, "yyyymmdd_hhmmss") & ".dwg" Debug.Print "Starting robust save process for: " & targetPath ' --- Phase 1: Retry Loop --- Do While retryCount < MAX_RETRIES And Not success On Error Resume Next ' AutoCADのSaveAsメソッド実行 ' 注意: SaveAsは戻り値を返さないため、Errオブジェクトで判定する ThisDrawing.SaveAs targetPath If Err.Number = 0 Then success = True Debug.Print "Save successful on attempt " & (retryCount + 1) Else errorMsg = Err.Description retryCount = retryCount + 1 Debug.Print "Save attempt " & retryCount & " failed: " & errorMsg ' エラーが致命的な場合(例:パスが不正)はリトライせず即座に終了 If Err.Number = 76 Then ' Path not found Exit Do End If ' 次のリトライまでOSレベルで待機 If retryCount < MAX_RETRIES Then Sleep RETRY_INTERVAL_MS DoEvents ' OSへの制御を戻し、ネットワークスタックの処理を促す End If End If On Error GoTo 0 Loop ' --- Phase 2: Fallback Strategy --- If Not success Then Debug.Print "All retries failed. Initiating local fallback..." On Error Resume Next ThisDrawing.SaveAs localFallbackPath If Err.Number = 0 Then MsgBox "【警告】ネットワーク保存に失敗しました。" & vbCrLf & _ "作業データは以下のローカルパスに退避されました:" & vbCrLf & _ localFallbackPath, vbCritical, "Network Connection Lost" Else ' ローカル保存すら失敗する場合(ディスクフル等)は、もはや手遅れである MsgBox "【致命的エラー】ネットワーク保存およびローカル退避の両方に失敗しました。" & vbCrLf & _ "作業内容が失われる可能性があります。直ちに手動保存を試みてください。", vbCritical End If On Error GoTo 0 Else Debug.Print "Process completed successfully." End If ' --- Phase 3: Memory Management --- ' 大規模な自動化処理の一部として呼び出す場合、オブジェクトの参照を明示的にクリアする習慣をつける ' 今回は ThisDrawing を操作しているため、自身を Nothing にすることはできないが、 ' 外部から渡されたオブジェクトがある場合は必ず Set obj = Nothing を行うこと。 End Sub

4. チーフアーキテクトの深掘り:技術的真髄

このコードを単なる「リトライ付きマクロ」として片付けてはならない。その背後にある、プロフェッショナルが意識すべき概念を解説する。

Windows API `Sleep` の必然性

VBA標準の `Wait` 命令は、CPUをビジーウェイト(空回し)状態にする可能性があり、システムリソースを無駄に消費する。一方、`kernel32.dll` の `Sleep` は、呼び出し中のスレッドを「待機状態」に移行させるため、OSが他のプロセス(ネットワークドライバの再接続処理など)にリソースを割り当てることを許容する。これが、リトライの成功率を劇的に高める鍵だ。

オブジェクトのライフサイクルとCOMの整合性

AutoCAD VBAはCOM(Component Object Model)技術に基づいている。`SaveAs` が失敗した際、AutoCAD内部のメモリ上にある「変更された図面データ」と、ディスク上の「ファイルの状態」には乖離が生じる。
もし、エラー発生時に適切にハンドリングせず、そのままマクロを終了させてしまうと、AutoCADは「保存に失敗した古い状態の図面」をメモリに保持し続けることになる。この不整合が、その後の `Regen` や `Audit` コマンドでクラッシュを引き起こす原因となる。

フォールバックにおける「決定論的」な設計

退避先として `Environ(“TEMP”)` を選択しているのは、ここが書き込み権限がほぼ確実に保証されており、かつネットワークの依存関係から完全に切り離された領域だからだ。設計者は、「どこなら確実に書き込めるか」を決定論的に判断しなければならない。

結論

堅牢な自動化とは、コードの行数を増やすことではない。「失敗のシナリオ」をコードの一部として組み込むことである。

ネットワーク、権限、ディスク容量。これら外部要因によるエラーを「想定外」として扱うエンジニアは、システムを構築する資格はない。エラーを「制御可能な事象」へと昇華させ、データの整合性を守り抜く。それこそが、我々アーキテクトに課せられた責務である。

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