【脱・初心者】OneDrive同期エラーを跳ね返す「堅牢な添付ファイル保存術」
こんにちは。業務自動化の世界へようこそ。
「マクロの記録」を使って、なんとか自動化の第一歩を踏み出した。そんなあなたなら、次は「もっと実用的なものを作りたい」と考えているはずです。メールの添付ファイルを自動で保存する……。一見、シンプルに見えるこのタスクですが、実はプロの現場でも多くのエンジニアが頭を悩ませる「落とし穴」が潜んでいます。
その落とし穴とは、OneDriveやSharePointといった「クラウドストレージ」への保存です。
「昨日まで動いていたのに、今日はエラーで止まってしまう」「たまに保存に失敗する」……もしそんな経験があるなら、あなたは今、エンジニアとして一段上のステージへ進むための重要な課題に直面しています。
今日は、そのエラーの正体を解き明かし、どんな環境でも止まらない「極限の堅牢性」を持ったコードの書き方を伝授しましょう。
1. なぜ「同期エラー」が起きるのか?
まず、敵を知ることから始めましょう。なぜ、ローカルのCドライブに保存する時は平気なのに、OneDriveのフォルダに保存しようとするとエラー(実行時エラー ’70’: 書き込み禁止、またはアクセス権がありません)が出るのでしょうか?
それは、「ファイル作成のタイミング」と「クラウド同期のタイミング」が衝突(コンフリクト)しているからです。
発生している現象のイメージ図
1. VBA君: 「よし、添付ファイルを保存するぞ!」 $\rightarrow$ *ファイルを作成*
2. OneDrive君: 「おっ、新しいファイルができたな! すぐにクラウドへアップロードしなきゃ!」 $\rightarrow$ *ファイルをスキャン・ロック(占有)*
3. VBA君: 「よし、次の処理(ファイル名の変更や移動)を……あれ? ファイルが開けない! エラーだ!」
このように、VBAがファイルを操作しようとした瞬間に、OneDriveが「同期のためにファイルを掴んで離さない」状態になっているのです。これをエンジニア用語で「レースコンディション(競合状態)」と呼びます。
2. 凡人のコード、プロのコード
多くの初心者は、このエラーに遭遇するとこう書きがちです。
' ❌ 初心者が陥りがちな「危ない」書き方
On Error Resume Next ' エラーを無視して進む
attachment.SaveAs FileName:=savePath
On Error GoTo 0
これは絶対にやめてください。`On Error Resume Next` は、エラーを「なかったこと」にするだけです。ファイルが保存できていないのに、プログラムだけが先に進んでしまい、後続の処理でさらに深刻なエラーを引き起こします。これは「不具合を隠蔽しているだけ」の状態です。
では、プロはどう書くのか?
答えは、「エラーが起きることを前提に、リトライ(再試行)の仕組みを組み込む」ことです。
3. 堅牢な実装:リトライ・ループ・アーキテクチャ
では、実際に使えるコードを見てみましょう。ここでは、Windowsの機能を直接呼び出す「API」という技術を使い、プログラムを数秒間「待機」させる高度なテクニックを導入します。
以下のコードを、標準モジュールにコピーして試してみてください。
Option Explicit
' Windows APIの宣言:プログラムをミリ秒単位で正確に一時停止させるために使用します
' 64bit版のOfficeでも動作するように「PtrSafe」を使用しています
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
''' <summary>
''' 添付ファイルを安全に保存するメインルーチン
''' </summary>
Sub SafeSaveAttachmentExample()
Dim objMail As Outlook.MailItem
Dim objAttachment As Outlook.Attachment
Dim saveFolder As String
Dim savePath As String
' 保存先フォルダ(OneDrive等の同期フォルダを指定してください)
saveFolder = "C:\Users\YourName\OneDrive\TestFolder\"
' フォルダの末尾に \ がなければ追加する
If Right(saveFolder, 1) <> "\" Then saveFolder = saveFolder & "\"
' 現在開いているメールを対象にする(テスト用)
On Error Resume Next
Set objMail = Application.ActiveInspector.CurrentItem
On Error GoTo 0
If objMail Is Nothing Then
MsgBox "メールを開いた状態で実行してください。", vbExclamation
Exit Sub
End If
' 添付ファイルのループ処理
For Each objAttachment In objMail.Attachments
savePath = saveFolder & objAttachment.FileName
' 【重要】ここで自作のリトライ関数を呼び出す
If SaveAttachmentWithRetry(objAttachment, savePath) Then
Debug.Print "成功: " & savePath
Else
Debug.Print "失敗: " & savePath
End If
Next objAttachment
MsgBox "処理が完了しました。詳細はイミディエイトウィンドウを確認してください。", vbInformation
End Sub
''' <summary>
''' 同期エラーを回避しながら添付ファイルを保存する関数
''' </summary>
''' <param name="att">保存する添付ファイルオブジェクト</param>
''' <param name="destPath">保存先のフルパス</param>
''' <returns>成功すればTrue、失敗すればFalse</returns>
Function SaveAttachmentWithRetry(ByRef att As Outlook.Attachment, ByVal destPath As String) As Boolean
Dim retryCount As Integer
Const MAX_RETRIES As Integer = 5 ' 最大リトライ回数
Const WAIT_INTERVAL As Long = 2000 ' 待機時間(ミリ秒): 2000ms = 2秒
Dim success As Boolean
success = False
retryCount = 0
' リトライループの開始
Do While retryCount < MAX_RETRIES And success = False
On Error Resume Next ' エラーハンドリングを開始
' 1. ファイルを保存してみる
att.SaveAs destPath
' 2. エラーが発生したかチェック
If Err.Number = 0 Then
' エラーなし = 保存成功!
success = True
Else
' エラー発生(おそらくファイルロック)
retryCount = retryCount + 1
Debug.Print "警告: 保存失敗(試行 " & retryCount & "/" & MAX_RETRIES & ")。" & _
"エラー内容: " & Err.Description
' エラーをクリアしないと、次のループでも同じエラーが残ってしまう
Err.Clear
' 3. 次の試行まで少し待つ(ここでOneDriveがファイルを離すのを待つ)
If retryCount < MAX_RETRIES Then
Sleep WAIT_INTERVAL
End If
End If
On Error GoTo 0 ' エラーハンドリングを通常に戻す
Loop
' 最終的な結果を返す
SaveAttachmentWithRetry = success
End Function
4. コードの解説:なぜこれで動くのか?
このコードの核となるのは `SaveAttachmentWithRetry` 関数です。ここには、プロの設計思想が3つ詰め込まれています。
① `Do While` によるリトライ・ループ
「1回やってダメなら諦める」のではなく、「最大5回までは粘る」という設計です。クラウドの同期は一瞬の出来事なので、2〜3秒待てば、OneDrive君がファイルを離してくれる確率が非常に高くなります。
② `Sleep` API による戦略的待機
VBA標準の `Application.Wait` ではなく、Windowsの `Sleep` APIを使っています。これは、CPUに「何もせず、指定した時間だけ休んでくれ」と命令する非常に軽量な方法です。これにより、無駄なループによる負荷を抑えつつ、確実に同期完了のタイミングを待ちます。
③ `Err.Clear` の重要性
ここが最も重要なテクニックです。VBAのエラーオブジェクト(`Err`)は、一度エラーが発生すると、明示的にクリアしない限り「エラー状態」を保持し続けます。
`Err.Clear` を書かないと、たとえ2回目の試行でファイル保存に成功したとしても、プログラムは「まだエラーが起きている」と勘違いしてしまいます。
5. まとめ:ここをクリアすれば、Outlook VBAの基本はバッチリですよ
今回学んだのは、単なる「エラー回避術」ではありません。
- 外部環境(クラウド、ネットワーク、他アプリ)との競合を予測する
- エラーを無視せず、構造的に対処する
- 「待機」という概念をプログラムに取り入れる
これらは、どのようなプログラミング言語でも通用する、「堅牢なシステム」を作るための普遍的な知見です。
「マクロが動かない」と嘆く段階から、「どうすれば環境の変化に強いコードが書けるか」を考える段階へ。あなたは今、その入り口に立っています。
一歩ずつ、確実に。このコードを自分の道具箱に入れて、より高度な自動化の世界へ踏み出していきましょう!応援していますよ。
