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

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

「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)への配慮だ。

結論

「動くコード」を書くのは初級者だ。「壊れないコード」を書くのが中級者であり、「失敗した後の挙動まで設計できる」者が、真のシニアエンジニアである。

ネットワークは常に不安定であり、ファイルシステムは常に裏切る。その前提に立ち、常にデータの生存を最優先に設計せよ。

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