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

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

「動けばいい」は素人の思考だ。0バイトの添付ファイルに潜む「自動化の崩壊」を防ぐ堅牢な設計論

業務自動化の現場において、エンジニアが直面する最大の敵は、コードの構文エラーではない。「予期せぬデータの不整合」だ。

Outlookから添付ファイルを自動保存するツールを作ったとする。ロジックは完璧だ。ファイル名も取得し、パスも生成し、保存する。しかし、もしその添付ファイルが「0バイト」だったらどうなるか? あるいは、メールサーバーの不具合で中身が空の「破損ファイル」として届いたら?

そのまま処理を続行すれば、後続のプロセス(データベースへのインポート、AIによる解析、あるいはERPへの連携)が、空のファイルという「毒」を喰らってシステム全体がクラッシュする。

今日は、中級者への階段を登るために避けては通れない、「例外的な添付ファイルを検知し、システムを止めずにログへ隔離する」という、プロフェッショナルな設計思想を伝授する。

1. なぜ「単純な保存」では不十分なのか

多くの開発者が書くコードは「ハッピーパス(正常系)」しか想定していない。

' --- 典型的な「素人」のコード ---
For Each att In MailItem.Attachments
    att.SaveAsFile "C:\Temp\" & att.FileName
Next att

このコードは、実務環境では「欠陥品」だ。
もし `att.Size` が 0 だった場合、ファイルシステムには「中身のないファイル」が生成される。このファイルが後続のETL(抽出・変換・格納)プロセスに渡された瞬間、エラーが連鎖し、原因の特定すら困難な「サイレント・フェイル(静かなる失敗)」を引き起こす。

プロの設計には、以下の3要素が不可欠である。

1. ガード句(Guard Clause)の設置: 不正なデータを「処理の入り口」で弾く。
2. 非同期的なログ記録: 失敗した事実を、メイン処理を妨げずに記録する。
3. 冪等性(Idempotency)の確保: 失敗しても、再実行時に二重処理や矛盾が起きない。

2. 堅牢な設計アーキテクチャ

単に `If Size > 0 Then` と書くだけでは、設計としては三流だ。我々が構築すべきは、「検知・分離・記録」のサイクルである。

ログ設計の極意

ログは `MsgBox` で表示してはいけない。自動化ツールは「人が見ていない場所」で動くものだ。ログは、後から機械的に解析できる形式(CSVや、タイムスタンプ付きのテキスト)で、ファイルとして永続化しなければならない。

依存関係の分離

「ファイルを保存するロジック」と「エラーをログに書くロジック」を分離せよ。これにより、将来的にログの出力先をテキストファイルからデータベース(SQL ServerやAccess)に変更したくなった時、メインロジックを一切汚さずに済む。

3. 実装:プロダクション・グレードのVBAコード

以下に、実務でそのまま組み込めるレベルの、堅牢な設計に基づいたコードを示す。ここでは、`FileSystemObject` を使用してファイル操作の信頼性を高め、例外が発生した際に詳細なコンテキスト(メール件名、送信者、エラー理由)をログに刻む設計にしている。

Option Explicit

' --- 設定定数 ---
Private Const SAVE_DIR As String = "C:\Automation\SavedAttachments\"
Private Const LOG_DIR As String = "C:\Automation\Logs\"
Private Const LOG_FILE_NAME As String = "Attachment_Error_Log.csv"

''' <summary>
''' メイン処理:メールアイテムから添付ファイルを安全に抽出する
''' </summary>
Public Sub ProcessMailAttachments(ByVal MailItem As Outlook.MailItem)
    Dim att As Outlook.Attachment
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' 保存先ディレクトリの存在確認(なければ作成)
    If Not fso.FolderExists(SAVE_DIR) Then fso.CreateFolder (SAVE_DIR)
    If Not fso.FolderExists(LOG_DIR) Then fso.CreateFolder (LOG_DIR)

    On Error GoTo ErrorHandler

    For Each att In MailItem.Attachments
        ' --- 1. ガード句:サイズチェック ---
        ' 0バイト、または極端に小さいファイル(破損の疑い)を検知
        If att.Size <= 0 Then
            Call WriteErrorLog(MailItem, att.FileName, "Zero-byte attachment detected.")
            GoTo NextAttachment
        End If

        ' --- 2. ファイル保存処理 ---
        Dim targetPath As String
        targetPath = SAVE_DIR & att.FileName
        
        ' 同名ファイルが存在する場合の衝突回避(簡易版)
        If fso.FileExists(targetPath) Then
            targetPath = SAVE_DIR & Format(Now, "yyyymmddhhmmss_") & att.FileName
        End If

        att.SaveAsFile targetPath
        
        ' --- 3. 保存後の整合性チェック ---
        ' 書き込み直後にファイルサイズを再確認する二段構え
        If fso.GetFile(targetPath).Size = 0 Then
            Call WriteErrorLog(MailItem, att.FileName, "File saved but size is 0 (I/O Error).")
            ' 失敗したファイルは削除してクリーンアップ
            fso.DeleteFile targetPath
        End If

NextAttachment:
    Next att

    Exit Sub

ErrorHandler:
    ' 予期せぬシステムエラー(権限不足、ディスクフル等)の捕捉
    Call WriteErrorLog(MailItem, "SYSTEM_ERROR", Err.Description)
    Resume NextAttachment
End Sub

''' <summary>
''' ログ記録専用モジュール:エラー情報をCSV形式で出力
''' </summary>
Private Sub WriteErrorLog(ByVal MailItem As Outlook.MailItem, ByVal FileName As String, ByVal Reason As String)
    Dim fso As Object
    Dim logFile As Object
    Dim logPath As String
    Dim logLine As String
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    logPath = LOG_DIR & LOG_FILE_NAME
    
    ' CSVヘッダーの作成(ファイルが存在しない場合のみ)
    If Not fso.FileExists(logPath) Then
        logLine = "Timestamp,Sender,Subject,FileName,Reason" & vbCrLf
        Set logFile = fso.CreateTextFile(logPath, True)
        logFile.Write logLine
        logFile.Close
    End If

    ' ログ行の生成(カンマ区切り)
    ' ※実務ではSubject内のカンマ対策としてダブルクォーテーションで囲むのが鉄則
    logLine = Format(Now, "yyyy-mm-dd hh:mm:ss") & "," & _
              """" & MailItem.SenderEmailAddress & """," & _
              """" & MailItem.Subject & """," & _
              """" & FileName & """," & _
              """" & Reason & """" & vbCrLf

    ' 追記モードで書き込み
    On Error Resume Next ' ログ書き込み失敗でメイン処理を止めないための防衛策
    Set logFile = fso.OpenTextFile(logPath, 8, True) ' 8 = ForAppending
    logFile.Write logLine
    logFile.Close
    On Error GoTo 0
End Sub

4. プロフェッショナルのための技術解説

このコードがなぜ「強い」のか。その設計意図を理解せよ。

① 二段構えの整合性チェック

`att.Size` によるチェックは「ダウンロード前」のチェックだ。しかし、ネットワークの瞬断やディスクの書き込みエラーにより、保存後にファイルが壊れる可能性はゼロではない。そのため、`fso.GetFile(targetPath).Size` を用いて「保存直後」にもう一度検証している。この「疑い続ける姿勢」が、堅牢なシステムを作る。

② ログ出力の非同期的な思考

`WriteErrorLog` 内で `On Error Resume Next` を使用している点に注目してほしい。これは一見、怠慢に見えるかもしれない。しかし、「メインの業務処理(添付ファイル保存)が、ログ記録という副次的な処理の失敗によって止まってはならない」という設計思想に基づいている。ログが書けないからといって、本来処理すべき他のメールの処理まで止めるのは本末転倒だ。

③ 文字列エスケープの考慮

CSV形式でログを出す際、メールの件名(Subject)にカンマが含まれていると、ログの列がズレて解析不能になる。コード内で `””””`(ダブルクォーテーションでの囲み)を用いているのは、後続の解析ツール(ExcelやPythonなど)への配慮だ。

結論:エンジニアとしてのマインドセット

「動くコード」を書くのは誰にでもできる。しかし、「止まらない、かつ、何が起きたかを正確に報告するコード」を書ける者こそが、真のエンジニアだ。

0バイトのファイル、アクセス権限のないフォルダ、重複するファイル名……。これらの「不都合な真実」を、エラーとして投げ出すのではなく、「制御された例外」としてログに隔離する。この設計思想こそが、あなたの自動化ツールを「便利なスクリプト」から「信頼されるシステム」へと昇華させるのだ。

次にコードを書くときは、自分に問いかけろ。
「もし、このデータがゴミだったら、私のシステムはどう振る舞うべきか?」と。

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