【実務・中級編】【中級者向け】件名に含まれる「注文番号」を正規表現で抽出し、フォルダ名として自動生成する – Outlook VBA解析バイブル

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

「場当たり的な実装」を卒業せよ:正規表現とFSOを用いた堅牢な添付ファイル自動仕分けの極意

現場で「動くツール」を作ることは、エンジニアにとって通過点に過ぎない。真に価値のあるエンジニアリングとは、「想定外の入力」や「環境の変化」に耐えうる、堅牢な(Robust)設計を構築することだ。

多くの開発者が、Outlook VBAで「件名から文字を抜いて、フォルダを作って、保存する」というタスクに挑む際、`InStr` や `Mid` 関数を組み合わせて場当たり的な文字列操作を行う。しかし、そんなコードは実務の荒波に放り込まれた瞬間、件名の微妙な表記揺れや、禁止文字が含まれたパスによって、音もなく沈黙する。

本稿では、中級者への階段を登ろうとする君たちに向けて、正規表現(RegExp)による精密なパターン抽出と、FileSystemObject (FSO) による動的なディレクトリ制御を組み合わせた、プロダクションレベルの設計思想を伝授する。

1. なぜ「文字列操作」では足りないのか

まず、設計の根幹となる考え方を整理しよう。
例えば、件名が `【注文】ORD-12345_株式会社ABC様` という形式だったとする。

初心者はこう書く。
`”ORD-“` が出現する位置を探し、そこから8文字切り出す……。

これがなぜ危険なのか?

  • `ORD 12345` (スペースが入った)
  • `ORDER-12345` (表記が変わった)
  • `[注文] ORD12345` (括弧が変わった)

これら全てのパターンに対応しようとすれば、`If` 文の地獄が始まる。これは「実装」であっても「設計」ではない。
我々が採用すべきは、「データの構造(パターン)」を定義する正規表現だ。

2. 堅牢な設計のための3つの鉄則

コードを書く前に、アーキテクトとして以下の3点を脳内に刻んでおけ。

① 異常系の徹底的な排除

ファイルシステムを操作する場合、OSが禁止している文字(`\ / : * ? ” < > |`)が注文番号に含まれていたらどうなるか? ツールは即座にクラッシュする。抽出した文字列をそのままパスとして使うのは、プロの仕事ではない。

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

`FileSystemObject` や `RegExp` は、COMオブジェクトだ。これらを適切に制御し、エラーが発生してもリソースを解放し、かつエラーの発生源を特定できる構造にする必要がある。

③ 冪等性(Idempotency)の確保

「同じ処理を何度実行しても、システムが壊れないこと」。
フォルダが既に存在する場合に `MkDir` でエラーを吐かせるような設計は、自動化ツールとしては致命的だ。

3. プロダクション・コードの実装例

それでは、実際に「注文番号(例:ORD-XXXXX)」を抽出し、それに基づいたディレクトリ構造を構築して添付ファイルを保存する、極めて堅牢なコードを示そう。

事前準備:
VBAエディタの [ツール] -> [参照設定] から以下にチェックを入れておくこと。

  • `Microsoft VBScript Regular Expressions 5.5`
  • `Microsoft Scripting Runtime`
Option Explicit

''' <summary>
''' メールの添付ファイルを、件名から抽出した注文番号に基づき自動仕分けするメインルーチン
''' </summary>
Public Sub ProcessIncomingMailAttachments(ByVal mailItem As Outlook.MailItem)
    On Error GoTo ErrorHandler

    ' --- 設定エリア ---
    Const BASE_SAVE_PATH As String = "C:\AutomatedStorage\Orders\" ' 保存先ベースディレクトリ
    Const REGEX_PATTERN As String = "ORD-\d{5}"                   ' 注文番号のパターン (ORD- + 数字5桁)
    ' ------------------

    Dim regEx As New RegExp
    Dim matches As MatchCollection
    Dim orderNumber As String
    Dim targetFolder As String
    Dim fso As New FileSystemObject
    Dim attachment As Outlook.Attachment
    
    ' 1. 正規表現の設定
    With regEx
        .Pattern = REGEX_PATTERN
        .IgnoreCase = True
        .Global = False ' 最初に見つかったものだけを取得
    End With

    ' 2. 件名から注文番号を抽出
    Set matches = regEx.Execute(mailItem.Subject)
    
    If matches.Count = 0 Then
        Debug.Print "Skip: 注文番号が見つかりませんでした。 Subject: " & mailItem.Subject
        Exit Sub
    End If
    
    orderNumber = matches(0).Value
    
    ' 3. 禁止文字のサニタイズ(念のための安全策)
    orderNumber = SanitizeFolderName(orderNumber)
    
    ' 4. 保存先ディレクトリの構築と作成
    targetFolder = BuildSafePath(BASE_SAVE_PATH, orderNumber)
    EnsureDirectoryExists fso, targetFolder

    ' 5. 添付ファイルの保存
    If mailItem.Attachments.Count > 0 Then
        For Each attachment In mailItem.Attachments
            ' 添付ファイルの保存実行
            Dim savePath As String
            savePath = targetFolder & "\" & attachment.FileName
            
            ' 同名ファイルが存在する場合の衝突回避ロジック(必要に応じて拡張)
            attachment.SaveAsFile savePath
            Debug.Print "Saved: " & savePath
        Next attachment
    Else
        Debug.Print "Info: 添付ファイルがありませんでした。"
    End If

CleanUp:
    Set regEx = Nothing
    Set fso = Nothing
    Exit Sub

ErrorHandler:
    ' 実務ではここでログファイルへの書き出しや、管理者への通知を行う
    MsgBox "Critical Error in ProcessIncomingMailAttachments:" & vbCrLf & _
           "Error No: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "Automation Error"
    Resume CleanUp
End Sub

''' <summary>
''' ファイルシステム上のディレクトリが存在することを確認し、なければ作成する
''' </summary>
Private Sub EnsureDirectoryExists(ByRef fso As FileSystemObject, ByVal path As String)
    ' 再帰的にディレクトリを作成する(階層が深い場合に対応)
    Dim parts() As String
    Dim currentPath As String
    Dim i As Integer
    
    parts = Split(path, "\")
    currentPath = parts(0) ' ドライブレター等
    
    For i = 1 To UBound(parts)
        If parts(i) <> "" Then
            currentPath = currentPath & "\" & parts(i)
            If Not fso.FolderExists(currentPath) Then
                fso.CreateFolder currentPath
            End If
        End If
    Next i
End Sub

''' <summary>
''' パスを安全に結合する(末尾のバックスラッシュ制御)
''' </summary>
Private Function BuildSafePath(ByVal baseDir As String, ByVal subDir As String) As String
    Dim fso As New FileSystemObject
    If Right(baseDir, 1) <> "\" Then baseDir = baseDir & "\"
    BuildSafePath = baseDir & subDir
End Function

''' <summary>
''' フォルダ名に使用できない文字を置換・除去する
''' </summary>
Private Function SanitizeFolderName(ByVal inputStr As String) As String
    Dim invalidChars As Variant
    Dim i As Integer
    invalidChars = Array("\", "/", ":", "*", "?", """", "<", ">", "|")
    
    SanitizeFolderName = inputStr
    For i = LBound(invalidChars) To UBound(invalidChars)
        SanitizeFolderName = Replace(SanitizeFolderName, invalidChars(i), "_")
    Next i
End Function

4. アーキテクトの視点:コード解説と運用上の注意

このコードが、単なる「コピペ」以上の価値を持つ理由を解説する。

正規表現による「意図」の明確化

`REGEXP_PATTERN = “ORD-\d{5}”` という記述は、単なる文字列検索ではない。「ORD-に続く5桁の数字」というビジネスルールをコードに落とし込んでいる。これにより、仕様変更(例:桁数が6桁になる)が発生した際も、修正箇所は1行で済む。

再帰的なディレクトリ作成 (`EnsureDirectoryExists`)

標準の `MkDir` は、親ディレクトリが存在しない場合にエラーを吐く。実務では、`C:\Data\2023\Orders\ORD-12345` のように、深い階層を動的に作りたいケースが多い。この関数は、階層を一段ずつチェックしながら作成していく、堅牢なアプローチを取っている。

サニタイズの重要性

`SanitizeFolderName` 関数を実装しているのは、正規表現が万が一、予期せぬ記号を拾った場合のリスクヘッジだ。これは「動けばいい」コードと「運用に耐える」コードの決定的な差である。

運用におけるパフォーマンスと限界

  • ネットワークドライブの遅延: `fso.FolderExists` や `fso.CreateFolder` は、ネットワーク越しに行うと非常に重い。大量のメールを一度に処理する場合は、ローカルで処理してから最後に移動させる等の検討が必要だ。
  • 競合状態 (Race Condition): 同時に複数のインスタンスが同じフォルダを作ろうとするとエラーになる可能性がある。厳密な環境では、エラーハンドリング内で「既に存在しているならOKとする」リトライロジックを組み込むべきだ。

結論

自動化の目的は、人間を単純作業から解放することにある。しかし、その自動化ツール自体が、エラーメッセージを吐いて止まり、管理者の手を煩わせるようでは本末転倒だ。

「パターンを定義せよ」「例外を想定せよ」「環境の制約を理解せよ」。

この3点を守り抜くことで、君の書くコードは、単なるスクリプトから、信頼される「システム」へと昇華する。次なる課題は、この仕組みをデータベース(SQL Server等)と連携させ、処理ログを永続化することだ。挑戦を続けることを期待している。

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