【極限設計】添付ファイル容量の「爆弾」を回避せよ:堅牢な自動検知・警告システムの構築術
業務自動化の世界において、もっとも「見えないコスト」を発生させる要因の一つが、メールサーバーの制限を超えた添付ファイルによる配信エラーだ。
「添付ファイルが大きすぎて送れませんでした」というエラーメッセージ。これは単なる通信エラーではない。業務フローの停止、データの欠落、そしてそれによる手動リカバリーコストの発生を意味する。プロフェッショナルなエンジニアであれば、問題が起きてから対処するのではなく、「問題が起きる前にシステムが自律的に防衛策を講じる」設計を組み込むべきだ。
本稿では、Outlook VBAを用い、添付ファイルの総容量を計算し、閾値を超えた場合に自動で警告を返す「ガードレール」の実装方法を解説する。単なるコピペで終わらせない。なぜその設計が必要なのか、その「思想」までを伝授しよう。
1. 素人が陥る「脆弱な設計」の罠
多くの開発者が最初に書くコードは、おそらくこのようなものだ。
' --- 典型的な「失敗する」コードのイメージ ---
For Each att In Item.Attachments
totalSize = totalSize + att.Size
Next att
If totalSize > 10000000 Then
Item.Reply.Send ' ← ここで致命的な設計ミスが発生する
End If
このコードには、実務に投入するにはあまりに多くの欠陥がある。
1. 型オーバーフローの無視: `totalSize` に `Integer` や `Long` を使用した場合、巨大な添付ファイル(数GBクラス)が来た瞬間に計算が破綻する。
2. 副作用(Side Effect)の制御不足: 警告メールを返信する際、条件判定のロジックと通信のロジックが密結合している。これでは、デバッグや仕様変更が極めて困難になる。
3. 例外処理の欠如: 破損したメールアイテムや、読み取り権限のない添付ファイルに遭遇した際、このコードは即座にクラッシュし、監視プロセスそのものを停止させる。
我々が目指すべきは、「計算(Logic)」、「判断(Policy)」、「アクション(Action)」を分離した、疎結合なアーキテクチャである。
2. プロダクション級の設計思想:三層分離モデル
堅牢なツールを作るためには、以下の3つのレイヤーに思考を切り分ける必要がある。
- Layer 1: Data Extraction (抽出層)
アイテムから純粋に「サイズ」という数値データだけを抽出する。ここではメールを送る、保存するといった「副作用」は一切排除する。
- Layer 2: Policy Engine (判定層)
抽出された数値が、あらかじめ定義された「閾値(Threshold)」を超えているかを判定する。
- Layer 3: Response Handler (応答層)
判定結果に基づき、警告メールを作成・送信する。
この分離により、「閾値を変更したい」「警告ではなくログに記録するだけにしたい」といった要求変更に対し、他のコードを壊すことなく、最小限の修正で対応が可能になる。
3. 実装:堅牢な添付ファイル・ガードレール
以下に、実務で使用可能なレベルまで昇華させたコードを示す。これを `ThisOutlookSession` に配置することを想定している。
Option Explicit
' --- 設定定数(保守性を高めるため、ロジックから分離) ---
Private Const MAX_ATTACHMENT_SIZE_BYTES As Double = 10485760 ' 10MB (10 * 1024 * 1024)
Private Const WARNING_SUBJECT_PREFIX As String = "[容量超過警告] "
''' <summary>
''' 新着メール受信時にトリガーされるイベントハンドラ
''' </summary>
Private Sub Application_NewMailEx(ByVal EntryID As String)
Dim objItem As Object
On Error GoTo ErrorHandler
' EntryIDからアイテムを取得
Set objItem = Application.GetNamespace("MAPI").GetItemFromID(EntryID)
' MailItemであることを確認(会議出席依頼などを除外)
If TypeOf objItem Is MailItem Then
ProcessMailItem objItem
End If
Exit Sub
ErrorHandler:
' プロダクション環境では、ここをファイルログやイベントログへ書き出す設計にする
Debug.Print "Critical Error in Application_NewMailEx: " & Err.Description
End Sub
''' <summary>
''' メールの処理フローを制御するメインロジック
''' </summary>
Private Sub ProcessMailItem(ByRef mailItem As MailItem)
Dim totalSize As Double
' 1. Data Extraction: サイズの計算
totalSize = CalculateTotalAttachmentSize(mailItem)
' 2. Policy Engine: 閾値判定
If totalSize > MAX_ATTACHMENT_SIZE_BYTES Then
' 3. Response Handler: 警告アクションの実行
SendSizeWarningReply mailItem, totalSize
End If
End Sub
''' <summary>
''' 添付ファイルの総容量を計算する(抽出層)
''' </summary>
''' <param name="mailItem">対象のメールアイテム</param>
''' <returns>合計サイズ(Bytes)</returns>
Private Function CalculateTotalAttachmentSize(ByRef mailItem As MailItem) As Double
Dim att As Attachment
Dim currentSum As Double
currentSum = 0
' 添付ファイルがない場合は即座に終了
If mailItem.Attachments.Count = 0 Then
CalculateTotalAttachmentSize = 0
Exit Function
End If
On Error Resume Next ' 個別の添付ファイルエラーで全体を止めないための防衛策
For Each att In mailItem.Attachments
' Double型を使用し、巨大なサイズによるオーバーフローを回避
currentSum = currentSum + CDbl(att.Size)
Next att
On Error GoTo 0
CalculateTotalAttachmentSize = currentSum
End Function
''' <summary>
''' 警告メールを自動返信する(応答層)
''' </summary>
''' <param name="originalMail">元のメールアイテム</param>
''' <param name="actualSize">検知されたサイズ</param>
Private Sub SendSizeWarningReply(ByRef originalMail As MailItem, ByVal actualSize As Double)
Dim replyMail As MailItem
Dim sizeMB As Double
' サイズをMB表記に変換(人間が読みやすい形式へ)
sizeMB = Round(actualSize / 1024 / 1024, 2)
On Error GoTo ReplyError
' 返信オブジェクトの生成
Set replyMail = originalMail.Reply
With replyMail
.Subject = WARNING_SUBJECT_PREFIX & .Subject
.HTMLBody = "<p style='color:red; font-weight:bold;'>" & _
"【警告】添付ファイルの総容量が制限値を超えています。<br>" & _
"検知サイズ: " & sizeMB & " MB<br>" & _
"サーバーの制限により、正しく受信できない可能性があります。<br>" & _
"ファイルを分割するか、クラウドストレージを利用してください。</p>" & _
"<hr>" & .HTMLBody
.Send
End With
Debug.Print "Warning sent for Item: " & originalMail.Subject
Exit Sub
ReplyError:
Debug.Print "Failed to send warning reply: " & Err.Description
End Sub
4. エンジニアとしての「深掘り」:実務での注意点
このコードを実装する際、さらに一歩上のレベルを目指すなら以下の2点を考慮せよ。
A. MIMEエンコードによる「見かけ上のサイズ」の乖離
メールは送信時、バイナリデータをテキストデータに変換する「Base64エンコード」が行われる。このプロセスにより、実際のファイルサイズよりも約33%程度、通信上のデータ量が増大する。
もし、メールサーバーの制限が「通信経路上での合計サイズ」に基づいている場合、コード内の `MAX_ATTACHMENT_SIZE_BYTES` は、実際のファイルサイズの合計よりも少し余裕(1.3倍程度)を持って設定するのが、真に「堅牢」な設計だ。
B. データベース・ログ連携への拡張性
実務では「警告を送って終わり」では不十分なことが多い。
「いつ、誰が、どの程度のサイズのメールを送ろうとしてエラーになったか」を、ExcelやSQL Server、あるいはクラウド上のログ基盤へ書き出す仕組みを `ErrorHandler` や `SendSizeWarningReply` の後に組み込むべきだ。これにより、組織全体の通信容量の傾向を分析する「インテリジェンス」へと昇華させることができる。
結論
自動化ツールを作る際、我々が向き合っているのは単なる「コード」ではない。「業務の継続性」だ。
エラーを恐れるのではなく、エラーが起きた時の振る舞いを設計に組み込む。この「防御的設計」こそが、凡庸なスクリプターと、伝説的なアーキテクトを分かつ境界線である。
