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

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

「SaveAs」を信じるな。SharePoint環境における堅牢なファイル保存を実現するレジリエント設計の極意

業務自動化エンジニアとして現場に立つとき、我々が直面するのは「コードが正しいか」という初歩的な問題ではない。「ネットワークという不確実な外部要因に対し、システムがいかに優雅に振る舞えるか」という、より高次な設計の問題である。

特に、Microsoft 365環境において、PowerPoint VBAからSharePointやOneDrive上のファイルへ直接保存を行う際、多くの開発者が「WebDAV特有の挙動」という壁にぶち当たる。

`ActivePresentation.SaveAs` を呼び出した瞬間、突如として発生する「ファイルへのアクセス権がありません」や「ネットワークエラー」といったエラー。これらは単なるバグではない。分散システムにおけるロック競合(HTTP 409 Conflict)や、ネットワークの瞬断、あるいはWebDAVプロトコルの同期遅延が引き起こす「仕様」なのだ。

本記事では、こうした不確実性を前提とした、プロフェッショナル向けの「レジリエント(回復力のある)保存ロジック」の設計手法を伝授する。

1. なぜ、単純な「SaveAs」では現場で使い物にならないのか

一般的なリファレンスに従い、単に `SaveAs` を実行するコードを書くのは容易だ。しかし、それは「ネットワークが常に完璧で、同時に同じファイルを誰も触っていない」という、現実には存在しない前提に基づいている。

WebDAVの罠:HTTP 409 Conflict

SharePointへの保存は、内部的にWebDAVプロトコルやMS-FSSHTTPを利用している。ユーザーがブラウザでファイルを開いている、あるいは別の自動化プロセスがメタデータを更新している最中に保存を試みると、サーバーは「競合(Conflict)」を返し、VBAは致命的な実行時エラーを吐いて停止する。

開発者が陥る「二流の設計」

1. エラーを無視する: `On Error Resume Next` でエラーを握りつぶし、ユーザーに「保存できたかどうかもわからない」不安を与える。
2. 単なるリトライ: 失敗した直後に即座にリトライする。これは、サーバー側のロックが解除される時間を無視しており、エラーの連鎖(Thundering Herd問題)を招くだけである。

2. 理想的なアーキテクチャ:Local Buffer & Exponential Backoff

プロフェッショナルが採用すべき設計は、「失敗を前提とした二段構えの防衛策」である。

戦略1:ローカル・テンポラリへの退避(Local Buffer Pattern)

ネットワーク保存に失敗した際、即座に「ローカルの安全な領域(%TEMP%)」へファイルを保存する。これにより、「ユーザーの作業データが失われる」という最悪の事態を確実に回避する。

戦略2:指数バックオフ(Exponential Backoff)

リトライを行う際は、待ち時間を「1秒、2秒、4秒、8秒…」と指数関数的に増やしていく。これにより、一時的なネットワークの混雑やサーバーのロック解除を待つ「知的な猶予」を生み出す。

3. 実装:プロダクション級のレジリエント・マクロ

以下に、これらを統合した堅牢なコードを示す。このコードは、単なるコピペ用ではない。オブジェクトのライフサイクルとエラーハンドリングの思想を組み込んでいる。

Option Explicit

' ==============================================================================
' Module: ResilienceModule
' Description: SharePoint保存時のネットワークエラーを検知し、
'              ローカル退避と指数バックオフによる再試行を行うレジリエント設計
' ==============================================================================

Private Const MAX_RETRIES As Integer = 4        ' 最大リトライ回数
Private Const INITIAL_WAIT As Double = 2        ' 初回待機時間(秒)

''' <summary>
''' プレゼンテーションを堅牢に保存するメインエントリポイント
''' </summary>
''' <param name="targetPath">保存先のフルパス(SharePoint URL等)</param>
Public Sub ResilientSave(ByVal targetPath As String)
    Dim success As Boolean
    Dim retryCount As Integer
    Dim waitTime As Double
    Dim localTempPath As String
    
    On Error GoTo ErrorHandler
    
    ' 1. まずは直接保存を試みる
    success = AttemptSave(targetPath)
    
    If Not success Then
        Debug.Print "Direct save failed. Switching to Resilience Mode..."
        
        ' 2. 保存失敗時、ローカルのテンポラリ領域へ退避(データの安全確保)
        localTempPath = CreateLocalTempPath(targetPath)
        If Not AttemptSave(localTempPath) Then
            MsgBox "致命的なエラー: ローカルへの退避にも失敗しました。", vbCritical
            Exit Sub
        End If
        
        ' 3. 指数バックオフを用いた再同期試行
        retryCount = 0
        waitTime = INITIAL_WAIT
        
        Do While retryCount < MAX_RETRIES
            Debug.Print "Retry attempt " & (retryCount + 1) & " after " & waitTime & "s..."
            
            ' 非同期的な待ちを実現するためにDoEventsを挟む
            WaitSeconds waitTime
            
            If AttemptSave(targetPath) Then
                ' 同期成功。ローカルのテンポラリファイルを削除
                Kill localTempPath
                MsgBox "ネットワーク不安定のため、再試行により保存が完了しました。", vbInformation
                Exit Sub
            End If
            
            ' 指数関数的に待ち時間を増加 (2^n)
            retryCount = retryCount + 1
            waitTime = waitTime * 2
        Loop
        
        ' すべてのリトライが失敗した場合
        MsgBox "ネットワークエラーが継続しています。ファイルはローカルに安全に退避されました。" & vbCrLf & _
               "保存先: " & localTempPath, vbExclamation
    Else
        Debug.Print "Save successful on first attempt."
    End If
    
    Exit Sub

ErrorHandler:
    MsgBox "予期せぬエラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 実際の保存処理をカプセル化した関数
''' </summary>
Private Function AttemptSave(ByVal path As String) As Boolean
    On Error Resume Next
    ActivePresentation.SaveCopyAs path
    
    ' SaveCopyAsは元のプレゼンテーションをロックしないため、
    ' ネットワークエラー検知には最適。
    If Err.Number = 0 Then
        AttemptSave = True
    Else
        ' ここでHTTP 409などのエラーをログに記録する設計が望ましい
        Debug.Print "Save Attempt Error: " & Err.Description
        AttemptSave = False
    End If
    On Error GoTo 0
End Function

''' <summary>
''' ローカルのTempフォルダに一意なファイル名でパスを生成する
''' </summary>
Private Function CreateLocalTempPath(ByVal originalPath As String) As String
    Dim fileName As String
    Dim folderPath As String
    
    ' 元のファイル名を取得
    fileName = Mid(originalPath, InStrRev(originalPath, "/") + 1)
    If fileName = "" Then fileName = "Recovered_Presentation.pptx"
    
    ' Tempフォルダのパス
    folderPath = Environ("TEMP") & "\"
    
    ' ファイル名が重複しないようタイムスタンプを付与
    CreateLocalTempPath = folderPath & Format(Now, "yyyymmdd_hhmmss_") & fileName
End Function

''' <summary>
''' 指定秒数待機する(UIのフリーズを最小限に抑える)
''' </summary>
Private Sub WaitSeconds(ByVal seconds As Double)
    Dim endWait As Double
    endWait = Timer + seconds
    Do While Timer < endWait
        DoEvents ' OSに制御を戻し、アプリケーションのハングを防ぐ
    Loop
End Sub

4. 設計の要点:なぜこのコードは「強い」のか

このコードを実装するにあたり、私が意図的に施した「プロの設計」は以下の3点だ。

① `SaveAs` ではなく `SaveCopyAs` を選択している

`SaveAs` は、プレゼンテーションの「現在のコンテキスト(作業対象)」そのものを書き換えてしまう。もし保存に失敗し、そのままユーザーが作業を続けた場合、作業対象がローカルのTempファイルに切り替わってしまうという、ユーザー体験上の致命的な混乱を招く。
`SaveCopyAs` を使うことで、「作業中のメモリ上のオブジェクト」は維持したまま、ファイルとしての出力だけを試行できる。これがレジリエンスの肝だ。

② `DoEvents` による非ブロッキング待機

VBAの `Sleep` API(Windows API)は強力だが、呼び出し中のアプリケーションを完全にフリーズさせる。業務ツールにおいて、保存中に「応答なし」と表示されるのは致命的な信頼失墜を招く。`DoEvents` をループさせた待機処理により、OSへの制御を戻し、ユーザーが「今、再試行中である」ことを視覚的に認識できる状態を保っている。

③ タイムスタンプによる衝突回避

`Environ(“TEMP”)` への退避時、単純に元のファイル名を使うのは素人の仕事だ。万が一、前回の失敗したファイルが残っていた場合、上書きエラーでさらにプロセスが止まる。`Format(Now, “yyyymmdd_hhmmss_”)` を付与することで、ファイル名の衝突を物理的に回避している。

5. 結論:エンジニアとしてのマインドセット

「動けばいい」コードは、開発環境という「理想郷」では機能する。しかし、数千人が利用するSharePoint環境という「戦場」では、エラーは必ず起きる。

優れた自動化エンジニアとは、エラーを出さない人間ではない。エラーが起きたときに、いかにユーザーのデータを守り、いかにシステムを自律的に復旧させるかを設計できる人間のことだ。

この「Local Buffer & Exponential Backoff」のパターンを、君の武器としてストックしておいてほしい。

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