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

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

マクロの記録を卒業しよう。件名から「注文番号」を抜き出し、フォルダを自動生成する極限の仕分け術

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

「マクロの記録」を使って、ボタン一つで特定の操作ができるようになった。それは素晴らしい第一歩です。でも、もしあなたが今、「メールの件名を見て、手動でフォルダを作り、そこに添付ファイルを保存する」という作業に、少しでも時間を割いているとしたら――。

もったいない。その時間は、もっとクリエイティブな思考に使うべきです。

今日は、単なる「定型作業の自動化」を超えて、「状況を判断して動的な構造を作る」という、中級者への登竜門となるテクニックを伝授します。テーマは、「正規表現(RegExp)を用いた注文番号の抽出と、動的なディレクトリ構築」です。

ここをクリアすれば、あなたのOutlook VBAは「ただの記録」から「知的なエージェント」へと進化します。準備はいいですか?

1. なぜ「正規表現」が必要なのか?

これまでの初級レベルの自動化では、`InStr`関数や`Mid`関数を使って、「〇文字目から5文字分を切り出す」といった手法を使っていたかもしれません。

しかし、現実はそんなに甘くありません。

  • 「注文番号:12345」
  • 「【注文No】12345」
  • 「Order No. 12345」

このように、件名のフォーマットが微妙に揺らぐことがあります。文字列の位置を固定して切り出す方法は、一箇所の変化で即座に崩壊します。

ここで登場するのが正規表現(Regular Expression)です。
正規表現は、「数字が続くパターンを探せ」「特定のキーワードの後の数字を捕まえろ」といった、「パターンの定義」を可能にします。これさえあれば、件名がどう揺らいでも、目的の「注文番号」だけを正確に射抜くことができるのです。

2. 設計図:処理のライフサイクル

コードを書く前に、エンジニアとして「設計図」を描きましょう。プログラムが動く際、以下のプロセスを辿ります。

1. メールの検知: 新着メール、あるいは選択したメールを取得。
2. パターンの照合 (RegExp): 件名の中に「注文番号らしきもの」があるかスキャン。
3. 値の抽出: 見つかったパターンから、純粋な「番号」だけを取り出す。
4. 環境の確認 (FSO): 保存先となるフォルダが既に存在するかチェック。
5. 構造の構築: フォルダがなければ、注文番号の名前で新しく作成。
6. ファイルの移送: 添付ファイルを、作成したフォルダへ安全に保存。

この「存在確認してから作る」というステップが、エラーを防ぐためのプロの作法です。

3. 実装:魂を込めたコード例

さあ、実際のコードを見ていきましょう。
今回は、初心者の方が設定で躓かないよう、参照設定を必要としない「レイトバインディング(遅延結合)」という手法で記述します。これなら、コードをコピペするだけで動きます。

Option Explicit

''' <summary>
''' 選択中のメールから注文番号を抽出し、フォルダを作成して添付ファイルを保存する
''' </summary>
Sub SmartAttachmentOrganizer()
    Dim objItem As Object
    Dim objMail As Outlook.MailItem
    Dim regEx As Object
    Dim matches As Object
    Dim orderNo As String
    Dim savePath As String
    Dim baseFolder As String
    Dim fso As Object
    Dim att As Outlook.Attachment
    
    ' --- 設定エリア ---
    ' 保存先のルートディレクトリを指定してください(末尾に \ を忘れないこと)
    baseFolder = "C:\Users\YourName\Documents\Orders\"
    ' ------------------

    ' 1. 選択されているアイテムの取得
    If Application.ActiveExplorer.Selection.Count = 0 Then
        MsgBox "メールを選択してください。", vbExclamation
        Exit Sub
    End If
    
    Set objItem = Application.ActiveExplorer.Selection.Item(1)
    
    ' メールアイテムでない場合は終了
    If Not TypeOf objItem Is MailItem Then
        MsgBox "メールを選択してください。", vbExclamation
        Exit Sub
    End If
    Set objMail = objItem

    ' 2. 正規表現の準備 (Late Binding)
    Set regEx = CreateObject("VBScript.RegExp")
    With regEx
        .Global = False
        .IgnoreCase = True
        ' パターン解説: 「注文」「No」「Order」の後に、コロンや空白があってもOK、その後の数字(\d+)をキャプチャ
        .Pattern = "(?:注文|No|Order)[\s::\.#-]*(\d+)"
    End With

    ' 3. 件名から注文番号を抽出
    If regEx.Test(objMail.Subject) Then
        Set matches = regEx.Execute(objMail.Subject)
        ' 正規表現のカッコ()で囲った部分(グループ1)が注文番号
        orderNo = matches(0).SubMatches(0)
    Else
        MsgBox "件名に注文番号が見つかりませんでした。", vbCritical
        Exit Sub
    End If

    ' 4. ファイルシステムオブジェクトの準備
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' 保存先フォルダのパスを構築
    savePath = baseFolder & orderNo & "\"

    ' 5. フォルダの動的生成
    ' フォルダが存在しない場合のみ作成する(ここがプロの作法)
    On Error Resume Next
    If Not fso.FolderExists(savePath) Then
        fso.CreateFolder savePath
        If Err.Number <> 0 Then
            MsgBox "フォルダの作成に失敗しました。パスを確認してください。" & vbCrLf & savePath, vbCritical
            Exit Sub
        End If
    End If
    On Error GoTo 0

    ' 6. 添付ファイルの保存
    If objMail.Attachments.Count > 0 Then
        For Each att In objMail.Attachments
            ' 添付ファイルを新しいフォルダへ保存
            att.SaveAsFile savePath & att.FileName
        Next att
        MsgBox "完了! 注文番号 [" & orderNo & "] のフォルダに保存しました。", vbInformation
    Else
        MsgBox "添付ファイルが見つかりませんでした。", vbExclamation
    End If

    ' オブジェクトの解放
    Set regEx = Nothing
    Set fso = Nothing
    Set objMail = Nothing
End Sub

4. コードの深層:ここが「設計」の肝だ

このコードの中で、特に意識してほしいポイントを解説します。

① 正規表現パターンの魔術

`.Pattern = “(?:注文|No|Order)[\s::\.#-]*(\d+)”`

この一行に、私の知見を凝縮しました。

  • `(?:注文|No|Order)`:非キャプチャグループといいます。「注文」か「No」か「Order」のいずれかに一致させますが、抽出対象には含めません。
  • `[\s::\.#-]*`:スペース、コロン、ドット、ハイフンなどが0回以上繰り返されていても無視する、という意味です。これで表記の揺れを完全に吸収します。
  • `(\d+)`:ここが本命です。「1回以上の数字の連続」を抽出し、メモリに保持します。

② FileSystemObject (FSO) の採用

VBA標準の `MkDir` 関数も使えますが、私はあえて `Scripting.FileSystemObject` を推奨します。なぜなら、FSOは「フォルダが存在するか?」というチェック(`FolderExists`)が非常にスマートに行え、実務におけるファイル操作の安定性が段違いだからです。

5. 陥りやすい罠:現場で起きるエラーを防ぐ

プロのエンジニアは、コードを書く時間よりも「エラーが起きないか」を考える時間の方が長いです。以下の3点には、常に注意を払ってください。

1. 禁止文字のトラップ:
注文番号に `/` や `*`、`?` などの記号が含まれている場合、Windowsのフォルダ名として使えないため、`CreateFolder` でエラーになります。実運用では、抽出した番号から記号を除去する処理を追加するのが理想的です。
2. パスの末尾の「\」:
`baseFolder` の末尾に `\` がないと、`baseFolder & orderNo` が `C:\DocsOrders12345` のように結合されてしまい、意図しない場所にフォルダが作られます。これは初心者が最も陥りやすいミスです。
3. 権限の問題:
`C:\` 直下など、書き込み権限が制限されている場所に保存しようとすると、エラーで止まります。必ず、ユーザーが確実に書き込める「ドキュメント」フォルダなどを指定しましょう。

最後に

いかがでしたか?
「件名から番号を抜き出し、フォルダを自動で作る」。一見すると小さな機能ですが、これは「非構造化データ(メール本文)を、構造化データ(整理されたフォルダ)へと変換する」という、データエンジニアリングの基本そのものです。

このコードをベースに、例えば「日付もフォルダ名に加える」とか「Excelの台帳に保存完了を記録する」といった拡張を加えてみてください。

一歩ずつ、着実に。
自動化の力で、あなたの時間を自由にする旅を続けてください。応援していますよ。

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