「動けばいい」から「止まらない」へ。Outlook VBAで0バイト添付ファイルをスマートに捌く極限の設計術
こんにちは。自動化の世界へようこそ。
マクロの記録機能を使って、自分なりの自動化ツールを作り始めたあなた。素晴らしい一歩を踏み出しましたね。しかし、実務という荒波に漕ぎ出すと、必ずと言っていいほど直面する「壁」があります。
それは、「想定外のデータ」です。
例えば、メールの添付ファイルを自動保存するマクロを作ったとしましょう。順調に動いていたのに、ある日突然、マクロがエラーを吐いて止まってしまう。原因を調べると、添付ファイルの中に「中身が空(0バイト)」のファイルや、通信エラーで破損したファイルが紛れ込んでいた……。
これは、プロの現場でもよくある「あるある」です。
今日は、単なる「記録されたマクロ」を卒業し、「例外(イレギュラー)を前提とした、止まらないプログラム」を書くための知恵を伝授します。ここをクリアすれば、あなたのVBAは「ツール」から「システム」へと進化します。
1. なぜ「0バイトのファイル」がマクロを破壊するのか?
まず、なぜエラーが起きるのか、そのメカニズムを理解しましょう。
通常、マクロは「ファイルがあるはずだ」「ファイルにはデータがあるはずだ」という「ハッピーパス(理想的な経路)」を前提にコードが書かれます。
しかし、ネットワークの瞬断や、送信側のシステムエラーによって、ファイルの実体がない「0バイトの添付ファイル」が届くことがあります。このとき、プログラムが「さあ、中身を保存するぞ!」と動こうとした瞬間、OSやOutlookが「おい、保存すべきデータが存在しないぞ」と悲鳴を上げ、実行を強制終了させてしまうのです。
プロのエンジニアは、「データは必ず汚れている(Dirty Data)」という前提で設計をします。
2. 設計思想: 「スキップ」と「ログ記録」の黄金パターン
エラーが起きたときに、マクロ全体を止めてしまうのは三流です。一流の設計は、以下の「例外処理フロー」を採用します。
1. 検知: 添付ファイルのサイズをチェックする。
2. 分岐:
- サイズが 0 より大きい $\rightarrow$ 通常通り保存。
- サイズが 0 $\rightarrow$ 保存をスキップし、「何が起きたか」をログに書き出す。
3. 継続: エラーを無視して、次のメール、次の添付ファイルの処理へ進む。
この「止まらずに、後で確認できるように証拠を残す」という考え方が、業務自動化の肝になります。
3. 実装: 堅牢な添付ファイル保存スクリプト
それでは、実際に動くコードを見てみましょう。
このコードでは、`FileSystemObject` という強力なツールを使って、ログファイルの作成まで行います。
事前準備:参照設定の魔法
このコードを動かすには、一つだけ準備が必要です。
1. VBAエディタのメニューから [ツール] $\rightarrow$ [参照設定] を開く。
2. 「Microsoft Scripting Runtime」 にチェックを入れて OK を押す。
(これで、高度なファイル操作ができるようになります)
' ============================================================
' テーマ:0バイト添付ファイルを検知し、スキップ&ログ記録する
' 設計思想:例外を止めるのではなく、記録して次に進む「堅牢設計」
' ============================================================
Option Explicit
Sub RobustAttachmentSaver()
Dim outlookApp As Outlook.Application
Dim ns As Outlook.NameSpace
Dim inbox As Outlook.Folder
Dim mailItem As Object ' MailItemだけでなく、MeetingItem等も考慮するためObject型
Dim att As Outlook.Attachment
Dim fso As FileSystemObject
Dim logFile As TextStream
' --- 設定エリア ---
Dim savePath As String: savePath = "C:\Temp\SavedFiles\" ' 保存先フォルダ
Dim logPath As String: logPath = "C:\Temp\process_log.txt" ' ログファイルのパス
' ------------------
Set fso = New FileSystemObject
' 保存先フォルダがなければ作成する(プロの配慮)
If Not fso.FolderExists(savePath) Then
fso.CreateFolder (savePath)
End If
' ログファイルを開く(追記モード:ForAppending)
Set logFile = fso.OpenTextFile(logPath, ForAppending, True)
logFile.WriteLine "--- 処理開始: " & Now & " ---"
Set outlookApp = New Outlook.Application
Set ns = outlookApp.GetNamespace("MAPI")
Set inbox = ns.GetDefaultFolder(olFolderInbox)
' 受信トレイのアイテムをループ(ここでは最新の10件を例にします)
' 本番では条件に合わせて変更してください
Dim i As Integer
For i = inbox.Items.Count To (inbox.Items.Count - 10 + 1) Step -1
If TypeOf inbox.Items(i) Is MailItem Then
Set mailItem = inbox.Items(i)
' 添付ファイルのループ
For Each att In mailItem.Attachments
' 【ここが核心】添付ファイルのサイズをチェック
If att.Size > 0 Then
' --- 通常ルート:保存処理 ---
On Error Resume Next ' 保存時の予期せぬエラー(ファイル使用中など)に備える
att.SaveAsFile savePath & att.FileName
If Err.Number <> 0 Then
logFile.WriteLine "[ERROR] 保存失敗: " & att.FileName & " (Reason: " & Err.Description & ")"
Err.Clear
End If
On Error GoTo 0 ' エラーハンドリングを通常に戻す
Else
' --- 例外ルート:0バイトの場合 ---
' 処理を止めずに、ログに記録して次のファイルへ
logFile.WriteLine "[SKIP] 0バイトのファイルを検知: " & _
"件名: " & mailItem.Subject & " / ファイル名: " & att.FileName
End If
Next att
End If
Next i
logFile.WriteLine "--- 処理終了: " & Now & " ---"
logFile.Close
MsgBox "処理が完了しました。詳細はログを確認してください。", vbInformation
' オブジェクトの解放
Set logFile = Nothing
Set fso = Nothing
Set ns = Nothing
Set outlookApp = Nothing
End Sub
4. コードの解説: ここが「プロ」のポイント
このコードをただコピペするだけでなく、以下の3つのポイントを魂に刻んでください。
① `If att.Size > 0 Then` による「ゲートキーパー」
これが今回の主役です。ファイルの実体を確認してから保存処理に入ることで、エラーの芽を事前に摘み取っています。これを「ガード句」と呼んだりします。
② `FileSystemObject` によるログの自動生成
`Debug.Print` でイミディエイトウィンドウに表示するだけでは、マクロが終わった瞬間に消えてしまいます。業務では「昨日の夜、エラーは出なかったか?」を確認する必要があります。ファイルとして残すことで、「証拠」としての価値が生まれます。
③ `On Error Resume Next` の適切な使い分け
「エラーを無視する」という命令は、使い方を間違えると危険な劇薬です。
今回のコードでは、「サイズチェック(自前で制御)」と「保存処理(OS依存のエラーへの備え)」を明確に使い分けています。
- サイズチェックは `If` 文で行う(論理的な制御)。
- `SaveAsFile` は、ファイルが既に開かれているなどの「予期せぬ外部要因」があるため、念のため `On Error Resume Next` で守る。
この使い分けこそが、安定したシステムを作る鍵です。
最後に: 次のステージへ
お疲れ様でした。これであなたは、単に「ファイルを保存するマクロ」ではなく、「異常を検知し、記録し、止まらずに完走する堅牢なプログラム」の書き方をマスターしました。
「もし、ここでネットワークが切れたら?」「もし、保存先に書き込み権限がなかったら?」
そんな風に、「失敗のパターン」を想像できるようになった時、あなたのエンジニアとしての視座は一段高くなります。
ここをクリアすれば、Outlook VBAの基本はバッチリですよ。自信を持って、次の自動化に挑戦してくださいね!応援しています。
