【入門編】【初心者向け】添付ファイル名に「送信者名」をプレフィックスとして付与し、誰からの資料か一目で判別する – Outlook VBA解析バイブル

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

添付ファイル管理の「迷子」をゼロにする。Outlook VBAで実現する、SenderNameプレフィックス付与術

こんにちは。業務自動化の世界へようこそ。

「あ、あの資料、誰から送られてきたんだっけ……?」
デスクトップに散乱する `report.xlsx` や `memo.pdf` を前に、メールを一つずつ遡って検索した経験はありませんか?

マクロの記録機能を使って「ボタンを押したら何かをする」という段階から一歩踏み出し、「データ(メール)が持つ情報を、別のデータ(ファイル名)に変換して活用する」という思考にシフトする。これこそが、エンジニアリングの醍醐味です。

今日は、プログラミング初学者が最初にぶつかる壁であり、かつマスターすると劇的に業務が変わる「メールの送信者名を取得して、添付ファイル名に結合する」というテクニックを伝授します。

ここをクリアすれば、Outlook VBAの基本はバッチリですよ。さあ、一緒に見ていきましょう。

1. 思考の設計図:何を、どう動かすのか?

いきなりコードを書くのは、地図を持たずに樹海に入るようなものです。まずは、私たちがやりたいことを「論理的なステップ」に分解しましょう。

私たちが目指すゴールは、「`report.xlsx`」というファイルを「`田中太郎_report.xlsx`」に変えて保存することです。

自動化のアルゴリズム(手順)

1. 対象の特定: 今見ているメール(あるいは受信したメール)を捕まえる。
2. 情報の抽出: そのメールの「送信者名(`SenderName`)」をメモリに読み込む。
3. 添付ファイルの走査: メールに付いている添付ファイルを一つずつチェックする。
4. 名前の合成: `送信者名` + `_` + `元のファイル名` という新しい名前を作る。
5. 書き出し: 指定したフォルダに、新しい名前で保存する。

この「情報の抽出」と「名前の合成」こそが、今回の核心部分です。

2. 実装:魂を込めたコード・テンプレート

それでは、実際に動くコードを見てみましょう。初心者の方でも扱いやすいよう、「現在選択しているメールに対して実行する」という形式で書いています。

以下のコードを、OutlookのVBAエディタ(Alt + F11)の標準モジュールに貼り付けてみてください。

Option Explicit

''' <summary>
''' 選択中のメールの添付ファイルに、送信者名を付けて保存するプロシージャ
''' </summary>
Sub SaveAttachmentsWithSenderName()
    Dim objSelection As Outlook.Selection
    Dim objMail As Outlook.MailItem
    Dim objAttachment As Outlook.Attachment
    Dim strSavePath As String
    Dim strSenderName As String
    Dim strNewFileName As String
    Dim strCleanName As String
    
    ' --- 設定エリア ---
    ' 保存先のパスを指定してください(最後に必ず \ を入れること)
    strSavePath = "C:\Users\YourName\Desktop\Attachments\"
    ' ------------------

    ' 1. フォルダの存在確認(簡易チェック)
    If Dir(strSavePath, vbDirectory) = "" Then
        MsgBox "保存先のフォルダが見つかりません: " & strSavePath, vbCritical
        Exit Sub
    End If

    ' 2. 現在選択されているアイテムを取得
    Set objSelection = Outlook.Application.ActiveExplorer.Selection

    ' 選択されているものが無い場合は終了
    If objSelection.Count = 0 Then
        MsgBox "メールを選択してください。", vbExclamation
        Exit Sub
    End If

    ' 3. 選択されたアイテムのループ処理
    For Each objMail In objSelection
        ' 選択されたものが「メール」であることを確認(会議出席依頼などを除外するため)
        If TypeOf objMail Is MailItem Then
            
            ' 送信者名を取得
            strSenderName = objMail.SenderName
            
            ' 【重要】ファイル名に使えない禁止文字を掃除する(後述の関数を使用)
            strCleanName = CleanFileName(strSenderName)

            ' 4. 添付ファイルを一つずつ処理
            If objMail.Attachments.Count > 0 Then
                For Each objAttachment In objMail.Attachments
                    
                    ' 新しいファイル名の組み立て: [送信者名]_[元のファイル名]
                    strNewFileName = strCleanName & "_" & objAttachment.FileName
                    
                    ' 保存実行
                    objAttachment.SaveAsFile strSavePath & strNewFileName
                    
                Next objAttachment
                
                Debug.Print "保存完了: " & objMail.Subject
            Else
                Debug.Print "添付ファイルなし: " & objMail.Subject
            End If
            
        End If
    Next objMail

    MsgBox "処理が完了しました!", vbInformation
End Sub

''' <summary>
''' ファイル名に使用できない禁止文字(\ / : * ? " < > |)をアンダースコアに置換する
''' </summary>
Function CleanFileName(strInput As String) As String
    Dim varChars As Variant
    Dim i As Integer
    Dim strResult As String
    
    strResult = strInput
    ' Windowsのファイル名で使用できない文字のリスト
    varChars = Array("\", "/", ":", "*", "?", """", "<", ">", "|")
    
    ' 各文字を順番にチェックして置換
    For i = LBound(varChars) To UBound(varChars)
        strResult = Replace(strResult, varChars(i), "_")
    Next i
    
    CleanFileName = strResult
End Function

3. プロの視点:ここが「分かれ道」です

コードをコピペして動かすだけでは、あなたはまだ「ユーザー」です。「エンジニア」になるためには、コードの裏側にあるオブジェクトの挙動を理解しなければなりません。

① `SenderName` プロパティの正体

`objMail.SenderName` は、メールのヘッダー情報から「表示名」を引っ張ってくるプロパティです。
ここで注意が必要なのは、「送信者の名前には、ファイル名として使えない記号が含まれている可能性がある」ということです。

例えば、送信者名が `Tanaka/Sato` だった場合、そのままファイル名に使うと、Windowsは「`Tanaka` というフォルダの中の `Sato` というファイル」だと勘違いしてしまい、エラーで止まってしまいます。
これを防ぐために、上記のコードでは `CleanFileName` という「文字の掃除用関数」を自作して組み込んでいます。これが、実務で使えるコードと、ただの練習用コードの決定的な差です。

② オブジェクトのライフサイクルと型判定

`ActiveExplorer.Selection` で取得できるのは、あくまで「選択されているもの」です。しかし、Outlookではメール以外にも「会議の予定」や「タスク」が選択できる場合があります。
`If TypeOf objMail Is MailItem Then` という一行を入れることで、プログラムが予期せぬデータに触れてクラッシュするのを防いでいます。これを「型判定」と呼びます。堅牢なプログラムには欠かせない作法です。

③ 文字列結合の演算子 `&`

VBAにおいて、文字列を繋ぐのは `+` ではなく `&` を使うのが鉄則です。
`+` は数値の足し算と混同されるリスクがありますが、`&` は「これは文字列の結合ですよ」という明確な意思表示になります。

4. 陥りやすいエラーと対策

実装中にエラーが出たら、慌てずに以下の3点を確認してください。

1. 「パスが見つかりません」エラー

  • `strSavePath` の末尾に `\` を忘れていませんか? `C:\Temp` ではなく `C:\Temp\` と書く必要があります。

2. 「実行時エラー ‘424’: オブジェクトが必要です」

  • `objMail` が正しくセットされていない可能性があります。メールを選択していない状態で実行していないか確認しましょう。

3. ファイルが上書きされる問題

  • 同じ送信者が同じ名前のファイルを送ってきた場合、後のファイルが前のファイルを上書きしてしまいます。これを防ぐには、ファイル名に `Now`(現在時刻)を付与するなどの工夫が必要です。

最後に

お疲れ様でした!
「送信者名を取得してファイル名に付ける」という一見小さなステップですが、ここには「データの抽出」「加工」「エラー回避」という、自動化エンジニアリングのエッセンスがすべて詰まっています。

これができるようになると、「次は受信した瞬間に自動で保存したいな(イベントプロシージャ)」とか、「特定のキーワードが含まれる時だけ実行したいな(条件分岐)」といった、より高度な設計への道が見えてくるはずです。

一歩ずつ、楽しみながらコードを書き進めていきましょう。応援していますよ!

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