添付ファイル保存のその先へ:データ抽出を組み込んだ「堅牢な」自動化設計論
業務自動化の現場において、「添付ファイルをフォルダに保存する」というタスクは、もはや自動化の「ゴール」ではなく、単なる「通過点」に過ぎません。
真に価値のある自動化とは、添付ファイルを保存すると同時に、メール本文に埋もれた「注文番号」「金額」「納期」といった構造化データを抽出し、集計用データベース(CSV)へ即座に書き込むことです。
しかし、多くのエンジニアが作成するコードは、例外処理が疎かで、メールのフォーマットが少し変わっただけで崩壊し、あるいはファイルアクセス権の競合で止まってしまう「脆いスクリプト」に留まっています。
本記事では、プロフェッショナルが実践する、「例外に強く、保守性が高く、データ整合性を担保した」メール解析・ログ出力システムの設計手法を伝授します。
1. アーキテクチャ設計:なぜ「単なるコピペ」では失敗するのか
初心者が書くコードは、一つの `Application_NewMailEx` イベント内に、「メール受信」「添付保存」「本文抽出」「CSV書き込み」のすべてを詰め込みます。これは「密結合」と呼ばれる最悪の状態です。
プロフェッショナルは、以下の3つの責務を明確に分離(Separation of Concerns)します。
1. Trigger Layer (検知層): 新着メールの検知と、処理対象の特定。
2. Extraction Layer (抽出層): 正規表現(RegExp)を用いた、非構造化データからの特定パターン抽出。
3. IO Layer (入出力層): ファイルシステムへの保存と、CSVへのアトミックな追記。
この設計思想に基づかないコードは、将来的に「抽出ロジックだけ変更したい」「保存先をクラウドストレージに変えたい」といった要件変更に耐えられません。
2. プロダクション・グレードの実装例
以下に、実務でそのまま利用可能なレベルのコードを示します。ここでは、`NewMailEx` を使用します。`NewMail` イベントは、複数のメールが同時に届いた際に処理漏れが発生するリスクがありますが、`NewMailEx` は受信したアイテムの `EntryID` を渡してくれるため、極めて堅牢です。
事前準備
VBAエディタの「ツール」→「参照設定」から以下にチェックを入れてください。
- Microsoft Scripting Runtime (FileSystemObject用)
- Microsoft VBScript Regular Expressions 5.5 (正規表現用)
実装コード
Option Explicit
' =================================================================
' 構成定数:環境に合わせて変更すること
' =================================================================
Private Const SAVE_DIR As String = "C:\Automation\Attachments\" ' 添付ファイル保存先
Private Const LOG_FILE As String = "C:\Automation\Logs\OrderLog.csv" ' 集計用CSV
Private Const REGEX_PATTERN As String = "注文番号:\s*([A-Z0-9\-]+)" ' 例: "注文番号: ABC-123" を抽出
' =================================================================
' Main Entry Point: 新着メール検知イベント
' =================================================================
Private Sub Application_NewMailEx(ByVal EntryIDCollection As String)
Dim entryIDs() As String
Dim i As Integer
Dim olItem As Object
Dim mailItem As Outlook.MailItem
' 複数のEntryIDがカンマ区切りで渡される場合があるため分割
entryIDs = Split(EntryIDCollection, ",")
On Error GoTo ErrorHandler
For i = LBound(entryIDs) To UBound(entryIDs)
Set olItem = Application.Session.GetItemFromID(entryIDs(i))
' メールアイテムであることを確認
If TypeOf olItem Is Outlook.MailItem Then
Set mailItem = olItem
' 処理実行
ProcessMail mailItem
End If
Next i
Exit Sub
ErrorHandler:
Debug.Print "Critical Error in NewMailEx: " & Err.Description
' ここで管理者への通知ロジックを入れるのがプロの仕事
End Sub
' =================================================================
' Logic: メールの解析と保存
' =================================================================
Private Sub ProcessMail(ByRef mail As Outlook.MailItem)
Dim fso As New FileSystemObject
Dim regEx As New RegExp
Dim matches As MatchCollection
Dim extractedValue As String
Dim attachment As Outlook.Attachment
Dim savePath As String
On Error GoTo ProcessErrorHandler
' 1. 添付ファイルの保存
If mail.Attachments.Count > 0 Then
If Not fso.FolderExists(SAVE_DIR) Then fso.CreateFolder (SAVE_DIR)
For Each attachment In mail.Attachments
' ファイル名に不正文字が含まれるリスクを考慮し、実際にはサニタイズが必要
savePath = SAVE_DIR & attachment.FileName
attachment.SaveAsFile savePath
Next attachment
End If
' 2. 本文からの特定データ抽出 (RegExp)
With regEx
.Global = False
.IgnoreCase = True
.Pattern = REGEX_PATTERN
End With
' MailItem.Body はテキスト形式、HTML形式でもプレーンテキストとして取得可能
Set matches = regEx.Execute(mail.Body)
If matches.Count > 0 Then
' 正規表現の第1グループ(カッコ内)を取得
extractedValue = matches(0).SubMatches(0)
Else
extractedValue = "NOT_FOUND"
End If
' 3. CSVへのログ追記
AppendToCSV mail.ReceivedTime, extractedValue, mail.Subject
Exit Sub
ProcessErrorHandler:
Debug.Print "Error processing mail: " & mail.Subject & " | " & Err.Description
End Sub
' =================================================================
' IO: CSVへのアトミックな追記
' =================================================================
Private Sub AppendToCSV(ByVal receiveTime As Date, ByVal dataValue As String, ByVal subject As String)
Dim fso As New FileSystemObject
Dim ts As TextStream
Dim logDir As String
logDir = fso.GetParentFolderName(LOG_FILE)
' ディレクトリ存在確認
If Not fso.FolderExists(logDir) Then fso.CreateFolder (logDir)
' ファイルが開けなかった場合(Excel等で開いている場合)の対策
On Error Resume Next
Set ts = fso.OpenTextFile(LOG_FILE, ForAppending, True)
If Err.Number <> 0 Then
' ファイルがロックされている場合は、一旦ログに記録して諦めるか、リトライロジックを検討
Debug.Print "CSV Lock Error: " & LOG_FILE
Exit Sub
End If
On Error GoTo 0
' CSV形式で書き込み (カンマ区切り、ダブルクォーテーション囲み)
' データのカンマによる崩れを防ぐため、値を引用符で囲むのが鉄則
ts.WriteLine Format(receiveTime, "yyyy/mm/dd hh:nn:ss") & "," & _
"""" & dataValue & """," & _
"""" & Replace(subject, """", """""") & """"
ts.Close
End Sub
3. リーダーからの技術的助言:バグを未然に防ぐ「設計の極意」
このコードを単にコピペして終わりにしてはいけません。実務で運用するにあたり、以下の3点に留意してください。
① HTMLメールの罠:`Body` か `HTMLBody` か
`mail.Body` はOutlookによって簡易的なテキスト変換が行われます。しかし、複雑なHTMLテーブル構造の中に数値がある場合、`Body` では文字が繋がってしまい、正規表現がマッチしなくなることがあります。
もし抽出精度が低いと感じたら、`HTMLBody` を取得し、正規表現をHTMLタグを考慮したものにするか、あるいは一時的にHTMLをプレーンテキストに変換するライブラリを検討してください。
② ファイルロック(Concurrency)問題
自動化ツールが最も頻繁に死ぬ原因は、「人間がCSVをExcelで開いている最中に、プログラムが書き込みに行こうとする」ことです。
上記のコードでは `On Error Resume Next` を用いて、ファイルがロックされている場合にクラッシュせず、エラーログを残して処理を継続する「生存優先」の設計にしています。実務では、ここに「数秒待ってリトライする」ロジックを追加するとより堅牢になります。
③ 正規表現の「サニタイズ」
`extractedValue` をCSVに書き込む際、データ自体にカンマが含まれていると、CSVの列がズレてデータが破壊されます。
必ず `”””” & dataValue & “”””` のように、値をダブルクォーテーションで囲むこと。これが、データ整合性を守るための最低限のマナーです。
結論
優れた自動化エンジニアは、コードの短さではなく、「そのコードがどのような異常事態に遭遇するか」を予測して書きます。
今回紹介した `NewMailEx` による検知、`RegExp` による抽出、そしてエラーを考慮した `FSO` によるIO処理。これらを組み合わせることで、あなたの作成するツールは「ただの便利スクリプト」から「信頼に足る業務システム」へと昇華します。
さあ、この設計思想を手に、次のプロジェクトへ挑んでください。
