【入門編】【中級者向け】添付ファイルが「0バイト」の場合に保存をスキップし、ログに記録する例外処理 – Outlook VBA解析バイブル

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

「動けばいい」から「止まらない」へ。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の基本はバッチリですよ。自信を持って、次の自動化に挑戦してくださいね!応援しています。

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