【実務・中級編】【初心者向け】メール本文の特定箇所から「案件番号」を抽出してファイル名に含める正規表現入門 – Outlook VBA解析バイブル

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

添付ファイル保存の「次元」を変えろ:正規表現を用いたメタデータ抽出による堅牢な自動化設計

業務自動化の現場に降り立つと、多くの開発者が陥る「初歩的かつ致命的な罠」がある。

それは、「添付ファイル名さえ保存できれば業務は回る」という安易な設計思想だ。

現場が真に求めているのは、単なるファイルのコピーではない。そのファイルが「どの案件に関するものか」「どのプロジェクトの成果物か」というコンテキスト(文脈)を付与された状態での保存である。メール本文に埋もれた「案件番号」を抽出し、ファイル名に刻印する。この一見単純な作業の背後には、正規表現の習得、オブジェクトのライフサイクル管理、そして例外処理という、プロフェッショナルとしての設計能力が問われる領域が広がっている。

本記事では、単なる「書き方」の紹介はしない。「なぜその書き方では現場で死ぬのか」、そして「どう設計すれば、保守性が高く、バグの起きないプロダクションコードになるのか」を、アーキテクトの視点から徹底的に解説する。

1. なぜ `InStr` や `Mid` では足りないのか?

多くの初心者は、特定の文字列を探す際に `InStr` 関数や `Mid` 関数を組み合わせて、文字列を切り出そうとする。

' 【非推奨】脆弱な実装例
pos = InStr(mailBody, "案件番号:")
If pos > 0 Then
    projectID = Mid(mailBody, pos + 6, 8)
End If

このコードは、一見動く。しかし、実務の荒波の中では容易に崩壊する。

  • 「案件番号:」の後にスペースが入った。
  • 「案件番号:」(コロンが半角)だった。
  • 桁数が変わった。

これら一つ一つの変化に対して、`If` 文の分岐を書き足すつもりか? それは設計ではなく、単なる「場当たり的な修正」だ。

ここで投入すべき武器が正規表現(Regular Expressions)である。正規表現は「パターンの定義」である。文字の並びの「ルール」を記述することで、表記の揺れを吸収し、抽出ロジックを極めてシンプルかつ強力に保つことができる。

2. プロダクション・アーキテクチャ:設計の三原則

堅牢なツールを作るために、以下の3点を設計思想の核に据えよ。

① ロジックの分離(Separation of Concerns)

「メールを走査するロジック」と「文字列から案件番号を抽出するロジック」を混ぜるな。抽出ロジックを独立した関数として切り出すことで、テストが容易になり、将来的なパターン変更にも即座に対応できる。

② オブジェクトのライフサイクル管理

正規表現エンジン(`VBScript.RegExp`)は、ループの中で毎回 `CreateObject` するな。生成コストは無視できない。ループの外で一度だけ生成し、使い回すのが鉄則だ。

③ 入力データのサニタイズ(Sanitization)

抽出した「案件番号」に、ファイル名として使えない禁止文字(`/`, `\`, `:`, `*`, `?`, `”`, `<`, `>`, `|`)が含まれていないかを確認せよ。これを行わないコードは、実行時にランタイムエラーを吐いて停止する「爆弾」と同じだ。

3. 実装例:案件番号抽出型・添付ファイル自動保存エンジン

以下に、実務でそのまま利用可能なレベルまで昇華させたコードを示す。
ここでは、参照設定の手間を省き、配布時のトラブル(参照不可エラー)を防ぐためにレイトバインディング(Late Binding)を採用している。

Option Explicit

''' <summary>
''' メインプロセス:受信トレイから特定の条件に合致するメールを処理する
''' </summary>
Public Sub ProcessProjectEmails()
    Dim outlookApp As Object
    Dim namespace As Object
    Dim inbox As Object
    Dim mailItem As Object
    Dim targetFolder As String
    Dim projectID As String
    Dim regExp As Object
    
    ' --- 設定領域 ---
    targetFolder = "C:\ProjectFiles\" ' 保存先パス(末尾に\を忘れるな)
    ' ----------------
    
    On Error GoTo ErrorHandler
    
    Set outlookApp = CreateObject("Outlook.Application")
    Set namespace = outlookApp.GetNamespace("MAPI")
    Set inbox = namespace.GetDefaultFolder(6) ' 6 = olFolderInbox
    
    ' 正規表現オブジェクトをループの外で一度だけ生成(パフォーマンス最適化)
    Set regExp = CreateObject("VBScript.RegExp")
    ' パターン例: 「PJ-」で始まり、その後に数字が5桁続くもの
    regExp.Pattern = "PJ-\d{5}"
    regExp.Global = False
    regExp.IgnoreCase = True

    ' 受信トレイのアイテムをループ(逆順で回すのが定石:削除や移動を伴う場合)
    Dim i As Long
    For i = inbox.Items.Count To 1 Step -1
        Set mailItem = inbox.Items(i)
        
        ' メールアイテムであることを確認
        If mailItem.Class = 43 Then ' 43 = olMail
            
            ' 1. 本文から案件番号を抽出
            projectID = ExtractProjectID(mailItem.Body, regExp)
            
            ' 案件番号が見つかった場合のみ処理を続行
            If projectID <> "" Then
                Call SaveAttachmentsWithID(mailItem, projectID, targetFolder)
            End If
            
        End If
    Next i

    MsgBox "処理が完了しました。", vbInformation
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 本文から正規表現を用いて案件番号を抽出する
''' </summary>
Private Function ExtractProjectID(ByVal bodyText As String, ByRef regExp As Object) As String
    Dim matches As Object
    
    ' 正規表現の実行
    Set matches = regExp.Execute(bodyText)
    
    If matches.Count > 0 Then
        ' 最初のマッチング結果を返す
        ExtractProjectID = matches(0).Value
    Else
        ExtractProjectID = ""
    End If
End Function

''' <summary>
''' 添付ファイルを案件番号付きのファイル名で保存する
''' </summary>
Private Sub SaveAttachmentsWithID(ByRef mailItem As Object, ByVal projectID As String, ByVal savePath As String)
    Dim att As Object
    Dim newFileName As String
    Dim fullPath As String
    Dim sanitizedID As String
    
    ' 1. 案件番号のサニタイズ(禁止文字の置換)
    sanitizedID = SanitizeFileName(projectID)
    
    ' 2. 添付ファイルのループ
    For Each att In mailItem.Attachments
        ' 新しいファイル名の構築: [案件番号]_[元のファイル名]
        newFileName = sanitizedID & "_" & att.FileName
        
        ' ファイル名に使用できない記号が元のファイル名に含まれている場合の対策
        newFileName = SanitizeFileName(newFileName)
        
        fullPath = savePath & newFileName
        
        ' 3. 保存実行
        On Error Resume Next ' 個別のファイル保存エラーで全体を止めない
        att.SaveAsFile fullPath
        If Err.Number <> 0 Then
            Debug.Print "保存失敗: " & att.FileName & " Error: " & Err.Description
            Err.Clear
        End If
        On Error GoTo 0
    Next att
End Sub

''' <summary>
''' ファイル名に使用できない文字をアンダースコアに置換する
''' </summary>
Private Function SanitizeFileName(ByVal text As String) As String
    Dim invalidChars As Variant
    Dim i As Integer
    
    ' Windowsのファイル名禁止文字
    invalidChars = Array("\", "/", ":", "*", "?", """", "<", ">", "|")
    
    SanitizeFileName = text
    For i = LBound(invalidChars) To UBound(invalidChars)
        SanitizeFileName = Replace(SanitizeFileName, invalidChars(i), "_")
    Next i
End Function

4. アーキテクトからの補足:実戦で勝ち抜くために

このコードは「動く」だけではない。実務レベルに耐えうるよう、以下の設計判断を下している。

なぜ `SanitizeFileName` が必要なのか?

もし、メール本文から抽出した案件番号が `PJ/2023/001` だった場合、そのままファイル名にしようとすると、OSはそれを「ディレクトリ構造」として解釈しようとし、存在しないパスを指定したとしてエラーを吐く。あるいは、ファイル名に `?` が含まれていれば、保存自体が拒否される。「外部からの入力(メール本文)を、システム(ファイルシステム)にそのまま流し込むな」。これはセキュリティと堅牢性の鉄則だ。

パフォーマンスの最適化

`regExp.Execute` を呼び出す際、`regExp` オブジェクトを `ByRef`(参照渡し)で関数に渡している。これにより、メモリ上の同一インスタンスを使い回し、オブジェクト生成のオーバーヘッドを最小限に抑えている。数千通のメールを処理する際、この差は顕著に現れる。

次のステップ:スケーラビリティ

このツールをさらに進化させるなら、以下の拡張を検討せよ。

  • ログ出力: `Debug.Print` ではなく、テキストファイルやデータベースへ「いつ、どのメールから、どのファイルを保存したか」を記録する。
  • 重複検知: 同一案件のファイルが既に存在する場合、`_v2` を付与するか、上書きするかを判断するロジックの実装。
  • DB連携: 保存したパスと案件番号をSQL ServerやAccessに書き込み、業務システムと同期させる。

結びに

自動化の本質は、単に作業を速めることではない。「人間が介在することによるエラー(ヒューマンエラー)の余地を、設計によって排除すること」にある。

正規表現を使いこなし、例外を想定し、オブジェクトを制御する。この一歩を踏み出すことで、君の書くコードは「単なるスクリプト」から「信頼されるシステム」へと昇華する。

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