【入門編】【中級者向け】添付ファイル名が重複した際に「(1), (2)…」と連番を付与して上書きを防止するループ処理 – Outlook VBA解析バイブル

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

上書きの恐怖から脱却せよ:Outlook VBAで添付ファイルを「安全に」自動保存する極限のロジック

こんにちは。今日もコードと向き合っているあなたを、心から歓迎します。

マクロの記録機能を使って「あ、これ便利だな」と一歩を踏み出したあなた。素晴らしいセンスです。しかし、実務という戦場に足を踏み入れると、ある「恐ろしい現実」に直面することになります。

それは、「同じ名前のファイルが来た瞬間、前のデータが跡形もなく消え去る」という現象です。

例えば、毎日届く「日報.xlsx」という添付ファイル。単純な保存マクロを組んでいると、新しいファイルが届いた瞬間に、昨日までの大切なデータが上書きされて消えてしまいます。これは単なるミスではなく、業務における「データの喪失」という致命的なリスクです。

今日は、そんな初学者が必ずぶつかる壁を突破し、プロのエンジニアが実践する「ファイル名重複回避ロジック」を伝授しましょう。ここをクリアすれば、あなたのOutlook VBAは「ただ動くツール」から「信頼されるシステム」へと進化します。

1. なぜ「上書き」は起きるのか? ―― 設計思想の欠如

プログラミングにおいて、ファイル保存の命令(`SaveAsFile`など)は、デフォルトでは「もし同じ名前のファイルがあったら、容赦なく上書きする」という挙動をすることが多々あります。

これを防ぐための考え方はシンプルです。
「保存する前に、そこに同じ名前の奴がいないか偵察(チェック)に行く」

この「偵察」こそが、今回学ぶ `Dir` 関数の役割です。

今回の設計戦略:スキャン&リネーム・アルゴリズム

1. ターゲットの確認: 保存したいファイル名を確認する。
2. 存在チェック: `Dir` 関数を使って、保存先に同名ファイルがあるか探す。
3. 回避ループ: もし存在したら、ファイル名に `(1)`、`(2)`… と番号を付けて、存在しない名前が見つかるまでループを回す。
4. 確定: 「誰もいないこと」を確認できた名前で、満を持して保存する。

2. 実装コード:堅牢な添付ファイル保存エンジン

それでは、実際に使えるコードを見ていきましょう。単に動くだけではなく、「拡張子を壊さない(file.pdf が file.pdf(1) にならない)」という、実務で最も重要なポイントを押さえた実装にしています。

' =================================================================
' 添付ファイル自動保存モジュール
' 設計思想: 重複回避によるデータ消失の完全防止
' =================================================================

Sub SaveAttachmentsWithUniqueName()
    Dim objNamespace As Outlook.NameSpace
    Dim objFolder As Outlook.MAPIFolder
    Dim objItem As Object
    Dim objMail As Outlook.MailItem
    Dim objAttachment As Outlook.Attachment
    
    Dim savePath As String
    Dim fileName As String
    Dim finalPath As String
    
    ' --- 設定エリア ---
    ' 保存先のフォルダパスを指定(末尾に \ を忘れないこと!)
    savePath = "C:\Users\YourName\Desktop\SavedAttachments\"
    ' ------------------

    ' フォルダが存在するかチェック(簡易版)
    If Dir(savePath, vbDirectory) = "" Then
        MsgBox "保存先フォルダが見つかりません: " & savePath, vbCritical
        Exit Sub
    End If

    Set objNamespace = Application.GetNamespace("MAPI")
    ' 受信トレイを選択
    Set objFolder = objNamespace.GetDefaultFolder(olFolderInbox)

    ' 受信トレイのアイテムをループ
    For Each objItem In objFolder.Items
        ' メールアイテムのみを対象とする
        If TypeOf objItem Is MailItem Then
            Set objMail = objItem
            
            ' メールの添付ファイルをループ
            For Each objAttachment In objMail.Attachments
                
                ' 1. 元のファイル名を取得
                fileName = objAttachment.FileName
                
                ' 2. 重複しないファイル名を生成する関数を呼び出す
                finalPath = GetUniqueFilePath(savePath, fileName)
                
                ' 3. ファイルを保存
                objAttachment.SaveAsFile finalPath
                
                Debug.Print "保存完了: " & finalPath
            Next objAttachment
        End If
    Next objItem

    MsgBag "処理が完了しました。"
End Sub

' =================================================================
' 関数: GetUniqueFilePath
' 役割: 指定されたパスに同名ファイルがある場合、(1), (2)... を付与したパスを返す
' =================================================================
Function GetUniqueFilePath(ByVal folderPath As String, ByVal originalName As String) As String
    Dim baseName As String
    Dim extension As String
    Dim dotPos As Integer
    Dim newName As String
    Dim counter As Integer
    Dim fullPath As String
    
    ' パスの末尾に \ がなければ補完する(堅牢性のための処置)
    If Right(folderPath, 1) <> "\" Then folderPath = folderPath & "\"
    
    ' 拡張子とファイル名を分離する
    ' 例: "report.pdf" -> baseName="report", extension=".pdf"
    dotPos = InStrRev(originalName, ".")
    If dotPos > 0 Then
        baseName = Left(originalName, dotPos - 1)
        extension = Mid(originalName, dotPos)
    Else
        baseName = originalName
        extension = ""
    End If
    
    ' 初回の試行
    newName = originalName
    fullPath = folderPath & newName
    counter = 1
    
    ' --- ここが極限のロジック:Dir関数による存在確認ループ ---
    ' Dir関数が空文字("")を返さない限り、ファイルは「存在する」と判断
    Do While Dir(fullPath) <> ""
        ' 重複していたら、(n) を付与した新しい名前を作る
        ' 例: "report(1).pdf"
        newName = baseName & "(" & counter & ")" & extension
        fullPath = folderPath & newName
        counter = counter + 1
    Loop
    ' -------------------------------------------------------
    
    ' 最終的に決定した「誰も使っていないパス」を返す
    GetUniqueFilePath = fullPath
End Function

3. プロの視点:コードの「魂」を読み解く

コードをただコピーして終わりにしてはいけません。なぜこの書き方をしたのか、その理由を知ることが、あなたを「書き手」から「設計者」へと変えます。

① `InStrRev` による拡張子の分離

多くの初心者がやってしまいがちなミスが、`fileName & “(” & counter & “)”` と直接結合してしまうことです。これだと、ファイル名が `data.xlsx(1)` という、OSが認識できないおかしな名前になってしまいます。
`InStrRev` を使って、「後ろから一番近いドット」を探し、ファイル名本体と拡張子を切り離す。この一手間が、データの整合性を守ります。

② `Do While Dir(fullPath) “”` の威力

`Dir` 関数は、指定したパスにファイルが存在すればその名前を返し、存在しなければ空の文字列 `””` を返します。
この「存在するかどうか」を判定の条件に使うことで、「空文字が返ってくるまで、名前を変え続ける」という、極めてシンプルかつ強力なループが完成します。

③ パス末尾の `\` 補完

`savePath` を指定する際、人間はうっかり `C:\Temp` と書いてしまうことがあります(本来は `C:\Temp\`)。
コード内で `If Right(folderPath, 1) <> “\” Then…` と書くことで、ユーザーの入力ミスをシステム側で吸収しています。これを「防御的プログラミング」と呼びます。

4. 陥りやすいエラーと対策

このコードを運用する上で、以下の点に注意してください。

  • アクセス権限: 保存先のフォルダに対して、書き込み権限がない場合はエラーになります。必ず書き込み可能なフォルダを指定してください。
  • 特殊文字: ファイル名に使えない文字(`\ / : * ? ” < > |`)が含まれるメール添付ファイルは、`SaveAsFile` でエラーになります。実務では、これらを置換する処理を追加するとさらに完璧です。
  • 大量のファイル: 数千個のファイルを一度に処理する場合、`Dir` 関数を回し続けるとわずかにパフォーマンスに影響しますが、Outlookの添付ファイル程度であれば全く問題になりません。

最後に:一歩先へ進むあなたへ

お疲れ様でした。これであなたは、「上書きによるデータ消失」という、プロの現場でも時折見かける初歩的な事故を防ぐ術を手にしました。

プログラミングとは、単に命令を並べることではありません。「起こりうる最悪の事態を想像し、それを未然に防ぐロジックを組み込むこと」です。

今回の `Dir` 関数を使ったループ処理は、ファイル操作におけるもっとも基本的で、もっとも重要なパターンの一つです。これをマスターしたあなたは、もう「マクロの記録」の枠には収まりません。

自信を持って、次の自動化に挑戦してください。応援していますよ。

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