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

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

【実務編】ネットワークの瞬断に負けない!「絶対にデータを失わない」ための堅牢なSaveAs実装術

こんにちは。AutoCAD VBAの深淵へようこそ。

マクロの記録機能を使って、「ボタン一つで図面を保存する」……そんな小さな成功体験から、あなたのエンジニアとしての旅は始まったことでしょう。でも、もしあなたが「実務で使えるツール」を作ろうとしているなら、今、一つの大きな壁にぶつかる必要があります。

それは、「現実の世界は、あなたのコードほど完璧ではない」という事実です。

プログラムが書いた通りに動くのは、環境が完璧な時だけ。実務では、ネットワークの瞬断、サーバーの応答遅延、あるいはファイル権限の競合といった「予期せぬノイズ」が常に牙を剥いています。特に、共有サーバー上のDWGファイルを扱う場合、保存(`SaveAs`)の瞬間にネットワークがわずかに途切れただけで、マクロは無残にクラッシュし、ユーザーの貴重な作業データは霧の中に消えてしまいます。

今日は、そんな「現場のトラブル」を未然に防ぎ、プロフェッショナルとして一目置かれる「リトライ(再試行)とローカル退避」を備えた堅牢な保存ロジックを伝授します。

ここをクリアすれば、あなたの作るツールは「ただ動くもの」から「信頼されるシステム」へと進化しますよ。

1. なぜ、単純な `SaveAs` では足りないのか?

まず、初級者が書きがちなコードを見てみましょう。

' 典型的な「初学者」のコード
Sub SimpleSave()
    Dim targetPath As String
    targetPath = "\\Server\Project\Drawing1.dwg"
    
    ' これだけだと、ネットワークが切れた瞬間にエラーで止まる
    ThisDrawing.SaveAs targetPath
    MsgBox "保存完了!"
End Sub

このコードの致命的な弱点は、「失敗した時の逃げ道がない」ことです。
`SaveAs` メソッドがエラーを吐いた瞬間、VBAの実行は停止し、ユーザーには不親切なデバッグ画面が表示されます。最悪の場合、メモリ上のデータが破棄され、保存できていなかった作業内容がすべて失われます。

プロのエンジニアは、「失敗すること」を前提に設計します。

2. 堅牢な保存ロジックの設計図(アルゴリズム)

私たちが構築すべきなのは、以下のような「守りのフロー」です。

[保存開始]
    ↓
[Step 1: ネットワーク経由で保存を試みる]
    ├─ 成功 ─→ [完了メッセージを表示] → [終了]
    └─ 失敗 ─→ [Step 2: リトライ処理へ]
        ↓
[Step 2: 一定時間待機して、指定回数リトライする]
    ├─ 成功 ─→ [完了メッセージを表示] → [終了]
    └─ 失敗 ─→ [Step 3: ローカルへ退避(緊急避難)]
        ↓
[Step 3: PCのローカル(Cドライブ等)へ保存]
    ├─ 成功 ─→ [警告メッセージ「ネットワーク失敗のためローカルに保存しました」] → [終了]
    └─ 失敗 ─→ [致命的なエラー通知] → [終了]

このフローこそが、データの損失をゼロに近づけるための「鉄壁の布陣」です。

3. 【実践】プロフェッショナル・コード

それでは、実際に現場でそのまま使えるレベルのコードを実装しましょう。
このコードは、エラーハンドリング(`On Error GoTo`)を駆使し、ループ処理によるリトライを実現しています。

Option Explicit

''' <summary>
''' ネットワーク環境を考慮した、堅牢な図面保存メソッド
''' </summary>
''' <param name="networkPath">保存先のネットワークパス</param>
Sub RobustSaveAs(ByVal networkPath As String)
    Dim retryCount As Integer
    Const MAX_RETRIES As Integer = 3      ' 最大リトライ回数
    Const RETRY_DELAY_SEC As Integer = 2  ' リトライ間の待機時間(秒)
    
    Dim localBackupPath As String
    Dim success As Boolean
    Dim attempt As Integer
    
    ' ローカルの退避先を設定(例:ドキュメントフォルダやTempフォルダ)
    ' ここではデスクトップを例にします
    localBackupPath = CreateObject("WScript.Shell").SpecialFolders("Desktop") & "\__EMERGENCY_SAVE_" & Format(Now, "yyyymmdd_hhmmss") & ".dwg"

    success = False
    attempt = 0

    ' --- Phase 1: ネットワークへの保存試行(リトライ付き) ---
    Do While attempt < MAX_RETRIES And success = False
        attempt = attempt + 1
        
        On Error Resume Next ' エラーが発生しても次へ進む(エラー判定を自分で行うため)
        ThisDrawing.SaveAs networkPath
        
        If Err.Number = 0 Then
            ' 成功した場合
            success = True
            On Error GoTo 0 ' エラーハンドリングをリセット
        Else
            ' 失敗した場合
            Debug.Print "Attempt " & attempt & " failed: " & Err.Description
            Err.Clear ' エラー情報をクリア
            
            If attempt < MAX_RETRIES Then
                ' 次のリトライまで少し待機(Windows APIのSleepを使う方法もあるが、簡易的にWait)
                Application.Wait (Now + TimeValue("00:00:0" & RETRY_DELAY_SEC))
            End If
        End If
        On Error GoTo 0
    Loop

    ' --- Phase 2: 結果判定とバックアップ処理 ---
    If success Then
        MsgBox "図面を正常に保存しました。" & vbCrLf & networkPath, vbInformation, "保存成功"
    Else
        ' ネットワーク保存が全リトライ失敗した場合、ローカルへ緊急退避
        Debug.Print "Network save failed. Attempting local backup..."
        
        On Error Resume Next
        ThisDrawing.SaveAs localBackupPath
        
        If Err.Number = 0 Then
            MsgBox "【警告】ネットワーク接続に失敗したため、ローカルへ退避保存しました。" & vbCrLf & _
                   "保存先: " & localBackupPath, vbExclamation, "ネットワークエラー"
        Else
            ' ローカル保存すら失敗した場合(ディスクフルや権限不足)
            MsgBox "【致命的エラー】保存に失敗しました。データを失う可能性があります!" & vbCrLf & _
                   "エラー内容: " & Err.Description, vbCritical, "保存不能"
        End If
        On Error GoTo 0
    End If
End Sub

''' <summary>
''' テスト用メインルーチン
''' </summary>
Sub Main()
    ' 実務で想定されるネットワークパス
    Dim myPath As String
    myPath = "\\YourServerName\SharedFolder\Project_A\Design_v1.dwg"
    
    Call RobustSaveAs(myPath)
End Sub

4. コードの核心:エンジニアとしての思考プロセス

このコードのどこが「プロ」なのか。そのポイントを解説します。

① `On Error Resume Next` の戦略的利用

通常、`On Error Resume Next` は「エラーを無視する」ために使われがちですが、これは危険な使い方です。
今回のコードでは、「エラーが起きたかどうかを `Err.Number` で判定するために、一時的にエラーをトラップする」という目的で使っています。エラーを無視するのではなく、「エラーを制御下に置く」。これが極限の知見です。

② `Application.Wait` による「猶予」の創出

ネットワークの瞬断は、コンマ数秒で復旧することが多々あります。失敗した瞬間にすぐリトライするのではなく、あえて数秒待つことで、復旧のタイミングを待つ「余裕」を持たせています。

③ 「最悪の事態」を想定したローカル退避

エンジニアの最大の責務は、「ユーザーのデータを失わせないこと」です。
ネットワークが死んでいるなら、せめてユーザーのPCの中にデータを残す。この「逃げ道(Fallback)」を用意しておくことが、ツールとしての信頼性を決定づけます。

5. 陥りやすい罠:オブジェクトのライフサイクル

最後に、一つだけ重要なアドバイスを。

`SaveAs` を実行する際、もしマクロの中で他のオブジェクト(例えば、開いている別の図面や、外部参照のパスなど)を複雑に操作している場合、保存の瞬間にそれらのオブジェクトの状態が不安定になることがあります。

特に、「保存中に図面内の要素を書き換える」ような処理を同時に走らせないこと。
「保存」は、オブジェクトの状態を確定させる(Freeze/Commitする)作業です。保存のプロセスと、図面を編集するプロセスは、明確に分離して設計してください。

まとめ:ここから、あなたのレベルが変わる

「動けばいい」という考え方は、学習者のフェーズです。
「どんな状況でも、安全に、確実に動く」を目指すのが、プロフェッショナルへの道です。

今回紹介したリトライと退避のロジックは、AutoCADに限らず、あらゆる業務自動化に応用できる普遍的な考え方です。これを自分の武器として使いこなせれば、あなたの書くコードは、現場の荒波の中でも揺るぎない信頼を得られるはずですよ。

さあ、次のステップへ進みましょう。応援しています!

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