添付ファイル名に「魂」を宿す。正規表現でメール本文から案件番号を自動抽出する極意
こんにちは。自動化の海を渡るエンジニアの皆さん。
今日は、マクロの記録(Record Macro)という「魔法の杖」を卒業し、プログラミングという「自らの剣」を手に入れようとしているあなたへ、最高にエキサイティングな話をしましょう。
皆さんは、こんな経験はありませんか?
「メールに添付されたファイルは保存したけれど、後で探すときに、どの案件のファイルだったか分からなくて困った……」
添付ファイルの名前は、送信者が決めた `document.pdf` や `scan001.jpg` といった、中身を全く説明してくれない無機質なものが多いものです。しかし、そのメールの本文には、必ずと言っていいほど「案件番号:PJ-2023-101」といった、ファイルに付与すべき大切なメタデータが眠っています。
この「本文から情報を抜き出し、ファイル名に反映させる」という一連の流れを自動化できれば、あなたの業務効率は劇的に、文字通り次元が変わるほど向上します。
今日はその鍵となる技術、「正規表現(Regular Expression)」をOutlook VBAで使いこなす方法を、丁寧に伝授します。ここをクリアすれば、Outlook VBAの基本はバッチリですよ。
1. なぜ「正規表現」が必要なのか?
普通、文字を探すときは「この文字が含まれていたら」という「完全一致」で探します。
しかし、案件番号は `PJ-001` だったり `PJ-999` だったりと、数字の部分が毎回変わりますよね。
「PJ-」の後ろに数字が続く、という「パターン」で探さなければならない。このパターン検索のスペシャリストが「正規表現」です。
正規表現を使えば、
「『PJ-』で始まり、その後に数字が4桁続く文字列を探せ」
といった命令を、たった一行の短い記号で記述できるのです。
2. 実践!案件番号を抜き出すための「魔法の呪文」
まずは、今回のターゲットとなる「案件番号」のパターンを定義しましょう。
例として、案件番号が `PJ-2023-001` のような形式だと仮定します。
これに対応する正規表現の書き方はこうです:
`PJ-\d{4}-\d{3}`
分解して解説しますね。
- `PJ-` : そのまま「PJ-」という文字を探します。
- `\d` : 「数字(Digit)」を意味する記号です。
- `{4}` : 「直前のパターンが4回繰り返される」という意味です。つまり `\d{4}` で「数字4桁」になります。
- `-` : 再びハイフンを探します。
- `\d{3}` : 「数字3桁」を意味します。
これだけで、バラバラな数字の案件番号を、正確に一本釣りできるようになります。
3. 【実践コード】添付ファイルを案件番号付きで保存する
それでは、実際にOutlook VBAで動くコードを見ていきましょう。
初心者の方が躓かないよう、「参照設定」をしなくても動く「実行時バインディング(Late Binding)」という手法で書いています。これなら、コピペしてすぐに試せますよ。
Option Explicit
''' <summary>
''' 選択しているメールから添付ファイルを抽出し、
''' 本文内の案件番号をファイル名に付与して保存するマクロ
''' </summary>
Sub SaveAttachmentsWithProjectNumber()
Dim olItem As Outlook.MailItem
Dim regEx As Object
Dim matches As Object
Dim projectNo As String
Dim savePath As String
Dim att As Outlook.Attachment
Dim fileName As String
Dim fileExt As String
' --- 設定エリア ---
' 保存先のフォルダを指定してください(最後に \ を忘れずに)
savePath = "C:\Users\YourName\Desktop\SavedAttachments\"
' 保存先フォルダが存在するかチェック(なければ作成はせず、エラー回避のため終了)
If Dir(savePath, vbDirectory) = "" Then
MsgBox "保存先フォルダが見つかりません: " & savePath, vbCritical
Exit Sub
End If
' ------------------
' 正規表現オブジェクトの生成(Late Binding)
Set regEx = CreateObject("VBScript.RegExp")
With regEx
.Pattern = "PJ-\d{4}-\d{3}" ' 【重要】ここで案件番号のパターンを指定
.Global = False ' 最初に見つかったものだけを取得
.IgnoreCase = True ' 大文字・小文字を区別しない
End With
' 現在選択しているアイテムをループ処理
' ※複数のメールを選択して実行することも可能です
For Each olItem In Outlook.Application.ActiveExplorer.Selection
' メールアイテム以外(予定表など)はスキップ
If TypeOf olItem Is MailItem Then
' 1. 本文から案件番号を探す
projectNo = ""
If regEx.Test(olItem.Body) Then
Set matches = regEx.Execute(olItem.Body)
projectNo = matches(0).Value ' 最初に見つかったパターンを取得
End If
' 2. 添付ファイルの処理
If olItem.Attachments.Count > 0 Then
For Each att In olItem.Attachments
' 拡張子と元のファイル名を取得
fileExt = Mid(att.FileName, InStrRev(att.FileName, "."))
' 案件番号が見つかった場合は、案件番号をファイル名に含める
If projectNo <> "" Then
' 新しいファイル名: [案件番号]_[元のファイル名]
fileName = projectNo & "_" & att.FileName
Else
' 案件番号がない場合は、そのままの名前
fileName = att.FileName
End If
' 3. ファイルの保存実行
' ※ファイル名に使えない記号が含まれるとエラーになるため注意
On Error Resume Next
att.SaveAsFile savePath & fileName
If Err.Number <> 0 Then
Debug.Print "保存失敗: " & att.FileName & " (Err: " & Err.Description & ")"
Err.Clear
Else
Debug.Print "保存成功: " & fileName
End If
On Error GoTo 0
Next att
Else
Debug.Print "添付ファイルなし: " & olItem.Subject
End If
End If
Next olItem
MsgBox "処理が完了しました。保存先を確認してください。", vbInformation
End Sub
4. プロの視点:ここをクリアすれば完璧!
コードを動かす際に、初心者が陥りやすい「3つの落とし穴」を解説しておきます。ここを理解していれば、あなたはもう初心者卒業です。
① ファイル名に使えない「禁忌の文字」
Windowsでは、ファイル名に `\ / : * ? ” < > |` といった文字を使うことができません。
もし、メール本文から抽出した文字列にこれらの文字が含まれていると、`att.SaveAsFile` の瞬間にプログラムがクラッシュします。
実務では、抽出した文字列に対して `Replace` 関数などを使って、これらの文字をアンダースコア `_` などに置換する処理を入れるのが「プロの作法」です。
② `Body` と `HTMLBody` の違い
Outlookのメールには、プレーンテキスト形式の `Body` と、装飾が含まれる `HTMLBody` があります。
正規表現でテキストを解析する場合、タグ(`
③ パターンの「厳密さ」
例えば、`PJ-\d{3}` というパターンにしていた場合、もし本文に `PJ-12345` という文字列があったらどうなるでしょうか?
正規表現は「条件に合う部分」を抜き出そうとするので、`PJ-123` だけを抜き出してしまうことがあります。
「必ず4桁である」といった制約を、`{4}` のように正確に指定することが、データの整合性を守る鍵となります。
最後に
いかがでしたか?
「メールから情報を抜き出し、ファイル名を変えて保存する」
一見すると地味な作業に見えるかもしれませんが、これが自動化されることで、人間は「データを確認する」という、より価値の高い仕事に集中できるようになります。
正規表現は、最初は少し難しく感じるかもしれません。しかし、一度マスターすれば、テキスト操作における最強の武器になります。まずは、今回紹介したコードを自分の環境に合わせて少しずつ書き換えて、実験してみてください。
「動いた!」というその瞬間の喜びが、あなたを一流のエンジニアへと押し上げてくれます。
応援していますよ。次はもっと高度な自動化の世界で会いましょう!
