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

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

WebDAVの深淵を制御する:SharePoint保存エラーに対するレジリエントな設計思想と実装

「保存に失敗しました」

この無慈悲なダイアログが、大規模な自動化プロセスを走らせているエンジニアの前に現れたとき、多くの者は単なる「ネットワークの瞬断」として片付けようとする。しかし、我々アーキテクトは知っている。それが単なるノイズではなく、分散システムにおける状態の不整合(State Inconsistency)、すなわちWebDAVプロトコル特有の競合状態(Conflict)や、サーバー側のロック制御の遅延であることを。

SharePointやOneDriveといったクラウドストレージを、あたかもローカルファイルシステムのように扱うVBAの実装において、標準的な `ActivePresentation.Save` に頼ることは、地雷原を全速力で駆け抜けるようなものだ。

本稿では、HTTP 409 (Conflict) やネットワークの不安定性を前提とした、「ローカルへの退避」と「指数バックオフ(Exponential Backoff)」によるレジリエント(回復弾力性のある)な保存メカニズムの設計と実装について、その極限の知見を共有する。

1. なぜ標準の保存メソッドは「脆弱」なのか

SharePointへのアクセスは、ファイルシステム(SMB)ではなく、多くの場合WebDAV、あるいはそれらを抽象化したREST APIを介している。ここで発生する問題は、ローカルのI/Oエラーとは根本的に性質が異なる。

1. HTTP 409 Conflict: 同一ファイルに対して、他のユーザーまたはバックグラウンドの同期プロセスが排他的ロックを保持している場合に発生する。
2. 分散システム特有の遅延: ファイルのメタデータ更新と実データの書き込みの間に、ネットワークのレイテンシによる「不整合な時間窓」が存在する。
3. セッションの断絶: 長時間の処理の間に、WebDAVのセッションがタイムアウトし、書き込み権限が一時的に失われる。

これらに対し、単に `On Error Resume Next` で握りつぶすことは、データの消失(Data Loss)を容認することと同義である。我々に求められるのは、「失敗を検知し、状態をローカルに保存し、再試行のサイクルに入る」という、高度なエラーハンドリング・ステートマシンである。

2. アーキテクチャ設計:Shadowing & Backoff

堅牢な保存プロセスを実現するために、以下の3つのフェーズを実装する。

Phase 1: Local Shadowing(ローカル・シャドウイング)

ネットワークへの直接書き込みが失敗した際、直ちに `Environ(“TEMP”)` 配下に、タイムスタンプを付与した「生存確認済み(Safe-to-Recover)」な一時ファイルを生成する。これにより、メモリ上のデータが失われるリスクをゼロにする。

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

再試行の際、一定の間隔でリトライするのは素人の仕事だ。サーバーの負荷やロックの解除時間を考慮し、待機時間を `2^n` の形で増大させる。これにより、サーバーへの過剰なリクエスト(Thundering Herd問題)を防ぎつつ、ロック解除のタイミングを効率的に捉える。

Phase 3: API-level Precision

VBAの `Application.Wait` は、スレッド全体を停止させ、UIの応答性を著しく損なう可能性がある。Windows APIの `Sleep` を用い、カーネルレベルで制御された精密な待機を行う。

3. 極限の実装例

以下に、シニアエンジニアが実戦投入すべき、レジリエントな保存ロジックのプロトタイプを示す。

Option Explicit

' Windows APIの宣言: 精密な待機を実現するためにkernel32を使用

If VBA7 Then

Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)

Else

Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

End If

' 定数の定義 Private Const MAX_RETRIES As Integer = 5 ' 最大リトライ回数 Private Const INITIAL_BACKOFF_MS As Long = 1000 ' 初回待機時間 (1秒) ''' <summary> ''' レジリエントな保存プロセスを実行する。 ''' 失敗時はローカルのテンポラリ領域に退避し、再試行を試みる。 ''' </summary> ''' <param name="targetPath">保存先のフルパス (SharePoint/UNCパス)</param> Public Sub ResilientSave(ByVal targetPath As String) Dim attempt As Integer Dim waitTime As Long Dim success As Boolean Dim tempFilePath As String Dim pres As Presentation Set pres = ActivePresentation success = False attempt = 0 ' 1. リトライループの開始 Do While attempt < MAX_RETRIES And Not success On Error Resume Next ' 保存試行 pres.Save If Err.Number = 0 Then success = True Debug.Print "[SUCCESS] Saved to: " & targetPath Else ' エラーコードの解析 (WebDAV/ネットワークエラーを想定) ' 0x80070035: Network path not found, 0x80070020: File in use 等 Debug.Print "[ERROR] Attempt " & attempt + 1 & " failed. Error: " & Err.Number attempt = attempt + 1 If attempt < MAX_RETRIES Then ' 指数バックオフの計算: initial * 2^(attempt-1) waitTime = INITIAL_BACKOFF_MS * (2 ^ (attempt - 1)) Debug.Print "[RETRY] Waiting " & waitTime & "ms before next attempt..." Sleep waitTime End If End If On Error GoTo 0 Loop ' 2. 最終的な失敗時のフォールバック(ローカル退避) If Not success Then tempFilePath = GenerateTempPath(targetPath) Debug.Print "[CRITICAL] All retries failed. Evacuating to: " & tempFilePath On Error Resume Next pres.SaveAs tempFilePath If Err.Number <> 0 Then ' ここまで失敗する場合は、メモリ上のデータすら危うい極限状態 MsgBox "致命的なエラー: ローカルへの退避にも失敗しました。プロセスを直ちに停止してください。", vbCritical Else MsgBox "ネットワークエラーにより、ファイルをローカルに退避しました。" & vbCrLf & _ "後ほど手動で同期するか、再同期ツールを実行してください。" & vbCrLf & _ "退避先: " & tempFilePath, vbExclamation End If On Error GoTo 0 End If ' 3. オブジェクトの明示的な解放(メモリリーク防止) ' 本来は呼び出し元で制御すべきだが、アーキテクトとしては意識しておくべき点 Set pres = Nothing End Sub ''' <summary> ''' 退避用のユニークな一時ファイルパスを生成する ''' </summary> Private Function GenerateTempPath(ByVal originalPath As String) As String Dim fso As Object Set fso = CreateObject("Scripting.FileSystemObject") ' 元のファイル名を取得し、タイムスタンプを付与 Dim fileName As String fileName = fso.GetFileName(originalPath) ' WindowsのTEMPディレクトリを利用 GenerateTempPath = Environ("TEMP") & "\PPT_RECOVERY_" & _ Format(Now, "yyyymmdd_hhmmss") & "_" & fileName Set fso = Nothing End Function

4. 深層解説:メモリとオブジェクトのライフサイクル

このコードを運用する上で、エンジニアが陥りやすい罠が二つある。

オブジェクトの参照整合性

`pres.Save` を呼び出す際、もしプレゼンテーションが壊れた状態(Corrupt)であったり、アドインによるハンドラが干渉している場合、`On Error Resume Next` は単にエラーをスキップするだけでなく、オブジェクトの内部ポインタを不安定にさせるリスクがある。
大規模なバッチ処理を行う場合は、`Set pres = Nothing` による明示的な解放に加え、必要に応じて `DoEvents` を挟み、OS側のI/Oキューが処理されるための「隙」を作ることも検討すべきだ。

Windows API `Sleep` の選択理由

VBA標準の `Application.Wait` は、ExcelやPowerPointのメインスレッドを完全にブロックし、アプリケーションを「応答なし」状態にする。これに対し、`kernel32.dll` の `Sleep` は、プロセスをスリープ状態に移行させるが、OSのスケジューリングに委ねられるため、より低レイヤーでの待機が可能だ。特に、指数バックオフのように「ミリ秒単位」の制御が必要な場合、`Sleep` は必須の選択肢となる。

結論

SharePoint環境におけるVBA開発は、もはや「ドキュメントの操作」ではなく、「分散システムにおけるデータ整合性の確保」という性質を帯びている。

エラーを「回避」するのではなく、エラーを「受け入れ、制御する」。
このレジリエントな設計思想こそが、現場のトラブルを極限まで減らし、システムの信頼性を担保する唯一の道である。

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