【実務・中級編】【上級者】クラウドストレージ上のファイル保存時に発生するWebDAV特有のネットワーク競合エラーを検知し、自動的にローカルテンポラリへ退避させて再同期を試みるレジリエントマクロ – PowerPoint VBA解析バイブル

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

「保存しました」が命取りになる。SharePoint/OneDrive環境でデータロストを防ぐ、レジリエントなVBA設計思想

業務自動化の現場において、多くの開発者が陥る「致命的な罠」がある。それは、「ローカル環境で動くコードを、そのままクラウドストレージ(SharePoint/OneDrive)へ持っていく」という慢心だ。

ローカルのHDD/SSDであれば、`ActivePresentation.Save` はほぼ確実に成功する。しかし、WebDAVプロトコルを介してクラウド上のファイルを操作する場合、話は別だ。ネットワークの瞬断、他ユーザーによる排他ロック、同期クライアントによるファイル占有――これらが原因で、VBAは「実行時エラー 1004」や「70(書き込み禁止)」を吐き出し、ユーザーの数時間に及ぶ作業を無に帰す。

本稿では、単なるエラー回避ではない。障害を前提とし、データの整合性を守り抜くための「レジリエント(回復力のある)な設計思想」と、その実装方法を伝授する。

1. なぜ、あなたのマクロは「脆弱」なのか

一般的な自動化ツールを作成するエンジニアは、以下のようなコードを書く。

' 典型的な「脆弱な」実装
Sub NaiveSave()
    On Error Resume Next ' 思考停止の回避策
    ActivePresentation.Save
    If Err.Number <> 0 Then
        MsgBox "保存に失敗しました。"
    End If
    On Error GoTo 0
End Sub

これは設計として「敗北」している。`On Error Resume Next` はエラーを隠蔽するだけで、解決もしていない。エラーが起きた瞬間、メモリ上のプレゼンテーションデータは「未保存の状態」のまま放置され、ユーザーが誤ってファイルを閉じれば、その瞬間にデータは消失する。

クラウド特有の競合要因

クラウドストレージ環境では、以下の事象が頻発する。

  • HTTP 409 Conflict: 同期プロセスがファイルをロックしている。
  • Network Latency: WebDAVのリクエストがタイムアウトする。
  • File Locking: OneDriveの同期エンジンが、保存処理中にファイルをスキャンしてロックをかける。

プロフェッショナルなアーキテクトは、「保存に失敗することを標準動作(Default Case)として設計」に組み込むべきだ。

2. レジリエント設計の三原則:Evacuate, Notify, Retry

堅牢な自動化基盤を構築するには、以下の3ステップによる「退避戦略」が必要である。

1. Evacuate(退避): クラウドへの保存が失敗した場合、即座に「ローカルのテンポラリ領域」へ別名保存する。これにより、データロストのリスクをゼロにする。
2. Notify(通知): ユーザーに対し、現在の状態(クラウドへの保存失敗)と、退避先(ローカルパス)を明確に提示する。
3. Retry(再試行): ネットワークやロックが解消されるのを待つ、あるいはユーザーの指示に基づき、同期の再試行を促す。

3. 実装例:プロダクション・グレードのレジリエント・セーブ

以下に、そのまま実務の基盤として利用できる、クラスモジュール級の堅牢性を備えたコードを示す。

Option Explicit

''' <summary>
''' クラウド環境(SharePoint/OneDrive)におけるネットワーク競合を考慮した、
''' レジリエントな保存処理を実行する。
''' </summary>
Public Sub ResilientSave()
    Dim targetPath As String
    Dim tempPath As String
    Dim fileName As String
    Dim fileExt As String
    Dim retryCount As Integer
    Const MAX_RETRIES As Integer = 3
    
    ' 1. 現在の保存先を取得
    targetPath = ActivePresentation.FullName
    
    ' ファイルが一度も保存されていない(パスがない)場合のハンドリング
    If targetPath = "" Then
        MsgBox "ファイルが保存されていません。初回保存を行ってください。", vbExclamation
        Exit Sub
    End If

    ' 2. 保存試行ループ
    On Error GoTo ErrorHandler
    
    For retryCount = 1 To MAX_RETRIES
        Debug.Print "Attempt " & retryCount & " to save: " & targetPath
        
        ' 保存実行
        ActivePresentation.Save
        
        ' 成功すればループを抜ける
        Debug.Print "Save successful."
        Exit Sub
    Next retryCount

CleanExit:
    Exit Sub

ErrorHandler:
    ' 3. エラー検知と退避ロジック
    ' エラー番号 70 (Permission Denied) や 1004 (Generic/Network) を想定
    Debug.Print "Save failed. Error: " & Err.Number & " - " & Err.Description
    
    ' ローカルテンポラリ領域の構築
    ' Environ("TEMP") を使用して、実行ユーザーの安全な領域を確保する
    fileName = GetFileNameWithoutExtension(targetPath)
    fileExt = GetFileExtension(targetPath)
    tempPath = Environ("TEMP") & "\" & fileName & "_" & Format(Now, "yyyymmdd_hhnnss") & "." & fileExt
    
    ' 4. 緊急退避(Evacuate)
    On Error Resume Next ' 退避自体の失敗によるクラッシュを防ぐ
    ActivePresentation.SaveAs FileName:=tempPath
    
    If Err.Number = 0 Then
        ' 5. ユーザーへの通知(Notify)
        MsgBox "【警告】クラウドへの保存に失敗しました(ネットワーク競合)。" & vbCrLf & vbCrLf & _
               "データの安全を確保するため、ローカルへ緊急退避しました。" & vbCrLf & _
               "退避先: " & tempPath & vbCrLf & vbCrLf & _
               "後ほど、このファイルをクラウドへ手動でアップロードするか、" & _
               "ネットワーク状況を確認して再同期してください。", vbCritical, "Resilient Save System"
    Else
        ' 退避すら失敗した場合(ディスクフル等)の最終防衛線
        MsgBox "【致命的エラー】クラウド保存およびローカル退避の両方に失敗しました。" & vbCrLf & _
               "作業内容をコピーして、別のアプリケーションに貼り付けて保存してください。", vbCritical, "Critical Failure"
    End If
    On Error GoTo 0
    
    Exit Sub
End Sub

' --- 以下、ユーティリティ関数(保守性を高めるために分離) ---

''' <summary>
''' パスから拡張子を除いたファイル名を取得する
''' </summary>
Private Function GetFileNameWithoutExtension(fullPath As String) As String
    Dim pos As Integer
    pos = InStrRev(fullPath, "\")
    If pos > 0 Then
        Dim namePart As String
        namePart = Mid(fullPath, pos + 1)
        Dim dotPos As Integer
        dotPos = InStrRev(namePart, ".")
        If dotPos > 0 Then
            GetFileNameWithoutExtension = Left(namePart, dotPos - 1)
        Else
            GetFileNameWithoutExtension = namePart
        End If
    Else
        GetFileNameWithoutExtension = fullPath
    End If
End Function

''' <summary>
''' パスから拡張子を取得する
''' </summary>
Private Function GetFileExtension(fullPath As String) As String
    Dim dotPos As Integer
    dotPos = InStrRev(fullPath, ".")
    If dotPos > 0 Then
        GetFileExtension = Mid(fullPath, dotPos + 1)
    Else
        GetFileExtension = ""
    End If
End Function

4. アーキテクトの視点:なぜこの設計なのか

このコードが、単なる「エラー回避マクロ」と一線を画しているポイントを解説する。

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

`ActivePresentation.SaveAs` を使用して退避させる際、単にファイルをコピーするのではなく、`SaveAs` を使うことで、「現在のメモリ上の最新状態」を新しいパスに書き出すことを保証している。これは、ファイルコピー(FileCopy)では不可能な、オブジェクトの状態を維持したままの救済措置だ。

パス管理の堅牢性

`Environ(“TEMP”)` を利用している点は極めて重要だ。書き込み権限のないディレクトリや、ネットワーク上の共有フォルダを退避先に指定すると、二次災害(退避失敗)を招く。OSが保証するローカルの一時ディレクトリを使うことは、レジリエント設計の鉄則である。

ユーザー体験(UX)への配慮

エラーが発生した際、黙って失敗するのではなく、「何が起き」「どこにデータが逃げたか」を明示している。自動化ツールにおいて、「ユーザーのコントロールを奪わないこと」は、信頼されるツールを作るための絶対条件だ。

5. まとめ:自動化エンジニアとしての責務

自動化エンジニアの仕事は、「Happy Path(正常系)」を構築することではない。「Unhappy Path(異常系)」をいかに美しく、かつ安全に制御するかにこそ、真の価値がある。

SharePointやOneDriveといったモダンな環境では、ネットワークの不安定さは「仕様」である。エラーを恐れるのではなく、エラーが起きた後の挙動を設計に組み込め。それこそが、世界最高峰のエンジニアへと至る唯一の道である。

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