「SaveAs」を盲信するな。ネットワーク切断を想定した「生存戦略」としての保存ロジック
業務自動化の現場において、エンジニアが最も陥りやすい罠がある。それは、「プログラムは、常に想定通りの環境で実行される」という甘い幻想だ。
君が書いた完璧なロジックが、どれほど計算機科学的に美しくても、物理的なネットワークの瞬断や、サーバーの瞬時的な応答停止(SMBプロトコルのタイムアウト)の前では、ただの無力なスクリプトに成り下がる。特にAutoCADの`SaveAs`メソッドは、ファイルシステムへの書き込みという、極めて「不確実性の高い」I/O操作を伴う。
ここでエラーハンドリングを怠り、マクロを停止させるか、あるいはエラーを無視して次へ進むような設計をした瞬間、ユーザーの図面データは消失し、君のエンジニアとしての信頼もまた、そのデータと共に失われることになる。
本稿では、中級者への階段を登るために不可欠な、「失敗することを前提とした」堅牢な保存設計を伝授する。
1. なぜ、標準的な `SaveAs` では不十分なのか
多くの開発者は、以下のようなコードを書く。
' 典型的な「素人」のコード
Sub BadSaveExample()
On Error Resume Next ' これが最大の罪だ
ThisDrawing.SaveAs "Z:\Project\Drawing1.dwg"
If Err.Number <> 0 Then
MsgBox "保存に失敗しました"
End If
On Error GoTo 0
End Sub
このコードには、プロフェッショナルとして致命的な欠陥が3つある。
1. エラーの隠蔽: `On Error Resume Next` は、エラーの「原因」を握りつぶす。ネットワークの問題なのか、権限の問題なのか、ファイルが読み取り専用なのかを判別できない。
2. リトライの欠如: ネットワークの瞬断は、1秒後には復旧していることが多い。一度の失敗で諦めるのは、設計として極めて非効率だ。
3. データの安全性(Fallback)の欠如: ネットワークが完全に死んでいる場合、このコードは何もしない。ユーザーが数時間かけて作成した図面は、保存されないまま閉じられるリスクに晒されている。
2. 設計思想:Retry & Fallback パターン
堅牢なシステムを構築するためには、「Retry(再試行)」と「Fallback(代替手段への退避)」の二段構えが必要だ。
設計要件
1. 指数バックオフ(に近い待機): 失敗直後に即座にリトライするのではなく、数秒の待機時間を挟むことで、ネットワークの復旧を待つ。
2. リトライ回数の制限: 無限ループは避ける。一定回数試行してもダメなら、次のフェーズへ移行する。
3. ローカル退避(Local Fallback): ネットワークへの保存が最終的に失敗した場合、強制的にローカル環境(`%TEMP%`等)へ保存し、ユーザーにその旨を通知する。これが「データの生存」を担保する最後の砦だ。
3. プロダクション・グレードのコード実装
以下に、実務でそのまま利用可能な、堅牢な保存ロジックの実装例を示す。このコードは、単なる「保存」ではなく、「データの保護」を目的としている。
Option Explicit
' --- 定数定義:設計のパラメータを分離する ---
Private Const MAX_RETRIES As Integer = 3 ' 最大リトライ回数
Private Const RETRY_DELAY_SEC As Integer = 3 ' リトライ間の待機秒数
''' <summary>
''' 堅牢なSaveAsメソッド。ネットワークエラーを考慮したリトライとローカル退避機能を備える。
''' </summary>
''' <param name="targetPath">保存先のフルパス</param>
''' <param name="fileFormat">AutoCADのファイル形式(acR18等)</param>
''' <returns>保存に成功した場合はTrue、ローカル退避した場合はFalse、致命的な失敗はError</returns>
Public Function RobustSaveAs(ByVal targetPath As String, Optional ByVal fileFormat As Long = 0) As Boolean
Dim retryCount As Integer
Dim isSuccess As Boolean
Dim errDescription As String
isSuccess = False
retryCount = 0
' 1. リトライループの開始
Do While retryCount <= MAX_RETRIES And Not isSuccess
On Error Resume Next
' AutoCADへの保存実行
' 注意: SaveAsは戻り値を持たないため、Errオブジェクトで成否を判定する
ThisDrawing.SaveAs targetPath, fileFormat
If Err.Number = 0 Then
isSuccess = True
Debug.Print "SUCCESS: Saved to " & targetPath
Else
errDescription = Err.Description
Err.Clear
retryCount = retryCount + 1
Debug.Print "RETRY [" & retryCount & "/" & MAX_RETRIES & "]: " & errDescription
If retryCount <= MAX_RETRIES Then
' 待機処理(OSに制御を戻しつつ待機)
WaitSeconds RETRY_DELAY_SEC
End If
End If
On Error GoTo 0
Loop
' 2. 最終判定とFallback(ローカル退避)ロジック
If isSuccess Then
RobustSaveAs = True
Else
Debug.Print "CRITICAL: Network save failed. Attempting local fallback..."
' ローカルのTempディレクトリを取得して退避
Dim localPath As String
localPath = GetLocalTempPath(targetPath)
On Error Resume Next
ThisDrawing.SaveAs localPath, fileFormat
If Err.Number = 0 Then
MsgBox "【警告】ネットワークへの保存に失敗しました。" & vbCrLf & _
"図面はローカルへ一時退避されました。" & vbCrLf & _
"保存先: " & localPath, vbExclamation, "ネットワーク切断検知"
RobustSaveAs = False ' 保存はできたが、意図した場所ではない
Else
MsgBox "【致命的エラー】保存に完全に失敗しました。データが失われる可能性があります!" & vbCrLf & _
"Error: " & errDescription, vbCritical, "システムエラー"
RobustSaveAs = False
End If
On Error GoTo 0
End If
End Function
''' <summary>
''' 指定されたパスに基づき、ローカルのTempフォルダへのパスを生成する
''' </summary>
Private Function GetLocalTempPath(ByVal originalPath As String) As String
Dim fso As Object
Set fso = CreateObject("Scripting.FileSystemObject")
Dim fileName As String
fileName = fso.GetFileName(originalPath)
' 環境変数からTempフォルダを取得
Dim tempDir As String
tempDir = Environ("TEMP")
' ファイル名にタイムスタンプを付与して衝突を避ける
GetLocalTempPath = tempDir & "\" & Format(Now, "yyyymmdd_hhnnss_") & fileName
End Function
''' <summary>
''' 指定した秒数だけスレッドを待機させる(DoEventsによりフリーズを防止)
''' </summary>
Private Sub WaitSeconds(ByVal sec As Integer)
Dim endTime As Double
endTime = Timer + sec
Do While Timer < endTime
DoEvents ' AutoCADのUIを固まらせないための極めて重要な処理
Loop
End Sub
4. アーキテクトからの補足:設計の深淵
このコードを実装するにあたり、以下の3つの観点を忘れてはならない。
① オブジェクトのライフサイクルと整合性
`SaveAs` が失敗したとき、`ThisDrawing` オブジェクトの状態がどうなっているかを意識せよ。AutoCADの内部状態が「未保存(Dirty)」のまま残るのか、あるいは中途半端に書き込みが進んでファイルが破損するリスクがあるのか。本コードでは、失敗した場合に即座にローカルへ「クリーンな状態」で保存し直すことで、不完全なファイルがネットワーク上に残るリスクを最小化している。
② データベース連携における「トランザクション」の概念
もし君のツールが、図面の保存と同時に「管理台帳(SQL ServerやAccess等)」を更新しているなら、保存の成功を確認してからDBを更新せよ。
「DB更新 → 図面保存失敗」という順序で処理を書くのは、最悪の設計だ。DB上は「保存済み」となっているのに、ファイルが存在しないという「データの不整合」が発生するからだ。
③ `DoEvents` の重み
`WaitSeconds` 内で使用している `DoEvents` は、単なるおまじないではない。ネットワーク待機中にAutoCADが「応答なし」と判定されるのを防ぎ、ユーザーが「あ、フリーズした」と思ってタスクマネージャーから強制終了させるのを防ぐための、ユーザーエクスペリエンス(UX)への配慮だ。
結論
「動くコード」を書くのは初級者だ。「壊れないコード」を書くのが中級者であり、「失敗した後の挙動まで設計できる」者が、真のシニアエンジニアである。
ネットワークは常に不安定であり、ファイルシステムは常に裏切る。その前提に立ち、常にデータの生存を最優先に設計せよ。
