【テクニカル・上級編】【中級者向け】添付ファイルの総容量を計算し、一定サイズを超える場合に警告メールを自動返信する – Outlook VBA解析バイブル

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

バイトの重みを知れ:メールサーバーの整合性を守るための添付ファイル容量制御アーキテクチャ

メールサーバーが「拒否」を返すとき、そこには常に設計上の不整合が存在する。

多くの開発者は、添付ファイルのサイズ制限を単なる「数値の比較」と捉える。しかし、真のシステムアーキテクトであれば、その背後にあるMIMEエンコードによるオーバーヘッド、SMTPプロトコルの制約、そしてOutlookプロセスにおけるメモリリソースの占有率を考慮しなければならない。

本稿では、Outlook VBAを用いた「添付ファイル総容量の監視と、閾値超過時の自動警告レスポンス」の実装について、単なるコードの提示を超えた、極限のメモリ管理と堅牢なエラーハンドリングの観点から詳述する。

1. 物理サイズと論理サイズの乖離:MIMEエンコードの罠

まず、エンジニアが陥りやすい致命的な誤解を正しておく。
ファイルシステムのサイズ(物理サイズ)と、メールとして送受信される際のサイズ(論理サイズ)は一致しない。

添付ファイルは、Base64などの方式でテキストエンコードされる。この際、データ量は理論上約1.33倍(33%増)に膨れ上がる。例えば、15MBのファイルを送ろうとしたとき、サーバー側では約20MBのペイロードとして処理される。

我々が実装すべきロジックは、単なる `Attachment.Size` の合計ではなく、この「エンコードによる膨張」を見越した閾値管理である。

2. オブジェクトのライフサイクルとメモリの解放

Outlook VBAは、しばしば長時間稼働するアドインや、バックグラウンドでの自動処理の一部として組み込まれる。ここで最も警戒すべきは、「オブジェクトの参照残存によるメモリリーク」だ。

`MailItem` や `Attachment` オブジェクトをループ内で生成し、適切に破棄(`Set = Nothing`)しなければ、Outlookのメモリ使用量は指数関数的に増大し、最終的にはプロセス全体のクラッシュ、あるいはシステム全体の不安定化を招く。

特に、大規模な添付ファイルを含むメールを処理する場合、そのオブジェクトはメモリ上に巨大なバイナリバッファを確保する。これらを明示的に解放する設計は、プロフェッショナルとしての最低限の作法である。

3. 実装:堅牢な容量監視エンジンの構築

以下に、シニアエンジニアが現場に投入するための、最適化されたコード構造を示す。

モジュール構成の設計思想

  • 分離性: 容量計算ロジックと、アクション(警告送信)ロジックを分離する。
  • 互換性: 64bit/32bit両環境を想定した宣言を行う。
  • 安全性: 予期せぬエラー(破損した添付ファイル等)でプロセスを停止させない。
Option Explicit

' --- 定数定義:システムの境界条件を明確にする ---
Private Const MAX_THRESHOLD_BYTES As LongPtr = 20_000_000 ' 20MB (物理サイズベース)
Private Const MIME_OVERHEAD_FACTOR As Double = 1.35      ' エンコードによる膨張を見越した係数
Private Const WARNING_SUBJECT As String = "[System Alert] Attachment Size Warning"

''' <summary>
''' 受信メールを監視し、添付ファイルの総容量をチェックするメインエントリーポイント
''' </summary>
Public Sub InspectIncomingMailSize(ByVal mi As Outlook.MailItem)
    Dim totalPhysicalSize As LongPtr
    Dim estimatedPayloadSize As LongPtr
    Dim att As Outlook.Attachment
    
    ' エラーハンドリングの開始
    On Error GoTo ErrorHandler

    ' 1. 添付ファイルの存在確認
    If mi.Attachments.Count = 0 Then Exit Sub

    ' 2. 添付ファイル容量の集計
    ' 注意:Attachmentオブジェクトへのアクセスは低速なため、最小限のループで完結させる
    For Each att In mi.Attachments
        totalPhysicalSize = totalPhysicalSize + att.Size
        ' メモリ解放の準備としての参照管理(ループ内では不要だが、設計思想として意識する)
    Next att

    ' 3. エンコード後の推定サイズを計算
    estimatedPayloadSize = CLngPtr(totalPhysicalSize * MIME_OVERHEAD_FACTOR)

    ' 4. 閾値判定
    If estimatedPayloadSize > MAX_THRESHOLD_BYTES Then
        SendWarningReply mi, totalPhysicalSize
    End If

CleanExit:
    ' オブジェクトの明示的な解放
    ' mi は呼び出し元で管理されるべきだが、念のため参照を断つ設計思想を持つ
    Set att = Nothing
    Exit Sub

ErrorHandler:
    ' ログ出力などの実運用では、ここでWindows Event Log等へ書き出す
    Debug.Print "Critical Error in InspectIncomingMailSize: " & Err.Description
    Resume CleanExit
End Sub

''' <summary>
''' 閾値を超過した場合の自動返信ロジック
''' </summary>
Private Sub SendWarningReply(ByVal originalMail As Outlook.MailItem, ByVal actualSize As LongPtr)
    Dim replyMail As Outlook.MailItem
    Dim bodyText As String
    
    On Error GoTo ReplyErrorHandler

    ' 返信メールの生成
    Set replyMail = originalMail.ReplyAll
    
    ' 警告メッセージの構築
    bodyText = "This is an automated system notification." & vbCrLf & vbCrLf & _
               "The total size of your attachments exceeds our server's recommended limit." & vbCrLf & _
               "Detected Physical Size: " & FormatSize(actualSize) & vbCrLf & _
               "Please compress your files or use a cloud storage link for future transmissions." & vbCrLf & vbCrLf & _
               "---" & vbCrLf & _
               "This message was generated by the Mail Integrity Guard."

    With replyMail
        .Subject = WARNING_SUBJECT & " : " & replyMail.Subject
        .HTMLBody = Replace(bodyText, vbCrLf, "<br>") ' シンプルなHTML変換
        .Importance = olImportanceHigh
        .Send ' 即時送信
    End With

CleanExit:
    Set replyMail = Nothing
    Exit Sub

ReplyErrorHandler:
    Debug.Print "Failed to send warning reply: " & Err.Description
    Resume CleanExit
End Sub

''' <summary>
''' バイト単位の数値を読みやすい形式に変換するユーティリティ
''' </summary>
Private Function FormatSize(ByVal bytes As LongPtr) As String
    Dim units As Variant
    Dim i As Integer
    units = Array("Bytes", "KB", "MB", "GB")
    
    i = 0
    Do While bytes >= 1024 And i < UBound(units)
        bytes = bytes / 1024
        i = i + 1
    Loop
    
    FormatSize = Format(bytes, "0.00") & " " & units(i)
End Function

4. プロフェッショナルのための深化:システム間連携と保守

このコードを実運用環境(Production)に投入する際、以下の3点を考慮せよ。

4.1. Windows APIによるプロセスの監視

VBAの `Application_NewMailEx` イベントを使用する場合、Outlookがバックグラウンドで動作している(あるいはリモートデスクトップ経由で操作されている)状況下では、イベントのトリガーが不安定になることがある。大規模なシステムでは、必要に応じて `GetForegroundWindow` などのWindows APIを使用し、Outlookのプロセス状態を外部から監視する仕組みを検討すべきだ。

4.2. レガシー環境への配慮

もしターゲット環境が古いExcel/Outlook(32bit版)である場合、`LongPtr` は `Long` として扱われる。しかし、現代的なアーキテクチャでは、コードの堅牢性を担保するために、必ず `LongPtr` を用いて64bit環境でのオーバーフローを防ぐ設計を標準とすべきである。

4.3. 拡張性:API連携への布石

現在の実装は「自動返信」だが、エンタープライズ環境においては「添付ファイルを自動的にOneDriveやSharePointへアップロードし、そのリンクを返信する」というフローが求められる。その際、VBAから `MSXML2.XMLHTTP` を用いてREST APIを叩く設計へと拡張する準備をしておくこと。

結論

添付ファイルのサイズチェックは、一見すると単純な比較演算に見える。しかし、その裏には通信プロトコルの特性、メモリ管理の厳密さ、そしてシステムの可用性を守るための設計思想が隠されている。

「動けばいい」コードを書くのは、単なるスクリプターだ。
「壊れない、そしてリソースを食いつぶさない」コードを書くこと。それこそが、我々アーキテクトに課せられた責務である。

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