添付ファイルに「重み」を感じる。Outlook VBAで制御する、プロフェッショナルなメール・ゲートキーパーの作り方
こんにちは。自動化の世界へようこそ。
「マクロの記録」を使って、なんとか一歩を踏み出したあなた。素晴らしい一歩です。でも、記録されたコードを見返して、「なぜここでこの単語が出てくるんだろう?」「もっとスマートに書けないのかな?」と、どこかモヤモヤした感覚を抱いていませんか?
その感覚こそが、あなたが「単なる操作の記録者」から「システムを設計するエンジニア」へと進化しようとしている証拠です。
今日は、そんなあなたに贈る、少しだけ背伸びした、でも非常に実用的なテーマを用意しました。
テーマは、「添付ファイルの総容量を計算し、制限を超えたら警告メールを自動返信する」ロジックの構築です。
メールサーバーの制限(例えば20MBなど)を意識せずにファイルを送り合い、結局送信エラーで業務が止まる……。そんな「現場の悲劇」を、あなたの書くコードで未然に防ぐ。これこそが、エンジニアが提供できる真の価値です。
1. 設計図を描く:ロジックの「思考プロセス」
いきなりコードを書き始めてはいけません。一流のアーキテクトは、必ず「ロジックのフロー」を頭の中で、あるいは紙の上で組み立てます。
今回のプログラムが実現すべきステップは以下の通りです。
1. 検知: 新しいメールが受信フォルダに届いたことを検知する。
2. 走査(スキャン): そのメールに添付されているファイルを一つずつ調べ上げる。
3. 集計: 各ファイルのサイズ(Byte)を足し合わせ、合計値を算出する。
4. 判定: 合計値が、あらかじめ決めておいた「閾値(しきいち)」を超えているか?
5. 実行: 超えていれば、相手に「サイズが大きすぎます」と親切な警告メールを自動返信する。
ここで重要なのは、「メール全体のサイズ」ではなく「添付ファイルの合計サイズ」を見るという点です。メールの本文やヘッダーの情報は無視し、純粋に「重い荷物(添付ファイル)」だけにフォーカスするのが、このロジックの肝になります。
2. 実装:魂を込めたコード・テンプレート
それでは、実際のコードを見ていきましょう。このコードは `ThisOutlookSession` に記述することを想定しています。
' --- ThisOutlookSession に記述してください ---
Option Explicit
' 閾値を設定(例:10MB = 10 * 1024 * 1024 Bytes)
' 現場のルールに合わせてここを調整します
Private Const MAX_ATTACHMENT_SIZE_BYTES As Long = 10485760
''' <summary>
''' 受信アイテムが追加されたときに自動的に実行されるイベントハンドラ
''' </summary>
Private Sub Application_NewMailEx(ByVal EntryID As String)
Dim objItem As Object
Dim objMail As Outlook.MailItem
Dim objAttachment As Outlook.Attachment
Dim totalSize As Long
Dim isTooLarge As Boolean
' EntryIDから受信したアイテムを取得
Set objItem = Application.GetNamespace("MAPI").GetItemFromID(EntryID)
' アイテムがメール(MailItem)であることを確認
' ※会議出席依頼などの場合は処理をスキップする(エラー防止の基本)
If TypeOf objItem Is Outlook.MailItem Then
Set objMail = objItem
totalSize = 0
isTooLarge = False
' --- 添付ファイルの総容量計算フェーズ ---
' Attachmentコレクションをループで回す
' オブジェクトのライフサイクルを意識し、一つずつ中身を覗き込むイメージです
For Each objAttachment In objMail.Attachments
' Attachment.Size プロパティは「Byte」単位で返される
' Long型を使用して、大きな数値でもオーバーフローしないようにします
totalSize = totalSize + objAttachment.Size
Next objAttachment
' --- 判定フェーズ ---
If totalSize > MAX_ATTACHMENT_SIZE_BYTES Then
isTooLarge = True
End If
' --- アクションフェーズ ---
If isTooLarge Then
Call SendWarningReply(objMail, totalSize)
End If
End If
' メモリ解放(オブジェクトのライフサイクルを適切に管理する習慣を)
Set objAttachment = Nothing
Set objMail = Nothing
Set objItem = Nothing
End Sub
''' <summary>
''' 警告メールを生成して返信するサブプロシージャ
''' </summary>
Private Sub SendWarningReply(ByRef targetMail As Outlook.MailItem, ByVal actualSize As Long)
Dim objReply As Outlook.MailItem
Dim strSizeMB As String
' バイト単位をMB単位に変換して、人間が読みやすい形式にする
' 1024で割る工程を挟むのがエンジニアの優しさです
strSizeMB = Format(actualSize / 1024 / 1024, "0.00")
' 返信メールオブジェクトを作成
Set objReply = targetMail.Reply
' 本文の構成
With objReply
.Body = "【自動警告】" & vbCrLf & vbCrLf & _
"お送りいただいたメールの添付ファイル総容量が、当社の規定サイズを超えています。" & vbCrLf & _
"現在の合計サイズ: " & strSizeMB & " MB" & vbCrLf & vbCrLf & _
"恐れ入りますが、ファイルを分割するか、ファイル転送サービス等をご利用ください。" & vbCrLf & _
"※このメールはシステムによる自動返信です。"
' 送信(ここを .Display に変えると、送信前に内容を確認できます)
.Send
End With
Set objReply = Nothing
End Sub
3. アーキテクトの視点:ここが「プロ」の境界線
コードを書いた後、あなたは自分自身にこう問いかけてください。「これ、もしイレギュラーなことが起きても止まらないかな?」と。
① 型の選択:`Long` を選んだ理由
添付ファイルのサイズは、数MB程度なら問題ありませんが、最近の巨大な動画ファイルなどを扱うと、`Integer` 型(最大約32,767)ではすぐに溢れてしまいます(オーバーフロー)。VBAにおいて、サイズや行数を扱うときは、常に余裕を持った `Long` 型を選択するのが鉄則です。
② 境界条件への配慮:`TypeOf` による型チェック
`Application_NewMailEx` は、メールだけでなく、会議の通知やシステムメッセージなど、あらゆる「新しいアイテム」に対して反応します。もし、メールではないオブジェクトに対して「添付ファイルを見ろ」と命令したら、プログラムはクラッシュします。
`If TypeOf objItem Is Outlook.MailItem Then` という一行は、堅牢なシステムを作るための「防波堤」なのです。
③ ユーザー体験(UX)への配慮:単位の変換
プログラムにとっての `10485760` は正確な数値ですが、人間にとってはただの数字の羅列です。これを `10.00 MB` と変換して伝える。この「相手(ユーザー)の視点」に立った処理こそが、ただのコードを「ツール」へと昇華させます。
4. 陥りやすい罠(Pitfalls)
最後に、あなたが開発中に遭遇するかもしれない「落とし穴」を教えておきましょう。
- 無限ループの恐怖:
もし、警告メール自体に大きな添付ファイルが含まれていて、それを自分自身が受信してしまったら……? 警告 $\rightarrow$ 受信 $\rightarrow$ 警告 $\rightarrow$ 受信……という無限ループに陥ります。
*対策*: 本格的な運用では、「送信者が自分自身(自分のアドレス)である場合は処理をスキップする」というロジックを追加してください。
- `.Send` と `.Display` の使い分け:
開発中は必ず `.Display` を使いましょう。いきなり `.Send` で自動送信してしまうと、デバッグ中に誤ったメールを大量に送信してしまうリスクがあります。
おわりに
いかがでしたか?
「添付ファイルのサイズを測る」という一見シンプルな動作の裏側には、オブジェクトの型、メモリの管理、ユーザーへの配慮といった、エンジニアリングの本質が詰まっています。
マクロの記録から脱却し、こうして「ロジック」を組み立てる力がついてくれば、Outlook VBAは単なる便利ツールではなく、あなたの強力な「デジタル・アシスタント」へと変わります。
ここをクリアすれば、Outlook VBAの基本はバッチリですよ。
さあ、次はどんな自動化に挑戦しましょうか?
Happy Coding!
