「保存しました」が命取りになる。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といったモダンな環境では、ネットワークの不安定さは「仕様」である。エラーを恐れるのではなく、エラーが起きた後の挙動を設計に組み込め。それこそが、世界最高峰のエンジニアへと至る唯一の道である。
